org.deegree.gml.feature
Class FeatureReference

java.lang.Object
  org.deegree.gml.GMLReference<Feature>
      org.deegree.gml.feature.FeatureReference

All Implemented Interfaces:

TypedObjectNode, Feature, GMLObject

public class FeatureReference
extends GMLReference<Feature>
implements Feature

Represents a reference to a feature, which is usually expressed using an xlink:href attribute in GML (may be document-local or remote).

Version:

$Revision: $, $Date: $

Author:

Markus Schneider, last edited by: $Author: schneider $

Constructor Summary

FeatureReference(GMLReferenceResolver resolver, java.lang.String uri, java.lang.String baseURL)
Creates a new FeatureReference instance.

Method Summary

Envelope	getEnvelope() Returns the envelope of the feature.
Property[]	getGeometryProperties() Returns all geometry-valued properties in order.
StandardGMLFeatureProps	getGMLProperties() Returns the standard GML properties (e.g.
javax.xml.namespace.QName	getName() Returns the name of the feature.
Property[]	getProperties() Returns all properties in order, excluding standard GML properties such as gml:name.
Property[]	getProperties(GMLVersion version) Returns all properties in order, including standard GML properties.
Property[]	getProperties(javax.xml.namespace.QName propName) Returns the properties with the given name, in order.
Property[]	getProperties(javax.xml.namespace.QName propName, GMLVersion version) Returns the properties with the given name, in order.
Property	getProperty(javax.xml.namespace.QName propName) Returns the property with the given name.
Property	getProperty(javax.xml.namespace.QName propName, GMLVersion version) Returns the property with the given name.
FeatureType	getType() Returns the type information for this feature.
void	setId(java.lang.String id) Sets the id of the feature.
void	setProperties(java.util.List<Property> props) Called during construction to initialize the properties of the feature.
void	setProperties(java.util.List<Property> props, GMLVersion version) Called during construction to initialize the properties of the feature.
void	setPropertyValue(javax.xml.namespace.QName propName, int occurence, TypedObjectNode value) Sets the value of a specific occurrence of a property with a given name (or removes the property feature).
void	setPropertyValue(javax.xml.namespace.QName propName, int occurence, TypedObjectNode value, GMLVersion version) Sets the value of a specific occurrence of a property with a given name (or removes the property from the feature).

Methods inherited from class org.deegree.gml.GMLReference

getId, getReferencedObject, getURI, isLocal, isResolved, resolve

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.deegree.feature.Feature

getId

Constructor Detail

FeatureReference

public FeatureReference(GMLReferenceResolver resolver,
                        java.lang.String uri,
                        java.lang.String baseURL)

Creates a new FeatureReference instance.

Parameters:

resolver - used for resolving the reference, must not be null

uri - the feature's uri, must not be null

baseURL - base URL for resolving the uri, may be null (no resolving of relative URLs)

Method Detail

getEnvelope

public Envelope getEnvelope()

Description copied from interface: Feature

Returns the envelope of the feature.

Specified by:

getEnvelope in interface Feature

Returns:

the envelope of the feature, or null if the feature has no envelope information / geometry properties

getGeometryProperties

public Property[] getGeometryProperties()

Description copied from interface: Feature

Returns all geometry-valued properties in order.

Specified by:

getGeometryProperties in interface Feature

Returns:

all geometry properties

getName

public javax.xml.namespace.QName getName()

Description copied from interface: Feature

Returns the name of the feature.

In a GML representation of the feature, this corresponds to the feature element's name.

Specified by:

getName in interface Feature

Returns:

the name of the feature instance, never null

getProperties

public Property[] getProperties()

Description copied from interface: Feature

Returns all properties in order, excluding standard GML properties such as gml:name.

Specified by:

getProperties in interface Feature

Returns:

all properties, excluding standard GML properties, may be empty, but never null

getProperties

public Property[] getProperties(javax.xml.namespace.QName propName)

Description copied from interface: Feature

Returns the properties with the given name, in order.

Specified by:

getProperties in interface Feature

Parameters:

propName - name of the requested properties

Returns:

the properties with the given name, in order, may be empty, but never null

getProperty

public Property getProperty(javax.xml.namespace.QName propName)

Description copied from interface: Feature

Returns the property with the given name.

Specified by:

getProperty in interface Feature

Parameters:

propName - name of the requested property

Returns:

the property with the given name

getType

public FeatureType getType()

Description copied from interface: Feature

Returns the type information for this feature.

Specified by:

getType in interface Feature

Returns:

the type information, never null

setId

public void setId(java.lang.String id)

Description copied from interface: Feature

Sets the id of the feature.

In a GML representation of the feature, this corresponds to the gml:id (GML 3 and later) or fid (GML 2) attribute of the feature element.

Specified by:

setId in interface Feature

Parameters:

id - the id of the feature instance, may be null

setProperties

public void setProperties(java.util.List<Property> props)
                   throws java.lang.IllegalArgumentException

Description copied from interface: Feature

Called during construction to initialize the properties of the feature.

Specified by:

setProperties in interface Feature

Throws:

java.lang.IllegalArgumentException - if the property names or values are not compatible with the feature type

setPropertyValue

public void setPropertyValue(javax.xml.namespace.QName propName,
                             int occurence,
                             TypedObjectNode value)

Description copied from interface: Feature

Sets the value of a specific occurrence of a property with a given name (or removes the property feature).

Specified by:

setPropertyValue in interface Feature

Parameters:

propName - property name

occurence - index of the property, starting with zero. If the property is not a multi-property (i.e. maxOccurs=1), this is always zero.

value - new value of the property or null (removes the property)

getProperties

public Property[] getProperties(GMLVersion version)

Description copied from interface: Feature

Returns all properties in order, including standard GML properties.

Specified by:

getProperties in interface Feature

Parameters:

version - determines the names and types of the standard GML properties, must not be null

Returns:

all properties, including standard GML properties, may be empty, but never null

getProperties

public Property[] getProperties(javax.xml.namespace.QName propName,
                                GMLVersion version)

Description copied from interface: Feature

Returns the properties with the given name, in order.

Specified by:

getProperties in interface Feature

Parameters:

propName - name of the requested properties

version - determines the names and types of the standard GML properties, must not be null

Returns:

the properties with the given name, in order, may be empty, but never null

getProperty

public Property getProperty(javax.xml.namespace.QName propName,
                            GMLVersion version)

Description copied from interface: Feature

Returns the property with the given name.

Specified by:

getProperty in interface Feature

Parameters:

propName - name of the requested property

version - determines the names and types of the standard GML properties, must not be null

Returns:

the property with the given name

setProperties

public void setProperties(java.util.List<Property> props,
                          GMLVersion version)
                   throws java.lang.IllegalArgumentException

Description copied from interface: Feature

Called during construction to initialize the properties of the feature.

Specified by:

setProperties in interface Feature

version - determines the names and types of the standard GML properties, must not be null

Throws:

java.lang.IllegalArgumentException - if the property names or values are not compatible with the feature type

setPropertyValue

public void setPropertyValue(javax.xml.namespace.QName propName,
                             int occurence,
                             TypedObjectNode value,
                             GMLVersion version)

Description copied from interface: Feature

Sets the value of a specific occurrence of a property with a given name (or removes the property from the feature).

Specified by:

setPropertyValue in interface Feature

Parameters:

propName - property name

occurence - index of the property, starting with zero. If the property is not a multi-property (i.e. maxOccurs=1), this is always zero.

value - new value of the property or null (removes the property)

version - determines the names and types of the standard GML properties, must not be null

getGMLProperties

public StandardGMLFeatureProps getGMLProperties()

Description copied from interface: GMLObject

Returns the standard GML properties (e.g. gml:name).

Specified by:

getGMLProperties in interface Feature

Specified by:

getGMLProperties in interface GMLObject

Overrides:

getGMLProperties in class GMLReference<Feature>

Returns:

the standard GML properties, may be