Package org.elasticsearch.index.query
Class AbstractGeometryQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
java.lang.Object
org.elasticsearch.index.query.AbstractQueryBuilder<QB>
org.elasticsearch.index.query.AbstractGeometryQueryBuilder<QB>
- All Implemented Interfaces:
NamedWriteable
,Writeable
,org.elasticsearch.common.xcontent.ToXContent
,org.elasticsearch.common.xcontent.ToXContentObject
,QueryBuilder
,Rewriteable<QueryBuilder>
- Direct Known Subclasses:
GeoShapeQueryBuilder
public abstract class AbstractGeometryQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>> extends AbstractQueryBuilder<QB>
Base
QueryBuilder
that builds a Geometry Query-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected static class
AbstractGeometryQueryBuilder.ParsedGeometryQueryParams
local class that encapsulates xcontent parsed shape parametersNested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent
org.elasticsearch.common.xcontent.ToXContent.DelegatingMapParams, org.elasticsearch.common.xcontent.ToXContent.MapParams, org.elasticsearch.common.xcontent.ToXContent.Params
Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable
Writeable.Reader<V>, Writeable.Writer<V>
-
Field Summary
Fields Modifier and Type Field Description static boolean
DEFAULT_IGNORE_UNMAPPED
The default value for ignore_unmapped.static java.lang.String
DEFAULT_SHAPE_FIELD_NAME
static java.lang.String
DEFAULT_SHAPE_INDEX_NAME
static ShapeRelation
DEFAULT_SHAPE_RELATION
protected java.lang.String
fieldName
protected static org.elasticsearch.common.ParseField
IGNORE_UNMAPPED_FIELD
protected boolean
ignoreUnmapped
protected static org.elasticsearch.common.ParseField
INDEXED_SHAPE_FIELD
protected java.lang.String
indexedShapeId
protected java.lang.String
indexedShapeIndex
protected java.lang.String
indexedShapePath
protected java.lang.String
indexedShapeRouting
protected java.lang.String
indexedShapeType
protected ShapeRelation
relation
protected static org.elasticsearch.common.ParseField
RELATION_FIELD
protected org.elasticsearch.geometry.Geometry
shape
protected static org.elasticsearch.common.ParseField
SHAPE_FIELD
protected static org.elasticsearch.common.ParseField
SHAPE_ID_FIELD
protected static org.elasticsearch.common.ParseField
SHAPE_INDEX_FIELD
protected static org.elasticsearch.common.ParseField
SHAPE_PATH_FIELD
protected static org.elasticsearch.common.ParseField
SHAPE_ROUTING_FIELD
protected static org.elasticsearch.common.ParseField
SHAPE_TYPE_FIELD
protected java.util.function.Supplier<org.elasticsearch.geometry.Geometry>
supplier
Fields inherited from class org.elasticsearch.index.query.AbstractQueryBuilder
boost, BOOST_FIELD, DEFAULT_BOOST, NAME_FIELD, queryName
Fields inherited from interface org.elasticsearch.index.query.Rewriteable
MAX_REWRITE_ROUNDS
Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent
EMPTY_PARAMS
-
Constructor Summary
Constructors Modifier Constructor Description protected
AbstractGeometryQueryBuilder(java.lang.String fieldName, java.lang.String indexedShapeId)
Creates a new ShapeQueryBuilder whose Query will be against the given field name and will use the Shape found with the given IDprotected
AbstractGeometryQueryBuilder(java.lang.String fieldName, java.lang.String indexedShapeId, java.lang.String indexedShapeType)
Deprecated.protected
AbstractGeometryQueryBuilder(java.lang.String fieldName, java.util.function.Supplier<org.elasticsearch.geometry.Geometry> supplier, java.lang.String indexedShapeId, java.lang.String indexedShapeType)
protected
AbstractGeometryQueryBuilder(java.lang.String fieldName, ShapeBuilder shape)
Deprecated.useAbstractGeometryQueryBuilder(String, Geometry)
insteadAbstractGeometryQueryBuilder(java.lang.String fieldName, org.elasticsearch.geometry.Geometry shape)
Creates a new AbstractGeometryQueryBuilder whose Query will be against the given field name using the given Shapeprotected
AbstractGeometryQueryBuilder(java.lang.String fieldName, org.elasticsearch.geometry.Geometry shape, java.lang.String indexedShapeId, java.lang.String indexedShapeType)
protected
AbstractGeometryQueryBuilder(StreamInput in)
Read from a stream. -
Method Summary
Modifier and Type Method Description protected abstract org.apache.lucene.search.Query
buildShapeQuery(SearchExecutionContext context, MappedFieldType fieldType)
builds the appropriate lucene shape queryprotected boolean
doEquals(AbstractGeometryQueryBuilder other)
Indicates whether some otherQueryBuilder
object of the same type is "equal to" this one.protected int
doHashCode()
protected QueryBuilder
doRewrite(QueryRewriteContext queryRewriteContext)
protected abstract void
doShapeQueryXContent(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params)
writes the xcontent specific to this shape queryprotected org.apache.lucene.search.Query
doToQuery(SearchExecutionContext context)
protected void
doWriteTo(StreamOutput out)
protected void
doXContent(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params)
java.lang.String
fieldName()
boolean
ignoreUnmapped()
Gets whether the query builder will ignore unmapped fields (and run aMatchNoDocsQuery
in place of this query) or throw an exception if the field is unmapped.AbstractGeometryQueryBuilder<QB>
ignoreUnmapped(boolean ignoreUnmapped)
Sets whether the query builder should ignore unmapped fields (and run aMatchNoDocsQuery
in place of this query) or throw an exception if the field is unmapped.java.lang.String
indexedShapeId()
java.lang.String
indexedShapeIndex()
QB
indexedShapeIndex(java.lang.String indexedShapeIndex)
Sets the name of the index where the indexed Shape can be foundjava.lang.String
indexedShapePath()
QB
indexedShapePath(java.lang.String indexedShapePath)
Sets the path of the field in the indexed Shape document that has the Shape itselfjava.lang.String
indexedShapeRouting()
QB
indexedShapeRouting(java.lang.String indexedShapeRouting)
Sets the optional routing to the indexed Shape that will be used in the queryjava.lang.String
indexedShapeType()
Deprecated.Types are in the process of being removed.protected abstract AbstractGeometryQueryBuilder<QB>
newShapeQueryBuilder(java.lang.String fieldName, java.util.function.Supplier<org.elasticsearch.geometry.Geometry> shapeSupplier, java.lang.String indexedShapeId, java.lang.String indexedShapeType)
creates a new ShapeQueryBuilder from the provided field name, supplier, indexed shape id, and indexed shape typeprotected abstract AbstractGeometryQueryBuilder<QB>
newShapeQueryBuilder(java.lang.String fieldName, org.elasticsearch.geometry.Geometry shape)
creates a new ShapeQueryBuilder from the provided field name and shape builderstatic AbstractGeometryQueryBuilder.ParsedGeometryQueryParams
parsedParamsFromXContent(org.elasticsearch.common.xcontent.XContentParser parser, AbstractGeometryQueryBuilder.ParsedGeometryQueryParams params)
ShapeRelation
relation()
QB
relation(ShapeRelation relation)
Sets the relation of query shape and indexed shape.org.elasticsearch.geometry.Geometry
shape()
QB
shape(org.elasticsearch.geometry.Geometry geometry)
Sets the shapeBuilder for the query shape.Methods inherited from class org.elasticsearch.index.query.AbstractQueryBuilder
addValidationError, boost, boost, checkNegativeBoost, declareStandardFields, equals, extractInnerHitBuilders, getName, hashCode, parseInnerQueryBuilder, parseInnerQueryBuilder, printBoostAndQueryName, queryName, queryName, requireValue, rewrite, throwParsingExceptionOnMultipleFields, toQuery, toString, toXContent, writeTo
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.elasticsearch.common.io.stream.NamedWriteable
getWriteableName
Methods inherited from interface org.elasticsearch.common.xcontent.ToXContentObject
isFragment
-
Field Details
-
DEFAULT_SHAPE_INDEX_NAME
public static final java.lang.String DEFAULT_SHAPE_INDEX_NAME- See Also:
- Constant Field Values
-
DEFAULT_SHAPE_FIELD_NAME
public static final java.lang.String DEFAULT_SHAPE_FIELD_NAME- See Also:
- Constant Field Values
-
DEFAULT_SHAPE_RELATION
-
DEFAULT_IGNORE_UNMAPPED
public static final boolean DEFAULT_IGNORE_UNMAPPEDThe default value for ignore_unmapped.- See Also:
- Constant Field Values
-
SHAPE_FIELD
protected static final org.elasticsearch.common.ParseField SHAPE_FIELD -
RELATION_FIELD
protected static final org.elasticsearch.common.ParseField RELATION_FIELD -
INDEXED_SHAPE_FIELD
protected static final org.elasticsearch.common.ParseField INDEXED_SHAPE_FIELD -
SHAPE_ID_FIELD
protected static final org.elasticsearch.common.ParseField SHAPE_ID_FIELD -
SHAPE_TYPE_FIELD
protected static final org.elasticsearch.common.ParseField SHAPE_TYPE_FIELD -
SHAPE_INDEX_FIELD
protected static final org.elasticsearch.common.ParseField SHAPE_INDEX_FIELD -
SHAPE_PATH_FIELD
protected static final org.elasticsearch.common.ParseField SHAPE_PATH_FIELD -
SHAPE_ROUTING_FIELD
protected static final org.elasticsearch.common.ParseField SHAPE_ROUTING_FIELD -
IGNORE_UNMAPPED_FIELD
protected static final org.elasticsearch.common.ParseField IGNORE_UNMAPPED_FIELD -
fieldName
protected final java.lang.String fieldName -
supplier
protected final java.util.function.Supplier<org.elasticsearch.geometry.Geometry> supplier -
indexedShapeId
protected final java.lang.String indexedShapeId -
indexedShapeType
protected final java.lang.String indexedShapeType -
shape
protected org.elasticsearch.geometry.Geometry shape -
indexedShapeIndex
protected java.lang.String indexedShapeIndex -
indexedShapePath
protected java.lang.String indexedShapePath -
indexedShapeRouting
protected java.lang.String indexedShapeRouting -
relation
-
ignoreUnmapped
protected boolean ignoreUnmapped
-
-
Constructor Details
-
AbstractGeometryQueryBuilder
Deprecated.useAbstractGeometryQueryBuilder(String, Geometry)
insteadCreates a new ShapeQueryBuilder whose Query will be against the given field name using the given Shape- Parameters:
fieldName
- Name of the field that will be queriedshape
- Shape used in the Query
-
AbstractGeometryQueryBuilder
public AbstractGeometryQueryBuilder(java.lang.String fieldName, org.elasticsearch.geometry.Geometry shape)Creates a new AbstractGeometryQueryBuilder whose Query will be against the given field name using the given Shape- Parameters:
fieldName
- Name of the field that will be queriedshape
- Shape used in the Query
-
AbstractGeometryQueryBuilder
protected AbstractGeometryQueryBuilder(java.lang.String fieldName, java.lang.String indexedShapeId)Creates a new ShapeQueryBuilder whose Query will be against the given field name and will use the Shape found with the given ID- Parameters:
fieldName
- Name of the field that will be filteredindexedShapeId
- ID of the indexed Shape that will be used in the Query
-
AbstractGeometryQueryBuilder
@Deprecated protected AbstractGeometryQueryBuilder(java.lang.String fieldName, java.lang.String indexedShapeId, java.lang.String indexedShapeType)Deprecated.useAbstractGeometryQueryBuilder(String, String)
insteadCreates a new AbstractGeometryQueryBuilder whose Query will be against the given field name and will use the Shape found with the given ID in the given type- Parameters:
fieldName
- Name of the field that will be filteredindexedShapeId
- ID of the indexed Shape that will be used in the QueryindexedShapeType
- Index type of the indexed Shapes
-
AbstractGeometryQueryBuilder
protected AbstractGeometryQueryBuilder(java.lang.String fieldName, org.elasticsearch.geometry.Geometry shape, java.lang.String indexedShapeId, @Nullable java.lang.String indexedShapeType) -
AbstractGeometryQueryBuilder
protected AbstractGeometryQueryBuilder(java.lang.String fieldName, java.util.function.Supplier<org.elasticsearch.geometry.Geometry> supplier, java.lang.String indexedShapeId, @Nullable java.lang.String indexedShapeType) -
AbstractGeometryQueryBuilder
Read from a stream.- Throws:
java.io.IOException
-
-
Method Details
-
doWriteTo
- Specified by:
doWriteTo
in classAbstractQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
- Throws:
java.io.IOException
-
fieldName
public java.lang.String fieldName()- Returns:
- the name of the field that will be queried
-
shape
Sets the shapeBuilder for the query shape.- Parameters:
geometry
- the geometry- Returns:
- this
-
shape
public org.elasticsearch.geometry.Geometry shape()- Returns:
- the shape used in the Query
-
indexedShapeId
public java.lang.String indexedShapeId()- Returns:
- the ID of the indexed Shape that will be used in the Query
-
indexedShapeType
@Deprecated public java.lang.String indexedShapeType()Deprecated.Types are in the process of being removed.- Returns:
- the document type of the indexed Shape that will be used in the Query
-
indexedShapeIndex
Sets the name of the index where the indexed Shape can be found- Parameters:
indexedShapeIndex
- Name of the index where the indexed Shape is- Returns:
- this
-
indexedShapeIndex
public java.lang.String indexedShapeIndex()- Returns:
- the index name for the indexed Shape that will be used in the Query
-
indexedShapePath
Sets the path of the field in the indexed Shape document that has the Shape itself- Parameters:
indexedShapePath
- Path of the field where the Shape itself is defined- Returns:
- this
-
indexedShapePath
public java.lang.String indexedShapePath()- Returns:
- the path of the indexed Shape that will be used in the Query
-
indexedShapeRouting
Sets the optional routing to the indexed Shape that will be used in the query- Parameters:
indexedShapeRouting
- indexed shape routing- Returns:
- this
-
indexedShapeRouting
public java.lang.String indexedShapeRouting()- Returns:
- the optional routing to the indexed Shape that will be used in the Query
-
relation
Sets the relation of query shape and indexed shape.- Parameters:
relation
- relation of the shapes- Returns:
- this
-
relation
- Returns:
- the relation of query shape and indexed shape to use in the Query
-
ignoreUnmapped
Sets whether the query builder should ignore unmapped fields (and run aMatchNoDocsQuery
in place of this query) or throw an exception if the field is unmapped. -
ignoreUnmapped
public boolean ignoreUnmapped()Gets whether the query builder will ignore unmapped fields (and run aMatchNoDocsQuery
in place of this query) or throw an exception if the field is unmapped. -
buildShapeQuery
protected abstract org.apache.lucene.search.Query buildShapeQuery(SearchExecutionContext context, MappedFieldType fieldType)builds the appropriate lucene shape query -
doShapeQueryXContent
protected abstract void doShapeQueryXContent(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params) throws java.io.IOExceptionwrites the xcontent specific to this shape query- Throws:
java.io.IOException
-
newShapeQueryBuilder
protected abstract AbstractGeometryQueryBuilder<QB> newShapeQueryBuilder(java.lang.String fieldName, org.elasticsearch.geometry.Geometry shape)creates a new ShapeQueryBuilder from the provided field name and shape builder -
newShapeQueryBuilder
protected abstract AbstractGeometryQueryBuilder<QB> newShapeQueryBuilder(java.lang.String fieldName, java.util.function.Supplier<org.elasticsearch.geometry.Geometry> shapeSupplier, java.lang.String indexedShapeId, java.lang.String indexedShapeType)creates a new ShapeQueryBuilder from the provided field name, supplier, indexed shape id, and indexed shape type -
doToQuery
- Specified by:
doToQuery
in classAbstractQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
-
doXContent
protected void doXContent(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params) throws java.io.IOException- Specified by:
doXContent
in classAbstractQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
- Throws:
java.io.IOException
-
doEquals
Description copied from class:AbstractQueryBuilder
Indicates whether some otherQueryBuilder
object of the same type is "equal to" this one.- Specified by:
doEquals
in classAbstractQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
-
doHashCode
protected int doHashCode()- Specified by:
doHashCode
in classAbstractQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
-
doRewrite
protected QueryBuilder doRewrite(QueryRewriteContext queryRewriteContext) throws java.io.IOException- Overrides:
doRewrite
in classAbstractQueryBuilder<QB extends AbstractGeometryQueryBuilder<QB>>
- Throws:
java.io.IOException
-
parsedParamsFromXContent
public static AbstractGeometryQueryBuilder.ParsedGeometryQueryParams parsedParamsFromXContent(org.elasticsearch.common.xcontent.XContentParser parser, AbstractGeometryQueryBuilder.ParsedGeometryQueryParams params) throws java.io.IOException- Throws:
java.io.IOException
-
AbstractGeometryQueryBuilder(String, String)
instead