javax.xml.bind
介面 DatatypeConverterInterface

public interface DatatypeConverterInterface

該 DatatypeConverterInterface 僅適用於 JAXB 提供者。JAXB 提供者必須提供一個實作此介面的類別。JAXB 提供者需要在第一次執行編組或解組操作之前（可能在調用 JAXBContext.newInstance 期間）的某個時間點調用 DatatypeConverter.setDatatypeConverter。要配置用於執行列印和解析功能的轉換器，這一步是必需的。重複調用此 api 是無效的，傳入第一個調用中的 DatatypeConverter 實例將是將從那時起有效的實例。

此介面定義了一些 parse 和 print 方法。在 JAXB 規範的預設綁定 Table 5-1 中指定的每個 XML 網要資料型別都有一個 parse 和 print 方法。

此處定義的 parse 和 print 方法由 DatatypeConverter 類別中定義的靜態 parse 和 print 方法調用。

XML 網要資料型別的 parse 方法必須能夠將 XML 網要資料型別的任何詞彙表示形式（由 XML Schema Part 2: Datatypes specification 指定）轉換為 XML 網要資料型別的值空間中的值。如果在轉換期間發生錯誤，則該方法將拋出 IllegalArgumentException，或者拋出 IllegalArgumentException 的子類別。

XML 網要資料型別的 print 方法可以輸出對於 XML 網要資料型別有效的任何詞彙表示形式。如果在轉換期間發生錯誤，則該方法將拋出 IllegalArgumentException，或者拋出 IllegalArgumentException 的子類別。

前綴 xsd：用於參考 XML 網要資料型別 XML Schema Part 2: Datatypes specification。

從以下版本開始：

JAXB1.0

另請參見：

DatatypeConverter, ParseConversionEvent, PrintConversionEvent

方法摘要

String	parseAnySimpleType(String lexicalXSDAnySimpleType) 返回包含簡單型別的詞彙表示形式的字元串。
byte[]	parseBase64Binary(String lexicalXSDBase64Binary) 將字元串參數轉換為一個位元組陣列。
boolean	parseBoolean(String lexicalXSDBoolean) 將字元串參數轉換為一個 boolean 值。
byte	parseByte(String lexicalXSDByte) 將字元串參數轉換為一個 byte 值。
Calendar	parseDate(String lexicalXSDDate) 將字元串參數轉換為一個 Calendar 值。
Calendar	parseDateTime(String lexicalXSDDateTime) 將字元串參數轉換為一個 Calendar 值。
BigDecimal	parseDecimal(String lexicalXSDDecimal) 將字元串參數轉換為一個 BigDecimal 值。
double	parseDouble(String lexicalXSDDouble) 將字元串參數轉換為一個 double 值。
float	parseFloat(String lexicalXSDFloat) 將字元串參數轉換為一個 float 值。
byte[]	parseHexBinary(String lexicalXSDHexBinary) 將字元串參數轉換為一個位元組陣列。
int	parseInt(String lexicalXSDInt) 將字元串參數轉換為一個 int 值。
BigInteger	parseInteger(String lexicalXSDInteger) 將字元串參數轉換為一個 BigInteger 值。
long	parseLong(String lexicalXSDLong) 將字元串參數轉換為一個 long 值。
QName	parseQName(String lexicalXSDQName, NamespaceContext nsc) 將字元串參數轉換為一個 QName 值。
short	parseShort(String lexicalXSDShort) 將字元串參數轉換為一個 short 值。
String	parseString(String lexicalXSDString) 將字元串參數轉換為一個字元串。
Calendar	parseTime(String lexicalXSDTime) 將字元串參數轉換為一個 Calendar 值。
long	parseUnsignedInt(String lexicalXSDUnsignedInt) 將字元串參數轉換為一個 long 值。
int	parseUnsignedShort(String lexicalXSDUnsignedShort) 將字元串參數轉換為一個 int 值。
String	printAnySimpleType(String val) 將字元串值轉換為一個字元串。
String	printBase64Binary(byte[] val) 將位元組陣列轉換為一個字元串。
String	printBoolean(boolean val) 將 boolean 值轉換為一個字元串。
String	printByte(byte val) 將 byte 值轉換為一個字元串。
String	printDate(Calendar val) 將 Calendar 值轉換為一個字元串。
String	printDateTime(Calendar val) 將 Calendar 值轉換為一個字元串。
String	printDecimal(BigDecimal val) 將 BigDecimal 值轉換為一個字元串。
String	printDouble(double val) 將 double 值轉換為一個字元串。
String	printFloat(float val) 將 float 值轉換為一個字元串。
String	printHexBinary(byte[] val) 將位元組陣列轉換為一個字元串。
String	printInt(int val) 將 int 值轉換為一個字元串。
String	printInteger(BigInteger val) 將 BigInteger 值轉換為一個字元串。
String	printLong(long val) 將 long 值轉換為一個字元串。
String	printQName(QName val, NamespaceContext nsc) 將 QName 實例轉換為一個字元串。
String	printShort(short val) 將 short 值轉換為一個字元串。
String	printString(String val) 將字元串參數轉換為一個字元串。
String	printTime(Calendar val) 將 Calendar 值轉換為一個字元串。
String	printUnsignedInt(long val) 將 long 值轉換為一個字元串。
String	printUnsignedShort(int val) 將 int 值轉換為一個字元串。

方法詳細資訊

parseString

String parseString(String lexicalXSDString)

將字元串參數轉換為一個字元串。

參數：

lexicalXSDString - XML 網要資料型別 xsd:string 的詞彙表示形式

返回：

與輸入字元串相同的字元串。

parseInteger

BigInteger parseInteger(String lexicalXSDInteger)

將字元串參數轉換為一個 BigInteger 值。

參數：

lexicalXSDInteger - 套件含 xsd:integer 的詞彙表示形式的字元串。

返回：

字元串參數表示的 BigInteger 值。

拋出：

NumberFormatException - 如果 lexicalXSDInteger 不是 BigInteger 值的有效字元串表示形式。

parseInt

int parseInt(String lexicalXSDInt)

將字元串參數轉換為一個 int 值。

參數：

lexicalXSDInt - 套件含 xsd:int 的詞彙表示形式的字元串。

返回：

字元串參數表示的 int 值。

拋出：

NumberFormatException - 如果 lexicalXSDInt 不是 int 值的有效字元串表示形式。

parseLong

long parseLong(String lexicalXSDLong)

將字元串參數轉換為一個 long 值。

參數：

lexicalXSDLong - 套件含 xsd:long 的詞彙表示形式的字元串。

返回：

字元串參數表示的 long 值。

拋出：

NumberFormatException - 如果 lexicalXSDLong 不是 long 值的有效字元串表示形式。

parseShort

short parseShort(String lexicalXSDShort)

將字元串參數轉換為一個 short 值。

參數：

lexicalXSDShort - 套件含 xsd:short 的詞彙表示形式的字元串。

返回：

字元串參數表示的 short 值。

拋出：

NumberFormatException - 如果 lexicalXSDShort 不是 short 值的有效字元串表示形式。

parseDecimal

BigDecimal parseDecimal(String lexicalXSDDecimal)

將字元串參數轉換為一個 BigDecimal 值。

參數：

lexicalXSDDecimal - 套件含 xsd:decimal 的詞彙表示形式的字元串。

返回：

字元串參數表示的 BigDecimal 值。

拋出：

NumberFormatException - 如果 lexicalXSDDecimal 不是 BigDecimal 的有效字元串表示形式。

parseFloat

float parseFloat(String lexicalXSDFloat)

將字元串參數轉換為一個 float 值。

參數：

lexicalXSDFloat - 套件含 xsd:float 的詞彙表示形式的字元串。

返回：

字元串參數表示的 float 值。

拋出：

NumberFormatException - 如果 lexicalXSDFloat 不是 float 值的有效字元串表示形式。

parseDouble

double parseDouble(String lexicalXSDDouble)

將字元串參數轉換為一個 double 值。

參數：

lexicalXSDDouble - 套件含 xsd:double 的詞彙表示形式的字元串。

返回：

字元串參數表示的 double 值。

拋出：

NumberFormatException - 如果 lexicalXSDDouble 不是 double 值的有效字元串表示形式。

parseBoolean

boolean parseBoolean(String lexicalXSDBoolean)

將字元串參數轉換為一個 boolean 值。

參數：

lexicalXSDBoolean - 套件含 xsd:boolean 的詞彙表示形式的字元串。

返回：

字元串參數表示的 boolean 值。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:boolean 中定義的詞彙值空間。

parseByte

byte parseByte(String lexicalXSDByte)

將字元串參數轉換為一個 byte 值。

參數：

lexicalXSDByte - 套件含 xsd:byte 的詞彙表示形式的字元串。

返回：

字元串參數表示的 byte 值。

拋出：

NumberFormatException - 如果 lexicalXSDByte 不包含可解析的位元組。

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:byte 中定義的詞彙值空間。

parseQName

QName parseQName(String lexicalXSDQName,
                 NamespaceContext nsc)

將字元串參數轉換為一個 QName 值。

字元串參數 lexicalXSDQname 必須符合 XML Schema Part 2: Datatypes specification:QNames 中指定的詞彙值空間。

參數：

lexicalXSDQName - 套件含 xsd:QName 的詞彙表示形式的字元串。

nsc - 解釋 QName 中前綴的名稱空間上下文。

返回：

字元串參數表示的 QName 值。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2 規範，或者 lexicalXSDQname 的名稱空間前綴未綁定到 NamespaceContext nsc 中的 URI。

parseDateTime

Calendar parseDateTime(String lexicalXSDDateTime)

將字元串參數轉換為一個 Calendar 值。

參數：

lexicalXSDDateTime - 套件含 xsd:datetime 的詞彙表示形式的字元串。

返回：

字元串參數表示的 Calendar 物件。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:dateTime 中定義的詞彙值空間。

parseBase64Binary

byte[] parseBase64Binary(String lexicalXSDBase64Binary)

將字元串參數轉換為一個位元組陣列。

參數：

lexicalXSDBase64Binary - 套件含 xsd:base64Binary 的詞彙表示形式的字元串。

返回：

字元串參數表示的位元組陣列。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:base64Binary 中定義的詞彙值空間。

parseHexBinary

byte[] parseHexBinary(String lexicalXSDHexBinary)

將字元串參數轉換為一個位元組陣列。

參數：

lexicalXSDHexBinary - 套件含 xsd:hexBinary 的詞彙表示形式的字元串。

返回：

字元串參數表示的位元組陣列。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:hexBinary 中定義的詞彙值空間。

parseUnsignedInt

long parseUnsignedInt(String lexicalXSDUnsignedInt)

將字元串參數轉換為一個 long 值。

參數：

lexicalXSDUnsignedInt - 套件含 xsd:unsignedInt 的詞彙表示形式的字元串。

返回：

字元串參數表示的 long 值。

拋出：

NumberFormatException - 如果不能將字元串參數解析為 long 值。

parseUnsignedShort

int parseUnsignedShort(String lexicalXSDUnsignedShort)

將字元串參數轉換為一個 int 值。

參數：

lexicalXSDUnsignedShort - 套件含 xsd:unsignedShort 的詞彙表示形式的字元串。

返回：

字元串參數表示的 int 值。

拋出：

NumberFormatException - 如果不能將字元串參數解析為 int 值。

parseTime

Calendar parseTime(String lexicalXSDTime)

將字元串參數轉換為一個 Calendar 值。

參數：

lexicalXSDTime - 套件含 xsd:Time 的詞彙表示形式的字元串。

返回：

字元串參數表示的 Calendar 值。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:Time 中定義的詞彙值空間。

parseDate

Calendar parseDate(String lexicalXSDDate)

將字元串參數轉換為一個 Calendar 值。

參數：

lexicalXSDDate - 套件含 xsd:Date 的詞彙表示形式的字元串。

返回：

字元串參數表示的 Calendar 值。

拋出：

IllegalArgumentException - 如果字元串參數不符合 XML Schema Part 2: Datatypes for xsd:Time 中定義的詞彙值空間。

parseAnySimpleType

String parseAnySimpleType(String lexicalXSDAnySimpleType)

返回包含簡單型別的詞彙表示形式的字元串。

參數：

lexicalXSDAnySimpleType - 套件含簡單型別的詞彙表示形式的字元串。

返回：

包含簡單型別的詞彙表示形式的字元串。

printString

String printString(String val)

將字元串參數轉換為一個字元串。

參數：

val - 字元串值。

返回：

包含 xsd:string 的詞彙表示形式的字元串

printInteger

String printInteger(BigInteger val)

將 BigInteger 值轉換為一個字元串。

參數：

val - 一個 BigInteger 值

返回：

包含 xsd:integer 的詞彙表示形式的字元串

拋出：

IllegalArgumentException - 如果 val 為 null。

printInt

String printInt(int val)

將 int 值轉換為一個字元串。

參數：

val - 一個 int 值

返回：

包含 xsd:int 的詞彙表示形式的字元串

printLong

String printLong(long val)

將 long 值轉換為一個字元串。

參數：

val - 一個 long 值

返回：

包含 xsd:long 的詞彙表示形式的字元串

printShort

String printShort(short val)

將 short 值轉換為一個字元串。

參數：

val - 一個 short 值

返回：

包含 xsd:short 的詞彙表示形式的字元串

printDecimal

String printDecimal(BigDecimal val)

將 BigDecimal 值轉換為一個字元串。

參數：

val - 一個 BigDecimal 值

返回：

包含 xsd:decimal 的詞彙表示形式的字元串

拋出：

IllegalArgumentException - 如果 val 為 null。

printFloat

String printFloat(float val)

將 float 值轉換為一個字元串。

參數：

val - 一個 float 值

返回：

包含 xsd:float 的詞彙表示形式的字元串

printDouble

String printDouble(double val)

將 double 值轉換為一個字元串。

參數：

val - 一個 double 值

返回：

包含 xsd:double 的詞彙表示形式的字元串

printBoolean

String printBoolean(boolean val)

將 boolean 值轉換為一個字元串。

參數：

val - 一個 boolean 值

返回：

包含 xsd:boolean 的詞彙表示形式的字元串

printByte

String printByte(byte val)

將 byte 值轉換為一個字元串。

參數：

val - 一個 byte 值

返回：

包含 xsd:byte 的詞彙表示形式的字元串

printQName

String printQName(QName val,
                  NamespaceContext nsc)

將 QName 實例轉換為一個字元串。

參數：

val - 一個 QName 值

nsc - 解釋 QName 中前綴的名稱空間上下文。

返回：

包含 QName 的詞彙表示形式的字元串

拋出：

IllegalArgumentException - 如果 val 為 null、nsc 為非 null 或 nsc.getPrefix(nsprefixFromVal) 為 null。

printDateTime

String printDateTime(Calendar val)

將 Calendar 值轉換為一個字元串。

參數：

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)

將 long 值轉換為一個字元串。

參數：

val - 一個 long 值

返回：

包含 xsd:unsignedInt 的詞彙表示形式的字元串

printUnsignedShort

String printUnsignedShort(int val)

將 int 值轉換為一個字元串。

參數：

val - 一個 int 值

返回：

包含 xsd:unsignedShort 的詞彙表示形式的字元串

printTime

String printTime(Calendar val)

將 Calendar 值轉換為一個字元串。

參數：

val - 一個 Calendar 值

返回：

包含 xsd:time 的詞彙表示形式的字元串

拋出：

IllegalArgumentException - 如果 val 為 null。

printDate

String printDate(Calendar val)

將 Calendar 值轉換為一個字元串。

參數：

val - 一個 Calendar 值

返回：

包含 xsd:date 的詞彙表示形式的字元串

拋出：

IllegalArgumentException - 如果 val 為 null。

printAnySimpleType

String printAnySimpleType(String val)

將字元串值轉換為一個字元串。

參數：

val - 字元串值

返回：

包含 xsd:AnySimpleType 的詞彙表示形式的字元串