org.geolatte.geom.crs

Class CrsId

java.lang.Object

org.geolatte.geom.crs.CrsId

public class CrsId
extends java.lang.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.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	authority
private int	code
static java.lang.String	DEFAULT_AUTHORITY
static CrsId	UNDEFINED Identifies an undefined (or unknown) CrsId.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
java.lang.String	getAuthority() Returns the authority for this CrsId.
int	getCode() Returns the code for this CrsId.
int	hashCode()
static CrsId	parse(java.lang.String srsString) Creates an instance from a String of the form "[<authority>:]<code>".
private static int	toNumericIdentifier(java.lang.String codeStr)
java.lang.String	toString()
java.lang.String	toUrn()
static CrsId	valueOf(int code) Returns a CrsId with the specified code and the EPSG as authority.
static CrsId	valueOf(java.lang.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 java.lang.String DEFAULT_AUTHORITY

See Also:

Constant Field Values

UNDEFINED

public static final CrsId UNDEFINED

Identifies an undefined (or unknown) CrsId.

authority

private final java.lang.String authority

code

private final int code

Constructor Detail

CrsId

public CrsId(java.lang.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(java.lang.String srsString)

Creates an instance from a String of the form "[<authority>:]<code>".

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:

java.lang.IllegalArgumentException - when the string can nog be parsed as

toNumericIdentifier

private static int toNumericIdentifier(java.lang.String codeStr)

valueOf

public static CrsId valueOf(java.lang.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 java.lang.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 java.lang.String toString()

Overrides:

toString in class java.lang.Object

toUrn

public java.lang.String toUrn()

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object