From 06e1cc92d3b7748fe7dd6eb99b59a565962fafaf Mon Sep 17 00:00:00 2001
From: Kelvin Tan <kelvint@apache.org>
Date: Sat, 11 May 2002 00:47:25 +0000
Subject: [PATCH] An object to encapsulate the results of a search.

git-svn-id: https://svn.apache.org/repos/asf/lucene/java/trunk@150769 13f79535-47bb-0310-9956-ffa450edef68
---
 .../contributions/fulcrum/SearchResults.java  | 83 +++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 sandbox/contributions/fulcrum/SearchResults.java

diff --git a/sandbox/contributions/fulcrum/SearchResults.java b/sandbox/contributions/fulcrum/SearchResults.java
new file mode 100644
index 00000000000..3191466b2b7
--- /dev/null
+++ b/sandbox/contributions/fulcrum/SearchResults.java
@@ -0,0 +1,83 @@
+import org.apache.log4j.Category;
+import org.apache.lucene.document.Document;
+import org.apache.lucene.search.Hits;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+
+import search.SearchResultFactory;
+
+/**
+ * <p>
+ * Encapsulates the results of a search. After a SearchResults has
+ * been constructed from a Hits object, the IndexSearcher can be
+ * safely closed.
+ * </p>
+ * <p>
+ * SearchResults also provides a way of retrieving Java objects from
+ * Documents (via {@link search.SearchResultsFactory}).
+ * </p>
+ * <p>
+ * <b>Note that this implementation uses code from
+ * /projects/appex/search.</b>
+ * </p>
+ */
+public class SearchResults
+{
+    private static Category cat = Category.getInstance(SearchResults.class);
+    private List hitsDocuments;
+    private List objectResults;
+    private int totalNumberOfResults;
+
+    public SearchResults(Hits hits) throws IOException
+    {
+        this(hits, 0, hits.length());
+    }
+
+    public SearchResults(Hits hits, int from, int to) throws IOException
+    {
+        hitsDocuments = new ArrayList();
+        totalNumberOfResults = hits.length();
+        if (to > totalNumberOfResults)
+        {
+            to = totalNumberOfResults;
+        }
+        for (int i = from; i < to; i++)
+        {
+            hitsDocuments.add(hits.doc(i));
+        }
+    }
+
+    public int getTotalNumberOfResults()
+    {
+        return totalNumberOfResults;
+    }
+
+    /**
+     * Obtain the results of the search as objects.
+     */
+    public List getResultsAsObjects()
+    {
+        if (objectResults == null)
+        {
+            objectResults = new ArrayList();
+            for (Iterator it = hitsDocuments.iterator(); it.hasNext();)
+            {
+                try
+                {
+                    Object o = SearchResultFactory.
+                            getDocAsObject((Document) it.next());
+                    if (!objectResults.contains(o))
+                        objectResults.add(o);
+                }
+                catch (Exception e)
+                {
+                    cat.error("Error instantiating an object from a document.", e);
+                }
+            }
+        }
+        return objectResults;
+    }
+}