パッケージ jakarta.xml.bind

インターフェース DatatypeConverterInterface

  • 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

    • メソッドの詳細

      • 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 の字句表現を含む文字列