org.geolatte.geom.crs

Class CrsId

java.lang.Object

org.geolatte.geom.crs.CrsId

public class CrsId
extends Object

An identifier for a CoordinateReferenceSystem or other object referenced in a CoordinateReferenceSystem definition.

A commonly used alternative name for CrsId is "SRID".

A CrsId consists of the name of an authority and a numeric identifier. The authority is the organization that is responsible for managing the definition of the identified object.

In practice, CoordinateReferenceSystems are usually identified by their EPSG code, with EPSG the authority for the identifier. In this implementation, EPSG is the default authority.

Author:

Karel Maesen, Geovise BVBA, 2011

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_AUTHORITY
static CrsId	UNDEFINED Identifies an undefined (or unknown) CrsId.

Constructor Summary

Constructors

Constructor and Description
CrsId(String authority, int code) Creates an instance having the specified authority and code.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
String	getAuthority() Returns the authority for this CrsId.
int	getCode() Returns the code for this CrsId.
int	hashCode()
static CrsId	parse(String srsString) Creates an instance from a String of the form "[:].
String	toString()
static CrsId	valueOf(int code) Returns a CrsId with the specified code and the EPSG as authority.
static CrsId	valueOf(String authority, int code) Returns an instance having the specified authority and code.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_AUTHORITY

public static final String DEFAULT_AUTHORITY

See Also:

Constant Field Values

UNDEFINED

public static final CrsId UNDEFINED

Identifies an undefined (or unknown) CrsId.

Constructor Detail

CrsId

public CrsId(String authority,
             int code)

Creates an instance having the specified authority and code.

If authority EPSG and 0 or -1 is passed for the code parameter, a value equal to CrsId.UNDEFINED is returned.

Parameters:

authority - the authority that assigned the code

code - the code for the CoordinateReferenceSystem

Method Detail

parse

public static CrsId parse(String srsString)

Creates an instance from a String of the form "[:].

If the "authority" prefix is missing, then the authority will be assumed to be EPSG.

Parameters:

srsString - the string to parse into a CrsId.

Returns:

Throws:

IllegalArgumentException - when the string can nog be parsed as

valueOf

public static CrsId valueOf(String authority,
                            int code)

Returns an instance having the specified authority and code.

Parameters:

authority - the authority that assigned the code

code - the code for the CoordinateReferenceSystem

Returns:

a CrsId for the specified authority and code.

valueOf

public static CrsId valueOf(int code)

Returns a CrsId with the specified code and the EPSG as authority.

Parameters:

code - the code for the CrsId.

Returns:

a CrsId for the specified code,and EPSG as authority.

getAuthority

public String getAuthority()

Returns the authority for this CrsId.

Returns:

a String representing the authority for this CrsId

getCode

public int getCode()

Returns the code for this CrsId.

Returns:

the numeric code for this CrsId

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object