Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class DatatypeConverter extends Object
javaType обязательное объявление может использоваться, чтобы настроить привязку типа данных XML-схемы к типу данных Java. Настройки могут включить запись синтаксического анализа и напечатать метод для парсинга и печати лексических представлений типа данных XML-схемы соответственно. Однако, запись синтаксического анализа и методов печати требует знания лексических представлений (
Этот класс облегчает писать методы печати и синтаксический анализ. Это определяет статический синтаксический анализ и методы печати, которые обеспечивают доступ к реализации провайдера 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
.
Статические методы, определенные в классе, могут также использоваться, чтобы определить синтаксический анализ или метод печати в javaType обязательное объявление.
Провайдеры JAXB обязаны вызывать setDatatypeConverter
api в некоторый момент перед первым упорядочивают или неупорядочивают работу (возможно, во время звонка в JAXBContext.newInstance). Этот шаг необходим, чтобы сконфигурировать преобразователь, который должен использоваться, чтобы выполнить функциональность синтаксического анализа и печать.
Метод печати для типа данных XML-схемы может вывести любое лексическое представление, которое допустимо относительно типа данных XML-схемы. Если с ошибкой встречаются во время преобразования, то IllegalArgumentException, или подкласс IllegalArgumentException должен быть брошен методом.
DatatypeConverterInterface
, ParseConversionEvent
, PrintConversionEvent
Модификатор и Тип | Метод и Описание |
---|---|
static String |
parseAnySimpleType(String lexicalXSDAnySimpleType)
Возвратите строку, содержащую лексическое представление простого типа.
|
static byte[] |
parseBase64Binary(String lexicalXSDBase64Binary)
Преобразовывает строковый параметр в массив байтов.
|
static boolean |
parseBoolean(String lexicalXSDBoolean)
Преобразовывает строковый параметр в булево значение.
|
static byte |
parseByte(String lexicalXSDByte)
Преобразовывает строковый параметр в значение байта.
|
static Calendar |
parseDate(String lexicalXSDDate)
Преобразовывает строковый параметр в Календарное значение.
|
static Calendar |
parseDateTime(String lexicalXSDDateTime)
Преобразовывает строковый параметр в Календарное значение.
|
static BigDecimal |
parseDecimal(String lexicalXSDDecimal)
Преобразовывает строковый параметр в значение BigDecimal.
|
static double |
parseDouble(String lexicalXSDDouble)
Преобразовывает строковый параметр в двойное значение.
|
static float |
parseFloat(String lexicalXSDFloat)
Преобразовывает строковый параметр в значение плавающее.
|
static byte[] |
parseHexBinary(String lexicalXSDHexBinary)
Преобразовывает строковый параметр в массив байтов.
|
static int |
parseInt(String lexicalXSDInt)
Преобразуйте строковый параметр в международное значение.
|
static BigInteger |
parseInteger(String lexicalXSDInteger)
Преобразуйте строковый параметр в значение BigInteger.
|
static long |
parseLong(String lexicalXSDLong)
Преобразовывает строковый параметр в длинное значение.
|
static QName |
parseQName(String lexicalXSDQName, NamespaceContext nsc)
Преобразовывает строковый параметр в значение байта.
|
static short |
parseShort(String lexicalXSDShort)
Преобразовывает строковый параметр в короткое значение.
|
static String |
parseString(String lexicalXSDString)
Преобразуйте лексический строковый параметр XSD в Строковое значение.
|
static Calendar |
parseTime(String lexicalXSDTime)
Преобразовывает строковый параметр в Календарное значение.
|
static long |
parseUnsignedInt(String lexicalXSDUnsignedInt)
Преобразовывает строковый параметр в длинное значение.
|
static int |
parseUnsignedShort(String lexicalXSDUnsignedShort)
Преобразовывает строковый параметр в международное значение.
|
static String |
printAnySimpleType(String val)
Преобразовывает строковое значение в строку.
|
static String |
printBase64Binary(byte[] val)
Преобразовывает массив байтов в строку.
|
static String |
printBoolean(boolean val)
Преобразовывает булево значение в строку.
|
static String |
printByte(byte val)
Преобразовывает значение байта в строку.
|
static String |
printDate(Calendar val)
Преобразовывает Календарное значение в строку.
|
static String |
printDateTime(Calendar val)
Преобразовывает Календарное значение в строку.
|
static String |
printDecimal(BigDecimal val)
Преобразовывает значение BigDecimal в строку.
|
static String |
printDouble(double val)
Преобразовывает двойное значение в строку.
|
static String |
printFloat(float val)
Преобразовывает значение плавающее в строку.
|
static String |
printHexBinary(byte[] val)
Преобразовывает массив байтов в строку.
|
static String |
printInt(int val)
Преобразовывает международное значение в строку.
|
static String |
printInteger(BigInteger val)
Преобразовывает значение BigInteger в строку.
|
static String |
printLong(long val)
Преобразовывает длинное значение в строку.
|
static String |
printQName(QName val, NamespaceContext nsc)
Преобразовывает экземпляр QName в строку.
|
static String |
printShort(short val)
Преобразовывает короткое значение в строку.
|
static String |
printString(String val)
Преобразовывает строковый параметр в строку.
|
static String |
printTime(Calendar val)
Преобразовывает Календарное значение в строку.
|
static String |
printUnsignedInt(long val)
Преобразовывает длинное значение в строку.
|
static String |
printUnsignedShort(int val)
Преобразовывает международное значение в строку.
|
static void |
setDatatypeConverter(DatatypeConverterInterface converter)
Этот метод для использования провайдера JAXB только.
|
public static void setDatatypeConverter(DatatypeConverterInterface converter)
Провайдеры JAXB обязаны вызывать этот метод в некоторый момент прежде, чем позволить любому клиенту JAXB, упорядочивают или неупорядочивают операции, чтобы произойти. Это необходимо, чтобы сконфигурировать преобразователь типа данных, который должен использоваться, чтобы выполнить преобразования синтаксического анализа и печать.
Вызов этого api неоднократно не будет иметь никакого эффекта - экземпляр DatatypeConverterInterface, который передают в первый вызов, является тем, который будет использоваться с тех пор.
converter
- экземпляр класса, который реализует класс DatatypeConverterInterface - этот параметр, не должен быть нулем.IllegalArgumentException
- если параметр является нулемSecurityException
- Если SecurityManager
ответственный лишает доступа, чтобы установить преобразователь типа данных.JAXBPermission
public static String parseString(String lexicalXSDString)
Преобразуйте лексический строковый параметр XSD в Строковое значение.
lexicalXSDString
- Строка, содержащая лексическое представление xsd:string.public static BigInteger parseInteger(String lexicalXSDInteger)
Преобразуйте строковый параметр в значение BigInteger.
lexicalXSDInteger
- Строка, содержащая лексическое представление xsd:integer.NumberFormatException
- lexicalXSDInteger
не допустимое строковое представление a BigInteger
значение.public static int parseInt(String lexicalXSDInt)
Преобразуйте строковый параметр в международное значение.
lexicalXSDInt
- Строка, содержащая лексическое представление xsd:int.NumberFormatException
- lexicalXSDInt
не допустимое строковое представление int
значение.public static long parseLong(String lexicalXSDLong)
Преобразовывает строковый параметр в длинное значение.
lexicalXSDLong
- Строка, содержащая лексическое представление xsd:long.NumberFormatException
- lexicalXSDLong
не допустимое строковое представление a long
значение.public static short parseShort(String lexicalXSDShort)
Преобразовывает строковый параметр в короткое значение.
lexicalXSDShort
- Строка, содержащая лексическое представление xsd:short.NumberFormatException
- lexicalXSDShort
не допустимое строковое представление a short
значение.public static BigDecimal parseDecimal(String lexicalXSDDecimal)
Преобразовывает строковый параметр в значение BigDecimal.
lexicalXSDDecimal
- Строка, содержащая лексическое представление xsd:decimal.NumberFormatException
- lexicalXSDDecimal
не допустимое строковое представление BigDecimal
.public static float parseFloat(String lexicalXSDFloat)
Преобразовывает строковый параметр в значение плавающее.
lexicalXSDFloat
- Строка, содержащая лексическое представление xsd:float.NumberFormatException
- lexicalXSDFloat
не допустимое строковое представление a float
значение.public static double parseDouble(String lexicalXSDDouble)
Преобразовывает строковый параметр в двойное значение.
lexicalXSDDouble
- Строка, содержащая лексическое представление xsd:double.NumberFormatException
- lexicalXSDDouble
не допустимое строковое представление a double
значение.public static boolean parseBoolean(String lexicalXSDBoolean)
Преобразовывает строковый параметр в булево значение.
lexicalXSDBoolean
- Строка, содержащая лексическое представление xsd:boolean.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:boolean.public static byte parseByte(String lexicalXSDByte)
Преобразовывает строковый параметр в значение байта.
lexicalXSDByte
- Строка, содержащая лексическое представление xsd:byte.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:byte.public static QName parseQName(String lexicalXSDQName, NamespaceContext nsc)
Преобразовывает строковый параметр в значение байта.
Строковый параметр lexicalXSDQname должен соответствовать лексическому пространству значений specifed в
lexicalXSDQName
- Строка, содержащая лексическое представление xsd:QName.nsc
- Контекст пространства имен для того, чтобы интерпретировать префикс в пределах QName.IllegalArgumentException
- если строковый параметр не соответствует спецификации Части 2 XML-схемы или если префикс пространства имен lexicalXSDQname не связывается с URI в NamespaceContext nsc.public static Calendar parseDateTime(String lexicalXSDDateTime)
Преобразовывает строковый параметр в Календарное значение.
lexicalXSDDateTime
- Строка, содержащая лексическое представление xsd:datetime.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:dateTime.public static byte[] parseBase64Binary(String lexicalXSDBase64Binary)
Преобразовывает строковый параметр в массив байтов.
lexicalXSDBase64Binary
- Строка, содержащая лексическое представление xsd:base64Binary.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:base64Binarypublic static byte[] parseHexBinary(String lexicalXSDHexBinary)
Преобразовывает строковый параметр в массив байтов.
lexicalXSDHexBinary
- Строка, содержащая лексическое представление xsd:hexBinary.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:hexBinary.public static long parseUnsignedInt(String lexicalXSDUnsignedInt)
Преобразовывает строковый параметр в длинное значение.
lexicalXSDUnsignedInt
- Строка, содержащая лексическое представление xsd:unsignedInt.NumberFormatException
- если строковый параметр не может быть проанализирован в значение long.public static int parseUnsignedShort(String lexicalXSDUnsignedShort)
Преобразовывает строковый параметр в международное значение.
lexicalXSDUnsignedShort
- Строка, содержащая лексическое представление xsd:unsignedShort.NumberFormatException
- если строковый параметр не может быть проанализирован в значение int.public static Calendar parseTime(String lexicalXSDTime)
Преобразовывает строковый параметр в Календарное значение.
lexicalXSDTime
- Строка, содержащая лексическое представление xsd:time.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:Time.public static Calendar parseDate(String lexicalXSDDate)
Преобразовывает строковый параметр в Календарное значение.
lexicalXSDDate
- Строка, содержащая лексическое представление xsd:Date.IllegalArgumentException
- если строковый параметр не соответствует лексическому пространству значений, определенному в Части 2 XML-схемы: Типы данных для xsd:Date.public static String parseAnySimpleType(String lexicalXSDAnySimpleType)
Возвратите строку, содержащую лексическое представление простого типа.
lexicalXSDAnySimpleType
- Строка, содержащая лексическое представление простого типа.public static String printString(String val)
Преобразовывает строковый параметр в строку.
val
- Строковое значение.public static String printInteger(BigInteger val)
Преобразовывает значение BigInteger в строку.
val
- Значение BigIntegerIllegalArgumentException
- val является нулем.public static String printInt(int val)
Преобразовывает международное значение в строку.
val
- Международное значениеpublic static String printLong(long val)
Преобразовывает длинное значение в строку.
val
- Длинное значениеpublic static String printShort(short val)
Преобразовывает короткое значение в строку.
val
- Короткое значениеpublic static String printDecimal(BigDecimal val)
Преобразовывает значение BigDecimal в строку.
val
- Значение BigDecimalIllegalArgumentException
- val является нулем.public static String printFloat(float val)
Преобразовывает значение плавающее в строку.
val
- Значение плавающееpublic static String printDouble(double val)
Преобразовывает двойное значение в строку.
val
- Двойное значениеpublic static String printBoolean(boolean val)
Преобразовывает булево значение в строку.
val
- Булево значениеpublic static String printByte(byte val)
Преобразовывает значение байта в строку.
val
- Значение байтаpublic static String printQName(QName val, NamespaceContext nsc)
Преобразовывает экземпляр QName в строку.
val
- Значение QNamensc
- Контекст пространства имен для того, чтобы интерпретировать префикс в пределах QName.IllegalArgumentException
- если val является нулем или если nsc является ненулем, или nsc.getPrefix(nsprefixFromVal) является нулем.public static String printDateTime(Calendar val)
Преобразовывает Календарное значение в строку.
val
- Календарное значениеIllegalArgumentException
- если val является нулем.public static String printBase64Binary(byte[] val)
Преобразовывает массив байтов в строку.
val
- Массив байтовIllegalArgumentException
- если val является нулем.public static String printHexBinary(byte[] val)
Преобразовывает массив байтов в строку.
val
- Массив байтовIllegalArgumentException
- если val является нулем.public static String printUnsignedInt(long val)
Преобразовывает длинное значение в строку.
val
- Длинное значениеpublic static String printUnsignedShort(int val)
Преобразовывает международное значение в строку.
val
- Международное значениеpublic static String printTime(Calendar val)
Преобразовывает Календарное значение в строку.
val
- Календарное значениеIllegalArgumentException
- если val является нулем.public static String printDate(Calendar val)
Преобразовывает Календарное значение в строку.
val
- Календарное значениеIllegalArgumentException
- если val является нулем.
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.