Package org.apache.solr.schema

Class EnumFieldType

java.lang.Object

org.apache.solr.schema.FieldProperties

org.apache.solr.schema.FieldType

org.apache.solr.schema.PrimitiveFieldType

org.apache.solr.schema.EnumFieldType

public class EnumFieldType
extends PrimitiveFieldType

Field type supporting string values with custom sort order.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	EnumFieldType.EnumMapping	Models all the info contained in an enums config XML file

Nested classes/interfaces inherited from class org.apache.solr.schema.FieldType

FieldType.DefaultAnalyzer, FieldType.MultiValueSelector

Field Summary

Fields

Modifier and Type	Field	Description
protected EnumFieldType.EnumMapping	enumMapping

Fields inherited from class org.apache.solr.schema.FieldType

ANALYZER, args, AUTO_GENERATE_PHRASE_QUERIES, CHAR_FILTER, CHAR_FILTERS, CLASS_NAME, docValuesFormat, ENABLE_GRAPH_QUERIES, falseProperties, FILTER, FILTERS, INDEX, INDEX_ANALYZER, MULTI_TERM, MULTI_TERM_ANALYZER, POLY_FIELD_SEPARATOR, postingsFormat, properties, QUERY, QUERY_ANALYZER, similarity, SIMILARITY, similarityFactory, SYNONYM_QUERY_STYLE, TOKENIZER, trueProperties, TYPE, TYPE_NAME, typeName

Fields inherited from class org.apache.solr.schema.FieldProperties

BINARY, DOC_VALUES, INDEXED, LARGE_FIELD, MULTIVALUED, OMIT_NORMS, OMIT_POSITIONS, OMIT_TF_POSITIONS, REQUIRED, SORT_MISSING_FIRST, SORT_MISSING_LAST, STORE_OFFSETS, STORE_TERMOFFSETS, STORE_TERMPAYLOADS, STORE_TERMPOSITIONS, STORE_TERMVECTORS, STORED, TOKENIZED, UNINVERTIBLE, USE_DOCVALUES_AS_STORED

Constructor Summary

Constructors

Constructor	Description
EnumFieldType()

Method Summary

Modifier and Type	Method	Description
org.apache.lucene.index.IndexableField	createField(SchemaField field, Object value)	Used for adding a document when a field needs to be created from a type and a string.
List<org.apache.lucene.index.IndexableField>	createFields(SchemaField sf, Object value)	Given a SchemaField, create one or more IndexableField instances
EnumFieldType.EnumMapping	getEnumMapping()
NumberType	getNumberType()	Return the numeric type of this field, or null if this field is not a numeric field.
final org.apache.lucene.queries.function.ValueSource	getSingleValueSource(FieldType.MultiValueSelector choice, SchemaField field, QParser parser)	Method for dynamically building a ValueSource based on a single value of a multivalued field.
org.apache.lucene.search.SortField	getSortField(SchemaField field, boolean top)	Returns the SortField instance that should be used to sort fields of this type.
protected org.apache.lucene.search.Query	getSpecializedRangeQuery(QParser parser, SchemaField field, String min, String max, boolean minInclusive, boolean maxInclusive)	Returns a Query instance for doing range searches on this field type.
UninvertingReader.Type	getUninversionType(SchemaField sf)	If DocValues is not enabled for a field, but it's indexed, docvalues can be constructed on the fly (uninverted, aka fieldcache) on the first request to sort, facet, etc.
org.apache.lucene.queries.function.ValueSource	getValueSource(SchemaField field, QParser qparser)	called to get the default value source (normally, from the Lucene FieldCache.)
String	indexedToReadable(String indexedForm)	Given an indexed term, return the human readable representation
org.apache.lucene.util.CharsRef	indexedToReadable(org.apache.lucene.util.BytesRef input, org.apache.lucene.util.CharsRefBuilder output)	Given an indexed term, append the human readable representation
protected void	init(IndexSchema schema, Map<String,String> args)	subclasses should initialize themselves with the args provided and remove valid arguments.
boolean	isTokenized()	Returns true if fields of this type should be tokenized
void	readableToIndexed(CharSequence val, org.apache.lucene.util.BytesRefBuilder result)	Given the readable value, return the term value that will match it.
String	readableToIndexed(String val)	Given the readable value, return the term value that will match it.
String	storedToIndexed(org.apache.lucene.index.IndexableField f)	Given the stored field, return the indexed form
String	toExternal(org.apache.lucene.index.IndexableField f)	Convert the stored-field format to an external (string, human readable) value
String	toInternal(String val)	Convert an external value (from XML update command or from query string) into the internal format for both storing and indexing (which can be modified by any analyzers).
Object	toNativeType(Object val)	Converts any Object to a java Object native to this field type
org.apache.solr.common.EnumFieldValue	toObject(org.apache.lucene.index.IndexableField f)	Convert the stored-field format to an external object.
org.apache.solr.common.EnumFieldValue	toObject(SchemaField sf, org.apache.lucene.util.BytesRef term)
void	write(TextResponseWriter writer, String name, org.apache.lucene.index.IndexableField f)	calls back to TextResponseWriter to write the field value

Methods inherited from class org.apache.solr.schema.PrimitiveFieldType

checkSupportsDocValues, enableDocValuesByDefault, getDefaultMultiValueSelectorForSort

Methods inherited from class org.apache.solr.schema.FieldType

checkSchemaField, createField, getAnalyzerProperties, getClassArg, getDocValuesFormat, getExistenceQuery, getFieldQuery, getFieldTermQuery, getIndexAnalyzer, getNamedPropertyValues, getNonFieldPropertyArgs, getNumericSort, getPostingsFormat, getPrefixQuery, getQueryAnalyzer, getRangeQuery, getRewriteMethod, getSetQuery, getSimilarity, getSimilarityFactory, getSortedNumericSortField, getSortedSetSortField, getSortField, getSpecializedExistenceQuery, getStringSort, getTypeName, hasProperty, isExplicitAnalyzer, isExplicitQueryAnalyzer, isMultiValued, isPointField, isPolyField, isUtf8Field, marshalBase64SortValue, marshalSortValue, marshalStringSortValue, multiValuedFieldCache, restrictProps, setArgs, setIndexAnalyzer, setIsExplicitAnalyzer, setIsExplicitQueryAnalyzer, setQueryAnalyzer, setSimilarity, storedToReadable, supportsAnalyzers, toString, treatUnboundedRangeAsExistence, unmarshalBase64SortValue, unmarshalSortValue, unmarshalStringSortValue, useDocValuesAsStored, write

Methods inherited from class java.lang.Object

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

Field Details

enumMapping

protected EnumFieldType.EnumMapping enumMapping

Constructor Details

EnumFieldType

public EnumFieldType()

Method Details

init

protected void init(IndexSchema schema,
 Map<String,String> args)

Description copied from class: FieldType

subclasses should initialize themselves with the args provided and remove valid arguments. leftover arguments will cause an exception. Common boolean properties have already been handled.

Overrides:

init in class PrimitiveFieldType

getEnumMapping

public EnumFieldType.EnumMapping getEnumMapping()

getUninversionType

public UninvertingReader.Type getUninversionType(SchemaField sf)

Description copied from class: FieldType

If DocValues is not enabled for a field, but it's indexed, docvalues can be constructed on the fly (uninverted, aka fieldcache) on the first request to sort, facet, etc. This specifies the structure to use.

This method will not be used if the field is (effectively) uninvertible="false"

Specified by:

getUninversionType in class FieldType

Parameters:

sf - field instance

Returns:

type to uninvert, or null (to disallow uninversion for the field)

See Also:

• SchemaField.isUninvertible()

getSpecializedRangeQuery

protected org.apache.lucene.search.Query getSpecializedRangeQuery(QParser parser,
 SchemaField field,
 String min,
 String max,
 boolean minInclusive,
 boolean maxInclusive)

Description copied from class: FieldType

Returns a Query instance for doing range searches on this field type. SolrQueryParser currently passes part1 and part2 as null if they are '*' respectively. minInclusive and maxInclusive are both true currently by SolrQueryParser but that may change in the future. Also, other QueryParser implementations may have different semantics.

Sub-classes should override this method to provide their own range query implementation. They should strive to handle nulls in part1 and/or part2 as well as unequal minInclusive and maxInclusive parameters gracefully.

This method does not, and should not, check for or handle existence queries, please look at FieldType.getRangeQuery(org.apache.solr.search.QParser, org.apache.solr.schema.SchemaField, java.lang.String, java.lang.String, boolean, boolean) for that logic.

Overrides:

getSpecializedRangeQuery in class FieldType

Parameters:

parser - the QParser calling the method

field - the schema field

min - the lower boundary of the range, nulls are allowed.

max - the upper boundary of the range, nulls are allowed

minInclusive - whether the minimum of the range is inclusive or not

maxInclusive - whether the maximum of the range is inclusive or not

Returns:

a Query instance to perform range search according to given parameters

readableToIndexed

public void readableToIndexed(CharSequence val,
 org.apache.lucene.util.BytesRefBuilder result)

Description copied from class: FieldType

Given the readable value, return the term value that will match it. This method will modify the size and length of the result parameter and write from offset 0

Overrides:

readableToIndexed in class FieldType

indexedToReadable

public String indexedToReadable(String indexedForm)

Description copied from class: FieldType

Given an indexed term, return the human readable representation

Overrides:

indexedToReadable in class FieldType

indexedToReadable

public org.apache.lucene.util.CharsRef indexedToReadable(org.apache.lucene.util.BytesRef input,
 org.apache.lucene.util.CharsRefBuilder output)

Description copied from class: FieldType

Given an indexed term, append the human readable representation

Overrides:

indexedToReadable in class FieldType

toObject

public org.apache.solr.common.EnumFieldValue toObject(SchemaField sf,
 org.apache.lucene.util.BytesRef term)

Overrides:

toObject in class FieldType

toObject

public org.apache.solr.common.EnumFieldValue toObject(org.apache.lucene.index.IndexableField f)

Description copied from class: FieldType

Convert the stored-field format to an external object.

Overrides:

toObject in class FieldType

See Also:

• FieldType.toInternal(java.lang.String)

storedToIndexed

public String storedToIndexed(org.apache.lucene.index.IndexableField f)

Description copied from class: FieldType

Given the stored field, return the indexed form

Overrides:

storedToIndexed in class FieldType

createField

public org.apache.lucene.index.IndexableField createField(SchemaField field,
 Object value)

Description copied from class: FieldType

Used for adding a document when a field needs to be created from a type and a string.

By default, the indexed value is the same as the stored value (taken from toInternal()). Having a different representation for external, internal, and indexed would present quite a few problems given the current Lucene architecture. An analyzer for adding docs would need to translate internal->indexed while an analyzer for querying would need to translate external->indexed.

The only other alternative to having internal==indexed would be to have internal==external. In this case, toInternal should convert to the indexed representation, toExternal() should do nothing, and createField() should *not* call toInternal, but use the external value and set tokenized=true to get Lucene to convert to the internal(indexed) form. :TODO: clean up and clarify this explanation.

Overrides:

createField in class FieldType

See Also:

• FieldType.toInternal(java.lang.String)

createFields

public List<org.apache.lucene.index.IndexableField> createFields(SchemaField sf,
 Object value)

Description copied from class: FieldType

Given a SchemaField, create one or more IndexableField instances

Overrides:

createFields in class FieldType

Parameters:

sf - the SchemaField

value - The value to add to the field

Returns:

An array of IndexableField

See Also:

• FieldType.createField(SchemaField, Object)
• FieldType.isPolyField()

getSingleValueSource

public final org.apache.lucene.queries.function.ValueSource getSingleValueSource(FieldType.MultiValueSelector choice,
 SchemaField field,
 QParser parser)

Description copied from class: FieldType

Method for dynamically building a ValueSource based on a single value of a multivalued field.

The default implementation throws an error except in the trivial case where this method is used on a SchemaField that is in fact not-multivalued, in which case it delegates to FieldType.getValueSource(org.apache.solr.schema.SchemaField, org.apache.solr.search.QParser)

Overrides:

getSingleValueSource in class FieldType

See Also:

• FieldType.MultiValueSelector

getSortField

public org.apache.lucene.search.SortField getSortField(SchemaField field,
 boolean top)

Description copied from class: FieldType

Returns the SortField instance that should be used to sort fields of this type.

Specified by:

getSortField in class FieldType

See Also:

• SchemaField.checkSortability()
• FieldType.getStringSort(org.apache.solr.schema.SchemaField, boolean)
• FieldType.getNumericSort(org.apache.solr.schema.SchemaField, org.apache.solr.schema.NumberType, boolean)

getValueSource

public org.apache.lucene.queries.function.ValueSource getValueSource(SchemaField field,
 QParser qparser)

Description copied from class: FieldType

called to get the default value source (normally, from the Lucene FieldCache.)

Overrides:

getValueSource in class FieldType

write

public void write(TextResponseWriter writer,
 String name,
 org.apache.lucene.index.IndexableField f)
           throws IOException

Description copied from class: FieldType

calls back to TextResponseWriter to write the field value

Sub-classes should prefer using FieldType.toExternal(IndexableField) or FieldType.toObject(IndexableField) to get the writeable external value of f instead of directly using f.stringValue() or f.binaryValue()

Specified by:

write in class FieldType

Throws:

IOException

isTokenized

public boolean isTokenized()

Description copied from class: FieldType

Returns true if fields of this type should be tokenized

Overrides:

isTokenized in class FieldType

getNumberType

public NumberType getNumberType()

Description copied from class: FieldType

Return the numeric type of this field, or null if this field is not a numeric field.

Overrides:

getNumberType in class FieldType

readableToIndexed

public String readableToIndexed(String val)

Description copied from class: FieldType

Given the readable value, return the term value that will match it.

Overrides:

readableToIndexed in class FieldType

toInternal

public String toInternal(String val)

Description copied from class: FieldType

Convert an external value (from XML update command or from query string) into the internal format for both storing and indexing (which can be modified by any analyzers).

Overrides:

toInternal in class FieldType

See Also:

• FieldType.toExternal(org.apache.lucene.index.IndexableField)

toExternal

public String toExternal(org.apache.lucene.index.IndexableField f)

Description copied from class: FieldType

Convert the stored-field format to an external (string, human readable) value

Overrides:

toExternal in class FieldType

See Also:

• FieldType.toInternal(java.lang.String)

toNativeType

public Object toNativeType(Object val)

Description copied from class: FieldType

Converts any Object to a java Object native to this field type

Overrides:

toNativeType in class FieldType