Spec-Zone.ru › OpenJDK 8

Класс DatatypeFactory

  • java.lang.Object
    • javax.xml.datatype.DatatypeFactory

public abstract class DatatypeFactory
extends Object

Фабрика, создающая новые объекты javax.xml.datatype Object, которые отображают XML в/из Java Object.

Новый экземпляр DatatypeFactory создаётся с помощью метода newInstance(), который использует следующие механизмы разрешения реализации для определения реализации:

  1. Если существует системная переменная, заданная свойством DATATYPEFACTORY_PROPERTY, "javax.xml.datatype.DatatypeFactory", создаётся класс с именем значения свойства. Любое исключение, выброшенное во время процесса создания экземпляра, обертывается как DatatypeConfigurationException.
  2. Если существует файл ${JAVA_HOME}/lib/jaxp.properties, он загружается в объект Properties Object. Затем запрашивается свойство Properties Object , как описано в предыдущем шаге, и обрабатывается, как описано в предыдущем шаге.
  3. Используются средства загрузки поставщиков услуг, определённые классом ServiceLoader, для попытки найти и загрузить реализацию сервиса с помощью стандартного механизма загрузки: средства загрузки поставщиков услуг будут использовать класc загрузки контекста текущего потока для попытки загрузки сервиса. Если класс загрузки контекста равен null, будет использован системный класс загрузки.
    В случае service configuration error будет выброшено исключение DatatypeConfigurationException.
  4. Последний механизм — попытка создания экземпляра Class, заданного свойством DATATYPEFACTORY_IMPLEMENTATION_CLASS. Любое исключение, выброшенное во время процесса создания экземпляра, обертывается как DatatypeConfigurationException.
С момента:
1.5
Версия:
$Revision: 1.13 $, $Date: 2010/03/11 23:10:53 $

Поля

Модификатор и тип Поле и описание
static String DATATYPEFACTORY_IMPLEMENTATION_CLASS

Имя класса реализации по умолчанию, как определено в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.
static String DATATYPEFACTORY_PROPERTY

Имя свойства по умолчанию, как определено в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.

Краткое описание конструкторов

Модификатор Конструктор и описание
protected DatatypeFactory()

Защищённый конструктор для предотвращения создания экземпляров вне пакета.

Краткое описание методов

Модификатор и тип Метод и описание
abstract Duration newDuration(boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

Получение нового экземпляра Duration, задавая Duration как isPositive, годы, месяцы, дни, часы, минуты, секунды.
Duration newDuration(boolean isPositive, int years, int months, int days, int hours, int minutes, int seconds)

Получение нового экземпляра Duration, задавая Duration как isPositive, годы, месяцы, дни, часы, минуты, секунды.
abstract Duration newDuration(long durationInMilliSeconds)

Получение нового экземпляра Duration, задавая Duration как миллисекунды.
abstract Duration newDuration(String lexicalRepresentation)

Получение нового экземпляра Duration, задавая Duration как строковое представление "PnYnMnDTnHnMnS", как определено в разделе 3.2.6.1 спецификации XML Schema 1.0.
Duration newDurationDayTime(boolean isPositive, BigInteger day, BigInteger hour, BigInteger minute, BigInteger second)

Создание Duration типа xdt:dayTimeDuration, используя указанные day, hour, minute и second, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.
Duration newDurationDayTime(boolean isPositive, int day, int hour, int minute, int second)

Создание Duration типа xdt:dayTimeDuration, используя указанные day, hour, minute и second, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.
Duration newDurationDayTime(long durationInMilliseconds)

Создание Duration типа xdt:dayTimeDuration, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.
Duration newDurationDayTime(String lexicalRepresentation)

Создание Duration типа xdt:dayTimeDuration, используя его строковое представление "PnDTnHnMnS", XQuery 1.0 и XPath 2.0 Data Model, xdt:dayTimeDuration.
Duration newDurationYearMonth(boolean isPositive, BigInteger year, BigInteger month)

Создание Duration типа xdt:yearMonthDuration, используя указанные year и month, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
Duration newDurationYearMonth(boolean isPositive, int year, int month)

Создание Duration типа xdt:yearMonthDuration, используя указанные year и month, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
Duration newDurationYearMonth(long durationInMilliseconds)

Создание Duration типа xdt:yearMonthDuration, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
Duration newDurationYearMonth(String lexicalRepresentation)

Создание Duration типа xdt:yearMonthDuration, используя его строковое представление "PnYnM", XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.
static DatatypeFactory newInstance()

Получение нового экземпляра DatatypeFactory.
static DatatypeFactory newInstance(String factoryClassName, ClassLoader classLoader)

Получение нового экземпляра DatatypeFactory по имени класса.
abstract XMLGregorianCalendar newXMLGregorianCalendar()

Создание нового экземпляра XMLGregorianCalendar.
abstract XMLGregorianCalendar newXMLGregorianCalendar(BigInteger year, int month, int day, int hour, int minute, int second, BigDecimal fractionalSecond, int timezone)

Конструктор, позволяющий использовать все пространства значений, разрешённые рекомендацией W3C XML Schema 1.0 для xsd:dateTime и родственных встроенных типов данных.
abstract XMLGregorianCalendar newXMLGregorianCalendar(GregorianCalendar cal)

Создание XMLGregorianCalendar из объекта GregorianCalendar.
XMLGregorianCalendar newXMLGregorianCalendar(int year, int month, int day, int hour, int minute, int second, int millisecond, int timezone)

Конструктор пространств значений, которые экземпляр java.util.GregorianCalendar должен преобразовать в экземпляр XMLGregorianCalendar.
abstract XMLGregorianCalendar newXMLGregorianCalendar(String lexicalRepresentation)

Создание XMLGregorianCalendar, анализируя строку как лексическое представление.
XMLGregorianCalendar newXMLGregorianCalendarDate(int year, int month, int day, int timezone)

Создание Java-представления встроенного типа данных XML Schema date или g*.
XMLGregorianCalendar newXMLGregorianCalendarTime(int hours, int minutes, int seconds, BigDecimal fractionalSecond, int timezone)

Создание Java-экземпляра типа данных XML Schema time.
XMLGregorianCalendar newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int timezone)

Создание Java-экземпляра встроенного типа данных XML Schema time.
XMLGregorianCalendar newXMLGregorianCalendarTime(int hours, int minutes, int seconds, int milliseconds, int timezone)

Создание Java-экземпляра типа данных XML Schema time.

Методы, унаследованные от класса java.lang.Object

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

Поля

DATATYPEFACTORY_PROPERTY

public static final String DATATYPEFACTORY_PROPERTY

Имя свойства по умолчанию, определенное в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.

Значение по умолчанию — javax.xml.datatype.DatatypeFactory.

См. также:
Значения константных полей

DATATYPEFACTORY_IMPLEMENTATION_CLASS

public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS

Имя класса реализации по умолчанию, определенное в JSR 206: Java(TM) API для обработки XML (JAXP) 1.3.

Реализующие должны указать имя соответствующего класса для экземпляризации, если никакой другой механизм разрешения реализации не увенчался успехом.

Пользователи не должны ссылаться на это поле; оно предназначено только для документирования детали реализации фабрики.

Конструкторы

DatatypeFactory

protected DatatypeFactory()

Защищенный конструктор для предотвращения экземпляризации за пределами пакета.

Используйте newInstance() для создания DatatypeFactory.

Методы

newInstance

public static DatatypeFactory newInstance()
                                   throws DatatypeConfigurationException

Получить новый экземпляр DatatypeFactory.

Механизмы разрешения реализации определены в документации этого Class.

Возвращает:
Новый экземпляр DatatypeFactory
Исключения:
DatatypeConfigurationException - Если реализация недоступна или не может быть создана.
См. также:
newInstance(String factoryClassName, ClassLoader classLoader)

newInstance

public static DatatypeFactory newInstance(String factoryClassName,
                                          ClassLoader classLoader)
                                   throws DatatypeConfigurationException

Получить новый экземпляр DatatypeFactory по имени класса. Эта функция полезна, когда в классе пути несколько поставщиков. Она предоставляет больше контроля приложению, позволяя указать, какой поставщик должен быть загружен.

После того как приложение получило ссылку на DatatypeFactory, оно может использовать фабрику для конфигурирования и получения экземпляров типов данных.

Совет по устранению неполадок

Установка системного свойства jaxp.debug заставит этот метод выводить много отладочных сообщений в System.err о выполняемых действиях и местах поиска.

Если у вас возникли проблемы, попробуйте:

java -Djaxp.debug=1 YourProgram ....
Параметры:
factoryClassName - полное имя класса фабрики, предоставляющей реализацию javax.xml.datatype.DatatypeFactory.
classLoader - ClassLoader, используемый для загрузки класса фабрики. Если null, используется текущий Thread контекста загрузчика класса.
Возвращает:
Новый экземпляр DatatypeFactory
Исключения:
DatatypeConfigurationException - если factoryClassName является null, или класс фабрики не может быть загружен или экземпляризован.
С:
1.6
См. также:
newInstance()

newDuration

public abstract Duration newDuration(String lexicalRepresentation)

Получить новый экземпляр Duration, указав Duration как строковое представление, "PnYnMnDTnHnMnS", как определено в спецификации XML Schema 1.0, раздел 3.2.6.1.

Часть 2 спецификации XML Schema: Типы данных, 3.2.6 продолжительность, определяет duration как:

продолжительность представляет длительность времени. Пространство значений продолжительности — шестимерное пространство, где координаты обозначают компоненты григорианского года, месяца, дня, часа, минуты и секунды, определенные в разделе 5.5.3.2 [ISO 8601], соответственно. Эти компоненты упорядочены по значимости в соответствии с порядком их появления, т. е. как год, месяц, день, час, минута и секунда.

Все шесть значений установлены и доступны из созданного Duration

Спецификация XML Schema утверждает, что значения могут иметь произвольную длину. Реализации могут отказаться от поддержки или не быть способны поддерживать произвольно большие и/или малые значения. UnsupportedOperationException будет брошен с сообщением, указывающим пределы реализации, если пределы возможностей реализации превышены.

Параметры:
lexicalRepresentation - String представление Duration.
Возвращает:
Новый Duration, созданный из парсинга lexicalRepresentation.
Исключения:
IllegalArgumentException - Если lexicalRepresentation не является допустимым представлением Duration.
UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.
NullPointerException - если lexicalRepresentation является null.

newDuration

public abstract Duration newDuration(long durationInMilliSeconds)

Получить новый экземпляр Duration, указав Duration как миллисекунды.

Часть 2 спецификации XML Schema: Типы данных, 3.2.6 продолжительность, определяет duration как:

продолжительность представляет длительность времени. Пространство значений продолжительности — шестимерное пространство, где координаты обозначают компоненты григорианского года, месяца, дня, часа, минуты и секунды, определенные в разделе 5.5.3.2 [ISO 8601], соответственно. Эти компоненты упорядочены по значимости в соответствии с порядком их появления, т. е. как год, месяц, день, час, минута и секунда.

Все шесть значений устанавливаются путем вычисления их значений из указанных миллисекунд и доступны с помощью методов get созданного Duration. Значения соответствуют и определяются:

  • ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
  • W3C XML Schema 1.0 Часть 2, Приложение D, Форматы дат и времени ISO 8601
  • XMLGregorianCalendar Сопоставление полей типа данных даты/времени между XML Schema 1.0 и представлением Java

Значение по умолчанию для начального экземпляра определено использованием GregorianCalendar начала эпохи: т.е., Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 и т.д. Это важно, так как существуют вариации в григорианском календаре, например, високосные годы имеют разные дни в месяце = Calendar.FEBRUARY, поэтому результат Duration.getMonths() и Duration.getDays() может быть изменён.

Параметры:
durationInMilliSeconds - Продолжительность в миллисекундах для создания.
Возвращает:
Новый Duration, представляющий durationInMilliSeconds.

newDuration

public abstract Duration newDuration(boolean isPositive,
                                     BigInteger years,
                                     BigInteger months,
                                     BigInteger days,
                                     BigInteger hours,
                                     BigInteger minutes,
                                     BigDecimal seconds)

Получить новый экземпляр Duration, указав Duration как isPositive, года, месяца, дни, часы, минуты, секунды.

Спецификация XML Schema утверждает, что значения могут иметь произвольную длину. Реализации могут отказаться от поддержки или не быть способны поддерживать произвольно большие и/или малые значения. UnsupportedOperationException будет брошен с сообщением, указывающим пределы реализации, если пределы возможностей реализации превышены.

Значение null указывает, что поле не установлено.

Параметры:
isPositive - Установите в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр будет проигнорирован.
years - этого Duration
months - этого Duration
days - этого Duration
hours - этого Duration
minutes - этого Duration
seconds - этого Duration
Возвращает:
Новый Duration, созданный из указанных значений.
Исключения:
IllegalArgumentException - Если значения не представляют собой допустимое представление Duration: если все поля (годы, месяцы, ...) равны null или если какое-либо из полей отрицательно.
UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.

newDuration

public Duration newDuration(boolean isPositive,
                            int years,
                            int months,
                            int days,
                            int hours,
                            int minutes,
                            int seconds)

Получить новый экземпляр Duration, указав Duration как isPositive, года, месяца, дни, часы, минуты, секунды.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Параметры:
isPositive - Установите в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр будет проигнорирован.
years - этого Duration
months - этого Duration
days - этого Duration
hours - этого Duration
minutes - этого Duration
seconds - этого Duration
Возвращает:
Новый Duration, созданный из указанных значений.
Исключения:
IllegalArgumentException - Если значения не представляют собой допустимое представление Duration: если какое-либо из полей отрицательно.
См. также:
newDuration( boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

newDurationDayTime

public Duration newDurationDayTime(String lexicalRepresentation)

Создайте объект типа xdt:dayTimeDuration, разобрав его представление в формате String, "PnDTnHnMnS", XQuery 1.0 и XPath 2.0 Модель данных, xdt:dayTimeDuration.

Тип данных xdt:dayTimeDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты день, час, минута и секунда. Этот тип данных находится в пространстве имён http://www.w3.org/2003/11/xpath-datatypes.

Все четыре значения установлены и доступны из созданного объекта Duration

Спецификация XML Schema утверждает, что значения могут иметь произвольный размер. Реализации могут выбрать не поддерживать или не быть способными поддерживать произвольно большие и/или малые значения. Будет брошено исключение UnsupportedOperationException с сообщением, указывающим пределы реализации, если возможности реализации будут превышены.

Параметры:
lexicalRepresentation — Лексическое представление продолжительности.
Возвращает:
Новый объект Duration, созданный с помощью указанного lexicalRepresentation.
Выбрасывает:
IllegalArgumentException — Если lexicalRepresentation не является допустимым представлением продолжительности, выраженной только в днях и времени.
UnsupportedOperationException — Если реализация не может поддерживать запрошенные значения.
NullPointerException — Если lexicalRepresentation имеет значение null.

newDurationDayTime

public Duration newDurationDayTime(long durationInMilliseconds)

Создайте объект Duration типа xdt:dayTimeDuration, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Модель данных, xdt:dayTimeDuration.

Тип данных xdt:dayTimeDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты день, час, минута и секунда. Этот тип данных находится в пространстве имён http://www.w3.org/2003/11/xpath-datatypes.

Все четыре значения устанавливаются, вычисляясь из указанных миллисекунд, и доступны с помощью методов get созданного объекта Duration. Значения соответствуют и определяются:

  • ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
  • W3C XML Schema 1.0 Часть 2, Приложение D, Форматы дат и времени ISO 8601
  • XMLGregorianCalendar Сопоставление полей типа данных даты/времени между XML Schema 1.0 и представлением Java

Установленная начальная точка определяется использованием началом эпохи в GregorianCalendar: т.е., Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 и т.д. Это важно, так как существуют вариации в григорианском календаре, например, високосные годы имеют разные дни в месяце = Calendar.FEBRUARY, поэтому результат Duration.getDays() может быть подвержен влиянию.

Любые оставшиеся миллисекунды после определения дня, часа, минуты и секунды отбрасываются.

Параметры:
durationInMilliseconds — Миллисекунды Duration для создания.
Возвращает:
Новый объект Duration, созданный с указанными durationInMilliseconds.
См. также:
XQuery 1.0 и XPath 2.0 Модель данных, xdt:dayTimeDuration

newDurationDayTime

public Duration newDurationDayTime(boolean isPositive,
                                   BigInteger day,
                                   BigInteger hour,
                                   BigInteger minute,
                                   BigInteger second)

Создайте объект Duration типа xdt:dayTimeDuration, используя указанные day, hour, minute и second, как определено в XQuery 1.0 и XPath 2.0 Модель данных, xdt:dayTimeDuration.

Тип данных xdt:dayTimeDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты день, час, минута и секунда. Этот тип данных находится в пространстве имён http://www.w3.org/2003/11/xpath-datatypes.

Спецификация XML Schema утверждает, что значения могут иметь произвольный размер. Реализации могут выбрать не поддерживать или не быть способными поддерживать произвольно большие и/или малые значения. Будет брошено исключение UnsupportedOperationException с сообщением, указывающим пределы реализации, если возможности реализации будут превышены.

Значение null указывает, что поле не установлено.

Параметры:
isPositive — Устанавливается в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр будет проигнорирован.
day — День продолжительности.
hour — Час продолжительности.
minute — Минута продолжительности.
second — Секунда продолжительности.
Возвращает:
Новый объект Duration, созданный с указанными day, hour, minute и second.
Выбрасывает:
IllegalArgumentException — Если значения не являются допустимым представлением продолжительности: если все поля (день, час, ...) равны null или любое из полей отрицательно.
UnsupportedOperationException — Если реализация не может поддерживать запрошенные значения.

newDurationDayTime

public Duration newDurationDayTime(boolean isPositive,
                                   int day,
                                   int hour,
                                   int minute,
                                   int second)

Создайте объект Duration типа xdt:dayTimeDuration, используя указанные day, hour, minute и second, как определено в XQuery 1.0 и XPath 2.0 Модель данных, xdt:dayTimeDuration.

Тип данных xdt:dayTimeDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты день, час, минута и секунда. Этот тип данных находится в пространстве имён http://www.w3.org/2003/11/xpath-datatypes.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Параметры:
isPositive — Устанавливается в false для создания отрицательной продолжительности. Когда длина продолжительности равна нулю, этот параметр будет проигнорирован.
day — День продолжительности.
hour — Час продолжительности.
minute — Минута продолжительности.
second — Секунда продолжительности.
Возвращает:
Новый объект Duration, созданный с указанными day, hour, minute и second.
Выбрасывает:
IllegalArgumentException — Если значения не являются допустимым представлением продолжительности: если любое из полей (день, час, ...) отрицательно.

newDurationYearMonth

public Duration newDurationYearMonth(String lexicalRepresentation)

Создайте объект Duration типа xdt:yearMonthDuration, разобрав его представление в формате String, "PnYnM", XQuery 1.0 и XPath 2.0 Модель данных, xdt:yearMonthDuration.

Тип данных xdt:yearMonthDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты год и месяц. Этот тип данных находится в пространстве имён XMLConstants.W3C_XPATH_DATATYPE_NS_URI.

Оба значения устанавливаются и доступны из созданного объекта Duration

Спецификация XML Schema утверждает, что значения могут иметь произвольный размер. Реализации могут выбрать не поддерживать или не быть способными поддерживать произвольно большие и/или малые значения. Будет брошено исключение UnsupportedOperationException с сообщением, указывающим пределы реализации, если возможности реализации будут превышены.

Параметры:
lexicalRepresentation — Лексическое представление продолжительности.
Возвращает:
Новый объект Duration, созданный с помощью указанного lexicalRepresentation.
Выбрасывает:
IllegalArgumentException — Если lexicalRepresentation не является допустимым представлением продолжительности, выраженной только в годах и месяцах.
UnsupportedOperationException — Если реализация не может поддерживать запрошенные значения.
NullPointerException — Если lexicalRepresentation имеет значение null.

newDurationYearMonth

public Duration newDurationYearMonth(long durationInMilliseconds)

Создайте Duration типа xdt:yearMonthDuration, используя указанные миллисекунды, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.

Тип данных xdt:yearMonthDuration является подтипом xs:duration, чьё лексическое представление содержит только компоненты года и месяца. Этот тип данных находится в пространстве имён XMLConstants.W3C_XPATH_DATATYPE_NS_URI.

Оба значения устанавливаются, вычисляясь из указанных миллисекунд, и доступны с помощью методов get созданного Duration. Значения соответствуют и определяются:

  • ISO 8601:2000(E) Раздел 5.5.3.2 Альтернативный формат
  • W3C XML Schema 1.0 Часть 2, Приложение D, Форматы дат и времени ISO 8601
  • XMLGregorianCalendar Сопоставление полей типа данных Дата/Время между XML Schema 1.0 и представлением Java

Значение по умолчанию для начальной инстанции определяется использованием GregorianCalendar начала эпохи: т.е., Calendar.YEAR = 1970, Calendar.MONTH = Calendar.JANUARY, Calendar.DATE = 1 и т.д. Это важно, поскольку в григорианском календаре есть вариации, например, високосные годы имеют разные дни в месяце = Calendar.FEBRUARY, поэтому результат вызова Duration.getMonths() может быть повлиян.

Любые оставшиеся миллисекунды после определения года и месяца отбрасываются.

Параметры:
durationInMilliseconds - Миллисекунды Duration для создания.
Возвращает:
Новый Duration, созданный с использованием указанных durationInMilliseconds.

newDurationYearMonth

public Duration newDurationYearMonth(boolean isPositive,
                                     BigInteger year,
                                     BigInteger month)

Создайте Duration типа xdt:yearMonthDuration, используя указанные year и month, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.

Спецификация XML Schema утверждает, что значения могут иметь произвольный размер. Реализации могут выбрать не поддерживать или неспособны поддерживать произвольно большие и/или малые значения. Будет брошено исключение UnsupportedOperationException с сообщением, указывающим на ограничения реализации, если будут превышены возможности реализации.

Значение null указывает, что поле не установлено.

Параметры:
isPositive - Установите в false, чтобы создать отрицательную продолжительность. Когда длительность равна нулю, этот параметр будет проигнорирован.
year - Год Duration.
month - Месяц Duration.
Возвращает:
Новый Duration, созданный с использованием указанных year и month.
Вызывает исключение:
IllegalArgumentException - Если значения не являются допустимым представлением Duration: если все поля (год, месяц) равны null или если любое из полей отрицательно.
UnsupportedOperationException - Если реализация не может поддерживать запрошенные значения.

newDurationYearMonth

public Duration newDurationYearMonth(boolean isPositive,
                                     int year,
                                     int month)

Создайте Duration типа xdt:yearMonthDuration, используя указанные year и month, как определено в XQuery 1.0 и XPath 2.0 Data Model, xdt:yearMonthDuration.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Параметры:
isPositive - Установите в false, чтобы создать отрицательную продолжительность. Когда длительность равна нулю, этот параметр будет проигнорирован.
year - Год Duration.
month - Месяц Duration.
Возвращает:
Новый Duration, созданный с использованием указанных year и month.
Вызывает исключение:
IllegalArgumentException - Если значения не являются допустимым представлением Duration: если любое из полей (год, месяц) отрицательно.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar()

Создать новый экземпляр XMLGregorianCalendar.

Все поля типа данных дата/время установлены в DatatypeConstants.FIELD_UNDEFINED или null.

Возвращает:
Новый XMLGregorianCalendar со всеми полями типа данных дата/время, установленными в DatatypeConstants.FIELD_UNDEFINED или null.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(String lexicalRepresentation)

Создайте новый XMLGregorianCalendar, разобрав строку как лексическое представление.

Разбор лексического строкового представления определён в XML Schema 1.0 Часть 2, Раздел 3.2.[7-14].1, Лексическое представление.

Строковое представление не должно содержать пробелов в начале и в конце.

Разбор выполняется по полю, поэтому для любой лексически корректной строки x выполняется:

newXMLGregorianCalendar(x).toXMLFormat().equals(x)

За исключением указанных несовпадений лексического/канонического представления, перечисленных в XML Schema 1.0 исправления, Раздел 3.2.7.2.

Параметры:
lexicalRepresentation - Лексическое представление одного из восьми типов данных дата/время XML Schema.
Возвращает:
XMLGregorianCalendar, созданный из lexicalRepresentation.
Вызывает исключение:
IllegalArgumentException - Если lexicalRepresentation не является допустимым XMLGregorianCalendar.
NullPointerException - Если lexicalRepresentation является null.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(GregorianCalendar cal)

Создайте XMLGregorianCalendar из GregorianCalendar.

Преобразование поле за полем из GregorianCalendar в XMLGregorianCalendar
java.util.GregorianCalendar поле javax.xml.datatype.XMLGregorianCalendar поле
ERA == GregorianCalendar.BC ? -YEAR : YEAR XMLGregorianCalendar.setYear(int year)
MONTH + 1 XMLGregorianCalendar.setMonth(int month)
DAY_OF_MONTH XMLGregorianCalendar.setDay(int day)
HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND XMLGregorianCalendar.setTime(int hour, int minute, int second, BigDecimal fractional)
(ZONE_OFFSET + DST_OFFSET) / (60*1000)
(в минутах) 		XMLGregorianCalendar.setTimezone(int offset)*

*потеря информации при преобразовании. Невозможно представить идентификатор часового пояса летнего времени java.util.GregorianCalendar в представлении типа данных дата/время XML Schema 1.0.

Для вычисления поля TimeZone возвращаемого значения,

  • если this.getTimezone() != FIELD_UNDEFINED, создать java.util.TimeZone с пользовательским идентификатором часового пояса, используя this.getTimezone().
  • в противном случае использовать значение часового пояса по умолчанию GregorianCalendar для хоста, определённое в соответствии со спецификацией java.util.TimeZone.getDefault().
Параметры:
cal - java.util.GregorianCalendar, используемый для создания XMLGregorianCalendar
Возвращает:
XMLGregorianCalendar, созданный из java.util.GregorianCalendar
Вызывает исключение:
NullPointerException - Если cal является null.

newXMLGregorianCalendar

public abstract XMLGregorianCalendar newXMLGregorianCalendar(BigInteger year,
                                                             int month,
                                                             int day,
                                                             int hour,
                                                             int minute,
                                                             int second,
                                                             BigDecimal fractionalSecond,
                                                             int timezone)

Конструктор, позволяющий использовать все пространства значений, разрешённые рекомендацией W3C XML Schema 1.0 для xsd:dateTime и связанных встроенных типов данных. Обратите внимание, что параметр year поддерживает произвольно большие числа, а fractionalSecond имеет бесконечную точность.

Значение null указывает, что поле не установлено.

Параметры:
year - для XMLGregorianCalendar, который будет создан.
month - для XMLGregorianCalendar, который будет создан.
day - для XMLGregorianCalendar, который будет создан.
hour - для XMLGregorianCalendar, который будет создан.
minute - для XMLGregorianCalendar, который будет создан.
second - для XMLGregorianCalendar, который будет создан.
fractionalSecond - для XMLGregorianCalendar, который будет создан.
timezone - для XMLGregorianCalendar, который будет создан.
Возвращает:
XMLGregorianCalendar, созданный из указанных значений.
Вызывает исключение:
IllegalArgumentException - Если значение любого отдельного параметра выходит за пределы максимального ограничения значения для поля, как определено в таблице сопоставления данных Дата/Время в XMLGregorianCalendar, или если составные значения образуют недопустимый XMLGregorianCalendar экземпляр, как определено в XMLGregorianCalendar.isValid().

newXMLGregorianCalendar

public XMLGregorianCalendar newXMLGregorianCalendar(int year,
                                                    int month,
                                                    int day,
                                                    int hour,
                                                    int minute,
                                                    int second,
                                                    int millisecond,
                                                    int timezone)

Конструктор пространства значений, которое экземпляр java.util.GregorianCalendar должен преобразовать в экземпляр XMLGregorianCalendar.

XMLGregorianCalendar eon и fractionalSecond установлены в null

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не установлено.

Параметры:
year - для создаваемого XMLGregorianCalendar.
month - для создаваемого XMLGregorianCalendar.
day - для создаваемого XMLGregorianCalendar.
hour - для создаваемого XMLGregorianCalendar.
minute - для создаваемого XMLGregorianCalendar.
second - для создаваемого XMLGregorianCalendar.
millisecond - для создаваемого XMLGregorianCalendar.
timezone - для создаваемого XMLGregorianCalendar.
Возвращаемое значение:
XMLGregorianCalendar, созданный из указанных значений.
Исключения:
IllegalArgumentException - если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют недопустимый экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().

newXMLGregorianCalendarDate

public XMLGregorianCalendar newXMLGregorianCalendarDate(int year,
                                                        int month,
                                                        int day,
                                                        int timezone)

Создать Java-представление встроенного типа данных XML Schema date или g*.

Например, экземпляр gYear можно создать, вызвав этот фабричный метод с параметрами month и day, установленными в DatatypeConstants.FIELD_UNDEFINED.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Параметры:
year - для создаваемого XMLGregorianCalendar.
month - для создаваемого XMLGregorianCalendar.
day - для создаваемого XMLGregorianCalendar.
timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не задано.
Возвращаемое значение:
XMLGregorianCalendar, созданный из значений параметров.
Исключения:
IllegalArgumentException - если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют недопустимый экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().
См. также:
DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int timezone)

Создать Java-экземпляр встроенного типа данных XML Schema time.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Параметры:
hours - количество часов
minutes - количество минут
seconds - количество секунд
timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не задано.
Возвращаемое значение:
XMLGregorianCalendar, созданный из значений параметров.
Исключения:
IllegalArgumentException - если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют недопустимый экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().
См. также:
DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        BigDecimal fractionalSecond,
                                                        int timezone)

Создать Java-экземпляр встроенного типа данных XML Schema time.

Значение null указывает, что поле не задано.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Параметры:
hours - количество часов
minutes - количество минут
seconds - количество секунд
fractionalSecond - значение null указывает, что это необязательное поле не задано.
timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не задано.
Возвращаемое значение:
XMLGregorianCalendar, созданный из значений параметров.
Исключения:
IllegalArgumentException - если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют недопустимый экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().
См. также:
DatatypeConstants.FIELD_UNDEFINED

newXMLGregorianCalendarTime

public XMLGregorianCalendar newXMLGregorianCalendarTime(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int milliseconds,
                                                        int timezone)

Создать Java-экземпляр встроенного типа данных XML Schema time.

Значение DatatypeConstants.FIELD_UNDEFINED указывает, что поле не задано.

Параметры:
hours - количество часов
minutes - количество минут
seconds - количество секунд
milliseconds - количество миллисекунд
timezone - смещение в минутах. DatatypeConstants.FIELD_UNDEFINED указывает, что необязательное поле не задано.
Возвращаемое значение:
XMLGregorianCalendar, созданный из значений параметров.
Исключения:
IllegalArgumentException - если значение любого отдельного параметра выходит за пределы максимального значения для поля, как определено в таблице сопоставления данных даты/времени в XMLGregorianCalendar, или если составные значения образуют недопустимый экземпляр XMLGregorianCalendar, как определено в XMLGregorianCalendar.isValid().
См. также:
DatatypeConstants.FIELD_UNDEFINED

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API