com.yahoo.search.query

Class SelectParser

java.lang.Object

com.yahoo.search.query.SelectParser

All Implemented Interfaces:

Parser

public class SelectParser
extends Object
implements Parser

The Select query language. This class will be parsing the Select parameters, and will be used when the query has the SELECT-type.

Author:

henrhoi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	SelectParser.ConnectedItem

Field Summary

Fields

Modifier and Type	Field and Description
private static String	ACCENT_DROP
private static String	ALTERNATIVES
private static String	AND
private static String	AND_NOT
private static String	AND_SEGMENTING
private static String	ANNOTATIONS
private static String	ASCENDING_HITS_ORDER
private static String	CALL
private List<SelectParser.ConnectedItem>	connectedItems
private static String	CONNECTION_ID
private static String	CONNECTION_WEIGHT
private static String	CONNECTIVITY
private static String	CONTAINS
private static Integer	DEFAULT_TARGET_NUM_HITS
private static String	DESCENDING_HITS_ORDER YQL parameters and functions
private static String	DISTANCE
private static String	DOT_PRODUCT
private ParserEnvironment	environment
private static String	EQ
private static String	EQUIV
private static String	FILTER
private static List<String>	FUNCTION_CALLS
private static String	HIT_LIMIT
private Map<Integer,TaggableItem>	identifiedItems
private static String	IMPLICIT_TRANSFORMS
private IndexFacts	indexFacts
private IndexFacts.Session	indexFactsSession
private static String	LABEL
private static String	MATCHES
private static String	NEAR
private static String	NFKC
private static String	NORMALIZE_CASE
private com.yahoo.language.process.Normalizer	normalizer
private static String	ONEAR
private static String	OR
private static String	ORIGIN
private static String	ORIGIN_LENGTH
private static String	ORIGIN_OFFSET
private static String	ORIGIN_ORIGINAL
private static String	PHRASE
private static String	PREDICATE
private static String	PREFIX
(package private) Parsable	query
private static String	RANGE
private static String	RANK
private static String	RANKED
private static String	SAME_ELEMENT
private static String	SCORE_THRESHOLD
private static String	SIGNIFICANCE
private static String	STEM
private static String	SUBSTRING
private static String	SUFFIX
private static String	TARGET_NUM_HITS
private static String	THRESHOLD_BOOST_FACTOR
private static String	UNIQUE_ID
private static String	USE_POSITION_DATA
private static String	USER_INPUT_LANGUAGE
private static String	WAND
private static String	WEAK_AND
private static String	WEIGHT
private static String	WEIGHTED_SET

Constructor Summary

Constructors

Constructor and Description
SelectParser(ParserEnvironment environment)

Method Summary

Modifier and Type	Method and Description
private static void	addItems(HashMap<Integer,com.yahoo.slime.Inspector> children, WeightedSetItem out)
private void	addItemsFromInspector(CompositeItem item, com.yahoo.slime.Inspector inspector)
private static void	addLongItems(HashMap<Integer,com.yahoo.slime.Inspector> children, WeightedSetItem out)
private static void	addStringItems(HashMap<Integer,com.yahoo.slime.Inspector> children, WeightedSetItem out)
private static void	assertHasOperator(String key, String expectedKey)
private CompositeItem	buildAnd(String key, com.yahoo.slime.Inspector value)
private Item	buildDotProduct(String key, com.yahoo.slime.Inspector value)
private Item	buildEquals(String key, com.yahoo.slime.Inspector value)
private Item	buildFunctionCall(String key, com.yahoo.slime.Inspector value)
private IntItem	buildGreaterThan(String field, String bound)
private IntItem	buildGreaterThanOrEquals(String field, String bound)
private IntItem	buildLessThan(String field, String bound)
private IntItem	buildLessThanOrEquals(String field, String bound)
private CompositeItem	buildNotAnd(String key, com.yahoo.slime.Inspector value)
private CompositeItem	buildOr(String key, com.yahoo.slime.Inspector value)
private Item	buildPredicate(String key, com.yahoo.slime.Inspector value)
private Item	buildRange(String key, com.yahoo.slime.Inspector value)
private CompositeItem	buildRank(String key, com.yahoo.slime.Inspector value)
private Item	buildRegExpSearch(String key, com.yahoo.slime.Inspector value)
private Item	buildTermSearch(String key, com.yahoo.slime.Inspector value)
private QueryTree	buildTree()
private Item	buildWand(String key, com.yahoo.slime.Inspector value)
private CompositeItem	buildWeakAnd(String key, com.yahoo.slime.Inspector value)
private Item	buildWeightedSet(String key, com.yahoo.slime.Inspector value)
private void	connectItems()
private com.yahoo.language.Language	decideParsingLanguage(com.yahoo.slime.Inspector value, String wordData)
private WeightedSetItem	fillWeightedSet(com.yahoo.slime.Inspector value, HashMap<Integer,com.yahoo.slime.Inspector> children, WeightedSetItem out)
private <T> T	getAnnotation(String annotationName, HashMap<String,com.yahoo.slime.Inspector> annotations, Class<T> expectedClass, T defaultValue)
private com.yahoo.slime.Inspector	getAnnotationAsInspectorOrNull(String annotationName, HashMap<String,com.yahoo.slime.Inspector> annotations)
private HashMap<String,com.yahoo.slime.Inspector>	getAnnotationMap(com.yahoo.slime.Inspector inspector)
private HashMap<String,com.yahoo.slime.Inspector>	getAnnotationMapFromAnnotationInspector(com.yahoo.slime.Inspector annotation)
private com.yahoo.slime.Inspector	getAnnotations(com.yahoo.slime.Inspector inspector)
private Boolean	getBoolAnnotation(String annotationName, HashMap<String,com.yahoo.slime.Inspector> annotations, Boolean defaultValue)
private Integer	getCappedRangeSearchParameter(com.yahoo.slime.Inspector annotations)
private com.yahoo.slime.Inspector	getChildren(com.yahoo.slime.Inspector inspector)
private HashMap<Integer,com.yahoo.slime.Inspector>	getChildrenMap(com.yahoo.slime.Inspector inspector)
private Double	getDoubleAnnotation(String annotationName, HashMap<String,com.yahoo.slime.Inspector> annotations, Double defaultValue)
List<VespaGroupingStep>	getGroupingSteps(String grouping)
private String	getIndex(String field)
private String	getInspectorKey(com.yahoo.slime.Inspector inspector)
private Integer	getIntegerAnnotation(String annotationName, HashMap<String,com.yahoo.slime.Inspector> annotations, Integer defaultValue)
private List<String>	getOperations(String grouping)
private Substring	getOrigin(com.yahoo.slime.Inspector annotations)
private Item	instantiateCompositeLeaf(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateEquivItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateLeafItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateNearItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateONearItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiatePhraseItem(String field, String key, com.yahoo.slime.Inspector value)
private IntItem	instantiateRangeItem(Number lowerBound, Number upperBound, String field, boolean bounds_left_open, boolean bounds_right_open)
private Item	instantiateSameElementItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateWordAlternativesItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateWordItem(String field, String key, com.yahoo.slime.Inspector value)
private Item	instantiateWordItem(String field, String rawWord, String key, com.yahoo.slime.Inspector value, boolean exactMatch, com.yahoo.language.Language language)
private <T extends TaggableItem> T	leafStyleSettings(com.yahoo.slime.Inspector annotations, T out)
private static IllegalArgumentException	newUnexpectedArgumentException(Object actual, Object... expected)
QueryTree	parse(Parsable query) Parser the given Parsable, and returns a corresponding QueryTree.
private void	prepareWord(String field, com.yahoo.slime.Inspector value, WordItem wordItem)
private List<com.yahoo.slime.Inspector>	valueListFromInspector(com.yahoo.slime.Inspector inspector)
private Item	walkJson(com.yahoo.slime.Inspector inspector)
private void	wordStyleSettings(com.yahoo.slime.Inspector value, WordItem out)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

query

Parsable query

indexFacts

private final IndexFacts indexFacts

identifiedItems

private final Map<Integer,TaggableItem> identifiedItems

connectedItems

private final List<SelectParser.ConnectedItem> connectedItems

normalizer

private final com.yahoo.language.process.Normalizer normalizer

environment

private final ParserEnvironment environment

indexFactsSession

private IndexFacts.Session indexFactsSession

DESCENDING_HITS_ORDER

private static final String DESCENDING_HITS_ORDER

YQL parameters and functions

See Also:

Constant Field Values

ASCENDING_HITS_ORDER

private static final String ASCENDING_HITS_ORDER

See Also:

Constant Field Values

DEFAULT_TARGET_NUM_HITS

private static final Integer DEFAULT_TARGET_NUM_HITS

ORIGIN_LENGTH

private static final String ORIGIN_LENGTH

See Also:

Constant Field Values

ORIGIN_OFFSET

private static final String ORIGIN_OFFSET

See Also:

Constant Field Values

ORIGIN

private static final String ORIGIN

See Also:

Constant Field Values

ORIGIN_ORIGINAL

private static final String ORIGIN_ORIGINAL

See Also:

Constant Field Values

CONNECTION_ID

private static final String CONNECTION_ID

See Also:

Constant Field Values

CONNECTION_WEIGHT

private static final String CONNECTION_WEIGHT

See Also:

Constant Field Values

CONNECTIVITY

private static final String CONNECTIVITY

See Also:

Constant Field Values

ANNOTATIONS

private static final String ANNOTATIONS

See Also:

Constant Field Values

NFKC

private static final String NFKC

See Also:

Constant Field Values

USER_INPUT_LANGUAGE

private static final String USER_INPUT_LANGUAGE

See Also:

Constant Field Values

ACCENT_DROP

private static final String ACCENT_DROP

See Also:

Constant Field Values

ALTERNATIVES

private static final String ALTERNATIVES

See Also:

Constant Field Values

AND_SEGMENTING

private static final String AND_SEGMENTING

See Also:

Constant Field Values

DISTANCE

private static final String DISTANCE

See Also:

Constant Field Values

DOT_PRODUCT

private static final String DOT_PRODUCT

See Also:

Constant Field Values

EQUIV

private static final String EQUIV

See Also:

Constant Field Values

FILTER

private static final String FILTER

See Also:

Constant Field Values

HIT_LIMIT

private static final String HIT_LIMIT

See Also:

Constant Field Values

IMPLICIT_TRANSFORMS

private static final String IMPLICIT_TRANSFORMS

See Also:

Constant Field Values

LABEL

private static final String LABEL

See Also:

Constant Field Values

NEAR

private static final String NEAR

See Also:

Constant Field Values

NORMALIZE_CASE

private static final String NORMALIZE_CASE

See Also:

Constant Field Values

ONEAR

private static final String ONEAR

See Also:

Constant Field Values

PHRASE

private static final String PHRASE

See Also:

Constant Field Values

PREDICATE

private static final String PREDICATE

See Also:

Constant Field Values

PREFIX

private static final String PREFIX

See Also:

Constant Field Values

RANKED

private static final String RANKED

See Also:

Constant Field Values

RANK

private static final String RANK

See Also:

Constant Field Values

SAME_ELEMENT

private static final String SAME_ELEMENT

See Also:

Constant Field Values

SCORE_THRESHOLD

private static final String SCORE_THRESHOLD

See Also:

Constant Field Values

SIGNIFICANCE

private static final String SIGNIFICANCE

See Also:

Constant Field Values

STEM

private static final String STEM

See Also:

Constant Field Values

SUBSTRING

private static final String SUBSTRING

See Also:

Constant Field Values

SUFFIX

private static final String SUFFIX

See Also:

Constant Field Values

TARGET_NUM_HITS

private static final String TARGET_NUM_HITS

See Also:

Constant Field Values

THRESHOLD_BOOST_FACTOR

private static final String THRESHOLD_BOOST_FACTOR

See Also:

Constant Field Values

UNIQUE_ID

private static final String UNIQUE_ID

See Also:

Constant Field Values

USE_POSITION_DATA

private static final String USE_POSITION_DATA

See Also:

Constant Field Values

WAND

private static final String WAND

See Also:

Constant Field Values

WEAK_AND

private static final String WEAK_AND

See Also:

Constant Field Values

WEIGHTED_SET

private static final String WEIGHTED_SET

See Also:

Constant Field Values

WEIGHT

private static final String WEIGHT

See Also:

Constant Field Values

AND

private static final String AND

See Also:

Constant Field Values

AND_NOT

private static final String AND_NOT

See Also:

Constant Field Values

OR

private static final String OR

See Also:

Constant Field Values

EQ

private static final String EQ

See Also:

Constant Field Values

RANGE

private static final String RANGE

See Also:

Constant Field Values

CONTAINS

private static final String CONTAINS

See Also:

Constant Field Values

MATCHES

private static final String MATCHES

See Also:

Constant Field Values

CALL

private static final String CALL

See Also:

Constant Field Values

FUNCTION_CALLS

private static final List<String> FUNCTION_CALLS

Constructor Detail

SelectParser

public SelectParser(ParserEnvironment environment)

Method Detail

parse

public QueryTree parse(Parsable query)

Description copied from interface: Parser

Parser the given Parsable, and returns a corresponding QueryTree. If parsing fails without an exception, the contained root will be an instance of NullItem.

Specified by:

parse in interface Parser

Parameters:

query - the Parsable to parse

Returns:

the parsed QueryTree, never null

buildTree

private QueryTree buildTree()

walkJson

private Item walkJson(com.yahoo.slime.Inspector inspector)

getGroupingSteps

public List<VespaGroupingStep> getGroupingSteps(String grouping)

getOperations

private List<String> getOperations(String grouping)

buildFunctionCall

@NonNull
private Item buildFunctionCall(String key,
                                        com.yahoo.slime.Inspector value)

addItemsFromInspector

private void addItemsFromInspector(CompositeItem item,
                                   com.yahoo.slime.Inspector inspector)

getChildren

private com.yahoo.slime.Inspector getChildren(com.yahoo.slime.Inspector inspector)

getChildrenMap

private HashMap<Integer,com.yahoo.slime.Inspector> getChildrenMap(com.yahoo.slime.Inspector inspector)

getAnnotations

private com.yahoo.slime.Inspector getAnnotations(com.yahoo.slime.Inspector inspector)

getAnnotationMapFromAnnotationInspector

private HashMap<String,com.yahoo.slime.Inspector> getAnnotationMapFromAnnotationInspector(com.yahoo.slime.Inspector annotation)

getAnnotationMap

private HashMap<String,com.yahoo.slime.Inspector> getAnnotationMap(com.yahoo.slime.Inspector inspector)

getAnnotation

private <T> T getAnnotation(String annotationName,
                            HashMap<String,com.yahoo.slime.Inspector> annotations,
                            Class<T> expectedClass,
                            T defaultValue)

getBoolAnnotation

private Boolean getBoolAnnotation(String annotationName,
                                  HashMap<String,com.yahoo.slime.Inspector> annotations,
                                  Boolean defaultValue)

getIntegerAnnotation

private Integer getIntegerAnnotation(String annotationName,
                                     HashMap<String,com.yahoo.slime.Inspector> annotations,
                                     Integer defaultValue)

getDoubleAnnotation

private Double getDoubleAnnotation(String annotationName,
                                   HashMap<String,com.yahoo.slime.Inspector> annotations,
                                   Double defaultValue)

getAnnotationAsInspectorOrNull

private com.yahoo.slime.Inspector getAnnotationAsInspectorOrNull(String annotationName,
                                                                 HashMap<String,com.yahoo.slime.Inspector> annotations)

buildAnd

@NonNull
private CompositeItem buildAnd(String key,
                                        com.yahoo.slime.Inspector value)

buildNotAnd

@NonNull
private CompositeItem buildNotAnd(String key,
                                           com.yahoo.slime.Inspector value)

buildOr

@NonNull
private CompositeItem buildOr(String key,
                                       com.yahoo.slime.Inspector value)

buildWeakAnd

@NonNull
private CompositeItem buildWeakAnd(String key,
                                            com.yahoo.slime.Inspector value)

leafStyleSettings

@NonNull
private <T extends TaggableItem> T leafStyleSettings(com.yahoo.slime.Inspector annotations,
                                                              @NonNull
                                                              T out)

getCappedRangeSearchParameter

private Integer getCappedRangeSearchParameter(com.yahoo.slime.Inspector annotations)

buildRange

@NonNull
private Item buildRange(String key,
                                 com.yahoo.slime.Inspector value)

buildGreaterThanOrEquals

@NonNull
private IntItem buildGreaterThanOrEquals(String field,
                                                  String bound)

buildLessThanOrEquals

@NonNull
private IntItem buildLessThanOrEquals(String field,
                                               String bound)

buildGreaterThan

@NonNull
private IntItem buildGreaterThan(String field,
                                          String bound)

buildLessThan

@NonNull
private IntItem buildLessThan(String field,
                                       String bound)

instantiateRangeItem

@NonNull
private IntItem instantiateRangeItem(Number lowerBound,
                                              Number upperBound,
                                              String field,
                                              boolean bounds_left_open,
                                              boolean bounds_right_open)

buildEquals

@NonNull
private Item buildEquals(String key,
                                  com.yahoo.slime.Inspector value)

buildWand

@NonNull
private Item buildWand(String key,
                                com.yahoo.slime.Inspector value)

fillWeightedSet

@NonNull
private WeightedSetItem fillWeightedSet(com.yahoo.slime.Inspector value,
                                                 HashMap<Integer,com.yahoo.slime.Inspector> children,
                                                 @NonNull
                                                 WeightedSetItem out)

addItems

private static void addItems(HashMap<Integer,com.yahoo.slime.Inspector> children,
                             WeightedSetItem out)

addStringItems

private static void addStringItems(HashMap<Integer,com.yahoo.slime.Inspector> children,
                                   WeightedSetItem out)

addLongItems

private static void addLongItems(HashMap<Integer,com.yahoo.slime.Inspector> children,
                                 WeightedSetItem out)

buildRegExpSearch

@NonNull
private Item buildRegExpSearch(String key,
                                        com.yahoo.slime.Inspector value)

buildWeightedSet

@NonNull
private Item buildWeightedSet(String key,
                                       com.yahoo.slime.Inspector value)

buildDotProduct

@NonNull
private Item buildDotProduct(String key,
                                      com.yahoo.slime.Inspector value)

buildPredicate

@NonNull
private Item buildPredicate(String key,
                                     com.yahoo.slime.Inspector value)

buildRank

@NonNull
private CompositeItem buildRank(String key,
                                         com.yahoo.slime.Inspector value)

buildTermSearch

@NonNull
private Item buildTermSearch(String key,
                                      com.yahoo.slime.Inspector value)

getInspectorKey

private String getInspectorKey(com.yahoo.slime.Inspector inspector)

instantiateLeafItem

@NonNull
private Item instantiateLeafItem(String field,
                                          String key,
                                          com.yahoo.slime.Inspector value)

instantiateCompositeLeaf

@NonNull
private Item instantiateCompositeLeaf(String field,
                                               String key,
                                               com.yahoo.slime.Inspector value)

instantiateWordItem

@NonNull
private Item instantiateWordItem(String field,
                                          String key,
                                          com.yahoo.slime.Inspector value)

instantiateWordItem

@NonNull
private Item instantiateWordItem(String field,
                                          String rawWord,
                                          String key,
                                          com.yahoo.slime.Inspector value,
                                          boolean exactMatch,
                                          com.yahoo.language.Language language)

decideParsingLanguage

private com.yahoo.language.Language decideParsingLanguage(com.yahoo.slime.Inspector value,
                                                          String wordData)

prepareWord

private void prepareWord(String field,
                         com.yahoo.slime.Inspector value,
                         WordItem wordItem)

wordStyleSettings

private void wordStyleSettings(com.yahoo.slime.Inspector value,
                               WordItem out)

getOrigin

private Substring getOrigin(com.yahoo.slime.Inspector annotations)

instantiateSameElementItem

@NonNull
private Item instantiateSameElementItem(String field,
                                                 String key,
                                                 com.yahoo.slime.Inspector value)

instantiatePhraseItem

@NonNull
private Item instantiatePhraseItem(String field,
                                            String key,
                                            com.yahoo.slime.Inspector value)

instantiateNearItem

@NonNull
private Item instantiateNearItem(String field,
                                          String key,
                                          com.yahoo.slime.Inspector value)

instantiateONearItem

@NonNull
private Item instantiateONearItem(String field,
                                           String key,
                                           com.yahoo.slime.Inspector value)

instantiateEquivItem

@NonNull
private Item instantiateEquivItem(String field,
                                           String key,
                                           com.yahoo.slime.Inspector value)

instantiateWordAlternativesItem

private Item instantiateWordAlternativesItem(String field,
                                             String key,
                                             com.yahoo.slime.Inspector value)

getIndex

@NonNull
private String getIndex(String field)

assertHasOperator

private static void assertHasOperator(String key,
                                      String expectedKey)

newUnexpectedArgumentException

private static IllegalArgumentException newUnexpectedArgumentException(Object actual,
                                                                       Object... expected)

valueListFromInspector

private List<com.yahoo.slime.Inspector> valueListFromInspector(com.yahoo.slime.Inspector inspector)

connectItems

private void connectItems()