Package org.elasticsearch.index.mapper

Class FieldMapper.Parameter<T>

org.elasticsearch.index.mapper.FieldMapper.Parameter<T>
Type Parameters:
T - the type of the value the parameter holds
All Implemented Interfaces:
<T>
Enclosing class:
FieldMapper
public static final class FieldMapper.Parameter<T> extends implements <T>
A configurable parameter for a field mapper

  • Field Details

    • name

      public final  name

  • Constructor Details

    • Parameter

      public Parameter​( name, boolean updateable, <T> defaultValue, ,​,​T> parser, <FieldMapper,​T> initializer)
      Creates a new Parameter
      Parameters:
      name - the parameter name, used in parsing and serialization
      updateable - whether the parameter can be updated with a new value during a mapping update
      defaultValue - the default value for the parameter, used if unspecified in mappings
      parser - a function that converts an object to a parameter value
      initializer - a function that reads a parameter value from an existing mapper

  • Method Details

    • getValue

      public T getValue()
      Returns the current value of the parameter

    • get

      public T get()
      Specified by:
       in interface <T>

    • getDefaultValue

      public T getDefaultValue()
      Returns the default value of the parameter

    • setValue

      public void setValue​(T value)
      Sets the current value of the parameter

    • isConfigured

      public boolean isConfigured()

    • acceptsNull

      public FieldMapper.Parameter<T> acceptsNull()
      Allows the parameter to accept a null value

    • canAcceptNull

      public boolean canAcceptNull()

    • addDeprecatedName

      public  deprecatedName)
      Adds a deprecated parameter name. If this parameter name is encountered during parsing, a deprecation warning will be emitted. The parameter will be serialized with its main name.

    • deprecated

      public FieldMapper.Parameter<T> deprecated()
      Deprecates the entire parameter. If this parameter is encountered during parsing, a deprecation warning will be emitted.

    • setValidator

      public <T> validator)
      Adds validation to a parameter, called after parsing and merging

    • setSerializer

      public FieldMapper.Parameter<T> setSerializer​(FieldMapper.Serializer<T> serializer, <> conflictSerializer)
      Configure a custom serializer for this parameter

    • setSerializerCheck

      public FieldMapper.Parameter<T> setSerializerCheck​(FieldMapper.SerializerCheck<T> check)
      Configure a custom serialization check for this parameter

    • alwaysSerialize

      public FieldMapper.Parameter<T> alwaysSerialize()
      Always serialize this parameter, no matter its value

    • neverSerialize

      public FieldMapper.Parameter<T> neverSerialize()
      Never serialize this parameter, no matter its value

    • setMergeValidator

      public FieldMapper.Parameter<T> setMergeValidator​(FieldMapper.MergeValidator<T> mergeValidator)
      Sets a custom merge validator. By default, merges are accepted if the parameter is updateable, or if the previous and new values are equal

    • requiresParameters

      public FieldMapper.Parameter<T> requiresParameters​(FieldMapper.Parameter<?>... ps)

    • precludesParameters

      public FieldMapper.Parameter<T> precludesParameters​(FieldMapper.Parameter<?>... ps)

    • parse

      public void parse​( field, MappingParserContext context,  in)
      Parse the field value from an Object
      Parameters:
      field - the field name
      context - the parser context
      in - the object

    • toXContent

      protected void toXContent​(org.elasticsearch.common.xcontent.XContentBuilder builder, boolean includeDefaults) throws
      Throws:

    • boolParam

      public static > boolParam​( name, boolean updateable, <> initializer, boolean defaultValue)
      Defines a parameter that takes the values true or false
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultValue - the default value, to be used if the parameter is undefined in a mapping

    • explicitBoolParam

      public static >> explicitBoolParam​( name, boolean updateable, <>> initializer, boolean defaultValue)
      Defines a parameter that takes the values true or false, and will always serialize its value if configured.
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultValue - the default value, to be used if the parameter is undefined in a mapping

    • doubleParam

      public static > doubleParam​( name, boolean updateable, <> initializer, double defaultValue)
      Defines a parameter that takes a double value
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultValue - the default value, to be used if the parameter is undefined in a mapping

    • floatParam

      public static > floatParam​( name, boolean updateable, <> initializer, float defaultValue)
      Defines a parameter that takes a float value
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultValue - the default value, to be used if the parameter is undefined in a mapping

    • intParam

      public static > intParam​( name, boolean updateable, <> initializer, int defaultValue)
      Defines a parameter that takes an integer value
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultValue - the default value, to be used if the parameter is undefined in a mapping

    • stringParam

      public static > stringParam​( name, boolean updateable, <> initializer,  defaultValue)
      Defines a parameter that takes a string value
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultValue - the default value, to be used if the parameter is undefined in a mapping

    • stringArrayParam

      public static <>> stringArrayParam​( name, boolean updateable, <<>> initializer, <> defaultValue)

    • restrictedStringParam

      public static > restrictedStringParam​( name, boolean updateable, <> initializer, ... values)
      Defines a parameter that takes one of a restricted set of string values
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      values - the set of values that the parameter can take. The first value in the list is the default value, to be used if the parameter is undefined in a mapping

    • analyzerParam

      public static  name, boolean updateable, <FieldMapper,​NamedAnalyzer> initializer, <NamedAnalyzer> defaultAnalyzer)
      Defines a parameter that takes an analyzer name
      Parameters:
      name - the parameter name
      updateable - whether the parameter can be changed by a mapping update
      initializer - a function that reads the parameter value from an existing mapper
      defaultAnalyzer - the default value, to be used if the parameter is undefined in a mapping

    • metaParam

      public static <,​>> metaParam()
      Declares a metadata parameter

    • boostParam

      public static > boostParam()

    • indexParam

      public static > indexParam​(<> initializer, boolean defaultValue)

    • storeParam

      public static > storeParam​(<> initializer, boolean defaultValue)

    • docValuesParam

      public static > docValuesParam​(<> initializer, boolean defaultValue)

    • scriptParam

      public static <FieldMapper,​Script> initializer)
      Defines a script parameter
      Parameters:
      initializer - retrieves the equivalent parameter from an existing FieldMapper for use in merges
      Returns:
      a script parameter

    • onScriptErrorParam

      public static > onScriptErrorParam​(<> initializer, FieldMapper.Parameter<Script> dependentScriptParam)
      Defines an on_script_error parameter
      Parameters:
      initializer - retrieves the equivalent parameter from an existing FieldMapper for use in merges
      dependentScriptParam - the corresponding required script parameter
      Returns:
      a new on_error_script parameter