[
https://issues.apache.org/jira/browse/LUCENE-1290?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12598914#action_12598914
]
Michael Busch commented on LUCENE-1290:
---------------------------------------
{quote}
Hits does seem to be very good at leading new Lucene users into writing
non-performant code and on that basis is probably worth deprecating.
{quote}
So it seems that a fair amount of people agree here that Hits should be
deprecated.
Hits will still be part of Lucene 2.4 and 2.9. In the meantime, we can develop
new helper classes,
like Mark's HitPageCollector, if people see the need for it. Contrib would be a
good place for
those classes.
So in case of no negative votes, I will commit this patch before the weekend.
> Deprecate Hits
> --------------
>
> Key: LUCENE-1290
> URL: https://issues.apache.org/jira/browse/LUCENE-1290
> Project: Lucene - Java
> Issue Type: Task
> Components: Search
> Reporter: Michael Busch
> Assignee: Michael Busch
> Priority: Minor
> Fix For: 2.4
>
> Attachments: lucene-1290.patch, lucene-1290.patch
>
>
> The Hits class has several drawbacks as pointed out in LUCENE-954.
> The other search APIs that use TopDocCollector and TopDocs should be used
> instead.
> This patch:
> - deprecates org/apache/lucene/search/Hits, Hit, and HitIterator, as well as
> the Searcher.search( * ) methods which return a Hits Object.
> - removes all references to Hits from the core and uses TopDocs and ScoreDoc
> instead
> - Changes the demo SearchFiles: adds the two modes 'paging search' and
> 'streaming search',
> each of which demonstrating a different way of using the search APIs. The
> former
> uses TopDocs and a TopDocCollector, the latter a custom HitCollector
> implementation.
> - Updates the online tutorial that descibes the demo.
> All tests pass.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
