DatatypeConverter (Java Platform SE 8 )

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

```
public final class DatatypeConverter
extends Object
```
的javatype绑定声明可用于自定义的XML Schema数据类型到java数据类型的约束。定制可以涉及编写解析和印刷方法和印刷解析的XML SCHEMA类型词汇表示的分别。然而，写作分析和打印方法需要的词汇表示的知识（ XML Schema Part2: Datatypes specification ），因此可能很难写。

这个类可以更容易写解析和打印方法。它定义了静态分析和打印的方法，提供一个API提供商的实施分析和打印方法。这些方法是通过自定义解析和打印方法调用的。例如，XSD的结合：日期时间一长可以使用分析和打印方法如下定制：
```
    // 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。一个实例中）。此步骤是必要的配置转换器，该转换器应用于执行打印和解析功能。

一个XML Schema数据类型的打印方法可以输出任何词汇表达，是有效的XML架构数据类型。如果在转换过程中遇到错误，然后一个时，或时子类必须由方法引发。
从以下版本开始：

jaxb1.0

另请参见：

DatatypeConverterInterface， ParseConversionEvent， PrintConversionEvent

方法摘要

所有方法静态方法具体的方法
Modifier and Type	Method and Description
`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)` 将字符串参数为一个int值。
`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)` 将字符串参数为一个int值。
`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)` 将一个int类型的值转换为字符串。
`static String`	`printInteger(BigInteger val)` BigInteger值转换为字符串。
`static String`	`printLong(long val)` 将一个长的值转换为字符串。
`static String`	`printQName(QName val, NamespaceContext nsc)` 转换成一个字符串属性实例。
`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)` 将一个int类型的值转换为字符串。
`static void`	`setDatatypeConverter(DatatypeConverterInterface converter)` 该方法是使用JAXB提供商。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细信息
  - setDatatypeConverter
```
public static void setDatatypeConverter(DatatypeConverterInterface converter)
```
    该方法是使用JAXB提供商。
    JAXB供应商都需要调用这个方法，在一些点在允许任何客户端的数据操作或JAXB元帅发生。这是必要的配置数据类型转换器，可用于打印和解析转换。
    
    调用此API反复将没有效果-进入第一次调用的datatypeconverterinterface实例就是将从此用。
    
    参数
    
    converter -一个类实现的datatypeconverterinterface类此参数不能为空的一个实例。
    
    异常
    
    IllegalArgumentException如果参数为空
    
    SecurityException -如果负责 SecurityManager否认设置数据类型转换器接入。
    
    另请参见：
    
    JAXBPermission
  - parseString
```
public static String parseString(String lexicalXSDString)
```
    将词汇XSD字符串参数为一个字符串值。
    
    参数
    
    lexicalXSDString -一个包含词汇表征XSD：字符串。
    
    结果
    
    由字符串参数表示的字符串值。
  - parseInteger
```
public static BigInteger parseInteger(String lexicalXSDInteger)
```
    将字符串参数为BigInteger值。
    
    参数
    
    lexicalXSDInteger -一个包含词汇表征XSD：整数。
    
    结果
    
    一个由字符串参数表示BigInteger值。
    
    异常
    
    NumberFormatException - lexicalXSDInteger不是一个 BigInteger值有效的字符串表示形式。
  - parseInt
```
public static int parseInt(String lexicalXSDInt)
```
    将字符串参数为一个int值。
    
    参数
    
    lexicalXSDInt -一个包含词汇表征XSD：int。
    
    结果
    
    用字符串表示int值。
    
    异常
    
    NumberFormatException - lexicalXSDInt不是一个 int值有效的字符串表示形式。
  - parseLong
```
public static long parseLong(String lexicalXSDLong)
```
    将字符串参数转换为长值。
    
    参数
    
    lexicalXSDLong -字符串XSD词汇表征：长。
    
    结果
    
    以字符串参数表示的长值。
    
    异常
    
    NumberFormatException - lexicalXSDLong不是一个 long值有效的字符串表示形式。
  - parseShort
```
public static short parseShort(String lexicalXSDShort)
```
    将字符串参数转换成一个短值。
    
    参数
    
    lexicalXSDShort -字符串XSD词汇表示：短。
    
    结果
    
    以字符串参数表示的一个短值。
    
    异常
    
    NumberFormatException - lexicalXSDShort不是一个 short值有效的字符串表示形式。
  - parseDecimal
```
public static BigDecimal parseDecimal(String lexicalXSDDecimal)
```
    将字符串参数为BigDecimal值。
    
    参数
    
    lexicalXSDDecimal -字符串XSD词汇表示：十进制。
    
    结果
    
    BigDecimal值的字符串表示。
    
    异常
    
    NumberFormatException - lexicalXSDDecimal不是 BigDecimal有效的字符串表示形式。
  - parseFloat
```
public static float parseFloat(String lexicalXSDFloat)
```
    将字符串参数转换为浮动值。
    
    参数
    
    lexicalXSDFloat -字符串XSD词汇表征：浮。
    
    结果
    
    以字符串参数表示的浮点值。
    
    异常
    
    NumberFormatException - lexicalXSDFloat不是一个 float值有效的字符串表示形式。
  - parseDouble
```
public static double parseDouble(String lexicalXSDDouble)
```
    将字符串参数转换为双值。
    
    参数
    
    lexicalXSDDouble -字符串XSD词汇表示：双。
    
    结果
    
    以字符串参数表示的双值。
    
    异常
    
    NumberFormatException - lexicalXSDDouble不是一个 double值有效的字符串表示形式。
  - parseBoolean
```
public static boolean parseBoolean(String lexicalXSDBoolean)
```
    将字符串参数转换为布尔值。
    
    参数
    
    lexicalXSDBoolean -字符串XSD词汇表示：布尔。
    
    结果
    
    由字符串参数表示的布尔值。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML Schema定义：2 Datatypes XSD：布尔。
  - parseByte
```
public static byte parseByte(String lexicalXSDByte)
```
    将字符串参数转换为一个字节值。
    
    参数
    
    lexicalXSDByte -字符串XSD词汇表征：字节。
    
    结果
    
    由字符串参数表示的一个字节值。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML Schema定义：2 Datatypes XSD：字节。
  - parseQName
```
public static QName parseQName(String lexicalXSDQName,
                               NamespaceContext nsc)
```
    将字符串参数转换为一个字节值。
    
    字符串参数lexicalXSDQname必须符合指定的词汇价值空间在XML Schema Part 2:Datatypes specification:QNames
    
    参数
    
    lexicalXSDQName -字符串XSD词汇表示：QName。
    
    nsc -命名空间上下文解释在一个QName前缀。
    
    结果
    
    一个由字符串参数值表示的属性。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合XML架构2部分规范或者命名空间前缀的 lexicalXSDQname不一定要在namespacecontext nsc URI。
  - parseDateTime
```
public static Calendar parseDateTime(String lexicalXSDDateTime)
```
    将字符串参数转换为日历值。
    
    参数
    
    lexicalXSDDateTime -字符串XSD词汇表征：日期。
    
    结果
    
    以字符串参数表示的日历对象。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML Schema定义：2部分：Datatypes的XSD日期。
  - parseBase64Binary
```
public static byte[] parseBase64Binary(String lexicalXSDBase64Binary)
```
    将字符串参数转换为字节数组。
    
    参数
    
    lexicalXSDBase64Binary -字符串XSD词汇表征：base64Binary。
    
    结果
    
    由字符串参数表示的字节数组。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML架构2部分：Datatypes：base64Binary XSD定义
  - parseHexBinary
```
public static byte[] parseHexBinary(String lexicalXSDHexBinary)
```
    将字符串参数转换为字节数组。
    
    参数
    
    lexicalXSDHexBinary -字符串XSD词汇表征：hexBinary。
    
    结果
    
    由字符串参数表示的字节数组。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML架构2部分：Datatypes：hexBinary XSD定义。
  - parseUnsignedInt
```
public static long parseUnsignedInt(String lexicalXSDUnsignedInt)
```
    将字符串参数转换为长值。
    
    参数
    
    lexicalXSDUnsignedInt -字符串XSD词汇表示：unsignedint。
    
    结果
    
    以字符串参数表示的长值。
    
    异常
    
    NumberFormatException如果字符串参数不能被解析成一个 long价值。
  - parseUnsignedShort
```
public static int parseUnsignedShort(String lexicalXSDUnsignedShort)
```
    将字符串参数为一个int值。
    
    参数
    
    lexicalXSDUnsignedShort -字符串XSD词汇表示：unsignedshort。
    
    结果
    
    一个int值的字符串表示。
    
    异常
    
    NumberFormatException如果字符串参数不能被解析成一个 int价值。
  - parseTime
```
public static Calendar parseTime(String lexicalXSDTime)
```
    将字符串参数转换为日历值。
    
    参数
    
    lexicalXSDTime -字符串XSD词汇表示：时间。
    
    结果
    
    以字符串参数表示的日历值。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML Schema定义：2 Datatypes XSD：时间。
  - parseDate
```
public static Calendar parseDate(String lexicalXSDDate)
```
    将字符串参数转换为日历值。
    
    参数
    
    lexicalXSDDate -字符串XSD词汇表征：日期。
    
    结果
    
    以字符串参数表示的日历值。
    
    异常
    
    IllegalArgumentException如果字符串参数不符合词汇的价值空间在XML Schema定义：2 Datatypes XSD：日期。
  - parseAnySimpleType
```
public static String parseAnySimpleType(String lexicalXSDAnySimpleType)
```
    返回一个包含简单类型的词法表示的字符串。
    
    参数
    
    lexicalXSDAnySimpleType -字符串的简单类型的词汇表征。
    
    结果
    
    一个包含简单类型的词法表示的字符串。
  - printString
```
public static String printString(String val)
```
    将字符串参数转换为字符串。
    
    参数
    
    val -一个字符串值。
    
    结果
    
    一个包含一个词汇表征XSD：字符串。
  - printInteger
```
public static String printInteger(BigInteger val)
```
    BigInteger值转换为字符串。
    
    参数
    
    val - BigInteger值
    
    结果
    
    一个包含一个词汇表征XSD：整数
    
    异常
    
    IllegalArgumentException - val是空的。
  - printInt
```
public static String printInt(int val)
```
    将一个int类型的值转换为字符串。
    
    参数
    
    val -一个int值
    
    结果
    
    一个包含一个词汇表征XSD：int
  - printLong
```
public static String printLong(long val)
```
    将一个长的值转换为字符串。
    
    参数
    
    val -长值
    
    结果
    
    一个包含一个词汇表征XSD：长
  - printShort
```
public static String printShort(short val)
```
    将一个短值转换成一个字符串。
    
    参数
    
    val -短值
    
    结果
    
    一个包含一个词汇表征XSD：短
  - printDecimal
```
public static String printDecimal(BigDecimal val)
```
    将一个BigDecimal值为字符串。
    
    参数
    
    val - BigDecimal值
    
    结果
    
    一个包含一个词汇表征XSD：十进制
    
    异常
    
    IllegalArgumentException - val是空的。
  - printFloat
```
public static String printFloat(float val)
```
    将一个浮点值转换为字符串。
    
    参数
    
    val -浮点值
    
    结果
    
    一个包含一个词汇表征XSD：浮
  - printDouble
```
public static String printDouble(double val)
```
    将双值转换为字符串。
    
    参数
    
    val -双重价值
    
    结果
    
    一个包含一个词汇表征XSD：双
  - printBoolean
```
public static String printBoolean(boolean val)
```
    将一个布尔值转换为字符串。
    
    参数
    
    val -布尔值
    
    结果
    
    一个包含一个词汇表征XSD：布尔
  - printByte
```
public static String printByte(byte val)
```
    将一个字节值转换为字符串。
    
    参数
    
    val -一个字节值
    
    结果
    
    一个包含一个词汇表征XSD：字节
  - printQName
```
public static String printQName(QName val,
                                NamespaceContext nsc)
```
    转换成一个字符串属性实例。
    
    参数
    
    val -属性值
    
    nsc -命名空间上下文解释在一个QName前缀。
    
    结果
    
    一个包含一个词汇表征QName
    
    异常
    
    IllegalArgumentException -如果 nsc非空或 nsc.getPrefix(nsprefixFromVal) val是null或空。
  - printDateTime
```
public static String printDateTime(Calendar val)
```
    将日历值转换为字符串。
    
    参数
    
    val -日历的价值
    
    结果
    
    一个包含一个词汇表征XSD日期：
    
    异常
    
    IllegalArgumentException -如果 val是空的。
  - printBase64Binary
```
public static String printBase64Binary(byte[] val)
```
    将一个字节数组转换为字符串。
    
    参数
    
    val -字节数组
    
    结果
    
    一个包含一个词汇表示：base64Binary XSD
    
    异常
    
    IllegalArgumentException -如果 val是空的。
  - printHexBinary
```
public static String printHexBinary(byte[] val)
```
    将一个字节数组转换为字符串。
    
    参数
    
    val -字节数组
    
    结果
    
    一个包含一个词汇表征XSD：hexBinary
    
    异常
    
    IllegalArgumentException -如果 val是空的。
  - printUnsignedInt
```
public static String printUnsignedInt(long val)
```
    将一个长的值转换为字符串。
    
    参数
    
    val -长值
    
    结果
    
    一个包含一个词汇表示：unsignedint XSD
  - printUnsignedShort
```
public static String printUnsignedShort(int val)
```
    将一个int类型的值转换为字符串。
    
    参数
    
    val -一个int值
    
    结果
    
    一个包含一个词汇表示：unsignedshort XSD
  - printTime
```
public static String printTime(Calendar val)
```
    将日历值转换为字符串。
    
    参数
    
    val -日历的价值
    
    结果
    
    一个包含一个词汇表征XSD：时间
    
    异常
    
    IllegalArgumentException -如果 val是空的。
  - printDate
```
public static String printDate(Calendar val)
```
    将日历值转换为字符串。
    
    参数
    
    val -日历的价值
    
    结果
    
    一个包含一个词汇表征XSD：日期
    
    异常
    
    IllegalArgumentException -如果 val是空的。
  - printAnySimpleType
```
public static String printAnySimpleType(String val)
```
    将字符串值转换为字符串。
    
    参数
    
    val -一个字符串值
    
    结果
    
    一个包含一个词汇表示：anysimpletype XSD

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class DatatypeConverter

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

setDatatypeConverter

parseString

parseInteger

parseInt

parseLong

parseShort

parseDecimal

parseFloat

parseDouble

parseBoolean

parseByte

parseQName

parseDateTime

parseBase64Binary

parseHexBinary

parseUnsignedInt

parseUnsignedShort

parseTime

parseDate

parseAnySimpleType

printString

printInteger

printInt

printLong

printShort

printDecimal

printFloat

printDouble

printBoolean

printByte

printQName

printDateTime

printBase64Binary

printHexBinary

printUnsignedInt

printUnsignedShort

printTime

printDate

printAnySimpleType