de.cismet.cismap.commons.featureservice.factory

Class WFSFeatureFactory

java.lang.Object

de.cismet.cismap.commons.featureservice.factory.AbstractFeatureFactory<FT,QT>

de.cismet.cismap.commons.featureservice.factory.DegreeFeatureFactory<WFSFeature,String>

de.cismet.cismap.commons.featureservice.factory.WFSFeatureFactory

All Implemented Interfaces:

FeatureFactory<WFSFeature,String>, Cloneable

public class WFSFeatureFactory
extends DegreeFeatureFactory<WFSFeature,String>

A FeatureFactory that creates WFSFeatures obtained from a Web Feature Service.
The factory is non-caching, which means that each request to createFeatures leads to a new WFS request, even if the bounding box is the same. However, it is possible to obtain the features created by the latesd WFS request via the getLastCreatedFeatures() operation.

Version:

$Revision$, $Date$

Author:

Pascal Dihé

Nested Class Summary

Nested classes/interfaces inherited from class de.cismet.cismap.commons.featureservice.factory.DegreeFeatureFactory

DegreeFeatureFactory.ParsingProgressListener

Nested classes/interfaces inherited from interface de.cismet.cismap.commons.featureservice.factory.FeatureFactory

FeatureFactory.TooManyFeaturesException

Field Summary

Fields

Modifier and Type	Field and Description
protected FeatureType	featureType
protected String	hostname

Fields inherited from class de.cismet.cismap.commons.featureservice.factory.DegreeFeatureFactory

featureSrid, geometryIndex

Fields inherited from class de.cismet.cismap.commons.featureservice.factory.AbstractFeatureFactory

DEBUG, groovyShell, ID, lastCreatedfeatureVector, lastGeom, lastQuery, layerName, layerProperties, logger, maxFeatureCount, styles

Constructor Summary

Constructors

Modifier	Constructor and Description
	WFSFeatureFactory(LayerProperties layerProperties, String hostname, FeatureType featureType, Crs crs, Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles) private Vector wfsFeatureVector = new Vector(); private PostMethod httppost; private InputStreamReader reader;
	WFSFeatureFactory(LayerProperties layerProperties, String hostname, FeatureType featureType, Crs crs, Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles, boolean reverseAxisOrder) private Vector wfsFeatureVector = new Vector(); private PostMethod httppost; private InputStreamReader reader;
protected	WFSFeatureFactory(WFSFeatureFactory wfsff) Creates a new WFSFeatureFactory object.

Method Summary

Modifier and Type	Method and Description
protected void	cleanup(InputStreamReader reader, org.apache.commons.httpclient.methods.PostMethod httppost) DOCUMENT ME!
WFSFeatureFactory	clone() DOCUMENT ME!
static String	convertFeatureQnameToName(QName qname) DOCUMENT ME!
Vector	createAttributes(SwingWorker workerThread) DOCUMENT ME!
protected WFSFeature	createFeatureInstance(org.deegree.model.feature.Feature degreeFeature, int index) DOCUMENT ME!
Vector<WFSFeature>	createFeatures(String query, BoundingBox boundingBox, SwingWorker workerThread) TODO: Track Progress?
List<WFSFeature>	createFeatures(String query, BoundingBox boundingBox, SwingWorker workerThread, int offset, int limit, FeatureServiceAttribute[] orderBy) Returns instances of features FT that match the optional query and that fall into the optional BoundingBox. Applies layerProperties (if set) on all Features (if the type of the feature implements the interface InheritsLayerProperties).
Crs	getCrs() DOCUMENT ME!
int	getFeatureCount(String query, BoundingBox bb) DOCUMENT ME!
protected void	initialiseFeature(WFSFeature featureServiceFeature, org.deegree.model.feature.Feature degreeFeature, boolean evaluateExpressions, int index) Perform standard initialisation of a newly created feature. In gereal, this operation is invokded by the processFeatureCollection operation.
protected boolean	isGenerateIds() DOCUMENT ME!
void	setCrs(Crs crs) DOCUMENT ME!
void	setHostname(String hostname) DOCUMENT ME!

Methods inherited from class de.cismet.cismap.commons.featureservice.factory.DegreeFeatureFactory

processFeatureCollection

Methods inherited from class de.cismet.cismap.commons.featureservice.factory.AbstractFeatureFactory

checkCancelled, createFeaturesFromMemory, createNewFeature, evaluateBeanShellExpression, evaluateExpressions, evaluateGroovyExpressions, featuresAlreadyInMemory, getLastCreatedFeatures, getLayerProperties, getMaxFeatureCount, getStyle, getStyle, reEvaluteExpressions, setInterruptedAllowed, setInterruptedNotAllowed, setLayerName, setLayerProperties, setMaxFeatureCount, setSLDStyle, sortFeatureList, updateLastCreatedFeatures, waitUntilInterruptedIsAllowed

Methods inherited from class java.lang.Object

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

Field Detail

hostname

protected String hostname

featureType

protected FeatureType featureType

Constructor Detail

WFSFeatureFactory

public WFSFeatureFactory(LayerProperties layerProperties,
                         String hostname,
                         FeatureType featureType,
                         Crs crs,
                         Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles)

private Vector wfsFeatureVector = new Vector(); private PostMethod httppost; private InputStreamReader reader;

Parameters:

layerProperties - DOCUMENT ME!

hostname - DOCUMENT ME!

featureType - wfsVersion DOCUMENT ME!

crs - DOCUMENT ME!

styles - DOCUMENT ME!

WFSFeatureFactory

public WFSFeatureFactory(LayerProperties layerProperties,
                         String hostname,
                         FeatureType featureType,
                         Crs crs,
                         Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles,
                         boolean reverseAxisOrder)

private Vector wfsFeatureVector = new Vector(); private PostMethod httppost; private InputStreamReader reader;

Parameters:

layerProperties - DOCUMENT ME!

hostname - DOCUMENT ME!

featureType - wfsVersion DOCUMENT ME!

crs - DOCUMENT ME!

styles - DOCUMENT ME!

reverseAxisOrder - DOCUMENT ME!

WFSFeatureFactory

protected WFSFeatureFactory(WFSFeatureFactory wfsff)

Creates a new WFSFeatureFactory object.

Parameters:

wfsff - DOCUMENT ME!

Method Detail

setHostname

public void setHostname(String hostname)

DOCUMENT ME!

Parameters:

hostname - DOCUMENT ME!

createFeatures

public Vector<WFSFeature> createFeatures(String query,
                                         BoundingBox boundingBox,
                                         SwingWorker workerThread)
                                  throws FeatureFactory.TooManyFeaturesException,
                                         Exception

TODO: Track Progress?

Parameters:

query - DOCUMENT ME!

boundingBox - DOCUMENT ME!

workerThread - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

FeatureFactory.TooManyFeaturesException - DOCUMENT ME!

Exception - DOCUMENT ME!

createAttributes

public Vector createAttributes(SwingWorker workerThread)
                        throws FeatureFactory.TooManyFeaturesException,
                               UnsupportedOperationException,
                               Exception

DOCUMENT ME!

Parameters:

workerThread - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

FeatureFactory.TooManyFeaturesException - DOCUMENT ME!

UnsupportedOperationException - DOCUMENT ME!

Exception - DOCUMENT ME!

initialiseFeature

protected void initialiseFeature(WFSFeature featureServiceFeature,
                                 org.deegree.model.feature.Feature degreeFeature,
                                 boolean evaluateExpressions,
                                 int index)
                          throws Exception

Description copied from class: DegreeFeatureFactory

Perform standard initialisation of a newly created feature.
In gereal, this operation is invokded by the processFeatureCollection operation.

Overrides:

initialiseFeature in class DegreeFeatureFactory<WFSFeature,String>

Parameters:

featureServiceFeature - DOCUMENT ME!

degreeFeature - feature to be initialised

evaluateExpressions - DOCUMENT ME!

index - DOCUMENT ME!

Throws:

Exception - DOCUMENT ME!

See Also:

#processFeatureCollection(javax.swing.SwingWorker, org.deegree2.model.feature.Feature[], boolean)

cleanup

protected void cleanup(InputStreamReader reader,
                       org.apache.commons.httpclient.methods.PostMethod httppost)

DOCUMENT ME!

Parameters:

reader - DOCUMENT ME!

httppost - DOCUMENT ME!

createFeatureInstance

protected WFSFeature createFeatureInstance(org.deegree.model.feature.Feature degreeFeature,
                                           int index)
                                    throws Exception

DOCUMENT ME!

Specified by:

createFeatureInstance in class DegreeFeatureFactory<WFSFeature,String>

Parameters:

degreeFeature - DOCUMENT ME!

index - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

Exception - DOCUMENT ME!

See Also:

#processFeatureCollection(javax.swing.SwingWorker, org.deegree2.model.feature.Feature[], boolean)

convertFeatureQnameToName

public static String convertFeatureQnameToName(QName qname)

DOCUMENT ME!

Parameters:

qname - DOCUMENT ME!

Returns:

DOCUMENT ME!

isGenerateIds

protected boolean isGenerateIds()

DOCUMENT ME!

Specified by:

isGenerateIds in class AbstractFeatureFactory<WFSFeature,String>

Returns:

DOCUMENT ME!

clone

public WFSFeatureFactory clone()

DOCUMENT ME!

Specified by:

clone in interface FeatureFactory<WFSFeature,String>

Specified by:

clone in class AbstractFeatureFactory<WFSFeature,String>

Returns:

DOCUMENT ME!

getCrs

public Crs getCrs()

DOCUMENT ME!

Returns:

the crs

setCrs

public void setCrs(Crs crs)

DOCUMENT ME!

Parameters:

crs - the crs to set

getFeatureCount

public int getFeatureCount(String query,
                           BoundingBox bb)

Description copied from interface: FeatureFactory

DOCUMENT ME!

Parameters:

query - DOCUMENT ME!

bb - DOCUMENT ME!

Returns:

DOCUMENT ME!

createFeatures

public List<WFSFeature> createFeatures(String query,
                                       BoundingBox boundingBox,
                                       SwingWorker workerThread,
                                       int offset,
                                       int limit,
                                       FeatureServiceAttribute[] orderBy)
                                throws FeatureFactory.TooManyFeaturesException,
                                       Exception

Description copied from interface: FeatureFactory

Returns instances of features FT that match the optional query and that fall into the optional BoundingBox.
Applies layerProperties (if set) on all Features (if the type of the feature implements the interface InheritsLayerProperties). The SwingWorker instance can be used to set the progress of the operation and to check the worker thread was canceled. The state of the features list after a the operation was canceled is undefined.

Parameters:

query - optional query of type QT to select the features to be returned

boundingBox - optional BoundingBox to restrict the features to be returned

workerThread - an optional worker thread that is observed

offset - the start index

limit - a limit

orderBy - the attributes, the features should be ordered by

Returns:

a list of matching features of type FT

Throws:

FeatureFactory.TooManyFeaturesException - if the maximum number of features is reached during processing

Exception - if something went wrong during parsing