com.prowidesoftware.swift.model.mx.adapters

Class ZonedDateTimeAdapter

java.lang.Object

javax.xml.bind.annotation.adapters.XmlAdapter<java.lang.String,javax.xml.datatype.XMLGregorianCalendar>

com.prowidesoftware.swift.model.mx.adapters.ZonedDateTimeAdapter

public class ZonedDateTimeAdapter
extends javax.xml.bind.annotation.adapters.XmlAdapter<java.lang.String,javax.xml.datatype.XMLGregorianCalendar>

XMLGregorianCalendar adapter for date time elements.

Marshals the date time as a local time with UTC offset format YYYY-MM-DDThh:mm:ss[.sss]+/-hh:mm which is aligned with ISO 8601. Dislike the default jaxb implementation, this adapter will always print the offset, and for UTC times in particular an explicit '+00:00' offset is used instead of the 'Z'. The fractional seconds is printed only when it is different than zero.

Notice the configured adapter in the model is the IsoDateTimeAdapter wrapper class, but you can pass this default implementation or your own in the constructor.

Since:

9.2.6

See Also:

TypeAdaptersConfiguration

Constructor Summary

Constructors

Constructor and Description
ZonedDateTimeAdapter() Creates a date time adapter with the default format
ZonedDateTimeAdapter(java.text.SimpleDateFormat dateFormat) Creates a time adapter with a specific given format that will be used for both the marshalling and unmarshalling
ZonedDateTimeAdapter(javax.xml.bind.annotation.adapters.XmlAdapter<java.lang.String,javax.xml.datatype.XMLGregorianCalendar> customAdapterImpl) Creates a date time adapter injecting a custom implementation

Method Summary

Modifier and Type	Method and Description
java.lang.String	marshal(javax.xml.datatype.XMLGregorianCalendar cal) Applies the configured format to the calendar.
javax.xml.datatype.XMLGregorianCalendar	unmarshal(java.lang.String value) Creates a calendar parsing the value with this adapter format, or the default lexical representation as fallback.

Methods inherited from class java.lang.Object

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

Constructor Detail

ZonedDateTimeAdapter

public ZonedDateTimeAdapter()

Creates a date time adapter with the default format

ZonedDateTimeAdapter

public ZonedDateTimeAdapter(java.text.SimpleDateFormat dateFormat)

Creates a time adapter with a specific given format that will be used for both the marshalling and unmarshalling

ZonedDateTimeAdapter

public ZonedDateTimeAdapter(javax.xml.bind.annotation.adapters.XmlAdapter<java.lang.String,javax.xml.datatype.XMLGregorianCalendar> customAdapterImpl)

Creates a date time adapter injecting a custom implementation

Method Detail

unmarshal

public javax.xml.datatype.XMLGregorianCalendar unmarshal(java.lang.String value)
                                                  throws java.lang.Exception

Creates a calendar parsing the value with this adapter format, or the default lexical representation as fallback.

Specified by:

unmarshal in class javax.xml.bind.annotation.adapters.XmlAdapter<java.lang.String,javax.xml.datatype.XMLGregorianCalendar>

Parameters:

value - the XML date time value to convert

Returns:

created calendar object or null if cannot be parsed

Throws:

java.lang.Exception

marshal

public java.lang.String marshal(javax.xml.datatype.XMLGregorianCalendar cal)
                         throws java.lang.Exception

Applies the configured format to the calendar. If the formats ends with an offset, and the calendar is an UTC date time, we uses an explicit '+00:00' instead of the 'Z' code.

Specified by:

marshal in class javax.xml.bind.annotation.adapters.XmlAdapter<java.lang.String,javax.xml.datatype.XMLGregorianCalendar>

Parameters:

cal - the model calendar to marshal

Returns:

formatted content for the XML

Throws:

java.lang.Exception