de.cismet.cismap.commons.featureservice.factory

Class AbstractFeatureFactory<FT extends FeatureServiceFeature,QT>

java.lang.Object

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

All Implemented Interfaces:

FeatureFactory<FT,QT>, Cloneable

Direct Known Subclasses:

DegreeFeatureFactory, JDBCFeatureFactory, PostgisFeatureFactory

public abstract class AbstractFeatureFactory<FT extends FeatureServiceFeature,QT>
extends Object
implements FeatureFactory<FT,QT>

Abstract impelementation of a FeatureFactory. Supports re-evaluation of id and annotation expressions.

Version:

$Revision$, $Date$

Author:

Pascal Dihé

Nested Class Summary

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

FeatureFactory.TooManyFeaturesException

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEBUG
protected groovy.lang.GroovyShell	groovyShell
protected int	ID
protected Vector<FT>	lastCreatedfeatureVector
protected com.vividsolutions.jts.geom.Geometry	lastGeom
protected QT	lastQuery
String	layerName
protected LayerProperties	layerProperties
protected org.apache.log4j.Logger	logger
protected int	maxFeatureCount
protected Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>>	styles

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractFeatureFactory() Creates a new AbstractFeatureFactory object.
protected	AbstractFeatureFactory(AbstractFeatureFactory aff) Creates a new AbstractFeatureFactory object.

Method Summary

Modifier and Type	Method and Description
protected boolean	checkCancelled(SwingWorker workerThread, String message) Checks if the worker thread was cancelled and performs cleanup.
abstract AbstractFeatureFactory	clone() DOCUMENT ME!
protected Vector<FT>	createFeaturesFromMemory(QT query, com.vividsolutions.jts.geom.Geometry geom) DOCUMENT ME!
FeatureServiceFeature	createNewFeature() This method must be implemented, if AbstractFeatureService.isEditable().
protected String	evaluateBeanShellExpression(FT feature, String expression) DOCUMENT ME!
protected void	evaluateExpressions(FT feature, int index) Evaluates id an annotation expressions of the current layer properties and applies it to the feature.
protected String	evaluateGroovyExpressions(FT feature, String expression) Evaluates a groovy expression.
protected boolean	featuresAlreadyInMemory(com.vividsolutions.jts.geom.Geometry geom, QT query) DOCUMENT ME!
Vector<FT>	getLastCreatedFeatures() This operation can be used to retrieve the last created features without the need to invoke the createFeatures() operation.
LayerProperties	getLayerProperties() Returns the layerProperties that are applied to all features constructed.
int	getMaxFeatureCount() Returns the maximum number of features that can be returned by this feature factory.
protected List<org.deegree.style.se.unevaluated.Style>	getStyle() DOCUMENT ME!
List<org.deegree.style.se.unevaluated.Style>	getStyle(String layerName) DOCUMENT ME!
protected abstract boolean	isGenerateIds() Determines if the service automatically generates unique IDs for all queryable features.
protected void	reEvaluteExpressions(List<FT> features, SwingWorker workerThread) Re-evaluates the expressions of all features in the list.
protected void	setInterruptedAllowed() DOCUMENT ME!
protected void	setInterruptedNotAllowed() DOCUMENT ME!
void	setLayerName(String layerName) DOCUMENT ME!
void	setLayerProperties(LayerProperties layerProperties) Sets the layerProperties that are applied to all features constructed.
void	setMaxFeatureCount(int maxFeatureCount) Sets the maximum number of features that can be returned by this feature factory and that fall into the specified BoundinfBox respectively.
void	setSLDStyle(Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles) DOCUMENT ME!
protected void	sortFeatureList(List<? extends FeatureServiceFeature> featureList, FeatureServiceAttribute[] attributes) DOCUMENT ME!
protected void	updateLastCreatedFeatures(Collection<FT> features, com.vividsolutions.jts.geom.Geometry geom, QT query) DOCUMENT ME!
void	waitUntilInterruptedIsAllowed() DOCUMENT ME!

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.cismet.cismap.commons.featureservice.factory.FeatureFactory

createAttributes, createFeatures, createFeatures, getFeatureCount

Field Detail

DEBUG

public static final boolean DEBUG

See Also:

Constant Field Values

layerName

public String layerName

ID

protected int ID

logger

protected org.apache.log4j.Logger logger

layerProperties

protected LayerProperties layerProperties

maxFeatureCount

protected int maxFeatureCount

groovyShell

protected groovy.lang.GroovyShell groovyShell

lastCreatedfeatureVector

protected Vector<FT extends FeatureServiceFeature> lastCreatedfeatureVector

styles

protected Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles

lastGeom

protected com.vividsolutions.jts.geom.Geometry lastGeom

lastQuery

protected QT lastQuery

Constructor Detail

AbstractFeatureFactory

protected AbstractFeatureFactory()

Creates a new AbstractFeatureFactory object.

AbstractFeatureFactory

protected AbstractFeatureFactory(AbstractFeatureFactory aff)

Creates a new AbstractFeatureFactory object.

Parameters:

aff - DOCUMENT ME!

Method Detail

waitUntilInterruptedIsAllowed

public void waitUntilInterruptedIsAllowed()

DOCUMENT ME!

setInterruptedAllowed

protected void setInterruptedAllowed()

DOCUMENT ME!

setInterruptedNotAllowed

protected void setInterruptedNotAllowed()

DOCUMENT ME!

setLayerName

public void setLayerName(String layerName)

Description copied from interface: FeatureFactory

DOCUMENT ME!

Specified by:

setLayerName in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Parameters:

layerName - DOCUMENT ME!

setSLDStyle

public void setSLDStyle(Map<String,LinkedList<org.deegree.style.se.unevaluated.Style>> styles)

Description copied from interface: FeatureFactory

DOCUMENT ME!

Specified by:

setSLDStyle in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Parameters:

styles - DOCUMENT ME!

setLayerProperties

public void setLayerProperties(LayerProperties layerProperties)

Description copied from interface: FeatureFactory

Sets the layerProperties that are applied to all features constructed. If the list of the last created features is not empty and any of the expressions of the layer properties changed, the new expressions are applied to the last created features and will be automatically applied to all newly created features.

Specified by:

setLayerProperties in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Parameters:

layerProperties - new LayerProperties

getLayerProperties

public LayerProperties getLayerProperties()

Description copied from interface: FeatureFactory

Returns the layerProperties that are applied to all features constructed.

Specified by:

getLayerProperties in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Returns:

the LayerProperties or null if not set

getMaxFeatureCount

public int getMaxFeatureCount()

Description copied from interface: FeatureFactory

Returns the maximum number of features that can be returned by this feature factory. Since the number of features returned is resticted by the specified BoundingBox a FeatureFactory implementation may be able to allocate more features as specified by maxFeatureCount.

Specified by:

getMaxFeatureCount in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Returns:

the maximum number of features or -1 if not set.

See Also:

CachingFeatureFactory

setMaxFeatureCount

public void setMaxFeatureCount(int maxFeatureCount)

Description copied from interface: FeatureFactory

Sets the maximum number of features that can be returned by this feature factory and that fall into the specified BoundinfBox respectively. If during processing of the BoundinfBox the maximum number is reached the factory throws a TooManyFeaturesException.

Specified by:

setMaxFeatureCount in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Parameters:

maxFeatureCount - the maximum number of features

sortFeatureList

protected void sortFeatureList(List<? extends FeatureServiceFeature> featureList,
                               FeatureServiceAttribute[] attributes)

DOCUMENT ME!

Parameters:

featureList - DOCUMENT ME!

attributes - DOCUMENT ME!

reEvaluteExpressions

protected void reEvaluteExpressions(List<FT> features,
                                    SwingWorker workerThread)

Re-evaluates the expressions of all features in the list. This operation may be called, if new layer properties are applied on cached features.

Parameters:

features - list of caches features

workerThread - DOCUMENT ME!

evaluateExpressions

protected void evaluateExpressions(FT feature,
                                   int index)

Evaluates id an annotation expressions of the current layer properties and applies it to the feature.

Parameters:

feature - to on that the expressions are applied

index - is used as if the evaluation of the id expression fails

evaluateGroovyExpressions

protected String evaluateGroovyExpressions(FT feature,
                                           String expression)

Evaluates a groovy expression.

Parameters:

feature - DOCUMENT ME!

expression - DOCUMENT ME!

Returns:

DOCUMENT ME!

evaluateBeanShellExpression

protected String evaluateBeanShellExpression(FT feature,
                                             String expression)

DOCUMENT ME!

Parameters:

feature - DOCUMENT ME!

expression - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

UnsupportedOperationException - DOCUMENT ME!

checkCancelled

protected boolean checkCancelled(SwingWorker workerThread,
                                 String message)

Checks if the worker thread was cancelled and performs cleanup.

Parameters:

workerThread - DOCUMENT ME!

message - DOCUMENT ME!

Returns:

true if the worker thread was cancelled

getLastCreatedFeatures

public Vector<FT> getLastCreatedFeatures()

Description copied from interface: FeatureFactory

This operation can be used to retrieve the last created features without the need to invoke the createFeatures() operation. It returns a copy of the internal features vector of the factory to provent concurrent modification exceptions.

Specified by:

getLastCreatedFeatures in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Returns:

the features created during the last call to createFeatures()

isGenerateIds

protected abstract boolean isGenerateIds()

Determines if the service automatically generates unique IDs for all queryable features. Note that if this operation returns true, the id expression is not evaluated.

Returns:

true if the service generates id}

updateLastCreatedFeatures

protected void updateLastCreatedFeatures(Collection<FT> features,
                                         com.vividsolutions.jts.geom.Geometry geom,
                                         QT query)

DOCUMENT ME!

Parameters:

features - DOCUMENT ME!

geom - DOCUMENT ME!

query - DOCUMENT ME!

createNewFeature

public FeatureServiceFeature createNewFeature()

Description copied from interface: FeatureFactory

This method must be implemented, if AbstractFeatureService.isEditable().

Specified by:

createNewFeature in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Returns:

a new object with a valid id

featuresAlreadyInMemory

protected boolean featuresAlreadyInMemory(com.vividsolutions.jts.geom.Geometry geom,
                                          QT query)

DOCUMENT ME!

Parameters:

geom - DOCUMENT ME!

query - DOCUMENT ME!

Returns:

DOCUMENT ME!

createFeaturesFromMemory

protected Vector<FT> createFeaturesFromMemory(QT query,
                                              com.vividsolutions.jts.geom.Geometry geom)
                                       throws FeatureFactory.TooManyFeaturesException,
                                              Exception

DOCUMENT ME!

Parameters:

query - DOCUMENT ME!

geom - DOCUMENT ME!

Returns:

DOCUMENT ME!

Throws:

FeatureFactory.TooManyFeaturesException - DOCUMENT ME!

Exception - DOCUMENT ME!

clone

public abstract AbstractFeatureFactory clone()

Description copied from interface: FeatureFactory

DOCUMENT ME!

Specified by:

clone in interface FeatureFactory<FT extends FeatureServiceFeature,QT>

Overrides:

clone in class Object

Returns:

DOCUMENT ME!

getStyle

protected List<org.deegree.style.se.unevaluated.Style> getStyle()

DOCUMENT ME!

Returns:

DOCUMENT ME!

getStyle

public List<org.deegree.style.se.unevaluated.Style> getStyle(String layerName)

DOCUMENT ME!

Parameters:

layerName - DOCUMENT ME!

Returns:

DOCUMENT ME!