org.geotools.referencing.factory
Class IdentifiedObjectSet

java.lang.Object
  extended byjava.util.AbstractCollection
      extended byjava.util.AbstractSet
          extended byorg.geotools.referencing.factory.IdentifiedObjectSet
All Implemented Interfaces:
java.util.Collection, java.io.Serializable, java.util.Set

public class IdentifiedObjectSet
extends java.util.AbstractSet
implements java.io.Serializable

A lazy set of identified objects. This set creates IdentifiedObjects from authority codes only when first needed. This class is typically used as the set returned by implementations of the createFromCoordinateReferenceSystemCodes method. Deferred creation in this case may have great performance impact since a set may contains about 40 entries (e.g. transformations from "ED50" (EPSG:4230) to "WGS 84" (EPSG:4326)) while some users only want to look for the first entry (e.g. the default AuthorityBackedFactory implementation).

Exception handling

If the underlying factory failed to creates an object because of an unsupported operation method (NoSuchIdentifierException), the exception is logged with the FINE level (because this is a recoverable failure) and the iteration continue. If the operation creation failed for any other kind of reason (FactoryException), then the exception is rethrown as an unchecked BackingStoreException. This default behavior can be changed if a subclass overrides the isRecoverableFailure method.

Serialization

Serialization of this class force the immediate creation of all identified objects not yet created. The serialized set is disconnected from the underlying factory.

Thread safety

This class is not thread-safe.

Since:
2.2
Version:
$Id: IdentifiedObjectSet.java 17672 2006-01-19 00:25:55Z desruisseaux $
Author:
Martin Desruisseaux
See Also:
Serialized Form

Field Summary
protected  org.opengis.referencing.AuthorityFactory factory
          The factory to use for creating identified objects when first needed.
 
Constructor Summary
IdentifiedObjectSet(org.opengis.referencing.AuthorityFactory factory)
          Creates an initially empty set.
 
Method Summary
 boolean add(java.lang.Object object)
          Ensures that this collection contains the specified object.
 boolean addAuthorityCode(java.lang.String code)
          Ensures that this collection contains an object for the specified authority code.
 void clear()
          Removes all of the elements from this collection.
 boolean contains(java.lang.Object object)
          Returns if this collection contains the specified object.
protected  org.opengis.referencing.IdentifiedObject createObject(java.lang.String code)
          Creates an object for the specified authority code.
protected  java.lang.String getAuthorityCode(org.opengis.referencing.IdentifiedObject object)
          Returns the code to uses as a key for the specified object.
 java.lang.String[] getAuthorityCodes()
          Returns the authority code of all objects in this set.
protected  boolean isRecoverableFailure(org.opengis.referencing.FactoryException exception)
          Returns if the specified exception should be handled as a recoverable failure.
 java.util.Iterator iterator()
          Returns an iterator over the objects in this set.
 boolean remove(java.lang.Object object)
          Removes a single instance of the specified element from this collection, if it is present.
 boolean removeAll(java.util.Collection collection)
          Removes from this collection all of its elements that are contained in the specified collection.
 void resolve(int n)
          Ensures that the n first objects in this set are created.
 void setAuthorityCodes(java.lang.String[] codes)
          Set the content of this set as an array of authority codes.
 int size()
          Returns the number of objects available in this set.
protected  java.lang.Object writeReplace()
          Returns a serializable copy of this set.
 
Methods inherited from class java.util.AbstractSet
equals, hashCode
 
Methods inherited from class java.util.AbstractCollection
addAll, containsAll, isEmpty, retainAll, toArray, toArray, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.Set
addAll, containsAll, isEmpty, retainAll, toArray, toArray
 

Field Detail

factory

protected final org.opengis.referencing.AuthorityFactory factory
The factory to use for creating identified objects when first needed.

Constructor Detail

IdentifiedObjectSet

public IdentifiedObjectSet(org.opengis.referencing.AuthorityFactory factory)
Creates an initially empty set. The IdentifiedObjects will be created when first needed using the specified factory.

Parameters:
factory - The factory to use for deferred IdentifiedObjects creations.
Method Detail

clear

public void clear()
Removes all of the elements from this collection.

Specified by:
clear in interface java.util.Set

size

public int size()
Returns the number of objects available in this set. Note that this number may decrease during the iteration process if the creation of some identified objects failed.

Specified by:
size in interface java.util.Set

addAuthorityCode

public boolean addAuthorityCode(java.lang.String code)
Ensures that this collection contains an object for the specified authority code. The identified object will be created from the specified code only when first needed. This method returns if this set changed as a result of this call.


add

public boolean add(java.lang.Object object)
Ensures that this collection contains the specified object. This set do not allows multiple objects for the same authority code. If this set already contains an object using the same authority code than the specified one, then the old object is replaced by the new one even if the objects are not otherwise identical.

Specified by:
add in interface java.util.Set

contains

public boolean contains(java.lang.Object object)
Returns if this collection contains the specified object.

Specified by:
contains in interface java.util.Set

remove

public boolean remove(java.lang.Object object)
Removes a single instance of the specified element from this collection, if it is present.

Specified by:
remove in interface java.util.Set

removeAll

public boolean removeAll(java.util.Collection collection)
Removes from this collection all of its elements that are contained in the specified collection.

Specified by:
removeAll in interface java.util.Set

iterator

public java.util.Iterator iterator()
Returns an iterator over the objects in this set. If the iteration encounter any kind of FactoryException other than NoSuchIdentifierException, then the exception will be rethrown as an unchecked BackingStoreException.

Specified by:
iterator in interface java.util.Set

resolve

public void resolve(int n)
             throws org.opengis.referencing.FactoryException
Ensures that the n first objects in this set are created. This method is typically invoked after some calls to addAuthorityCode(java.lang.String) in order to make sure that the underlying factory is really capable to create at least one object. FactoryException (except the ones accepted as recoverable failures) are thrown as if they were never wrapped into BackingStoreException.

Parameters:
n - The number of object to resolve. If this number is equals or greater than the set's size, then the creation of all objects is garantee successful.
Throws:
org.opengis.referencing.FactoryException - if an object creation failed.

getAuthorityCodes

public java.lang.String[] getAuthorityCodes()
Returns the authority code of all objects in this set. The returned array contains the codes in iteration order. This method do not trig the creation of any new object.

This method is typically used together with setAuthorityCodes(java.lang.String[]) for altering the iteration order on the basis of authority codes.


setAuthorityCodes

public void setAuthorityCodes(java.lang.String[] codes)
Set the content of this set as an array of authority codes. For any code in the given list, this method will preserve the corresponding identified object if it was already created. Other objects will be created only when first needed, as usual in this implementation.

This method is typically used together with getAuthorityCodes() for altering the iteration order on the basis of authority codes. If the specified array contains the same elements than getAuthorityCodes() in a different order, then this method just set the new ordering.

See Also:
addAuthorityCode(java.lang.String)

getAuthorityCode

protected java.lang.String getAuthorityCode(org.opengis.referencing.IdentifiedObject object)
Returns the code to uses as a key for the specified object. The default implementation returns the code of the first identifier, if any, or the code of theprimary name otherwise. Subclasses may overrides this method if they want to use a different key for this set.


createObject

protected org.opengis.referencing.IdentifiedObject createObject(java.lang.String code)
                                                         throws org.opengis.referencing.FactoryException
Creates an object for the specified authority code. This method is invoked during the iteration process if an object was not already created. The default implementation invokes factory.createObject(code). Subclasses may override this method if they want to invoke a more specific method.

Throws:
org.opengis.referencing.FactoryException

isRecoverableFailure

protected boolean isRecoverableFailure(org.opengis.referencing.FactoryException exception)
Returns if the specified exception should be handled as a recoverable failure. This method is invoked during the iteration process if the factory failed to create some object. If this method returns for the given exception, then the exception will be logged in the Geotools factory logger with the FINE level. If this method returns , then the exception will be retrown as a BackingStoreException. The default implementation returns only for NoSuchIdentifierException (not to be confused with NoSuchAuthorityCodeException).


writeReplace

protected java.lang.Object writeReplace()
                                 throws java.io.ObjectStreamException
Returns a serializable copy of this set. This method is invoked automatically during serialization. The serialised set of identified objects is disconnected from the underlying factory.

Throws:
java.io.ObjectStreamException


Copyright © GeoTools. All Rights Reserved.