Java Doc for BufferedAuthorityFactory.java in » GIS » GeoTools-2.4.1 » org » geotools » referencing » factory » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation

1.	6.0 JDK Core
2.	6.0 JDK Modules
3.	6.0 JDK Modules com.sun
4.	6.0 JDK Modules com.sun.java
5.	6.0 JDK Modules sun
6.	6.0 JDK Platform
7.	Ajax
8.	Apache Harmony Java SE
9.	Aspect oriented
10.	Authentication Authorization
11.	Blogger System
12.	Build
13.	Byte Code
14.	Cache
15.	Chart
16.	Chat
17.	Code Analyzer
18.	Collaboration
19.	Content Management System
20.	Database Client
21.	Database DBMS
22.	Database JDBC Connection Pool
23.	Database ORM
24.	Development
25.	EJB Server geronimo
26.	EJB Server GlassFish
27.	EJB Server JBoss 4.2.1
28.	EJB Server resin 3.1.5
29.	ERP CRM Financial
30.	ESB
31.	Forum
32.	GIS
33.	Graphic Library
34.	Groupware
35.	HTML Parser
36.	IDE
37.	IDE Eclipse
38.	IDE Netbeans
39.	Installer
40.	Internationalization Localization
41.	Inversion of Control
42.	Issue Tracking
43.	J2EE
44.	JBoss
45.	JMS
46.	JMX
47.	Library
48.	Mail Clients
49.	Net
50.	Parser
51.	PDF
52.	Portal
53.	Profiler
54.	Project Management
55.	Report
56.	RSS RDF
57.	Rule Engine
58.	Science
59.	Scripting
60.	Search Engine
61.	Security
62.	Sevlet Container
63.	Source Control
64.	Swing Library
65.	Template Engine
66.	Test Coverage
67.	Testing
68.	UML
69.	Web Crawler
70.	Web Framework
71.	Web Mail
72.	Web Server
73.	Web Services
74.	Web Services apache cxf 2.0.1
75.	Web Services AXIS2
76.	Wiki Engine
77.	Workflow Engines
78.	XML
79.	XML UI

Java

Java Tutorial

Illustrator Tutorials

GIMP Tutorials

C# / C Sharp

C# / CSharp Tutorial

C# / CSharp Open Source

SQL Server / T-SQL Tutorial

Oracle PL / SQL

Oracle PL/SQL Tutorial

Flash / Flex / ActionScript

VBA / Excel / Access / Word

XML

XML Tutorial

Microsoft Office PowerPoint 2007 Tutorial

Microsoft Office Excel 2007 Tutorial

Microsoft Office Word 2007 Tutorial

Java Source Code / Java Documentation » GIS » GeoTools 2.4.1 » org.geotools.referencing.factory

Source Cross Reference

Class Diagram

Java Document (Java Doc)

org.geotools.referencing.factory .ReferencingFactory

org.geotools.referencing.factory .AbstractAuthorityFactory

org.geotools.referencing.factory .BufferedAuthorityFactory

All known Subclasses:   org.geotools.referencing .DefaultAuthorityFactory,  org.geotools.referencing.factory .DeferredAuthorityFactory,
BufferedAuthorityFactory
public class BufferedAuthorityFactory extends AbstractAuthorityFactory implements BufferedFactory(Code)
An authority factory that caches all objects created by an other factory. All createFoo(String) methods first looks if a previously created object exists for the given code. If such an object exists, it is returned. Otherwise, the object creation is delegated to the specified at creation time, and the result is cached in this buffered factory.
Objects are cached by strong references, up to the amount of objects specified at construction time. If a greater amount of objects are cached, the oldest ones will be retained through a instead of a strong one. This means that this buffered factory will continue to returns them as long as they are in use somewhere else in the Java virtual machine, but will be discarted (and recreated on the fly if needed) otherwise.
since:
   2.1
version:
   $Id: BufferedAuthorityFactory.java 26078 2007-06-28 15:00:59Z desruisseaux $
author:
   Martin Desruisseaux

Field Summary
final static int DEFAULT_MAX
     The default value for BufferedAuthorityFactory.maxStrongReferences .
AbstractAuthorityFactory backingStore
     The underlying authority factory.

Constructor Summary
protected BufferedAuthorityFactory(AbstractAuthorityFactory factory)
     Constructs an instance wrapping the specified factory with a default number of entries to keep by strong reference.
This constructor is protected because subclasses must declare which of the DatumAuthorityFactory , CSAuthorityFactory , CRSAuthorityFactory and CoordinateOperationAuthorityFactory interfaces they choose to implement.
Parameters:
  factory - The factory to cache.
protected BufferedAuthorityFactory(AbstractAuthorityFactory factory, int maxStrongReferences)
     Constructs an instance wrapping the specified factory.
BufferedAuthorityFactory(int priority, int maxStrongReferences)
     Constructs an instance without initial backing store.

Method Summary
final void completeHints()
     Completes the set of hints according the value currently set in this object.
public synchronized CartesianCS createCartesianCS(String code)
     Returns a cartesian coordinate system from a code.
public synchronized CompoundCRS createCompoundCRS(String code)
     Returns a 3D coordinate reference system from a code.
public synchronized CoordinateOperation createCoordinateOperation(String code)
     Returns an operation from a single operation code.
public synchronized CoordinateReferenceSystem createCoordinateReferenceSystem(String code)
     Returns an arbitrary coordinate reference system from a code.
public synchronized CoordinateSystem createCoordinateSystem(String code)
     Returns an arbitrary coordinate system from a code.
public synchronized CoordinateSystemAxis createCoordinateSystemAxis(String code)
     Returns a coordinate system axis from a code.
public synchronized CylindricalCS createCylindricalCS(String code)
     Returns a cylindrical coordinate system from a code.
public synchronized Datum createDatum(String code)
     Returns an arbitrary datum from a code.
public synchronized DerivedCRS createDerivedCRS(String code)
     Returns a derived coordinate reference system from a code.
public synchronized Ellipsoid createEllipsoid(String code)
     Returns an ellipsoid from a code.
public synchronized EllipsoidalCS createEllipsoidalCS(String code)
     Returns an ellipsoidal coordinate system from a code.
public synchronized EngineeringCRS createEngineeringCRS(String code)
     Returns an engineering coordinate reference system from a code.
public synchronized EngineeringDatum createEngineeringDatum(String code)
     Returns an engineering datum from a code.
public synchronized Extent createExtent(String code)
     Returns an extent (usually an area of validity) from a code.
public synchronized Set createFromCoordinateReferenceSystemCodes(String sourceCode, String targetCode)
     Returns an operation from coordinate reference system codes.
public synchronized GeocentricCRS createGeocentricCRS(String code)
     Returns a geocentric coordinate reference system from a code.
public synchronized GeodeticDatum createGeodeticDatum(String code)
     Returns a geodetic datum from a code.
public synchronized GeographicCRS createGeographicCRS(String code)
     Returns a geographic coordinate reference system from a code.
public synchronized ImageCRS createImageCRS(String code)
     Returns an image coordinate reference system from a code.
public synchronized ImageDatum createImageDatum(String code)
     Returns an image datum from a code.
public synchronized IdentifiedObject createObject(String code)
     Returns an arbitrary object from a code.
public synchronized OperationMethod createOperationMethod(String code)
     Returns an operation method from a code.
public synchronized ParameterDescriptor createParameterDescriptor(String code)
     Returns a parameter descriptor from a code.
public synchronized PolarCS createPolarCS(String code)
     Returns a polar coordinate system from a code.
public synchronized PrimeMeridian createPrimeMeridian(String code)
     Returns a prime meridian from a code.
public synchronized ProjectedCRS createProjectedCRS(String code)
     Returns a projected coordinate reference system from a code.
public synchronized SphericalCS createSphericalCS(String code)
     Returns a spherical coordinate system from a code.
public synchronized TemporalCRS createTemporalCRS(String code)
     Returns a temporal coordinate reference system from a code.
public synchronized TemporalDatum createTemporalDatum(String code)
     Returns a temporal datum from a code.
public synchronized TimeCS createTimeCS(String code)
     Returns a temporal coordinate system from a code.
public synchronized Unit createUnit(String code)
     Returns an unit from a code.
public synchronized VerticalCRS createVerticalCRS(String code)
     Returns a vertical coordinate reference system from a code.
public synchronized VerticalCS createVerticalCS(String code)
     Returns a vertical coordinate system from a code.
public synchronized VerticalDatum createVerticalDatum(String code)
     Returns a vertical datum from a code.
Collection dependencies()
     Returns the direct dependencies.
public synchronized void dispose()
     Releases resources immediately instead of waiting for the garbage collector.
public synchronized Citation getAuthority()
     Returns the organization or party responsible for definition and maintenance of the underlying database.
public synchronized Set getAuthorityCodes(Class type)
     Returns the set of authority codes of the given type.
AbstractAuthorityFactory getBackingStore()
     Returns the backing store authority factory.
public synchronized String getBackingStoreDescription()
     Returns a description of the underlying backing store, or null if unknow.
public synchronized InternationalString getDescriptionText(String code)
     Gets a description of the object corresponding to a code.
Parameters:
  code - Value allocated by authority.
public synchronized IdentifiedObjectFinder getIdentifiedObjectFinder(Class type)
     Returns a finder which can be used for looking up unidentified objects.
public synchronized Citation getVendor()
     Returns the vendor responsible for creating the underlying factory implementation.
synchronized boolean isAvailable()
     Returns true if this factory is available.
boolean sameAuthorityCodes(AuthorityFactory factory)
     If this factory is a wrapper for the specified factory that do not add any additional , returns true .

Field Detail
DEFAULT_MAX
final static int DEFAULT_MAX(Code)
The default value for BufferedAuthorityFactory.maxStrongReferences .

backingStore
AbstractAuthorityFactory backingStore(Code)
The underlying authority factory. This field may be null if this object was created by the . In this case, the subclass is responsible for creating the backing store when DeferredAuthorityFactory.createBackingStore is invoked.
See Also:   BufferedAuthorityFactory.getBackingStore
See Also:   DeferredAuthorityFactory.createBackingStore

Constructor Detail
BufferedAuthorityFactory
protected BufferedAuthorityFactory(AbstractAuthorityFactory factory)(Code)
Constructs an instance wrapping the specified factory with a default number of entries to keep by strong reference.
This constructor is protected because subclasses must declare which of the DatumAuthorityFactory , CSAuthorityFactory , CRSAuthorityFactory and CoordinateOperationAuthorityFactory interfaces they choose to implement.
Parameters:
  factory - The factory to cache. Can not be null .

BufferedAuthorityFactory
protected BufferedAuthorityFactory(AbstractAuthorityFactory factory, int maxStrongReferences)(Code)
Constructs an instance wrapping the specified factory. The maxStrongReferences argument specify the maximum number of objects to keep by strong reference. If a greater amount of objects are created, then the strong references for the oldest ones are replaced by weak references.
This constructor is protected because subclasses must declare which of the DatumAuthorityFactory , CSAuthorityFactory , CRSAuthorityFactory and CoordinateOperationAuthorityFactory interfaces they choose to implement.
Parameters:
  factory - The factory to cache. Can not be null .
Parameters:
  maxStrongReferences - The maximum number of objects to keep by strong reference.

BufferedAuthorityFactory
BufferedAuthorityFactory(int priority, int maxStrongReferences)(Code)
Constructs an instance without initial backing store. This constructor is for subclass constructors only. Subclasses are responsible for creating an appropriate backing store when the DeferredAuthorityFactory.createBackingStore method is invoked.
Parameters:
  priority - The priority for this factory, as a number betweenBufferedAuthorityFactory.MINIMUM_PRIORITY MINIMUM_PRIORITY andBufferedAuthorityFactory.MAXIMUM_PRIORITY MAXIMUM_PRIORITY inclusive.
Parameters:
  maxStrongReferences - The maximum number of objects to keep by strong reference.
See Also:   DeferredAuthorityFactory.createBackingStore

Method Detail
completeHints
final void completeHints()(Code)
Completes the set of hints according the value currently set in this object. This method is invoked by BufferedAuthorityFactory or by DeferredAuthorityFactory at backing store creation time.
The backing store is of course an important dependency. This method gives a chance to org.geotools.factory.FactoryRegistry to compare the user-requested hints (especially Hints.FORCE_LONGITUDE_FIRST_AXIS_ORDER ) against the backing store hints, by following the dependency declared there.
DON'T FORGET to set those hints to null when DeferredAuthorityFactory dispose the backing store.

createCartesianCS
public synchronized CartesianCS createCartesianCS(String code) throws FactoryException(Code)
Returns a cartesian coordinate system from a code.

createCompoundCRS
public synchronized CompoundCRS createCompoundCRS(String code) throws FactoryException(Code)
Returns a 3D coordinate reference system from a code.

createCoordinateOperation
public synchronized CoordinateOperation createCoordinateOperation(String code) throws FactoryException(Code)
Returns an operation from a single operation code.
since:
   2.2

createCoordinateReferenceSystem
public synchronized CoordinateReferenceSystem createCoordinateReferenceSystem(String code) throws FactoryException(Code)
Returns an arbitrary coordinate reference system from a code.

createCoordinateSystem
public synchronized CoordinateSystem createCoordinateSystem(String code) throws FactoryException(Code)
Returns an arbitrary coordinate system from a code.

createCoordinateSystemAxis
public synchronized CoordinateSystemAxis createCoordinateSystemAxis(String code) throws FactoryException(Code)
Returns a coordinate system axis from a code.

createCylindricalCS
public synchronized CylindricalCS createCylindricalCS(String code) throws FactoryException(Code)
Returns a cylindrical coordinate system from a code.

createDatum
public synchronized Datum createDatum(String code) throws FactoryException(Code)
Returns an arbitrary datum from a code.

createDerivedCRS
public synchronized DerivedCRS createDerivedCRS(String code) throws FactoryException(Code)
Returns a derived coordinate reference system from a code.

createEllipsoid
public synchronized Ellipsoid createEllipsoid(String code) throws FactoryException(Code)
Returns an ellipsoid from a code.

createEllipsoidalCS
public synchronized EllipsoidalCS createEllipsoidalCS(String code) throws FactoryException(Code)
Returns an ellipsoidal coordinate system from a code.

createEngineeringCRS
public synchronized EngineeringCRS createEngineeringCRS(String code) throws FactoryException(Code)
Returns an engineering coordinate reference system from a code.

createEngineeringDatum
public synchronized EngineeringDatum createEngineeringDatum(String code) throws FactoryException(Code)
Returns an engineering datum from a code.

createExtent
public synchronized Extent createExtent(String code) throws FactoryException(Code)
Returns an extent (usually an area of validity) from a code.

createFromCoordinateReferenceSystemCodes
public synchronized Set createFromCoordinateReferenceSystemCodes(String sourceCode, String targetCode) throws FactoryException(Code)
Returns an operation from coordinate reference system codes.
since:
   2.2

createGeocentricCRS
public synchronized GeocentricCRS createGeocentricCRS(String code) throws FactoryException(Code)
Returns a geocentric coordinate reference system from a code.

createGeodeticDatum
public synchronized GeodeticDatum createGeodeticDatum(String code) throws FactoryException(Code)
Returns a geodetic datum from a code.

createGeographicCRS
public synchronized GeographicCRS createGeographicCRS(String code) throws FactoryException(Code)
Returns a geographic coordinate reference system from a code.

createImageCRS
public synchronized ImageCRS createImageCRS(String code) throws FactoryException(Code)
Returns an image coordinate reference system from a code.

createImageDatum
public synchronized ImageDatum createImageDatum(String code) throws FactoryException(Code)
Returns an image datum from a code.

createObject
public synchronized IdentifiedObject createObject(String code) throws FactoryException(Code)
Returns an arbitrary object from a code.

createOperationMethod
public synchronized OperationMethod createOperationMethod(String code) throws FactoryException(Code)
Returns an operation method from a code.
since:
   2.2

createParameterDescriptor
public synchronized ParameterDescriptor createParameterDescriptor(String code) throws FactoryException(Code)
Returns a parameter descriptor from a code.
since:
   2.2

createPolarCS
public synchronized PolarCS createPolarCS(String code) throws FactoryException(Code)
Returns a polar coordinate system from a code.

createPrimeMeridian
public synchronized PrimeMeridian createPrimeMeridian(String code) throws FactoryException(Code)
Returns a prime meridian from a code.

createProjectedCRS
public synchronized ProjectedCRS createProjectedCRS(String code) throws FactoryException(Code)
Returns a projected coordinate reference system from a code.

createSphericalCS
public synchronized SphericalCS createSphericalCS(String code) throws FactoryException(Code)
Returns a spherical coordinate system from a code.

createTemporalCRS
public synchronized TemporalCRS createTemporalCRS(String code) throws FactoryException(Code)
Returns a temporal coordinate reference system from a code.

createTemporalDatum
public synchronized TemporalDatum createTemporalDatum(String code) throws FactoryException(Code)
Returns a temporal datum from a code.

createTimeCS
public synchronized TimeCS createTimeCS(String code) throws FactoryException(Code)
Returns a temporal coordinate system from a code.

createUnit
public synchronized Unit createUnit(String code) throws FactoryException(Code)
Returns an unit from a code.

createVerticalCRS
public synchronized VerticalCRS createVerticalCRS(String code) throws FactoryException(Code)
Returns a vertical coordinate reference system from a code.

createVerticalCS
public synchronized VerticalCS createVerticalCS(String code) throws FactoryException(Code)
Returns a vertical coordinate system from a code.

createVerticalDatum
public synchronized VerticalDatum createVerticalDatum(String code) throws FactoryException(Code)
Returns a vertical datum from a code.

dependencies
Collection dependencies()(Code)
Returns the direct dependencies. The returned list contains the backing store specified at construction time, or the exception if it can't be obtained.

dispose
public synchronized void dispose() throws FactoryException(Code)
Releases resources immediately instead of waiting for the garbage collector.

getAuthority
public synchronized Citation getAuthority()(Code)
Returns the organization or party responsible for definition and maintenance of the underlying database.

getAuthorityCodes
public synchronized Set getAuthorityCodes(Class type) throws FactoryException(Code)
Returns the set of authority codes of the given type. The type argument specify the base class.
Parameters:
  type - The spatial reference objects type. The set of authority codes for spatial reference objects of the given type.If this factory doesn't contains any object of the given type, then this methodreturns an .
throws:
  FactoryException - if access to the underlying database failed.

getBackingStore
AbstractAuthorityFactory getBackingStore() throws FactoryException(Code)
Returns the backing store authority factory. The backing store to uses in createXXX(...) methods.
throws:
  FactoryException - if the creation of backing store failed.

getBackingStoreDescription
public synchronized String getBackingStoreDescription() throws FactoryException(Code)
Returns a description of the underlying backing store, or null if unknow. This is for example the database software used for storing the data.
throws:
  FactoryException - if a failure occured while fetching the engine description.

getDescriptionText
public synchronized InternationalString getDescriptionText(String code) throws FactoryException(Code)
Gets a description of the object corresponding to a code.
Parameters:
  code - Value allocated by authority. A description of the object, or null if the objectcorresponding to the specified code has no description.
throws:
  NoSuchAuthorityCodeException - if the specified code was not found.
throws:
  FactoryException - if the query failed for some other reason.

getIdentifiedObjectFinder
public synchronized IdentifiedObjectFinder getIdentifiedObjectFinder(Class type) throws FactoryException(Code)
Returns a finder which can be used for looking up unidentified objects. The default implementation delegates lookup to the underlying backing store and caches the result.
since:
   2.4

getVendor
public synchronized Citation getVendor()(Code)
Returns the vendor responsible for creating the underlying factory implementation.

isAvailable
synchronized boolean isAvailable()(Code)
Returns true if this factory is available. The default implementation returns false if no backing store were setup and DeferredAuthorityFactory.createBackingStore throws an exception.

sameAuthorityCodes
boolean sameAuthorityCodes(AuthorityFactory factory)(Code)
If this factory is a wrapper for the specified factory that do not add any additional , returns true . This method is for FallbackAuthorityFactory internal use only and should not be public. A cheap test without BufferedAuthorityFactory.getBackingStore invocation is suffisient for our needs.

Methods inherited from org.geotools.referencing.factory.AbstractAuthorityFactory
public CartesianCS createCartesianCS(String code) throws FactoryException(Code)(Java Doc)
public CompoundCRS createCompoundCRS(String code) throws FactoryException(Code)(Java Doc)
public CoordinateOperation createCoordinateOperation(String code) throws FactoryException(Code)(Java Doc)
public CoordinateReferenceSystem createCoordinateReferenceSystem(String code) throws FactoryException(Code)(Java Doc)
public CoordinateSystem createCoordinateSystem(String code) throws FactoryException(Code)(Java Doc)
public CoordinateSystemAxis createCoordinateSystemAxis(String code) throws FactoryException(Code)(Java Doc)
public CylindricalCS createCylindricalCS(String code) throws FactoryException(Code)(Java Doc)
public Datum createDatum(String code) throws FactoryException(Code)(Java Doc)
public DerivedCRS createDerivedCRS(String code) throws FactoryException(Code)(Java Doc)
public Ellipsoid createEllipsoid(String code) throws FactoryException(Code)(Java Doc)
public EllipsoidalCS createEllipsoidalCS(String code) throws FactoryException(Code)(Java Doc)
public EngineeringCRS createEngineeringCRS(String code) throws FactoryException(Code)(Java Doc)
public EngineeringDatum createEngineeringDatum(String code) throws FactoryException(Code)(Java Doc)
public Extent createExtent(String code) throws FactoryException(Code)(Java Doc)
public Set createFromCoordinateReferenceSystemCodes(String sourceCode, String targetCode) throws FactoryException(Code)(Java Doc)
public GeocentricCRS createGeocentricCRS(String code) throws FactoryException(Code)(Java Doc)
public GeodeticDatum createGeodeticDatum(String code) throws FactoryException(Code)(Java Doc)
public GeographicCRS createGeographicCRS(String code) throws FactoryException(Code)(Java Doc)
public ImageCRS createImageCRS(String code) throws FactoryException(Code)(Java Doc)
public ImageDatum createImageDatum(String code) throws FactoryException(Code)(Java Doc)
public IdentifiedObject createObject(String code) throws FactoryException(Code)(Java Doc)
public OperationMethod createOperationMethod(String code) throws FactoryException(Code)(Java Doc)
public ParameterDescriptor createParameterDescriptor(String code) throws FactoryException(Code)(Java Doc)
public PolarCS createPolarCS(String code) throws FactoryException(Code)(Java Doc)
public PrimeMeridian createPrimeMeridian(String code) throws FactoryException(Code)(Java Doc)
public ProjectedCRS createProjectedCRS(String code) throws FactoryException(Code)(Java Doc)
public SphericalCS createSphericalCS(String code) throws FactoryException(Code)(Java Doc)
public TemporalCRS createTemporalCRS(String code) throws FactoryException(Code)(Java Doc)
public TemporalDatum createTemporalDatum(String code) throws FactoryException(Code)(Java Doc)
public TimeCS createTimeCS(String code) throws FactoryException(Code)(Java Doc)
public Unit createUnit(String code) throws FactoryException(Code)(Java Doc)
public VerticalCRS createVerticalCRS(String code) throws FactoryException(Code)(Java Doc)
public VerticalCS createVerticalCS(String code) throws FactoryException(Code)(Java Doc)
public VerticalDatum createVerticalDatum(String code) throws FactoryException(Code)(Java Doc)
public void dispose() throws FactoryException(Code)(Java Doc)
abstract public Citation getAuthority()(Code)(Java Doc)
public String getBackingStoreDescription() throws FactoryException(Code)(Java Doc)
public IdentifiedObjectFinder getIdentifiedObjectFinder(Class type) throws FactoryException(Code)(Java Doc)
boolean isAvailable()(Code)(Java Doc)
final protected NoSuchAuthorityCodeException noSuchAuthorityCode(Class type, String code)(Code)(Java Doc)
boolean sameAuthorityCodes(AuthorityFactory factory)(Code)(Java Doc)
protected String trimAuthority(String code)(Code)(Java Doc)

Fields inherited from org.geotools.referencing.factory.ReferencingFactory
final static Citation ALL(Code)(Java Doc)
final public static Logger LOGGER(Code)(Java Doc)

Methods inherited from org.geotools.referencing.factory.ReferencingFactory
Collection dependencies()(Code)(Java Doc)
protected static void ensureNonNull(String name, Object object) throws InvalidParameterValueException(Code)(Java Doc)
public Citation getVendor()(Code)(Java Doc)

www.java2java.com | Contact Us

All other trademarks are property of their respective owners.