Package com.yahoo.prelude.query

Class SegmentItem

java.lang.Object

com.yahoo.prelude.query.Item

com.yahoo.prelude.query.CompositeItem

com.yahoo.prelude.query.SegmentItem

All Implemented Interfaces:

BlockItem, HasIndexItem, Cloneable

Direct Known Subclasses:

AndSegmentItem, TaggableSegmentItem

public abstract class SegmentItem
extends CompositeItem
implements BlockItem

An immutable and'ing of a collection of sub-expressions. It does not extend AndItem to avoid code using instanceof handling it as an AndItem.

Author:

Steinar Knutsen

Nested Class Summary

Nested classes/interfaces inherited from class com.yahoo.prelude.query.Item

Item.ItemCreator, Item.ItemType

Field Summary

Fields inherited from class com.yahoo.prelude.query.Item

connectedBacklink, connectedItem, connectivity, DEFAULT_WEIGHT, documentFrequency, explicitSignificance, significance, uniqueID

Constructor Summary

Constructors

Constructor	Description
SegmentItem(String rawWord, String current, boolean isFromQuery, boolean stemmed)	Creates a new segment item
SegmentItem(String rawWord, String current, boolean isFromQuery, boolean stemmed, Substring origin)	Creates a new segment item

Method Summary

Modifier and Type	Method	Description
void	addItem(int index, Item item)	Inserts the item at a position and increases the index of existing items starting on this position by one
void	addItem(Item item)
SegmentItem	clone()	Return a deep copy of this object
void	disclose(Discloser discloser)
boolean	equals(Object o)	Returns whether this item is of the same class and contains the same state as the given item.
String	getNormalized()
int	getNumWords()	Returns how many phrase words does this item contain
Substring	getOrigin()	Returns null right now
String	getRawWord()	The untransformed raw text from the user serving as base for this item.
SegmentingRule	getSegmentingRule()	If the block has to be resegmented, what operator should be chosen if it is necessary to change operator?
int	hashCode()
boolean	isFromQuery()	Returns whether this block of text originates from a user and should therefore receive the normal processing applied to raw text (such as stemming).
boolean	isFromUser()
boolean	isLocked()	Whether this composite is in a mutable state.
boolean	isStemmed()
boolean	isWords()	Returns whether this item represents normal text
void	lock()	Make composite immutable if this is supported.
Item	removeItem(int index)	Removes the item at the given index
boolean	removeItem(Item item)	Removes the given item.
void	setFromUser(boolean isFromUser)
void	setSegmentingRule(SegmentingRule segmentingRule)
void	setStemmed(boolean stemmed)
boolean	shouldFoldIntoWand()	whether this item should be folded into a parent WeakAndItem
void	shouldFoldIntoWand(boolean value)	set the flag for folding into a parent WeakAndItem
String	stringValue()	Returns the value of this term as a string

Methods inherited from class com.yahoo.prelude.query.CompositeItem

acceptsItemsOfType, adding, appendBodyString, encode, encodeThis, encodingArity, ensureNotInSubtree, extractSingleChild, getItem, getItemCount, getItemIndex, getItemIterator, getTermCount, items, setIndexName, setItem, shouldParenthesize

Methods inherited from class com.yahoo.prelude.query.Item

addAnnotation, appendHeadingString, getAnnotation, getBytes, getCode, getCreator, getItemType, getLabel, getLanguage, getName, getParent, getWeight, hasAnnotation, hasConnectivityBackLink, hasPrefixMatchSemantics, hasUniqueID, isFilter, isFromSpecialToken, isProtected, isRanked, isRoot, putBytes, putString, setCreator, setFilter, setFromSpecialToken, setHasUniqueID, setLabel, setLanguage, setParent, setPositionData, setProtected, setRanked, setWeight, toString, usePositionData

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.yahoo.prelude.query.HasIndexItem

getIndexName

Constructor Details

SegmentItem

public SegmentItem(String rawWord,
 String current,
 boolean isFromQuery,
 boolean stemmed)

Creates a new segment item

Parameters:

rawWord - the raw form of this segment as received in the request

current - the current transformed version of the raw form, or the raw form repeated if no normalized form is known

isFromQuery - whether this segment stems from the query received in the request

stemmed - whether this is stemmed

SegmentItem

public SegmentItem(String rawWord,
 String current,
 boolean isFromQuery,
 boolean stemmed,
 Substring origin)

Creates a new segment item

Parameters:

rawWord - the raw form of this segment as received in the request

current - the current transformed version of the raw form, or the raw form repeated if no normalized form is known

isFromQuery - whether this segment stems from the query received in the request

stemmed - whether this is stemmed

origin - the original text that led to this

Method Details

getRawWord

public String getRawWord()

Description copied from interface: BlockItem

The untransformed raw text from the user serving as base for this item.

Specified by:

getRawWord in interface BlockItem

getNormalized

public String getNormalized()

stringValue

public String stringValue()

Description copied from interface: BlockItem

Returns the value of this term as a string

Specified by:

stringValue in interface BlockItem

isFromQuery

public boolean isFromQuery()

Description copied from interface: BlockItem

Returns whether this block of text originates from a user and should therefore receive the normal processing applied to raw text (such as stemming).

Specified by:

isFromQuery in interface BlockItem

isStemmed

public boolean isStemmed()

Specified by:

isStemmed in interface BlockItem

setStemmed

public void setStemmed(boolean stemmed)

lock

public void lock()

Description copied from class: CompositeItem

Make composite immutable if this is supported.

Overrides:

lock in class CompositeItem

isLocked

public boolean isLocked()

Description copied from class: CompositeItem

Whether this composite is in a mutable state.

Overrides:

isLocked in class CompositeItem

getNumWords

public int getNumWords()

Description copied from interface: HasIndexItem

Returns how many phrase words does this item contain

Specified by:

getNumWords in interface HasIndexItem

addItem

public void addItem(Item item)

Overrides:

addItem in class CompositeItem

addItem

public void addItem(int index,
 Item item)

Description copied from class: CompositeItem

Inserts the item at a position and increases the index of existing items starting on this position by one

Overrides:

addItem in class CompositeItem

removeItem

public Item removeItem(int index)

Description copied from class: CompositeItem

Removes the item at the given index

Overrides:

removeItem in class CompositeItem

Parameters:

index - the index of the item to remove

Returns:

the removed item

removeItem

public boolean removeItem(Item item)

Description copied from class: CompositeItem

Removes the given item. Does nothing if the item is not present.

Overrides:

removeItem in class CompositeItem

Parameters:

item - the item to remove

Returns:

whether the item was removed

clone

public SegmentItem clone()

Return a deep copy of this object

Overrides:

clone in class CompositeItem

isWords

public boolean isWords()

Description copied from interface: BlockItem

Returns whether this item represents normal text

Specified by:

isWords in interface BlockItem

isFromUser

public boolean isFromUser()

setFromUser

public void setFromUser(boolean isFromUser)

getOrigin

public Substring getOrigin()

Returns null right now

Specified by:

getOrigin in interface BlockItem

disclose

public void disclose(Discloser discloser)

Overrides:

disclose in class CompositeItem

getSegmentingRule

public SegmentingRule getSegmentingRule()

Description copied from interface: BlockItem

If the block has to be resegmented, what operator should be chosen if it is necessary to change operator?

Specified by:

getSegmentingRule in interface BlockItem

setSegmentingRule

public void setSegmentingRule(SegmentingRule segmentingRule)

equals

public boolean equals(Object o)

Description copied from class: CompositeItem

Returns whether this item is of the same class and contains the same state as the given item.

Overrides:

equals in class CompositeItem

hashCode

public int hashCode()

Overrides:

hashCode in class CompositeItem

shouldFoldIntoWand

public boolean shouldFoldIntoWand()

whether this item should be folded into a parent WeakAndItem

shouldFoldIntoWand

public void shouldFoldIntoWand(boolean value)

set the flag for folding into a parent WeakAndItem