-
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スキーマ・データ型を参照するために使用されます。
- 導入されたバージョン:
- 1.6, JAXB 1.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
の名前空間接頭辞がNamespaceContextnsc
内の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の場合。
-
-