org.geotools.referencing.factory
Class ReferencingFactory

Object
  AbstractFactory
      ReferencingFactory

All Implemented Interfaces:

RegisterableService, Factory

Direct Known Subclasses:

AbstractAuthorityFactory, AbstractCoordinateOperationFactory, DatumAliases, DefaultMathTransformFactory, NADCONGridShiftFactory, NTv2GridShiftFactory, ReferencingFactoryContainer, ReferencingObjectFactory

public class ReferencingFactory
extends AbstractFactory
implements Factory

Base class for all factories in the referencing module. Factories can be grouped in two categories:

• Authority factories creates objects from a compact string defined by an authority.
  These classes are working as "builders": they hold the definition or recipies used to construct an objet.

• Object factories allows applications to make objects that cannot be created by an authority factory. This factory is very flexible, whereas the authority factory is easier to use.
  These classes are working as "Factories": they provide a series of create methods that can be used like a constructor.

Since:

2.1

Author:

Martin Desruisseaux (IRD)

Field Summary

static Logger

LOGGER The logger for event related to Geotools's factories.

Fields inherited from class AbstractFactory

hints, MAXIMUM_PRIORITY, MINIMUM_PRIORITY, NORMAL_PRIORITY, priority

Constructor Summary

protected	ReferencingFactory() Constructs a factory with the default priority.
protected	ReferencingFactory(int priority) Constructs a factory with the specified priority.

Method Summary

protected static void	ensureNonNull(String name, Object object) Makes sure that an argument is non-null.
Citation	getVendor() Returns the vendor responsible for creating this factory implementation.

Methods inherited from class AbstractFactory

addImplementationHints, equals, getImplementationHints, getPriority, hashCode, onDeregistration, onRegistration, toString

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

LOGGER

public static final Logger LOGGER

The logger for event related to Geotools's factories.

Constructor Detail

ReferencingFactory

protected ReferencingFactory()

Constructs a factory with the default priority.

ReferencingFactory

protected ReferencingFactory(int priority)

Constructs a factory with the specified priority.

Parameters:

priority - The priority for this factory, as a number between MINIMUM_PRIORITY and MAXIMUM_PRIORITY inclusive.

Method Detail

getVendor

public Citation getVendor()

Returns the vendor responsible for creating this factory implementation. Many implementations may be available for the same factory interface. The default implementation returns Geotools.

Returns:

The vendor for this factory implementation.

ensureNonNull

protected static void ensureNonNull(String name,
                                    Object object)
                             throws InvalidParameterValueException

Makes sure that an argument is non-null. This is a convenience method for subclass methods.

Parameters:

name - Argument name.

object - User argument.

Throws:

InvalidParameterValueException - if object is null.