com.atlassian.confluence.search.v2
Interface SearchResult

All Superinterfaces:

BaseSearchResult

All Known Implementing Classes:

AbstractLuceneSearchResult, LuceneSearchResult

public interface SearchResult
extends BaseSearchResult

An individual search result. The SearchResult provides access to a number of attributes that are populated directly from the index without requiring an additional database hit. There should be enough information directly in the result to give a pretty detailed description of the hit. It is heavier than it's parent @see BaseSearchResult which should be used in preference when the lucene fields required to be accessed can be known by the developer in advance of the lucene query being executed.

Method Summary

java.lang.String	getContent() Gets the text content of the search result.
java.lang.Integer	getContentVersion() Returns the version of the content if available, or null if there's no version for this result.
java.util.Date	getCreationDate()
java.lang.String	getCreator() Deprecated. since 5.2. Use getCreatorUser() instead
ConfluenceUser	getCreatorUser() Gets the person who created the entity represented by the search result.
java.lang.String	getDisplayTitle() Gets the title of the search result appropriate for displaying to a user.
java.util.Map<java.lang.String,java.lang.String>	getExtraFields() If the retrieved documents contain additional fields that cannot be directly accessed by this interface then they can be retrieved via this method.
java.util.Set<java.lang.String>	getLabels(com.atlassian.user.User user) Gets the labels on the current search result that are visible to the specified user.
java.util.Date	getLastModificationDate() Gets the last modification date of the entity represented by the search result.
java.lang.String	getLastModifier() Deprecated. since 5.2. Use getLastModifierUser() instead
ConfluenceUser	getLastModifierUser() Gets the last person to modify the entity represented by the search result.
java.lang.String	getLastUpdateDescription() Gets some string describing the last modification to this content.
java.lang.String	getOwnerTitle() If this result represents an attachment then this field will return the title of the page or blog post the attachment is attached to.
java.lang.String	getOwnerType() If this result represents an attachment then this field will return the type of the container, a page or blogpost.
java.util.Set<java.lang.String>	getPersonalLabels() Gets all the personal labels on the current search result.
java.lang.String	getSpaceKey()
java.lang.String	getSpaceName()
java.lang.String	getType() Gets a string representation of the type of the entity represented by the search result.
java.lang.String	getUrlPath() Gets the URL path to the search result, relative to the site's context root.
boolean	hasLabels()
boolean	isHomePage() Checks if the search result represents the homepage of a space.

Methods inherited from interface com.atlassian.confluence.search.v2.BaseSearchResult

getField, getHandle, isFieldRequested

Method Detail

getExtraFields

java.util.Map<java.lang.String,java.lang.String> getExtraFields()

If the retrieved documents contain additional fields that cannot be directly accessed by this interface then they can be retrieved via this method.

The field names are abstracted from the underlying search implementation and will be centrally defined. Their values are not yet documented.

Returns:

Map of additional field names and their values.

getContent

java.lang.String getContent()

Gets the text content of the search result.

Returns:

the text content of the search result

getType

java.lang.String getType()

Gets a string representation of the type of the entity represented by the search result. If the entity is a content object, this is the value of ContentEntityObject.getType()

Returns:

the type of the entity represented as a string, or null if no such type can be determined

See Also:

ContentTypeAware.getType()

isHomePage

boolean isHomePage()

Checks if the search result represents the homepage of a space.

Returns:

true if the result represents the homepage of a space

getLastModificationDate

java.util.Date getLastModificationDate()

Gets the last modification date of the entity represented by the search result.

Returns:

the last modification date of the entity

getLastModifier

@Deprecated
java.lang.String getLastModifier()

Deprecated. since 5.2. Use getLastModifierUser() instead

getLastModifierUser

ConfluenceUser getLastModifierUser()

Gets the last person to modify the entity represented by the search result.

Returns:

the result's last modifier

Since:

5.2

getDisplayTitle

java.lang.String getDisplayTitle()

Gets the title of the search result appropriate for displaying to a user. All results should return something useful for this method.

Returns:

the title of the search result appropriate for display on a page

See Also:

Addressable.getDisplayTitle()

getUrlPath

java.lang.String getUrlPath()

Gets the URL path to the search result, relative to the site's context root. All results should return something useful for this method

Returns:

the URL path to the search result

See Also:

Addressable.getUrlPath()

getLastUpdateDescription

java.lang.String getLastUpdateDescription()

Gets some string describing the last modification to this content. May be null if no such string is available. For content objects, this will be the same as the "version comment"

This string is user-supplied, and therefore not internationalised

Returns:

a string describing the last modification to the content

See Also:

ContentEntityObject.getVersionComment()

getSpaceName

java.lang.String getSpaceName()

Returns:

the name of the space that contains this search result.

getSpaceKey

java.lang.String getSpaceKey()

Returns:

the key of the space that contains this search result

hasLabels

boolean hasLabels()

Returns:

true if this search result has labels, false otherwise.

getLabels

java.util.Set<java.lang.String> getLabels(com.atlassian.user.User user)

Gets the labels on the current search result that are visible to the specified user.

Parameters:

user - filter labels by this user

Returns:

the labels on the current search result that are visible to the specified user.

getPersonalLabels

java.util.Set<java.lang.String> getPersonalLabels()

Gets all the personal labels on the current search result.

Returns:

all the personal labels on the current search result

getCreationDate

java.util.Date getCreationDate()

getCreator

@Deprecated
java.lang.String getCreator()

Deprecated. since 5.2. Use getCreatorUser() instead

getCreatorUser

ConfluenceUser getCreatorUser()

Gets the person who created the entity represented by the search result.

Returns:

the result's creator

Since:

5.2

getOwnerType

java.lang.String getOwnerType()

If this result represents an attachment then this field will return the type of the container, a page or blogpost.

Returns:

the owner type

getOwnerTitle

java.lang.String getOwnerTitle()

If this result represents an attachment then this field will return the title of the page or blog post the attachment is attached to.

Returns:

the owner title

getContentVersion

java.lang.Integer getContentVersion()
                                    throws java.lang.NumberFormatException

Returns the version of the content if available, or null if there's no version for this result.

Throws:

java.lang.NumberFormatException - if the document in the index has an unparseable version number