[ https://issues.apache.org/jira/browse/UIMA-5115?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15533169#comment-15533169 ]
Marshall Schor commented on UIMA-5115: -------------------------------------- uimaFIT has a param for following/preceding that limits the number of annotations returned. The general "positioning" alternatives include a FS, begin/end, and those two plus a possible "offset". These seem to possibly confict when designing APIs. (offset(n) here means after positioning the iterator to some start position, before starting, do "n" moveToPrevious/Next() operations). I tend to think that limit(n) is more popular than offset(n); if so, perhaps we should offer it the optional positional parameter spot uniformly in all the API variants instead of offset? Examples: {code} cas.select(MyType.class).startAt(begin, end, limit).offset(3) // limit is (optional) positional, offset via keyword cas.select(MyType.class).startAt(begin, end, offset).limit(4) // offset is (optional) positional, limit via keyword cas.select(MyType.class).following(begin, end, limit).offset(3) // limit is (optional) positional, offset via keyword cas.select(MyType.class).following(begin, end, offset).limit(4) // offset is (optional) positional, limit via keyword {code} Other ideas or preferences? I don't have a strong preference, except I'm slightly in favor of being consistent. * The inconsistent approach would be to have it one way for, say,, coveredBy, and the other way for following. > uv3 select() api for iterators and streams over CAS contents > ------------------------------------------------------------ > > Key: UIMA-5115 > URL: https://issues.apache.org/jira/browse/UIMA-5115 > Project: UIMA > Issue Type: New Feature > Components: Core Java Framework > Reporter: Marshall Schor > Priority: Minor > Fix For: 3.0.0SDKexp > > > Design and implement a select() API based on uimaFIT's select, integrated > well with Java 8 concepts. Initial discussions in UIMA-1524. Wiki with > diagram: https://cwiki.apache.org/confluence/display/UIMA/UV3+Iterator+support -- This message was sent by Atlassian JIRA (v6.3.4#6332)