com.esri.adf.web.ags.data
Class AGSGeocodeFunctionality

java.lang.Object
  com.esri.adf.web.ags.data.AGSGeocodeFunctionality

All Implemented Interfaces:

GeocodeFunctionality, GISFunctionality, Serializable

public class AGSGeocodeFunctionality
extends Object
implements GeocodeFunctionality, Serializable

See Also:

Serialized Form

Field Summary

protected HashMap<String,Object>	address
protected AGSGeocodeResource	agsgeo
protected HashMap<String,String>	aliases
protected boolean	fetchAddressDetails
protected String[]	fields
static String	MATCH_ADDRESS_FIELD_NAME
static String	MINIMUM_CANDIDATE_SCORE
protected com.esri.arcgisws.PropertySet	mods
static String	OUTPUT_SPATIAL_REFERENCE
static String	SCORE_FIELD_NAME

Fields inherited from interface com.esri.adf.web.data.GeocodeFunctionality

FUNCTIONALITY_NAME

Constructor Summary

AGSGeocodeFunctionality()

Method Summary

protected com.esri.arcgisws.PropertySet	createAddressPropertySet()
void	destroyFunctionality() The cleanup chores (such as releasing held resources) for the functionality must be performed in this method.
List<AddressCandidate>	findAddressCandidates() Returns a List of AddressCandidates based on the current set of address field values.
String	generateAddressString()
AddressCandidate	geocodeAddress() Geocodes a single address based on the current set of address field values.
String	getAddressFieldAlias(String fieldName) Returns an alias for the given address field.
String[]	getAddressFields() Returns an array of address fields for this geocoder.
String	getAddressFieldValue(String fieldName) Returns the value for a given address field.
int	getMinScore()
AGSGeocodeResource	getResource() Returns the GISResource associated with this functionality.
void	initFunctionality(GISResource resource) The initialization chores for the functionality must be performed in this method.
boolean	isFetchAddressDetails()
void	setAddressFieldValue(String fieldName, String value) Sets the value for a given address field.
void	setFetchAddressDetails(boolean fetchAddressDetails)
void	setMinScore(int minScore)

Methods inherited from class java.lang.Object

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

Field Detail

agsgeo

protected AGSGeocodeResource agsgeo

fields

protected String[] fields

aliases

protected HashMap<String,String> aliases

address

protected HashMap<String,Object> address

mods

protected com.esri.arcgisws.PropertySet mods

fetchAddressDetails

protected boolean fetchAddressDetails

SCORE_FIELD_NAME

public static final String SCORE_FIELD_NAME

See Also:

Constant Field Values

MATCH_ADDRESS_FIELD_NAME

public static final String MATCH_ADDRESS_FIELD_NAME

See Also:

Constant Field Values

MINIMUM_CANDIDATE_SCORE

public static final String MINIMUM_CANDIDATE_SCORE

See Also:

Constant Field Values

OUTPUT_SPATIAL_REFERENCE

public static final String OUTPUT_SPATIAL_REFERENCE

See Also:

Constant Field Values

Constructor Detail

AGSGeocodeFunctionality

public AGSGeocodeFunctionality()

Method Detail

initFunctionality

public void initFunctionality(GISResource resource)

Description copied from interface: GISFunctionality

The initialization chores for the functionality must be performed in this method. This method is called by the resource when the functionality needs to be initialized. This happens either when the resource itself is being initialized or if users add this functionality to the resource using the GISResource.addFunctionality(String, GISFunctionality) method after the resource has already been initialized.

Classes which implement this method should maintain the resource as a class instance variable and return the same in the GISFunctionality.getResource() method. The functionality is ready for use only after this method has been called.

Specified by:

initFunctionality in interface GISFunctionality

Parameters:

resource - the GISResource that this functionality supports

See Also:

GISResource.init(WebContext)

destroyFunctionality

public void destroyFunctionality()

Description copied from interface: GISFunctionality

The cleanup chores (such as releasing held resources) for the functionality must be performed in this method. This method is called by the GISResource when the resource itself is being destroyed.

The functionality is no longer usable after this method has been called.

Specified by:

destroyFunctionality in interface GISFunctionality

See Also:

GISResource.destroy()

getAddressFields

public String[] getAddressFields()

Description copied from interface: GeocodeFunctionality

Returns an array of address fields for this geocoder. Every implementation of GeocodeFunctionality defines the address fields that are available.

The GeocodeTask dynamically generates input text box for each address field.

Specified by:

getAddressFields in interface GeocodeFunctionality

Returns:

a String array of address fields for this geocoder

setAddressFieldValue

public void setAddressFieldValue(String fieldName,
                                 String value)

Description copied from interface: GeocodeFunctionality

Sets the value for a given address field.

Specified by:

setAddressFieldValue in interface GeocodeFunctionality

Parameters:

fieldName - the address field for which the value is to be set

value - the value for the given address field

getAddressFieldValue

public String getAddressFieldValue(String fieldName)

Description copied from interface: GeocodeFunctionality

Returns the value for a given address field.

Specified by:

getAddressFieldValue in interface GeocodeFunctionality

Parameters:

fieldName - the address field for which the value is to be returned

Returns:

the value for the given address field

getAddressFieldAlias

public String getAddressFieldAlias(String fieldName)

Description copied from interface: GeocodeFunctionality

Returns an alias for the given address field.

The GeocodeTask labels the input text box for the address field with this alias.

Specified by:

getAddressFieldAlias in interface GeocodeFunctionality

Parameters:

fieldName - the address field for which the alias is to be returned

Returns:

the alias for the given address field

geocodeAddress

public AddressCandidate geocodeAddress()

Description copied from interface: GeocodeFunctionality

Geocodes a single address based on the current set of address field values.

Specified by:

geocodeAddress in interface GeocodeFunctionality

Returns:

a single geocoded address

createAddressPropertySet

protected com.esri.arcgisws.PropertySet createAddressPropertySet()

generateAddressString

public String generateAddressString()

findAddressCandidates

public List<AddressCandidate> findAddressCandidates()

Description copied from interface: GeocodeFunctionality

Returns a List of AddressCandidates based on the current set of address field values.

Specified by:

findAddressCandidates in interface GeocodeFunctionality

Returns:

a List of AddressCandidates matching the current set of address field values

getResource

public AGSGeocodeResource getResource()

Description copied from interface: GISFunctionality

Returns the GISResource associated with this functionality.

The resource passed to GISFunctionality.initFunctionality(GISResource) is maintained as a class variable and is accessible through this method.

Specified by:

getResource in interface GISFunctionality

Returns:

the GISResource associated with this functionality

isFetchAddressDetails

public boolean isFetchAddressDetails()

getMinScore

public int getMinScore()

Returns:

the minScore

setMinScore

public void setMinScore(int minScore)

Parameters:

minScore - the minScore to set

setFetchAddressDetails

public void setFetchAddressDetails(boolean fetchAddressDetails)