Package org.kiwiproject.xml

Class KiwiXmlConverters

java.lang.Object

org.kiwiproject.xml.KiwiXmlConverters

public class KiwiXmlConverters
extends Object

Static utilities for converting to/from XML data types, e.g. XMLGregorianCalendar.

Constructor Summary

Constructors

Constructor	Description
KiwiXmlConverters()

Method Summary

Modifier and Type	Method	Description
static XMLGregorianCalendar	dateToXMLGregorianCalendar(Date date)	Converts a Date to an XMLGregorianCalendar in the default time zone.
static XMLGregorianCalendar	dateToXMLGregorianCalendar(Date date, ZoneId zoneId)	Converts a Date to an XMLGregorianCalendar in the given time zone.
static XMLGregorianCalendar	dateToXMLGregorianCalendarUTC(Date date)	Converts a Date to an XMLGregorianCalendar in UTC.
static XMLGregorianCalendar	epochMillisToXMLGregorianCalendar(long epochMillis)	Converts milliseconds since the epoch to an XMLGregorianCalendar object in the default time zone.
static XMLGregorianCalendar	epochMillisToXMLGregorianCalendar(long epochMillis, ZoneId zoneId)	Converts milliseconds since the epoch to an XMLGregorianCalendar object in the given time zone.
static XMLGregorianCalendar	epochMillisToXMLGregorianCalendarUTC(long epochMillis)	Converts milliseconds since the epoch to an XMLGregorianCalendar object in UTC.
static XMLGregorianCalendar	instantToXMLGregorianCalendar(Instant instant)	Converts an Instant object to an XMLGregorianCalendar in the default time zone.
static XMLGregorianCalendar	instantToXMLGregorianCalendar(Instant instant, ZoneId zoneId)	Converts an Instant object to an XMLGregorianCalendar in the given time zone.
static XMLGregorianCalendar	instantToXMLGregorianCalendarUTC(Instant instant)	Converts an Instant object to an XMLGregorianCalendar in UTC.
static XMLGregorianCalendar	newXMLGregorianCalendar()	Create a new XMLGregorianCalendar in the default time zone that is initialized to the current date/time.
static XMLGregorianCalendar	newXMLGregorianCalendar(ZoneId zoneId)	Create a new XMLGregorianCalendar in the given time zone that is initialized to the current date/time.
static XMLGregorianCalendar	newXMLGregorianCalendarUTC()	Create a new XMLGregorianCalendar in UTC that is initialized to the current date/time.
static Date	xmlGregorianCalendarToDate(XMLGregorianCalendar xmlGregorianCalendar)	Given an XMLGregorianCalendar, return its value as a Date.
static long	xmlGregorianCalendarToEpochMillis(XMLGregorianCalendar xmlGregorianCalendar)	Given an XMLGregorianCalendar, return its value in milliseconds since the epoch.
static Instant	xmlGregorianCalendarToInstant(XMLGregorianCalendar xmlGregorianCalendar)	Converts an XMLGregorianCalendar to an Instant.
static LocalDateTime	xmlGregorianCalendarToLocalDateTime(XMLGregorianCalendar xmlGregorianCalendar)	Converts an XMLGregorianCalendar to a LocalDateTime in the default time zone.
static LocalDateTime	xmlGregorianCalendarToLocalDateTime(XMLGregorianCalendar xmlGregorianCalendar, ZoneId zoneId)	Converts an XMLGregorianCalendar to a LocalDateTime using the given ZoneId.

Methods inherited from class java.lang.Object

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

Constructor Detail

KiwiXmlConverters

public KiwiXmlConverters()

Method Detail

newXMLGregorianCalendar

public static XMLGregorianCalendar newXMLGregorianCalendar()

Create a new XMLGregorianCalendar in the default time zone that is initialized to the current date/time.

Returns:

a new instance representing the current date/time

newXMLGregorianCalendarUTC

public static XMLGregorianCalendar newXMLGregorianCalendarUTC()

Create a new XMLGregorianCalendar in UTC that is initialized to the current date/time.

Returns:

a new instance representing the current date/time

newXMLGregorianCalendar

public static XMLGregorianCalendar newXMLGregorianCalendar(ZoneId zoneId)

Create a new XMLGregorianCalendar in the given time zone that is initialized to the current date/time.

Parameters:

zoneId - the time zone for the new GregorianCalendar instance

Returns:

a new instance representing the current date/time

epochMillisToXMLGregorianCalendar

public static XMLGregorianCalendar epochMillisToXMLGregorianCalendar(long epochMillis)

Converts milliseconds since the epoch to an XMLGregorianCalendar object in the default time zone.

Parameters:

epochMillis - number of milliseconds since the epoch

Returns:

a new instance representing the given number of epoch milliseconds

epochMillisToXMLGregorianCalendarUTC

public static XMLGregorianCalendar epochMillisToXMLGregorianCalendarUTC(long epochMillis)

Converts milliseconds since the epoch to an XMLGregorianCalendar object in UTC.

Parameters:

epochMillis - number of milliseconds since the epoch

Returns:

a new instance representing the given number of epoch milliseconds

epochMillisToXMLGregorianCalendar

public static XMLGregorianCalendar epochMillisToXMLGregorianCalendar(long epochMillis,
                                                                     ZoneId zoneId)

Converts milliseconds since the epoch to an XMLGregorianCalendar object in the given time zone.

Parameters:

epochMillis - number of milliseconds since the epoch

zoneId - the time zone for the new GregorianCalendar instance

Returns:

a new instance representing the given number of epoch milliseconds

instantToXMLGregorianCalendar

public static XMLGregorianCalendar instantToXMLGregorianCalendar(Instant instant)

Converts an Instant object to an XMLGregorianCalendar in the default time zone.

Parameters:

instant - the instant object to convert

Returns:

a new instance representing the given instant in time

instantToXMLGregorianCalendarUTC

public static XMLGregorianCalendar instantToXMLGregorianCalendarUTC(Instant instant)

Converts an Instant object to an XMLGregorianCalendar in UTC.

Parameters:

instant - the instant object to convert

Returns:

a new instance representing the given instant in time

instantToXMLGregorianCalendar

public static XMLGregorianCalendar instantToXMLGregorianCalendar(Instant instant,
                                                                 ZoneId zoneId)

Converts an Instant object to an XMLGregorianCalendar in the given time zone.

Parameters:

instant - the instant object to convert

zoneId - the time zone for the new GregorianCalendar instance

Returns:

a new instance representing the given instant in time

dateToXMLGregorianCalendar

public static XMLGregorianCalendar dateToXMLGregorianCalendar(Date date)

Converts a Date to an XMLGregorianCalendar in the default time zone.

Parameters:

date - the date object to convert

Returns:

a new instance representing the given date

dateToXMLGregorianCalendarUTC

public static XMLGregorianCalendar dateToXMLGregorianCalendarUTC(Date date)

Converts a Date to an XMLGregorianCalendar in UTC.

Parameters:

date - the date object to convert

Returns:

a new instance representing the given date

dateToXMLGregorianCalendar

public static XMLGregorianCalendar dateToXMLGregorianCalendar(Date date,
                                                              ZoneId zoneId)

Converts a Date to an XMLGregorianCalendar in the given time zone.

Parameters:

date - the date object to convert

zoneId - the time zone for the new GregorianCalendar instance

Returns:

a new instance representing the given date

xmlGregorianCalendarToInstant

public static Instant xmlGregorianCalendarToInstant(XMLGregorianCalendar xmlGregorianCalendar)

Converts an XMLGregorianCalendar to an Instant.

Parameters:

xmlGregorianCalendar - the XMLGregorianCalendar to convert

Returns:

the instant representing the given XMLGregorianCalendar

xmlGregorianCalendarToLocalDateTime

public static LocalDateTime xmlGregorianCalendarToLocalDateTime(XMLGregorianCalendar xmlGregorianCalendar)

Converts an XMLGregorianCalendar to a LocalDateTime in the default time zone.

Parameters:

xmlGregorianCalendar - the XMLGregorianCalendar to convert

Returns:

the local date/time representing the given XMLGregorianCalendar

xmlGregorianCalendarToLocalDateTime

public static LocalDateTime xmlGregorianCalendarToLocalDateTime(XMLGregorianCalendar xmlGregorianCalendar,
                                                                ZoneId zoneId)

Converts an XMLGregorianCalendar to a LocalDateTime using the given ZoneId.

Parameters:

xmlGregorianCalendar - the XMLGregorianCalendar to convert

zoneId - the time-zone, which may be an offset, not null

Returns:

the local date/time representing the given XMLGregorianCalendar

xmlGregorianCalendarToEpochMillis

public static long xmlGregorianCalendarToEpochMillis(XMLGregorianCalendar xmlGregorianCalendar)

Given an XMLGregorianCalendar, return its value in milliseconds since the epoch.

Parameters:

xmlGregorianCalendar - the XMLGregorianCalendar to convert

Returns:

the epoch milliseconds representing the given XMLGregorianCalendar

xmlGregorianCalendarToDate

public static Date xmlGregorianCalendarToDate(XMLGregorianCalendar xmlGregorianCalendar)

Given an XMLGregorianCalendar, return its value as a Date.

Parameters:

xmlGregorianCalendar - the XMLGregorianCalendar to convert

Returns:

the date representing the given XMLGregorianCalendar