Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind
Класс DatatypeConverter

java.lang.Object
  javax.xml.bind.DatatypeConverter

public final class DatatypeConverter
расширяет java.lang. Объект

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

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

    // 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;
    }
    

Есть статический метод синтаксического анализа и печати, соответствующий каждому синтаксическому анализу и методу печати соответственно в DatatypeConverterInterface.

Статические методы, определенные в class, могут также использоваться, чтобы определить синтаксический анализ или метод печати в javaType обязательное объявление.

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

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

С тех пор:

JAXB1.0

Автор:

• Sekhar Vajjhala, Sun Microsystems, Inc.
• Джо Фьалли, Sun Microsystems Inc.
• Kohsuke Кавагути, Sun Microsystems, Inc.
• Райан Шоемэкер, Sun Microsystems Inc.

См. Также:

DatatypeConverterInterface, ParseConversionEvent, PrintConversionEvent

Сводка метода

static java.lang.String	parseAnySimpleType(java.lang.String lexicalXSDAnySimpleType) Возвратите строку, содержащую лексическое представление простого типа.
static byte[]	parseBase64Binary(java.lang.String lexicalXSDBase64Binary) Преобразовывает строковый параметр в массив байтов.
static boolean	parseBoolean(java.lang.String lexicalXSDBoolean) Преобразовывает строковый параметр в булево значение.
static byte	parseByte(java.lang.String lexicalXSDByte) Преобразовывает строковый параметр в значение байта.
static java.util.Calendar	parseDate(java.lang.String lexicalXSDDate) Преобразовывает строковый параметр в Календарное значение.
static java.util.Calendar	parseDateTime(java.lang.String lexicalXSDDateTime) Преобразовывает строковый параметр в Календарное значение.
static java.math.BigDecimal	parseDecimal(java.lang.String lexicalXSDDecimal) Преобразовывает строковый параметр в значение BigDecimal.
static double	parseDouble(java.lang.String lexicalXSDDouble) Преобразовывает строковый параметр в двойное значение.
static float	parseFloat(java.lang.String lexicalXSDFloat) Преобразовывает строковый параметр в значение плавающее.
static byte[]	parseHexBinary(java.lang.String lexicalXSDHexBinary) Преобразовывает строковый параметр в массив байтов.
static int	parseInt(java.lang.String lexicalXSDInt) Преобразуйте строковый параметр в международное значение.
static java.math.BigInteger	parseInteger(java.lang.String lexicalXSDInteger) Преобразуйте строковый параметр в значение BigInteger.
static long	parseLong(java.lang.String lexicalXSDLong) Преобразовывает строковый параметр в длинное значение.
static javax.xml.namespace.QName	parseQName(java.lang.String lexicalXSDQName, javax.xml.namespace.NamespaceContext nsc) Преобразовывает строковый параметр в значение байта.
static short	parseShort(java.lang.String lexicalXSDShort) Преобразовывает строковый параметр в короткое значение.
static java.lang.String	parseString(java.lang.String lexicalXSDString) Преобразуйте лексический строковый параметр XSD в Строковое значение.
static java.util.Calendar	parseTime(java.lang.String lexicalXSDTime) Преобразовывает строковый параметр в Календарное значение.
static long	parseUnsignedInt(java.lang.String lexicalXSDUnsignedInt) Преобразовывает строковый параметр в длинное значение.
static int	parseUnsignedShort(java.lang.String lexicalXSDUnsignedShort) Преобразовывает строковый параметр в международное значение.
static java.lang.String	printAnySimpleType(java.lang.String val) Преобразовывает строковое значение в строку.
static java.lang.String	printBase64Binary(byte[] val) Преобразовывает массив байтов в строку.
static java.lang.String	printBoolean(boolean val) Преобразовывает булево значение в строку.
static java.lang.String	printByte(byte val) Преобразовывает значение байта в строку.
static java.lang.String	printDate(java.util.Calendar val) Преобразовывает Календарное значение в строку.
static java.lang.String	printDateTime(java.util.Calendar val) Преобразовывает Календарное значение в строку.
static java.lang.String	printDecimal(java.math.BigDecimal val) Преобразовывает значение BigDecimal в строку.
static java.lang.String	printDouble(double val) Преобразовывает двойное значение в строку.
static java.lang.String	printFloat(float val) Преобразовывает значение плавающее в строку.
static java.lang.String	printHexBinary(byte[] val) Преобразовывает массив байтов в строку.
static java.lang.String	printInt(int val) Преобразовывает международное значение в строку.
static java.lang.String	printInteger(java.math.BigInteger val) Преобразовывает значение BigInteger в строку.
static java.lang.String	printLong(long val) Преобразовывает длинное значение в строку.
static java.lang.String	printQName(javax.xml.namespace.QName val, javax.xml.namespace.NamespaceContext nsc) Преобразовывает экземпляр QName в строку.
static java.lang.String	printShort(short val) Преобразовывает короткое значение в строку.
static java.lang.String	printString(java.lang.String val) Преобразовывает строковый параметр в строку.
static java.lang.String	printTime(java.util.Calendar val) Преобразовывает Календарное значение в строку.
static java.lang.String	printUnsignedInt(long val) Преобразовывает длинное значение в строку.
static java.lang.String	printUnsignedShort(int val) Преобразовывает международное значение в строку.
static void	setDatatypeConverter(DatatypeConverterInterface converter) Этот метод для использования провайдера JAXB только.

Методы, наследованные от class java.lang. Объект

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

Деталь метода

setDatatypeConverter

public static void setDatatypeConverter(DatatypeConverterInterface converter)

Этот метод для использования провайдера JAXB только.

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

Вызов этого api неоднократно не будет иметь никакого эффекта - экземпляр DatatypeConverterInterface, который передают в первый вызов, является тем, который будет использоваться с тех пор.

Параметры:

converter - экземпляр class, который реализует DatatypeConverterInterface class - этот параметр, не должен быть нулем.

Броски:

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

SecurityException - Если SecurityManager ответственный лишает доступа, чтобы установить преобразователь типа данных.

См. Также:

JAXBPermission

parseString

public static java.lang.String parseString(java.lang.String lexicalXSDString)

Преобразуйте лексический строковый параметр XSD в Строковое значение.

Параметры:

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

Возвраты:

Строковое значение представляется строковым параметром.

parseInteger

public static java.math.BigInteger parseInteger(java.lang.String lexicalXSDInteger)

Преобразуйте строковый параметр в значение BigInteger.

Параметры:

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

Возвраты:

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

Броски:

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

parseInt

public static int parseInt(java.lang.String lexicalXSDInt)

Преобразуйте строковый параметр в международное значение.

Параметры:

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

Возвраты:

Международное значение представляется строковым параметром.

Броски:

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

parseLong

public static long parseLong(java.lang.String lexicalXSDLong)

Преобразовывает строковый параметр в длинное значение.

Параметры:

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

Возвраты:

Длинное значение представляется строковым параметром.

Броски:

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

parseShort

public static short parseShort(java.lang.String lexicalXSDShort)

Преобразовывает строковый параметр в короткое значение.

Параметры:

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

Возвраты:

Короткое значение представляется строковым параметром.

Броски:

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

parseDecimal

public static java.math.BigDecimal parseDecimal(java.lang.String lexicalXSDDecimal)

Преобразовывает строковый параметр в значение BigDecimal.

Параметры:

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

Возвраты:

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

Броски:

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

parseFloat

public static float parseFloat(java.lang.String lexicalXSDFloat)

Преобразовывает строковый параметр в значение плавающее.

Параметры:

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

Возвраты:

Значение плавающее представляется строковым параметром.

Броски:

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

parseDouble

public static double parseDouble(java.lang.String lexicalXSDDouble)

Преобразовывает строковый параметр в двойное значение.

Параметры:

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

Возвраты:

Двойное значение представляется строковым параметром.

Броски:

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

parseBoolean

public static boolean parseBoolean(java.lang.String lexicalXSDBoolean)

Преобразовывает строковый параметр в булево значение.

Параметры:

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

Возвраты:

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

Броски:

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

parseByte

public static byte parseByte(java.lang.String lexicalXSDByte)

Преобразовывает строковый параметр в значение байта.

Параметры:

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

Возвраты:

Значение байта представляется строковым параметром.

Броски:

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

parseQName

public static javax.xml.namespace.QName parseQName(java.lang.String lexicalXSDQName,
                                                   javax.xml.namespace.NamespaceContext nsc)

Преобразовывает строковый параметр в значение байта.

Строковый параметр lexicalXSDQname должен соответствовать лексическому пространству значений specifed в Части 2:Datatypes XML-схемы specification:QNames

Параметры:

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

nsc - Контекст пространства имен для того, чтобы интерпретировать префикс в пределах QName.

Возвраты:

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

Броски:

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

parseDateTime

public static java.util.Calendar parseDateTime(java.lang.String lexicalXSDDateTime)

Преобразовывает строковый параметр в Календарное значение.

Параметры:

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

Возвраты:

Календарный объект представляется строковым параметром.

Броски:

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

parseBase64Binary

public static byte[] parseBase64Binary(java.lang.String lexicalXSDBase64Binary)

Преобразовывает строковый параметр в массив байтов.

Параметры:

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

Возвраты:

Массив байтов представляется строковым параметром.

Броски:

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

parseHexBinary

public static byte[] parseHexBinary(java.lang.String lexicalXSDHexBinary)

Преобразовывает строковый параметр в массив байтов.

Параметры:

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

Возвраты:

Массив байтов представляется строковым параметром.

Броски:

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

parseUnsignedInt

public static long parseUnsignedInt(java.lang.String lexicalXSDUnsignedInt)

Преобразовывает строковый параметр в длинное значение.

Параметры:

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

Возвраты:

Длинное значение представляется строковым параметром.

Броски:

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

parseUnsignedShort

public static int parseUnsignedShort(java.lang.String lexicalXSDUnsignedShort)

Преобразовывает строковый параметр в международное значение.

Параметры:

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

Возвраты:

Международное значение представляется строковым параметром.

Броски:

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

parseTime

public static java.util.Calendar parseTime(java.lang.String lexicalXSDTime)

Преобразовывает строковый параметр в Календарное значение.

Параметры:

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

Возвраты:

Календарное значение представляется строковым параметром.

Броски:

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

parseDate

public static java.util.Calendar parseDate(java.lang.String lexicalXSDDate)

Преобразовывает строковый параметр в Календарное значение.

Параметры:

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

Возвраты:

Календарное значение представляется строковым параметром.

Броски:

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

parseAnySimpleType

public static java.lang.String parseAnySimpleType(java.lang.String lexicalXSDAnySimpleType)

Возвратите строку, содержащую лексическое представление простого типа.

Параметры:

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

Возвраты:

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

printString

public static java.lang.String printString(java.lang.String val)

Преобразовывает строковый параметр в строку.

Параметры:

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

Возвраты:

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

printInteger

public static java.lang.String printInteger(java.math.BigInteger val)

Преобразовывает значение BigInteger в строку.

Параметры:

val - Значение BigInteger

Возвраты:

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

Броски:

IllegalArgumentException - val является нулем.

printInt

public static java.lang.String printInt(int val)

Преобразовывает международное значение в строку.

Параметры:

val - Международное значение

Возвраты:

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

printLong

public static java.lang.String printLong(long val)

Преобразовывает длинное значение в строку.

Параметры:

val - Длинное значение

Возвраты:

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

printShort

public static java.lang.String printShort(short val)

Преобразовывает короткое значение в строку.

Параметры:

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

Возвраты:

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

printDecimal

public static java.lang.String printDecimal(java.math.BigDecimal val)

Преобразовывает значение BigDecimal в строку.

Параметры:

val - Значение BigDecimal

Возвраты:

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

Броски:

IllegalArgumentException - val является нулем.

printFloat

public static java.lang.String printFloat(float val)

Преобразовывает значение плавающее в строку.

Параметры:

val - Значение плавающее

Возвраты:

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

printDouble

public static java.lang.String printDouble(double val)

Преобразовывает двойное значение в строку.

Параметры:

val - Двойное значение

Возвраты:

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

printBoolean

public static java.lang.String printBoolean(boolean val)

Преобразовывает булево значение в строку.

Параметры:

val - Булево значение

Возвраты:

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

printByte

public static java.lang.String printByte(byte val)

Преобразовывает значение байта в строку.

Параметры:

val - Значение байта

Возвраты:

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

printQName

public static java.lang.String printQName(javax.xml.namespace.QName val,
                                          javax.xml.namespace.NamespaceContext nsc)

Преобразовывает экземпляр QName в строку.

Параметры:

val - Значение QName

nsc - Контекст пространства имен для того, чтобы интерпретировать префикс в пределах QName.

Возвраты:

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

Броски:

IllegalArgumentException - если val является нулем или если nsc является ненулем, или nsc.getPrefix(nsprefixFromVal) является нулем.

printDateTime

public static java.lang.String printDateTime(java.util.Calendar val)

Преобразовывает Календарное значение в строку.

Параметры:

val - Календарное значение

Возвраты:

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

Броски:

IllegalArgumentException - если val является нулем.

printBase64Binary

public static java.lang.String printBase64Binary(byte[] val)

Преобразовывает массив байтов в строку.

Параметры:

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

Возвраты:

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

Броски:

IllegalArgumentException - если val является нулем.

printHexBinary

public static java.lang.String printHexBinary(byte[] val)

Преобразовывает массив байтов в строку.

Параметры:

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

Возвраты:

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

Броски:

IllegalArgumentException - если val является нулем.

printUnsignedInt

public static java.lang.String printUnsignedInt(long val)

Преобразовывает длинное значение в строку.

Параметры:

val - Длинное значение

Возвраты:

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

printUnsignedShort

public static java.lang.String printUnsignedShort(int val)

Преобразовывает международное значение в строку.

Параметры:

val - Международное значение

Возвраты:

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

printTime

public static java.lang.String printTime(java.util.Calendar val)

Преобразовывает Календарное значение в строку.

Параметры:

val - Календарное значение

Возвраты:

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

Броски:

IllegalArgumentException - если val является нулем.

printDate

public static java.lang.String printDate(java.util.Calendar val)

Преобразовывает Календарное значение в строку.

Параметры:

val - Календарное значение

Возвраты:

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

Броски:

IllegalArgumentException - если val является нулем.

printAnySimpleType

public static java.lang.String printAnySimpleType(java.lang.String val)

Преобразовывает строковое значение в строку.

Параметры:

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

Возвраты:

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