DatatypeConverterInterface (Jakarta EE Platform API)

```
public interface DatatypeConverterInterface
```
DatatypeConverterInterface は、Jakarta XML Binding プロバイダー専用です。Jakarta XML Binding プロバイダーは、このインターフェースを実装するクラスを提供する必要があります。Jakarta XML Binding Providers は、最初のマーシャルまたはアンマーシャル操作の前のある時点で（おそらく、JAXBContext.newInstance の呼び出し中に）DatatypeConverter.setDatatypeConverter API を呼び出す必要があります。この手順は、出力および解析機能を実行するために使用する必要があるコンバーターを構成するために必要です。この API を繰り返し呼び出しても効果はありません。最初の呼び出しに渡された DatatypeConverter インスタンスは、それ以降に使用されるインスタンスです。
このインターフェースは、解析メソッドと出力メソッドを定義します。Jakarta XML Binding 仕様のデフォルトのバインディング表 5-1 で指定されている XML スキーマデータ型ごとに 1 つの解析および出力メソッドがあります。
ここで定義されている parse メソッドと print メソッドは、DatatypeConverter クラスで定義されている静的な parse メソッドと print メソッドによって呼び出されます。
XML スキーマデータ型の parse メソッドは、XML スキーマデータ型の字句表現（XML スキーマ Part2: データ型の仕様によって指定された XML スキーマデータ型の値空間の値に変換できる必要があります。変換中にエラーが発生した場合は、IllegalArgumentException または、IllegalArgumentException のサブクラスをメソッドでスローする必要があります。
XML スキーマデータ型の print メソッドは、XML スキーマデータ型に関して有効な任意の字句表現を出力できます。変換中にエラーが発生した場合は、IllegalArgumentException または IllegalArgumentException のサブクラスをメソッドでスローする必要があります。
プレフィックス xsd: XML スキーマデータ型 XML スキーマ Part2: データ型の仕様を参照するために使用されます。
導入:
1.6、JAXB 1.0
作成者:
- Sekhar Vajjhala, Sun Microsystems, Inc.
- Joe Fialli, Sun Microsystems Inc.
- Kohsuke Kawaguchi, Sun Microsystems, Inc.
- Ryan Shoemaker,Sun Microsystems Inc.
関連事項:
DatatypeConverter, ParseConversionEvent, PrintConversionEvent

方法の概要

すべてのメソッドインスタンスメソッド抽象メソッド
修飾子と型	メソッドと説明
`StringSE`	`parseAnySimpleType(StringSE lexicalXSDAnySimpleType)` 単純型の字句表現を含む文字列を返します。
`byte[]`	`parseBase64Binary(StringSE lexicalXSDBase64Binary)` 文字列引数をバイトの配列に変換します。
`boolean`	`parseBoolean(StringSE lexicalXSDBoolean)` 文字列引数をブール値に変換します。
`byte`	`parseByte(StringSE lexicalXSDByte)` 文字列引数をバイト値に変換します。
`CalendarSE`	`parseDate(StringSE lexicalXSDDate)` 文字列引数をカレンダー値に変換します。
`CalendarSE`	`parseDateTime(StringSE lexicalXSDDateTime)` 文字列引数をカレンダー値に変換します。
`BigDecimalSE`	`parseDecimal(StringSE lexicalXSDDecimal)` 文字列引数を BigDecimal 値に変換します。
`double`	`parseDouble(StringSE lexicalXSDDouble)` 文字列引数を double 値に変換します。
`float`	`parseFloat(StringSE lexicalXSDFloat)` 文字列引数を float 値に変換します。
`byte[]`	`parseHexBinary(StringSE lexicalXSDHexBinary)` 文字列引数をバイトの配列に変換します。
`int`	`parseInt(StringSE lexicalXSDInt)` 文字列引数を int 値に変換します。
`BigIntegerSE`	`parseInteger(StringSE lexicalXSDInteger)` 文字列引数を BigInteger 値に変換します。
`long`	`parseLong(StringSE lexicalXSDLong)` 文字列引数を long 値に変換します。
`QNameSE`	`parseQName(StringSE lexicalXSDQName, NamespaceContextSE nsc)` 文字列引数を QName 値に変換します。
`short`	`parseShort(StringSE lexicalXSDShort)` 文字列引数を短い値に変換します。
`StringSE`	`parseString(StringSE lexicalXSDString)` 文字列引数を文字列に変換します。
`CalendarSE`	`parseTime(StringSE lexicalXSDTime)` 文字列引数をカレンダー値に変換します。
`long`	`parseUnsignedInt(StringSE lexicalXSDUnsignedInt)` 文字列引数を long 値に変換します。
`int`	`parseUnsignedShort(StringSE lexicalXSDUnsignedShort)` 文字列引数を int 値に変換します。
`StringSE`	`printAnySimpleType(StringSE val)` 文字列値を文字列に変換します。
`StringSE`	`printBase64Binary(byte[] val)` バイトの配列を文字列に変換します。
`StringSE`	`printBoolean(boolean val)` ブール値を文字列に変換します。
`StringSE`	`printByte(byte val)` バイト値を文字列に変換します。
`StringSE`	`printDate(CalendarSE val)` カレンダー値を文字列に変換します。
`StringSE`	`printDateTime(CalendarSE val)` カレンダー値を文字列に変換します。
`StringSE`	`printDecimal(BigDecimalSE val)` BigDecimal 値を文字列に変換します。
`StringSE`	`printDouble(double val)` double 値を文字列に変換します。
`StringSE`	`printFloat(float val)` float 値を文字列に変換します。
`StringSE`	`printHexBinary(byte[] val)` バイトの配列を文字列に変換します。
`StringSE`	`printInt(int val)` int 値を文字列に変換します。
`StringSE`	`printInteger(BigIntegerSE val)` BigInteger 値を文字列に変換します。
`StringSE`	`printLong(long val)` long 値を文字列に変換します。
`StringSE`	`printQName(QNameSE val, NamespaceContextSE nsc)` QName インスタンスを文字列に変換します。
`StringSE`	`printShort(short val)` 短い値を文字列に変換します。
`StringSE`	`printString(StringSE val)` 文字列引数を文字列に変換します。
`StringSE`	`printTime(CalendarSE val)` カレンダー値を文字列に変換します。
`StringSE`	`printUnsignedInt(long val)` long 値を文字列に変換します。
`StringSE`	`printUnsignedShort(int val)` int 値を文字列に変換します。

- メソッドの詳細
  - parseString
```
StringSE parseString(StringSE lexicalXSDString)
```
    文字列引数を文字列に変換します。
    パラメーター:
    lexicalXSDString - XML スキーマデータ型 xsd:string の字句表現
    戻り値:
    入力文字列と同じ文字列。
  - parseInteger
```
BigIntegerSE parseInteger(StringSE lexicalXSDInteger)
```
    文字列引数を BigInteger 値に変換します。
    パラメーター:
    lexicalXSDInteger - xsd:integer の字句表現を含む文字列。
    戻り値:
    文字列引数で表される BigInteger 値。
    例外:
    NumberFormatExceptionSE - lexicalXSDInteger は、BigIntegerSE 値の有効な文字列表現ではありません。
  - parseInt
```
int parseInt(StringSE lexicalXSDInt)
```
    文字列引数を int 値に変換します。
    パラメーター:
    lexicalXSDInt - xsd:int の字句表現を含む文字列。
    戻り値:
    int 値は、文字列引数のバイトを表します。
    例外:
    NumberFormatExceptionSE - lexicalXSDInt は、int 値の有効な文字列表現ではありません。
  - parseLong
```
long parseLong(StringSE lexicalXSDLong)
```
    文字列引数を long 値に変換します。
    パラメーター:
    lexicalXSDLong - xsd:long の字句表現を含む文字列。
    戻り値:
    文字列引数で表される長い値。
    例外:
    NumberFormatExceptionSE - lexicalXSDLong は、long 値の有効な文字列表現ではありません。
  - parseShort
```
short parseShort(StringSE lexicalXSDShort)
```
    文字列引数を短い値に変換します。
    パラメーター:
    lexicalXSDShort - xsd:short の字句表現を含む文字列。
    戻り値:
    文字列引数で表される短い値。
    例外:
    NumberFormatExceptionSE - lexicalXSDShort は、short 値の有効な文字列表現ではありません。
  - parseDecimal
```
BigDecimalSE parseDecimal(StringSE lexicalXSDDecimal)
```
    文字列引数を BigDecimal 値に変換します。
    パラメーター:
    lexicalXSDDecimal - xsd:decimal の字句表現を含む文字列。
    戻り値:
    文字列引数で表される BigDecimal 値。
    例外:
    NumberFormatExceptionSE - lexicalXSDDecimal は、BigDecimalSE の有効な文字列表現ではありません。
  - parseFloat
```
float parseFloat(StringSE lexicalXSDFloat)
```
    文字列引数を float 値に変換します。
    パラメーター:
    lexicalXSDFloat - xsd:float の字句表現を含む文字列。
    戻り値:
    文字列引数で表される浮動小数点値。
    例外:
    NumberFormatExceptionSE - lexicalXSDFloat は、float 値の有効な文字列表現ではありません。
  - parseDouble
```
double parseDouble(StringSE lexicalXSDDouble)
```
    文字列引数を double 値に変換します。
    パラメーター:
    lexicalXSDDouble - xsd:double の字句表現を含む文字列。
    戻り値:
    文字列引数で表される double 値。
    例外:
    NumberFormatExceptionSE - lexicalXSDDouble は、double 値の有効な文字列表現ではありません。
  - parseBoolean
```
boolean parseBoolean(StringSE lexicalXSDBoolean)
```
    文字列引数をブール値に変換します。
    パラメーター:
    lexicalXSDBoolean - xsd:boolean の字句表現を含む文字列。
    戻り値:
    文字列引数で表されるブール値。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが XML スキーマパート 2 で定義されている字句値スペースに準拠していない場合: xsd:boolean のデータ型。
  - parseByte
```
byte parseByte(StringSE lexicalXSDByte)
```
    文字列引数をバイト値に変換します。
    パラメーター:
    lexicalXSDByte - xsd:byte の字句表現を含む文字列。
    戻り値:
    文字列引数で表されるバイト値。
    例外:
    NumberFormatExceptionSE - lexicalXSDByte には、解析可能なバイトが含まれていません。
    IllegalArgumentExceptionSE - 文字列パラメーターが XML スキーマパート 2 で定義されている字句値スペースに準拠していない場合: xsd:byte のデータ型。
  - parseQName
```
QNameSE parseQName(StringSE lexicalXSDQName,
                 NamespaceContextSE nsc)
```
    文字列引数を QName 値に変換します。
    文字列パラメーター lexicalXSDQname は、XML スキーマパート 2: データ型の仕様: QNames で指定された字句値スペースに準拠している必要があります
    パラメーター:
    lexicalXSDQName - xsd:QName の字句表現を含む文字列。
    nsc - QName 内のプレフィックスを解釈するための名前空間コンテキスト。
    戻り値:
    文字列引数で表される QName 値。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが XML スキーマパート 2 仕様に準拠していない場合、または lexicalXSDQname の名前空間プレフィックスが NamespaceContext nsc の URI にバインドされていない場合。
  - parseDateTime
```
CalendarSE parseDateTime(StringSE lexicalXSDDateTime)
```
    文字列引数をカレンダー値に変換します。
    パラメーター:
    lexicalXSDDateTime - xsd:datetime の字句表現を含む文字列。
    戻り値:
    文字列引数で表される Calendar オブジェクト。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが、XML スキーマパート 2: xsd:dateTime のデータ型で定義されている字句値空間に準拠していない場合。
  - parseBase64Binary
```
byte[] parseBase64Binary(StringSE lexicalXSDBase64Binary)
```
    文字列引数をバイトの配列に変換します。
    パラメーター:
    lexicalXSDBase64Binary - xsd:base64Binary の字句表現を含む文字列。
    戻り値:
    文字列引数で表されるバイトの配列。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが XML スキーマパート 2 で定義された字句値スペースに準拠していない場合: xsd:base64Binary のデータ型
  - parseHexBinary
```
byte[] parseHexBinary(StringSE lexicalXSDHexBinary)
```
    文字列引数をバイトの配列に変換します。
    パラメーター:
    lexicalXSDHexBinary - xsd:hexBinary の字句表現を含む文字列。
    戻り値:
    文字列引数で表されるバイトの配列。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが、XML スキーマパート 2: xsd:hexBinary のデータ型で定義されている字句値空間に準拠していない場合。
  - parseUnsignedInt
```
long parseUnsignedInt(StringSE lexicalXSDUnsignedInt)
```
    文字列引数を long 値に変換します。
    パラメーター:
    lexicalXSDUnsignedInt - xsd:unsignedInt の字句表現を含む文字列。
    戻り値:
    文字列引数で表される長い値。
    例外:
    NumberFormatExceptionSE - 文字列パラメーターを解析して long 値にできない場合。
  - parseUnsignedShort
```
int parseUnsignedShort(StringSE lexicalXSDUnsignedShort)
```
    文字列引数を int 値に変換します。
    パラメーター:
    lexicalXSDUnsignedShort - xsd:unsignedShort の字句表現を含む文字列。
    戻り値:
    文字列引数で表される int 値。
    例外:
    NumberFormatExceptionSE - 文字列パラメーターを解析して int 値にできない場合。
  - parseTime
```
CalendarSE parseTime(StringSE lexicalXSDTime)
```
    文字列引数をカレンダー値に変換します。
    パラメーター:
    lexicalXSDTime - xsd:Time の字句表現を含む文字列。
    戻り値:
    文字列引数で表されるカレンダ値。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが XML スキーマパート 2 で定義されている字句値スペースに準拠していない場合: xsd:Time のデータ型。
  - parseDate
```
CalendarSE parseDate(StringSE lexicalXSDDate)
```
    文字列引数をカレンダー値に変換します。
    パラメーター:
    lexicalXSDDate - xsd:Date の字句表現を含む文字列。
    戻り値:
    文字列引数で表されるカレンダ値。
    例外:
    IllegalArgumentExceptionSE - 文字列パラメーターが XML スキーマパート 2:xsd:Date のデータ型で定義されている字句値スペースに準拠していない場合。
  - parseAnySimpleType
```
StringSE parseAnySimpleType(StringSE lexicalXSDAnySimpleType)
```
    単純型の字句表現を含む文字列を返します。
    パラメーター:
    lexicalXSDAnySimpleType - 単純型の字句表現を含む文字列。
    戻り値:
    単純型の字句表現を含む文字列。
  - printString
```
StringSE printString(StringSE val)
```
    文字列引数を文字列に変換します。
    パラメーター:
    val - 文字列値。
    戻り値:
    xsd:string の字句表現を含む文字列
  - printInteger
```
StringSE printInteger(BigIntegerSE val)
```
    BigInteger 値を文字列に変換します。
    パラメーター:
    val - BigInteger 値
    戻り値:
    xsd:integer の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null です。
  - printInt
```
StringSE printInt(int val)
```
    int 値を文字列に変換します。
    パラメーター:
    val - int 値
    戻り値:
    xsd:int の字句表現を含む文字列
  - printLong
```
StringSE printLong(long val)
```
    long 値を文字列に変換します。
    パラメーター:
    val - 長い値
    戻り値:
    xsd:long の字句表現を含む文字列
  - printShort
```
StringSE printShort(short val)
```
    短い値を文字列に変換します。
    パラメーター:
    val - 短い値
    戻り値:
    xsd:short の字句表現を含む文字列
  - printDecimal
```
StringSE printDecimal(BigDecimalSE val)
```
    BigDecimal 値を文字列に変換します。
    パラメーター:
    val - BigDecimal 値
    戻り値:
    xsd:decimal の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null です。
  - printFloat
```
StringSE printFloat(float val)
```
    float 値を文字列に変換します。
    パラメーター:
    val - 浮動小数点値
    戻り値:
    xsd:float の字句表現を含む文字列
  - printDouble
```
StringSE printDouble(double val)
```
    double 値を文字列に変換します。
    パラメーター:
    val - 二重値
    戻り値:
    xsd:double の字句表現を含む文字列
  - printBoolean
```
StringSE printBoolean(boolean val)
```
    ブール値を文字列に変換します。
    パラメーター:
    val - ブール値
    戻り値:
    xsd:boolean の字句表現を含む文字列
  - printByte
```
StringSE printByte(byte val)
```
    バイト値を文字列に変換します。
    パラメーター:
    val - バイト値
    戻り値:
    xsd:byte の字句表現を含む文字列
  - printQName
```
StringSE printQName(QNameSE val,
                  NamespaceContextSE nsc)
```
    QName インスタンスを文字列に変換します。
    パラメーター:
    val - QName 値
    nsc - QName 内のプレフィックスを解釈するための名前空間コンテキスト。
    戻り値:
    QName の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null の場合、または nsc が null でない場合、nsc.getPrefix(nsprefixFromVal) が null の場合。
  - printDateTime
```
StringSE printDateTime(CalendarSE val)
```
    カレンダー値を文字列に変換します。
    パラメーター:
    val - カレンダー値
    戻り値:
    xsd:dateTime の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null の場合。
  - printBase64Binary
```
StringSE printBase64Binary(byte[] val)
```
    バイトの配列を文字列に変換します。
    パラメーター:
    val - バイトの配列
    戻り値:
    xsd:base64Binary の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null の場合。
  - printHexBinary
```
StringSE printHexBinary(byte[] val)
```
    バイトの配列を文字列に変換します。
    パラメーター:
    val - バイトの配列
    戻り値:
    xsd:hexBinary の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null の場合。
  - printUnsignedInt
```
StringSE printUnsignedInt(long val)
```
    long 値を文字列に変換します。
    パラメーター:
    val - 長い値
    戻り値:
    xsd:unsignedInt の字句表現を含む文字列
  - printUnsignedShort
```
StringSE printUnsignedShort(int val)
```
    int 値を文字列に変換します。
    パラメーター:
    val - int 値
    戻り値:
    xsd:unsignedShort の字句表現を含む文字列
  - printTime
```
StringSE printTime(CalendarSE val)
```
    カレンダー値を文字列に変換します。
    パラメーター:
    val - カレンダー値
    戻り値:
    xsd:time の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null の場合。
  - printDate
```
StringSE printDate(CalendarSE val)
```
    カレンダー値を文字列に変換します。
    パラメーター:
    val - カレンダー値
    戻り値:
    xsd:date の字句表現を含む文字列
    例外:
    IllegalArgumentExceptionSE - val が null の場合。
  - printAnySimpleType
```
StringSE printAnySimpleType(StringSE val)
```
    文字列値を文字列に変換します。
    パラメーター:
    val - 文字列値
    戻り値:
    xsd:AnySimpleType の字句表現を含む文字列

インターフェース DatatypeConverterInterface

方法の概要

メソッドの詳細

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