[
https://issues.apache.org/jira/browse/UIMA-1524?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15497451#comment-15497451
]
Marshall Schor commented on UIMA-1524:
--------------------------------------
A partial reply - more later...
(5) and (7) both have an aspect of words being "declarative" vs "imperative"
sense. Declarative is (to my mind) more in keeping with the lazy approach to
functional paradigm embodied in streams, where nothing happens until you get to
the "terminal" operation. The declarative says more what is to happen, without
specifying how. The imperative is more of a how statement.
The term "skip" sounds like an imperative action. The term "offset" sounds (to
me) more declarative. I, however, completely agree that it's confusing due to
its other use within UIMA. So need to find another "declarative" term (if
possible). Maybe fudgeFactor( + - nnn) ? (offered in the spirit of
brainstorming - might be silly, but might trigger a good thing :-) )
The term "reverse" is more like an action. The declarative term might be
iterate-toward-end-of-index, or iterate-toward-beginning-of-index. Of course,
these are too long... However, ignoring that, I think it would be intuitive
that iterate-toward-end-of-index().iterate-toward-end-of-index() would not be a
no-op.
When you have semantics like reverse().reverse() being a no-op, yes, it makes
sense in terms of imperative actions, but it requires the human reader of the
code to "play computer" and keep some state variables, in order to figure out
what the meaning of a bit of code is. As my brain grows feebler (!), I find I
prefer approaches which don't require this :-), but instead, always simply mean
just what they say.
So, I'd like to find a declarative term expressing iteration direction -
towardFirst, towardLast, or ??
> JFSIndexRepository should be enhanced with new generic methods
> --------------------------------------------------------------
>
> Key: UIMA-1524
> URL: https://issues.apache.org/jira/browse/UIMA-1524
> Project: UIMA
> Issue Type: Improvement
> Components: Core Java Framework
> Affects Versions: 2.3
> Reporter: Joern Kottmann
>
> Existing methods should be overloaded with an additional Class argument to
> specify the exact return type. This changes make down casting of returned
> objects unnecessary.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)