Package org.eclipse.help.search
Interface ISearchDocument
-
public interface ISearchDocument
Represents a document in the search index. This interface is used by clients which implement the search participant extension point. While the help system uses the Lucene classes internally this interface does not import anything from Lucene and enables the API for adding search participants to remain binary compatible whatever changes are made in Lucene.- Since:
- 3.5
- Restriction:
- This interface is not intended to be implemented by clients.
- Restriction:
- This interface is not intended to be extended by clients.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
addContents(Reader contents, Reader exactContents)
Alternate way of adding contents which is closer to the API for the deprecated extension point org.eclipse.help.base.luceneSearchParticipants.void
addContents(String contents)
void
setHasFilters(boolean hasFilters)
Allows search participant to indicate that a document will be processed at runtime and that parts of the contents may not be displayed to the user, causing a match in the search to be shown as a potential match.void
setSummary(String summary)
void
setTitle(String title)
-
-
-
Method Detail
-
setTitle
void setTitle(String title)
- Parameters:
title
- the title which will be shown in the search results summary. This function should be called exactly once per document
-
setSummary
void setSummary(String summary)
- Parameters:
summary
- the summary which will be used when displaying search results. This function should be called exactly once per document
-
addContents
void addContents(String contents)
- Parameters:
contents
- the text which will be used when performing a search. The search index will parse the contents and store the results in a database for rapid retrieval.
-
addContents
void addContents(Reader contents, Reader exactContents)
Alternate way of adding contents which is closer to the API for the deprecated extension point org.eclipse.help.base.luceneSearchParticipants. This is provided for backward compatibility, most users will find it simpler to useaddContents(String)
- Parameters:
contents
- a Reader object which provides the contentsexactContents
- a second Reader object which contains the same same contents
-
setHasFilters
void setHasFilters(boolean hasFilters)
Allows search participant to indicate that a document will be processed at runtime and that parts of the contents may not be displayed to the user, causing a match in the search to be shown as a potential match. By default documents are considered to be unfiltered so this function need only be called to indicate that a document is filtered
-
-