Класс DatatypeConverter

public final class DatatypeConverter
extends Object

Декларация привязки javaType может использоваться для настройки привязки типа данных XML-схемы к типу данных Java. Настройка может включать в себя написание методов parse и print для парсинга и вывода лексических представлений типа данных XML-схемы соответственно. Однако, написание методов parse и print требует знания лексических представлений (спецификация XML Schema Part2: Datatypes) и поэтому может быть сложным.

Этот класс упрощает написание методов parse и print. Он определяет статические методы parse и print, которые предоставляют доступ к реализации методов parse и print поставщика JAXB. Эти методы вызываются пользовательскими методами parse и print. Например, привязку xsd:dateTime к long можно настроить с помощью методов parse и print следующим образом:

// Customized parse method
public long myParseCal( String dateTimeString ) {
    java.util.Calendar cal = DatatypeConverter.parseDateTime(dateTimeString);
    long longval = convert_calendar_to_long(cal); //application specific
    return longval;
}

// Customized print method
public String myPrintCal( Long longval ) {
    java.util.Calendar cal = convert_long_to_calendar(longval) ; //application specific
    String dateTimeString = DatatypeConverter.printDateTime(cal);
    return dateTimeString;
}

Существует статический метод parse и print, соответствующий каждому методу parse и print в DatatypeConverterInterface.

Статические методы, определенные в классе, также могут использоваться для указания метода parse или print в декларации привязки javaType.

Поставщикам JAXB требуется вызвать метод setDatatypeConverter в какой-то момент перед первой операцией маршализации или размаршализации (возможно, во время вызова JAXBContext.newInstance). Этот шаг необходим для конфигурации преобразователя, который должен использоваться для выполнения функций print и parse.

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

Методы

setDatatypeConverter

public static void setDatatypeConverter(DatatypeConverterInterface converter)

Параметры:

converter - экземпляр класса, реализующего класс DatatypeConverterInterface — этот параметр не должен быть равен null.

Исключения:

IllegalArgumentException - если параметр равен null

SecurityException - Если ответственный SecurityManager запрещает доступ к установке преобразователя типов данных.

См. также:

JAXBPermission

parseString

public static String parseString(String lexicalXSDString)

Параметры:

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

Возвращает:

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

parseInteger

public static BigInteger parseInteger(String lexicalXSDInteger)

Параметры:

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

Возвращает:

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

Исключения:

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

parseInt

public static int parseInt(String lexicalXSDInt)

Параметры:

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

Возвращает:

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

Исключения:

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

parseLong

public static long parseLong(String lexicalXSDLong)

Параметры:

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

Возвращает:

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

Исключения:

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

parseShort

public static short parseShort(String lexicalXSDShort)

Параметры:

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

Возвращает:

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

Исключения:

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

parseDecimal

public static BigDecimal parseDecimal(String lexicalXSDDecimal)

Параметры:

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

Возвращает:

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

Исключения:

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

parseFloat

public static float parseFloat(String lexicalXSDFloat)

Параметры:

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

Возвращает:

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

Исключения:

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

parseDouble

public static double parseDouble(String lexicalXSDDouble)

Параметры:

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

Возвращает:

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

Исключения:

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

parseBoolean

public static boolean parseBoolean(String lexicalXSDBoolean)

Параметры:

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

Возвращает:

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

Исключения:

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

parseByte

public static byte parseByte(String lexicalXSDByte)

Параметры:

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

Возвращает:

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

Исключения:

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

parseQName

public static QName parseQName(String lexicalXSDQName,
                               NamespaceContext nsc)

Параметры:

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

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

Возвращает:

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

Исключения:

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

parseDateTime

public static Calendar parseDateTime(String lexicalXSDDateTime)

Параметры:

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

Возвращает:

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

Исключения:

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

parseBase64Binary

public static byte[] parseBase64Binary(String lexicalXSDBase64Binary)

Параметры:

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

Возвращает:

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

Исключения:

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

parseHexBinary

public static byte[] parseHexBinary(String lexicalXSDHexBinary)

Параметры:

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

Возвращает:

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

Исключения:

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

parseUnsignedInt

public static long parseUnsignedInt(String lexicalXSDUnsignedInt)

Параметры:

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

Возвращает:

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

Исключения:

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

parseUnsignedShort

public static int parseUnsignedShort(String lexicalXSDUnsignedShort)

Параметры:

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

Возвращает:

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

Исключения:

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

parseTime

public static Calendar parseTime(String lexicalXSDTime)

Параметры:

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

Возвращает:

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

Исключения:

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

parseDate

public static Calendar parseDate(String lexicalXSDDate)

Параметры:

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

Возвращает:

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

Исключения:

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

parseAnySimpleType

public static String parseAnySimpleType(String lexicalXSDAnySimpleType)

Параметры:

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

Возвращает:

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

printString

public static String printString(String val)

Параметры:

val - значение String.

Возвращает:

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

printInteger

public static String printInteger(BigInteger val)

Параметры:

val - Значение BigInteger

Возвращает:

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

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

IllegalArgumentException - val равно null.

printInt

public static String printInt(int val)

Параметры:

val - Значение int

Возвращает:

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

printLong

public static String printLong(long val)

Параметры:

val - Значение long

Возвращает:

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

printShort

public static String printShort(short val)

Параметры:

val - Значение short

Возвращает:

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

printDecimal

public static String printDecimal(BigDecimal val)

Параметры:

val - Значение BigDecimal

Возвращает:

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

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

IllegalArgumentException - val равно null.

printFloat

public static String printFloat(float val)

Параметры:

val - Значение float

Возвращает:

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

printDouble

public static String printDouble(double val)

Параметры:

val - Значение double

Возвращает:

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

printBoolean

public static String printBoolean(boolean val)

Параметры:

val - Значение boolean

Возвращает:

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

printByte

public static String printByte(byte val)

Параметры:

val - Значение byte

Возвращает:

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

printQName

public static String printQName(QName val,
                                NamespaceContext nsc)

Параметры:

val - Значение QName

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

Возвращает:

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

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

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

printDateTime

public static String printDateTime(Calendar val)

Параметры:

val - Значение Calendar

Возвращает:

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

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

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

printBase64Binary

public static String printBase64Binary(byte[] val)

Параметры:

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

Возвращает:

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

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

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

printHexBinary

public static String printHexBinary(byte[] val)

Параметры:

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

Возвращает:

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

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

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

printUnsignedInt

public static String printUnsignedInt(long val)

Параметры:

val - Значение long

Возвращает:

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

printUnsignedShort

public static String printUnsignedShort(int val)

Параметры:

val - Значение int

Возвращает:

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

printTime

public static String printTime(Calendar val)

Параметры:

val - Значение Calendar

Возвращает:

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

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

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

printDate

public static String printDate(Calendar val)

Параметры:

val - Значение Calendar

Возвращает:

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

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

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

printAnySimpleType

public static String printAnySimpleType(String val)

Параметры:

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

Возвращает:

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