DatatypeConverterInterface (Java Platform SE 8)

```
public interface DatatypeConverterInterface
```
DatatypeConverterInterfaceは、JAXBプロバイダのみによって使用されます。JAXBプロバイダは、このインタフェースを実装したクラスを提供する必要があります。JAXBプロバイダは、最初の整列化または非整列化操作が呼び出される前のある時点で(おそらく、JAXBContext.newInstanceの呼出し中)、DatatypeConverter.setDatatypeConverter APIを呼び出す必要があります。このステップは、出力および解析機能を実行する上で使用すべきコンバータを設定するために必要になります。このAPIを繰返し呼び出しても効果はありません。最初の呼出しに渡されたDatatypeConverterインスタンスが、それ以降使用されるインスタンスです。

このインタフェースは、解析メソッドおよび出力メソッドを定義します。JAXB仕様のデフォルト・バインディング・テーブル5-1で指定された各XMLスキーマ・データ型に対し、1つの解析メソッドおよび出力メソッドがあります。

ここに定義する解析メソッドおよび出力メソッドは、DatatypeConverterクラスに定義されたstatic解析メソッドおよび出力メソッドによって呼び出されます。

XMLスキーマ・データ型用の解析メソッドは、『XML Schema Part2: Datatypes』に指定されているXMLスキーマ・データ型の字句表現を、XMLスキーマ・データ型の値領域内の値に変換できる必要があります。変換中にエラーが発生した場合、このメソッドはIllegalArgumentException、または、IllegalArgumentExceptionのサブクラスをスローする必要があります。

XMLスキーマ・データ型の出力メソッドは、XMLスキーマ・データ型として有効な字句表現を出力可能です。変換中にエラーが発生した場合、このメソッドはIllegalArgumentException、または、IllegalArgumentExceptionのサブクラスをスローする必要があります。
接頭辞xsd: は、『XML Schema Part2: Datatypes』仕様に定義されているXMLスキーマ・データ型を参照するために使用されます。

導入されたバージョン:

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 Schemaデータ型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のxsd:booleanに関する仕様で定義された字句値領域に準拠していない場合。
  - parseByte
```
byte parseByte(String lexicalXSDByte)
```
    文字列引数をbyte値に変換します。
    
    パラメータ:
    
    lexicalXSDByte - xsd:byteの字句表現を含む文字列。
    
    戻り値:
    
    文字列引数が表すbyte値。
    
    例外:
    
    NumberFormatException - lexicalXSDByteが解析可能なbyteを含まない場合。
    
    IllegalArgumentException - 文字列パラメータがXML Schema Part 2: Datatypesのxsd:byteに関する仕様で定義された字句値領域に準拠していない場合。
  - parseQName
```
QName parseQName(String lexicalXSDQName,
                 NamespaceContext nsc)
```
    文字列引数をQName値に変換します。
    文字列パラメータlexicalXSDQnameは、XML Schema Part 2:Datatypes仕様の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のxsd:dateTimeに関する仕様で定義された字句値領域に準拠していない場合。
  - parseBase64Binary
```
byte[] parseBase64Binary(String lexicalXSDBase64Binary)
```
    文字列引数をバイト配列に変換します。
    
    パラメータ:
    
    lexicalXSDBase64Binary - xsd:base64Binaryの字句表現を含む文字列。
    
    戻り値:
    
    文字列引数が表すバイト配列。
    
    例外:
    
    IllegalArgumentException - 文字列パラメータがXML Schema Part 2: Datatypesのxsd:base64Binaryに関する仕様で定義された字句値領域に準拠していない場合
  - parseHexBinary
```
byte[] parseHexBinary(String lexicalXSDHexBinary)
```
    文字列引数をバイト配列に変換します。
    
    パラメータ:
    
    lexicalXSDHexBinary - xsd:hexBinaryの字句表現を含む文字列。
    
    戻り値:
    
    文字列引数が表すバイト配列。
    
    例外:
    
    IllegalArgumentException - 文字列パラメータがXML Schema Part 2: Datatypesの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のxsd:timeに関する仕様で定義された字句値領域に準拠していない場合。
  - parseDate
```
Calendar parseDate(String lexicalXSDDate)
```
    文字列引数をCalendar値に変換します。
    
    パラメータ:
    
    lexicalXSDDate - xsd:Dateの字句表現を含む文字列。
    
    戻り値:
    
    文字列引数が表すCalendar値。
    
    例外:
    
    IllegalArgumentException - 文字列パラメータがXML Schema Part 2: Datatypesのxsd:Dateに関する仕様で定義された字句値領域に準拠していない場合。
  - 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の字句表現を含む文字列

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

インタフェース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