Package com.gpudb.protocol
Class FilterByGeometryRequest
java.lang.Object
com.gpudb.protocol.FilterByGeometryRequest
All Implemented Interfaces:
org.apache.avro.generic.GenericContainer, org.apache.avro.generic.IndexedRecordpublic class FilterByGeometryRequest extends Object implements org.apache.avro.generic.IndexedRecord
A set of parameters for
GPUdb.filterByGeometry.
Applies a geometry filter against a geospatial geometry column in a given table or view. The filtering geometry is provided by inputWkt.
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final classA set of string constants for theFilterByGeometryRequestparameteroperation.static final classA set of string constants for theFilterByGeometryRequestparameteroptions.Constructor Summary
ConstructorsConstructorDescriptionConstructs a FilterByGeometryRequest object with default parameters.FilterByGeometryRequest(String tableName, String viewName, String columnName, String inputWkt, String operation, Map<String, String> options) Constructs a FilterByGeometryRequest object with the specified parameters.Method Summary
Modifier and TypeMethodDescriptionbooleanget(int index) This method supports the Avro framework and is not intended to be called directly by the user.static org.apache.avro.SchemaThis method supports the Avro framework and is not intended to be called directly by the user.Name of the column to be used in the filter.A geometry in WKT format that will be used to filter the objects intableName.The geometric filtering operation to perform.Optional parameters.org.apache.avro.SchemaThis method supports the Avro framework and is not intended to be called directly by the user.Name of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules.If provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria.inthashCode()voidThis method supports the Avro framework and is not intended to be called directly by the user.setColumnName(String columnName) Name of the column to be used in the filter.setInputWkt(String inputWkt) A geometry in WKT format that will be used to filter the objects intableName.setOperation(String operation) The geometric filtering operation to perform.setOptions(Map<String, String> options) Optional parameters.setTableName(String tableName) Name of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules.setViewName(String viewName) If provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria.toString()
Constructor Details
FilterByGeometryRequest
public FilterByGeometryRequest()Constructs a FilterByGeometryRequest object with default parameters.FilterByGeometryRequest
public FilterByGeometryRequest(String tableName, String viewName, String columnName, String inputWkt, String operation, Map<String, String> options) Constructs a FilterByGeometryRequest object with the specified parameters.Parameters:tableName- Name of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view containing a geospatial geometry column.viewName- If provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ”.columnName- Name of the column to be used in the filter. Must be a geospatial geometry column.inputWkt- A geometry in WKT format that will be used to filter the objects intableName. The default value is ”.operation- The geometric filtering operation to perform. Supported values:CONTAINS: Matches records that contain the given WKT ininputWkt, i.e. the given WKT is within the bounds of a record’s geometry.CROSSES: Matches records that cross the given WKT.DISJOINT: Matches records that are disjoint from the given WKT.EQUALS: Matches records that are the same as the given WKT.INTERSECTS: Matches records that intersect the given WKT.OVERLAPS: Matches records that overlap the given WKT.TOUCHES: Matches records that touch the given WKT.WITHIN: Matches records that are within the given WKT.
options- Optional parameters.CREATE_TEMP_TABLE: IfTRUE, a unique temporary table name will be generated in the sys_temp schema and used in place ofviewName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned inQUALIFIED_VIEW_NAME. Supported values:The default value isFALSE.COLLECTION_NAME: [DEPRECATED—please specify the containing schema for the view as part ofviewNameand useGPUdb.createSchemato create the schema if non-existent] Name of a schema for the newly created view. If the schema provided is non-existent, it will be automatically created.
Map.
Method Details
getClassSchema
public static org.apache.avro.Schema getClassSchema()This method supports the Avro framework and is not intended to be called directly by the user.Returns:The schema for the class.getTableName
Name of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view containing a geospatial geometry column.Returns:The current value oftableName.setTableName
Name of the table on which the filter by geometry will be performed, in [schema_name.]table_name format, using standard name resolution rules. Must be an existing table or view containing a geospatial geometry column.Parameters:tableName- The new value fortableName.Returns:thisto mimic the builder pattern.getViewName
If provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ”.Returns:The current value ofviewName.setViewName
If provided, then this will be the name of the view containing the results, in [schema_name.]view_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view. The default value is ”.Parameters:viewName- The new value forviewName.Returns:thisto mimic the builder pattern.setColumnName
Name of the column to be used in the filter. Must be a geospatial geometry column.Parameters:columnName- The new value forcolumnName.Returns:thisto mimic the builder pattern.setInputWkt
A geometry in WKT format that will be used to filter the objects intableName. The default value is ”.Parameters:inputWkt- The new value forinputWkt.Returns:thisto mimic the builder pattern.getOperation
The geometric filtering operation to perform. Supported values:CONTAINS: Matches records that contain the given WKT ininputWkt, i.e. the given WKT is within the bounds of a record’s geometry.CROSSES: Matches records that cross the given WKT.DISJOINT: Matches records that are disjoint from the given WKT.EQUALS: Matches records that are the same as the given WKT.INTERSECTS: Matches records that intersect the given WKT.OVERLAPS: Matches records that overlap the given WKT.TOUCHES: Matches records that touch the given WKT.WITHIN: Matches records that are within the given WKT.
Returns:The current value ofoperation.setOperation
The geometric filtering operation to perform. Supported values:CONTAINS: Matches records that contain the given WKT ininputWkt, i.e. the given WKT is within the bounds of a record’s geometry.CROSSES: Matches records that cross the given WKT.DISJOINT: Matches records that are disjoint from the given WKT.EQUALS: Matches records that are the same as the given WKT.INTERSECTS: Matches records that intersect the given WKT.OVERLAPS: Matches records that overlap the given WKT.TOUCHES: Matches records that touch the given WKT.WITHIN: Matches records that are within the given WKT.
Parameters:operation- The new value foroperation.Returns:thisto mimic the builder pattern.getOptions
Optional parameters.CREATE_TEMP_TABLE: IfTRUE, a unique temporary table name will be generated in the sys_temp schema and used in place ofviewName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned inQUALIFIED_VIEW_NAME. Supported values:The default value isFALSE.COLLECTION_NAME: [DEPRECATED—please specify the containing schema for the view as part ofviewNameand useGPUdb.createSchemato create the schema if non-existent] Name of a schema for the newly created view. If the schema provided is non-existent, it will be automatically created.
Map.Returns:The current value ofoptions.setOptions
Optional parameters.CREATE_TEMP_TABLE: IfTRUE, a unique temporary table name will be generated in the sys_temp schema and used in place ofviewName. This is always allowed even if the caller does not have permission to create tables. The generated name is returned inQUALIFIED_VIEW_NAME. Supported values:The default value isFALSE.COLLECTION_NAME: [DEPRECATED—please specify the containing schema for the view as part ofviewNameand useGPUdb.createSchemato create the schema if non-existent] Name of a schema for the newly created view. If the schema provided is non-existent, it will be automatically created.
Map.Parameters:options- The new value foroptions.Returns:thisto mimic the builder pattern.getSchema
public org.apache.avro.Schema getSchema()This method supports the Avro framework and is not intended to be called directly by the user.Specified by:getSchemain interfaceorg.apache.avro.generic.GenericContainerReturns:The schema object describing this class.get
This method supports the Avro framework and is not intended to be called directly by the user.Specified by:getin interfaceorg.apache.avro.generic.IndexedRecordParameters:index- the position of the field to getReturns:value of the field with the given index.Throws:put
This method supports the Avro framework and is not intended to be called directly by the user.Specified by:putin interfaceorg.apache.avro.generic.IndexedRecordParameters:index- the position of the field to setvalue- the value to setThrows: