Интерфейс DatatypeConverterInterface

public interface DatatypeConverterInterface

Интерфейс DatatypeConverterInterface предназначен только для использования поставщиками JAXB. Поставщик JAXB должен предоставить класс, реализующий этот интерфейс. Поставщики JAXB обязаны вызвать API DatatypeConverter.setDatatypeConverter в какой-то момент перед первой операцией маршализации или демаршализации (возможно, во время вызова JAXBContext.newInstance). Этот шаг необходим для конфигурации преобразователя, который должен использоваться для выполнения функций печати и разбора. Повторный вызов этого API не повлияет — экземпляр DatatypeConverter, переданный в первый вызов, будет использоваться в дальнейшем.

Этот интерфейс определяет методы разбора и печати. Существует по одному методу разбора и печати для каждого типа данных XML схемы, указанного в таблице стандартной привязки 5-1 в спецификации JAXB.

Методы разбора и печати, определенные здесь, вызываются статическими методами разбора и печати, определенными в классе DatatypeConverter.

Метод разбора для типа данных XML схемы должен уметь преобразовывать любое лексическое представление типа данных XML схемы (указанное в спецификации XML Schema Part2: Datatypes specification) в значение в пространстве значений типа данных XML схемы. Если при преобразовании возникает ошибка, метод должен бросить исключение IllegalArgumentException или подкласс IllegalArgumentException.

Метод печати для типа данных XML схемы может выводить любое лексическое представление, которое является допустимым с точки зрения типа данных XML схемы. Если при преобразовании возникает ошибка, метод должен бросить исключение IllegalArgumentException или подкласс IllegalArgumentException.

Префикс xsd: используется для обозначения типов данных XML схемы XML Schema Part2: Datatypes specification.

Методы

parseString

String parseString(String lexicalXSDString)

Параметры:

lexicalXSDString - Лексическое представление типа данных XML Schema xsd:string

Возвращает:

Строку, идентичную входной строке.

parseInteger

BigInteger parseInteger(String lexicalXSDInteger)

Параметры:

lexicalXSDInteger - Строка, содержащая лексическое представление xsd:integer.

Возвращает:

Значение BigInteger, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDInteger не является допустимым строковым представлением значения BigInteger.

parseInt

int parseInt(String lexicalXSDInt)

Параметры:

lexicalXSDInt - Строка, содержащая лексическое представление xsd:int.

Возвращает:

Значение int, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDInt не является допустимым строковым представлением значения int.

parseLong

long parseLong(String lexicalXSDLong)

Параметры:

lexicalXSDLong - Строка, содержащая лексическое представление xsd:long.

Возвращает:

Значение long, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDLong не является допустимым строковым представлением значения long.

parseShort

short parseShort(String lexicalXSDShort)

Параметры:

lexicalXSDShort - Строка, содержащая лексическое представление xsd:short.

Возвращает:

Значение short, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDShort не является допустимым строковым представлением значения short.

parseDecimal

BigDecimal parseDecimal(String lexicalXSDDecimal)

Параметры:

lexicalXSDDecimal - Строка, содержащая лексическое представление xsd:decimal.

Возвращает:

Значение BigDecimal, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDDecimal не является допустимым строковым представлением BigDecimal.

parseFloat

float parseFloat(String lexicalXSDFloat)

Параметры:

lexicalXSDFloat - Строка, содержащая лексическое представление xsd:float.

Возвращает:

Значение float, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDFloat не является допустимым строковым представлением значения float.

parseDouble

double parseDouble(String lexicalXSDDouble)

Параметры:

lexicalXSDDouble - Строка, содержащая лексическое представление xsd:double.

Возвращает:

Значение double, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDDouble не является допустимым строковым представлением значения double.

parseBoolean

boolean parseBoolean(String lexicalXSDBoolean)

Параметры:

lexicalXSDBoolean - Строка, содержащая лексическое представление xsd:boolean.

Возвращает:

Значение boolean, представленное строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:boolean.

parseByte

byte parseByte(String lexicalXSDByte)

Параметры:

lexicalXSDByte - Строка, содержащая лексическое представление xsd:byte.

Возвращает:

Значение byte, представленное строковым аргументом.

Исключения:

NumberFormatException - lexicalXSDByte не содержит байт, который можно разобрать.

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:byte.

parseQName

QName parseQName(String lexicalXSDQName,
                 NamespaceContext nsc)

Параметры:

lexicalXSDQName - Строка, содержащая лексическое представление xsd:QName.

nsc - Контекст пространства имен для интерпретации префикса в QName.

Возвращает:

Значение QName, представленное строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует спецификации XML Schema Part 2 или если префикс пространства имен lexicalXSDQname не привязан к URI в NamespaceContext nsc.

parseDateTime

Calendar parseDateTime(String lexicalXSDDateTime)

Параметры:

lexicalXSDDateTime - Строка, содержащая лексическое представление xsd:datetime.

Возвращает:

Объект Calendar, представленный строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:dateTime.

parseBase64Binary

byte[] parseBase64Binary(String lexicalXSDBase64Binary)

Параметры:

lexicalXSDBase64Binary - Строка, содержащая лексическое представление xsd:base64Binary.

Возвращает:

Массив байтов, представленный строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:base64Binary

parseHexBinary

byte[] parseHexBinary(String lexicalXSDHexBinary)

Параметры:

lexicalXSDHexBinary - Строка, содержащая лексическое представление xsd:hexBinary.

Возвращает:

Массив байтов, представленный строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:hexBinary.

parseUnsignedInt

long parseUnsignedInt(String lexicalXSDUnsignedInt)

Параметры:

lexicalXSDUnsignedInt - Строка, содержащая лексическое представление xsd:unsignedInt.

Возвращает:

Значение long, представленное строковым аргументом.

Исключения:

NumberFormatException - если строковый параметр не может быть разобран в значение long.

parseUnsignedShort

int parseUnsignedShort(String lexicalXSDUnsignedShort)

Параметры:

lexicalXSDUnsignedShort - Строка, содержащая лексическое представление xsd:unsignedShort.

Возвращает:

Значение int, представленное строковым аргументом.

Исключения:

NumberFormatException - если строковый параметр не может быть разобран в значение int.

parseTime

Calendar parseTime(String lexicalXSDTime)

Параметры:

lexicalXSDTime - Строка, содержащая лексическое представление xsd:Time.

Возвращает:

Значение Calendar, представленное строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:Time.

parseDate

Calendar parseDate(String lexicalXSDDate)

Параметры:

lexicalXSDDate - Строка, содержащая лексическое представление xsd:Date.

Возвращает:

Значение Calendar, представленное строковым аргументом.

Исключения:

IllegalArgumentException - если строковый параметр не соответствует лексическому пространству значений, определенному в XML Schema Part 2: Datatypes для xsd:Date.

parseAnySimpleType

String parseAnySimpleType(String lexicalXSDAnySimpleType)

Параметры:

lexicalXSDAnySimpleType - Строка, содержащая лексическое представление простого типа.

Возвращает:

Строка, содержащая лексическое представление простого типа.

printString

String printString(String val)

Параметры:

val - Строковое значение.

Возвращает:

Строка, содержащая лексическое представление xsd:string

printInteger

String printInteger(BigInteger val)

Параметры:

val - Значение BigInteger

Возвращает:

Строка, содержащая лексическое представление xsd:integer

Исключения:

IllegalArgumentException - val имеет значение null.

printInt

String printInt(int val)

Параметры:

val - Значение int

Возвращает:

Строка, содержащая лексическое представление xsd:int

printLong

String printLong(long val)

Параметры:

val - Значение long

Возвращает:

Строка, содержащая лексическое представление xsd:long

printShort

String printShort(short val)

Параметры:

val - Короткое значение

Возвращает:

Строка, содержащая лексическое представление xsd:short

printDecimal

String printDecimal(BigDecimal val)

Параметры:

val - Значение BigDecimal

Возвращает:

Строка, содержащая лексическое представление xsd:decimal

Выбрасывает:

IllegalArgumentException - val равно null.

printFloat

String printFloat(float val)

Параметры:

val - Значение float

Возвращает:

Строка, содержащая лексическое представление xsd:float

printDouble

String printDouble(double val)

Параметры:

val - Значение double

Возвращает:

Строка, содержащая лексическое представление xsd:double

printBoolean

String printBoolean(boolean val)

Параметры:

val - Значение boolean

Возвращает:

Строка, содержащая лексическое представление xsd:boolean

printByte

String printByte(byte val)

Параметры:

val - Значение byte

Возвращает:

Строка, содержащая лексическое представление xsd:byte

printQName

String printQName(QName val,
                  NamespaceContext nsc)

Параметры:

val - Значение QName

nsc - Контекст пространства имен для интерпретации префикса в QName.

Возвращает:

Строка, содержащая лексическое представление QName

Выбрасывает:

IllegalArgumentException - если val равно null или если nsc не null или nsc.getPrefix(nsprefixFromVal) равно null.

printDateTime

String printDateTime(Calendar val)

Параметры:

val - Значение Calendar

Возвращает:

Строка, содержащая лексическое представление xsd:dateTime

Выбрасывает:

IllegalArgumentException - если val равно null.

printBase64Binary

String printBase64Binary(byte[] val)

Параметры:

val - Массив байтов

Возвращает:

Строка, содержащая лексическое представление xsd:base64Binary

Выбрасывает:

IllegalArgumentException - если val равно null.

printHexBinary

String printHexBinary(byte[] val)

Параметры:

val - Массив байтов

Возвращает:

Строка, содержащая лексическое представление xsd:hexBinary

Выбрасывает:

IllegalArgumentException - если val равно null.

printUnsignedInt

String printUnsignedInt(long val)

Параметры:

val - Значение long

Возвращает:

Строка, содержащая лексическое представление xsd:unsignedInt

printUnsignedShort

String printUnsignedShort(int val)

Параметры:

val - Значение int

Возвращает:

Строка, содержащая лексическое представление xsd:unsignedShort

printTime

String printTime(Calendar val)

Параметры:

val - Значение Calendar

Возвращает:

Строка, содержащая лексическое представление xsd:time

Выбрасывает:

IllegalArgumentException - если val равно null.

printDate

String printDate(Calendar val)

Параметры:

val - Значение Calendar

Возвращает:

Строка, содержащая лексическое представление xsd:date

Выбрасывает:

IllegalArgumentException - если val равно null.

printAnySimpleType

String printAnySimpleType(String val)

Параметры:

val - Значение строки

Возвращает:

Строка, содержащая лексическое представление xsd:AnySimpleType