us.gov.dod.standard.ssrf._3_1.adapter

Class XmlAdapterLAT

java.lang.Object

javax.xml.bind.annotation.adapters.XmlAdapter<String,Number>

us.gov.dod.standard.ssrf._3_1.adapter.AXmlAdapterNumber

us.gov.dod.standard.ssrf._3_1.adapter.XmlAdapterLAT

public class XmlAdapterLAT
extends AXmlAdapterNumber

XML data type adapter for the SSRF Latitude data type.

The geographical latitude (degrees, minutes, seconds and hemisphere N or S) of the Point or center of the Ellipse. Same remarks for seconds and leading zeros. enter N or S immediately following the seconds. The format is: ddmmss.hhH (where ".hh" is optional and H = N or S).

[XSD ERR REGEX] This data item MUST comply to the regular expression: "(((((([0-8][0-9]))([0-5][0-9]){2})(. [0-9]{1,2})?)|900000)(N|S))|X"

Developer note: This Lat is an extension and replacement implementation of the default Lat using a BigDecimal value in Decimal degrees (instead of DMS-encoded string) and relying upon the XmlJavaTypeAdapter for DMS translation.

Version:

3.1.0, 04/04/2015

Author:

Key Bridge LLC

Constructor Summary

Constructors

Constructor and Description
XmlAdapterLAT() Construct a new adapter instance.

Method Summary

Modifier and Type	Method and Description
protected String	getLatHemisphere(Number latitude) Get the latitude hemisphere from a latitude in decimal degrees.
String	marshal(Number v) Convert a value type to a bound type.
Number	unmarshal(String v) Convert a bound type to a value type.

Methods inherited from class us.gov.dod.standard.ssrf._3_1.adapter.AXmlAdapterNumber

convert, getMaxInclusive, getMinInclusive

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XmlAdapterLAT

public XmlAdapterLAT()

Construct a new adapter instance.

Latitude ranges from -90 to +90 degrees.

Allow 9 decimal places; centimeter precision.

Method Detail

unmarshal

public Number unmarshal(String v)
                 throws Exception

Convert a bound type to a value type.

This is called when converting an object to XML.

Overrides:

unmarshal in class AXmlAdapterNumber

Parameters:

v - The value to be convereted. Can be null.

Returns:

the converted value

Throws:

Exception - if there's an error during the conversion. The caller is responsible for reporting the error to the user through ValidationEventHandler.

marshal

public String marshal(Number v)
               throws Exception

Convert a value type to a bound type.

This is called with converting XML to an object.

Overrides:

marshal in class AXmlAdapterNumber

Parameters:

v - The value to be converted. Can be null.

Returns:

the converted value

Throws:

Exception - if there's an error during the conversion. The caller is responsible for reporting the error to the user through ValidationEventHandler.

getLatHemisphere

protected String getLatHemisphere(Number latitude)

Get the latitude hemisphere from a latitude in decimal degrees.

Returns:

the latitude hemisphere: [N]orth or [S]outh