oracle.spatial.hadoop.vector.mvsuggest

Class WebMVSService

java.lang.Object

oracle.spatial.hadoop.vector.mvsuggest.WebMVSService

All Implemented Interfaces:

LocationService, MVSService

Direct Known Subclasses:

MVSuggestService

public class WebMVSService
extends java.lang.Object
implements MVSService, LocationService

MVSService implementation used to communicate with a web MVSuggest service instance. The service location should be the URL of the MVSuggest service.

Constructor Summary

Constructors

Constructor and Description
WebMVSService()

Method Summary

Methods

Modifier and Type	Method and Description
MVSQueryRequester	createQueryRequester() Creates an instance of MVSQueryRequester used to send match requests
void	environmentCleanup(org.apache.hadoop.conf.Configuration conf) Performs cleanning tasks like removing temporal file.
void	environmentSetup(org.apache.hadoop.conf.Configuration conf) Performs the necessary setup before running a job.
java.lang.String[]	getLayers() Gets the layers indexed by MVSuggest
MVSConfig	getMVSConfig() Gets the MVSuggest configuration bean
java.lang.String	getTemplate(java.lang.String layer) Gets the template content for a single layer
void	init(org.apache.hadoop.conf.Configuration conf) Initializes a single instance per task.
protected void	init(MVSConfig mvsConfig)
void	init(java.lang.String serverURL, java.lang.String[] matchLayers) Initialize the service with the specified server URL.
protected java.util.List<GeoAreaInfo>	query(java.lang.String jsonQry)
java.util.List<GeoAreaInfo>	searchResult(java.util.List<java.lang.String> records) Return the geometric area informations of the data strings.
GeoAreaInfo	searchResult(java.lang.String data) Return the geometric area information of the data string.
protected void	setMatchLayers(java.lang.String[] matchLayers)

Methods inherited from class java.lang.Object

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

Constructor Detail

WebMVSService

public WebMVSService()

Method Detail

environmentSetup

public void environmentSetup(org.apache.hadoop.conf.Configuration conf)
                      throws java.io.IOException

Description copied from interface: MVSService

Performs the necessary setup before running a job. This method should be called only once per job, before the job is executed.

Specified by:

environmentSetup in interface MVSService

Parameters:

conf - the job configuration

Throws:

java.io.IOException

environmentCleanup

public void environmentCleanup(org.apache.hadoop.conf.Configuration conf)
                        throws java.io.IOException

Description copied from interface: MVSService

Performs cleanning tasks like removing temporal file. This method is executed once the job has finished.

Specified by:

environmentCleanup in interface MVSService

Parameters:

conf - the job configuration

Throws:

java.io.IOException

init

public void init(org.apache.hadoop.conf.Configuration conf)
          throws java.io.IOException

Description copied from interface: MVSService

Initializes a single instance per task. This method should be called once per instance.

Specified by:

init in interface MVSService

Parameters:

conf - the job configuration

Throws:

java.io.IOException

getMVSConfig

public MVSConfig getMVSConfig()

Description copied from interface: MVSService

Gets the MVSuggest configuration bean

Specified by:

getMVSConfig in interface MVSService

Returns:

the MVsuggest configuration

getLayers

public java.lang.String[] getLayers()

Description copied from interface: MVSService

Gets the layers indexed by MVSuggest

Specified by:

getLayers in interface MVSService

Returns:

an array of layer names

getTemplate

public java.lang.String getTemplate(java.lang.String layer)

Description copied from interface: MVSService

Gets the template content for a single layer

Specified by:

getTemplate in interface MVSService

Parameters:

layer - the template content in JSON format

Returns:

createQueryRequester

public MVSQueryRequester createQueryRequester()

Description copied from interface: MVSService

Creates an instance of MVSQueryRequester used to send match requests

Specified by:

createQueryRequester in interface MVSService

Returns:

init

public void init(java.lang.String serverURL,
                 java.lang.String[] matchLayers)
          throws java.io.IOException

Description copied from interface: LocationService

Initialize the service with the specified server URL.

Specified by:

init in interface LocationService

Parameters:

serverURL - the server URL

matchLayers - optional - which layers should be used to search

Throws:

java.io.IOException - thrown if an IOException occurs.

init

protected void init(MVSConfig mvsConfig)
             throws java.io.IOException

Throws:

java.io.IOException

setMatchLayers

protected void setMatchLayers(java.lang.String[] matchLayers)

searchResult

public GeoAreaInfo searchResult(java.lang.String data)
                         throws java.io.IOException

Return the geometric area information of the data string. If the geometry is a polygon then a centroid is set as pointGeometry.

Specified by:

searchResult in interface LocationService

Parameters:

data - data string

Returns:

geometric area information

Throws:

java.io.IOException - thrown if an IOException occurs.

searchResult

public java.util.List<GeoAreaInfo> searchResult(java.util.List<java.lang.String> records)
                                         throws java.io.IOException

Return the geometric area informations of the data strings. If the geometry of a geometric area is a polygon then a centroid is set as pointGeometry.

Specified by:

searchResult in interface LocationService

Parameters:

records - data strings

Returns:

the geometric area informations

Throws:

java.io.IOException - thrown if an IOException occurs.

query

protected java.util.List<GeoAreaInfo> query(java.lang.String jsonQry)
                                     throws java.io.IOException

Throws:

java.io.IOException