モジュール java.xml
パッケージ javax.xml.datatype

クラスDatatypeFactory

  • public abstract class DatatypeFactory
extends Object
    XMLをJava Objectへ、あるいはJava Objectからマップする新しいjavax.xml.datatype Objectを作成するファクトリです。

    DatatypeFactoryの新しいインスタンスは、newInstance()メソッドによって作成されます。このメソッドでは、次の実装解決メカニズムを使用して実装が決定されます。

    1. DATATYPEFACTORY_PROPERTYによって指定されたシステム・プロパティ、「javax.xml.datatype.DatatypeFactory」が存在する場合は、そのプロパティ値の名前を持つクラスがインスタンス化されます。 インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationExceptionとしてラップされます。

    2. 構成ファイル"jaxp.properties"を使用します。 このファイルは標準のProperties形式であり、通常Javaインストールのconfディレクトリにあります。 これには、実装クラスの完全修飾名が格納されています。

      jaxp.propertiesファイルはJAXP実装によって一度だけ読み込まれ、その値は将来の使用のためにキャッシュされます。 最初の読込み時にファイルが存在しないと、そのあとにその存在がチェックされることはない。 最初に読み込まれたあと、jaxp.propertiesのプロパティの値を変更することはできない。

    3. ServiceLoaderクラスで定義されているサービス・プロバイダ・ローディング機能を使用して、デフォルトのロード・メカニズムを使用してサービスの実装を特定してロード: サービス・プロバイダ・ローディング機能は、現在のスレッド・コンテキスト・クラス・ローダーを使用してサービスをロードしようとします。 コンテキスト・クラス・ローダーがnullの場合、システム・クラス・ローダーが使用されます。

      サービス構成エラー,が発生した場合は、DatatypeConfigurationExceptionがスローされます。

    4. 最後のメカニズムは、DATATYPEFACTORY_IMPLEMENTATION_CLASSで指定されたClassのインスタンス化を試みることです。 インスタンス化のプロセス中にスローされた例外は、DatatypeConfigurationExceptionとしてラップされます。

    導入されたバージョン:
    1.5

    • フィールドの詳細

      • DATATYPEFACTORY_PROPERTY

        public static final String DATATYPEFACTORY_PROPERTY
        JSR 206: Java(TM) API for XML Processing (JAXP) 1.3で定義されているデフォルトの実装クラス名です。

        デフォルト値はjavax.xml.datatype.DatatypeFactoryです。

        関連項目:
        定数フィールド値

      • DATATYPEFACTORY_IMPLEMENTATION_CLASS

        public static final String DATATYPEFACTORY_IMPLEMENTATION_CLASS
        JSR 206: Java(TM) API for XML Processing (JAXP) 1.3で定義されているデフォルトの実装クラス名です。

        その他の実装解決メカニズムが成功しない場合、実装はインスタンス化される適切なクラスの名前を指定する必要があります。

        ユーザーはこのフィールドを参照すべきではありません。ファクトリ実装の詳細を文書化することだけを目的としています。

    • コンストラクタの詳細

      • DatatypeFactory

        protected DatatypeFactory()
        パッケージ外のインスタンス化を防ぐための保護されたコンストラクタです。

        newInstance()を使用してDatatypeFactoryを作成します。

    • メソッドの詳細

      • newDefaultInstance

        public static DatatypeFactory newDefaultInstance()
        DatatypeFactory 「組み込みシステム-デフォルト実装」の新しいインスタンスを作成します。
        戻り値:
        DatatypeFactory組み込みシステムのデフォルト実装の新しいインスタンス。
        導入されたバージョン:
        9

      • newInstance

        public static DatatypeFactory newInstance​(String factoryClassName,
                                          ClassLoader classLoader)
                                   throws DatatypeConfigurationException
        クラス名からDatatypeFactoryの新しいインスタンスを取得します。 この関数は、クラス・パスに複数のプロバイダがある場合に便利です。 どのプロバイダがロードされるかを指定できるため、アプリケーションをさらに制御できます。

        アプリケーションがDatatypeFactoryへの参照を取得すると、ファクトリを使用してdatatypeのインスタンスを構成および取得することができます。

        トラブルシューティングのヒント

        jaxp.debugシステム・プロパティを設定すると、このメソッドは実行中の処理や検索している場所に関する大量のデバッグ・メッセージをSystem.errに出力します。

        問題がある場合、次のようにします。 

         java -Djaxp.debug=1 YourProgram ....
        パラメータ:
        factoryClassName - javax.xml.datatype.DatatypeFactoryの実装を提供する完全修飾のファクトリ・クラス名。
        classLoader - ファクトリ・クラスのロードに使用されるClassLoader。 nullの場合は、現在のThreadのコンテキストclassLoaderが、ファクトリ・クラスのロードに使用されます。
        戻り値:
        DatatypeFactoryの新しいインスタンス
        例外:
        DatatypeConfigurationException - factoryClassNameがnull、またはファクトリ・クラスをロードまたはインスタンス化できない場合。
        導入されたバージョン:
        1.6
        関連項目:
        newInstance()

      • newDuration

        public abstract Duration newDuration​(String lexicalRepresentation)
        XML Schema 1.0のセクション3.2.6.1に定義されているように、Durationをその文字列表現「PnYnMnDTnHnMnS」で指定するDurationの新しいインスタンスを取得します。

        XML Schema Part 2: Datatypes, 3.2.6 durationは、次のようにdurationを定義します。

        時間の長さを表すデュレーションです。 デュレーションの値の空間は6次元であり、ここでは座標によって、それぞれ[ISO 8601]のセクション5.5.3.2で定義されているグレゴリオ暦の年、月、日、時間、分、および秒のコンポーネントが指定されます。 これらのコンポーネントは、単位の大きさ順、すなわち年、月、日、時間、分、および秒の順序で並べられます。

        6つの値はすべて設定されており、作成されたDurationから使用できます。

        XMLスキーマ仕様では、任意のサイズの値をとることができます。 実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。 実装容量の限界を超えている場合は、実装限界を示すメッセージとともにUnsupportedOperationExceptionがスローされます。

        パラメータ:
        lexicalRepresentation - DurationのString表現。
        戻り値:
        lexicalRepresentationの構文解析から作成された新しいDuration。
        例外:
        IllegalArgumentException - lexicalRepresentationがDurationの有効な表現でない場合。
        UnsupportedOperationException - 実装が要求された値をサポートできない場合。
        NullPointerException - lexicalRepresentationがnullである場合。

      • newDuration

        public abstract Duration newDuration​(long durationInMilliSeconds)
        Durationをミリ秒で指定するDurationの新しいインスタンスを取得します。

        XML Schema Part 2: Datatypes, 3.2.6 durationは、次のようにdurationを定義します。

        時間の長さを表すデュレーションです。 デュレーションの値の空間は6次元であり、ここでは座標によって、それぞれ[ISO 8601]のセクション5.5.3.2で定義されているグレゴリオ暦の年、月、日、時間、分、および秒のコンポーネントが指定されます。 これらのコンポーネントは、単位の大きさ順、すなわち年、月、日、時間、分、および秒の順序で並べられます。

        6つの値はすべて指定されたミリ秒からそれぞれの値を計算することによって設定され、作成されたDurationのgetメソッドを使って使用可能となります。 値は、次の項目に準拠し、それらによって定義されています。

        デフォルトの開始インスタンスは、GregorianCalendarが元期の開始を使うことによって定義されます。例として、Calendar.YEAR = 1970、Calendar.MONTH = Calendar.JANUARY、Calendar.DATE = 1などが挙げられます。グレゴリオ暦には変動があるため、これが重要となります。たとえば、うるう年では、month = Calendar.FEBRUARYの日数が変わるため、Duration.getMonths()とDuration.getDays()の結果に影響が出る可能性があります。

        パラメータ:
        durationInMilliSeconds - ミリ秒で作成するデュレーション。
        戻り値:
        durationInMilliSecondsを表す新しいDuration。

      • newDuration

        public abstract Duration newDuration​(boolean isPositive,
                                     BigInteger years,
                                     BigInteger months,
                                     BigInteger days,
                                     BigInteger hours,
                                     BigInteger minutes,
                                     BigDecimal seconds)
        DurationをisPositive、年、月、日、時間、分、秒で指定するDurationの新しいインスタンスを取得します。

        XMLスキーマ仕様では、任意のサイズの値をとることができます。 実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。 実装容量の限界を超えている場合は、実装限界を示すメッセージとともにUnsupportedOperationExceptionがスローされます。

        null値は、フィールドが設定されていないことを示します。

        パラメータ:
        isPositive - falseに設定すると、負のデュレーションが作成される。 デュレーションの長さが0の場合、このパラメータは無視される。
        years - このDuration
        months - このDuration
        days - このDuration
        hours - このDuration
        minutes - このDuration
        seconds - このDuration
        戻り値:
        指定された値から作成された新しいDuration。
        例外:
        IllegalArgumentException - 値がDurationの表現として無効である場合。すべてのフィールド(years、months、...)がnullまたはいずれかのフィールドが負の場合。
        UnsupportedOperationException - 実装が要求された値をサポートできない場合。

      • newDuration

        public Duration newDuration​(boolean isPositive,
                            int years,
                            int months,
                            int days,
                            int hours,
                            int minutes,
                            int seconds)
        DurationをisPositive、年、月、日、時間、分、秒で指定するDurationの新しいインスタンスを取得します。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        isPositive - falseに設定すると、負のデュレーションが作成される。 デュレーションの長さが0の場合、このパラメータは無視される。
        years - このDuration
        months - このDuration
        days - このDuration
        hours - このDuration
        minutes - このDuration
        seconds - このDuration
        戻り値:
        指定された値から作成された新しいDuration。
        例外:
        IllegalArgumentException - 値がDurationの表現として無効である場合。いずれかのフィールドが負の場合。
        関連項目:
        newDuration( boolean isPositive, BigInteger years, BigInteger months, BigInteger days, BigInteger hours, BigInteger minutes, BigDecimal seconds)

      • newDurationDayTime

        public Duration newDurationDayTime​(String lexicalRepresentation)
        String表現、「PnDTnHnMnS」、「XQuery 1.0 and XPath 2.0 Data Model」の「xdt:dayTimeDuration」を構文解析することによって、xdt:dayTimeDuration型のDurationを作成します。

        データ型xdt:dayTimeDurationは、字句表現に日、時間、分、および秒コンポーネントのみが含まれるxs:durationのサブタイプです。 このデータ型は、名前空間http://www.w3.org/2003/11/xpath-datatypesにあります。

        4つの値はすべて設定されており、作成されたDurationから使用できます。

        XMLスキーマ仕様では、任意のサイズの値をとることができます。 実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。 実装容量の限界を超えている場合は、実装限界を示すメッセージとともにUnsupportedOperationExceptionがスローされます。

        パラメータ:
        lexicalRepresentation - デュレーションの字句表現。
        戻り値:
        指定されたlexicalRepresentationを使用して作成された新しいDuration。
        例外:
        IllegalArgumentException - lexicalRepresentationが日および時間でのみで表されているDurationの表現として無効である場合。
        UnsupportedOperationException - 実装が要求された値をサポートできない場合。
        NullPointerException - lexicalRepresentationがnullである場合。

      • newDurationDayTime

        public Duration newDurationDayTime​(long durationInMilliseconds)
        「XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration」で定義された指定されたミリ秒を使用して、xdt:dayTimeDuration型のDurationを作成します。

        データ型xdt:dayTimeDurationは、字句表現に日、時間、分、および秒コンポーネントのみが含まれるxs:durationのサブタイプです。 このデータ型は、名前空間http://www.w3.org/2003/11/xpath-datatypesにあります。

        4つの値はすべて指定されたミリ秒からそれぞれの値を計算することによって設定され、作成されたDurationのgetメソッドを使って使用可能となります。 値は、次の項目に準拠し、それらによって定義されています。

        デフォルトの開始インスタンスは、GregorianCalendarが元期の開始を使うことによって定義されます。例として、Calendar.YEAR = 1970、Calendar.MONTH = Calendar.JANUARY、Calendar.DATE = 1などが挙げられます。グレゴリオ暦には変動があるため、これが重要となります。たとえば、うるう年では、month = Calendar.FEBRUARYの日数が変わるため、Duration.getDays()の結果に影響が出る可能性があります。

        日、時間、分、および秒を決定したあとに残るミリ秒は破棄されます。

        パラメータ:
        durationInMilliseconds - 作成するDurationのミリ秒。
        戻り値:
        指定されたdurationInMillisecondsで作成された新しいDuration。
        関連項目:
        「XQuery 1.0 and XPath 2.0 Data Model」、「xdt:dayTimeDuration」

      • newDurationDayTime

        public Duration newDurationDayTime​(boolean isPositive,
                                   BigInteger day,
                                   BigInteger hour,
                                   BigInteger minute,
                                   BigInteger second)
        「XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration」で定義されたday、hour、minute、およびsecondを使用して、xdt:dayTimeDuration型のDurationを作成します。

        データ型xdt:dayTimeDurationは、字句表現に日、時間、分、および秒コンポーネントのみが含まれるxs:durationのサブタイプです。 このデータ型は、名前空間http://www.w3.org/2003/11/xpath-datatypesにあります。

        XMLスキーマ仕様では、任意のサイズの値をとることができます。 実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。 実装容量の限界を超えている場合は、実装限界を示すメッセージとともにUnsupportedOperationExceptionがスローされます。

        null値は、フィールドが設定されていないことを示します。

        パラメータ:
        isPositive - falseに設定すると、負のデュレーションが作成される。 デュレーションの長さが0の場合、このパラメータは無視される。
        day - Durationの日。
        hour - Durationの時間。
        minute - Durationの分。
        second - Durationの秒。
        戻り値:
        指定されたday、hour、minute、およびsecondで作成された新しいDuration。
        例外:
        IllegalArgumentException - 値がDurationの表現として無効である場合。すべてのフィールド(day、hour、...)がnullまたはいずれかのフィールドが負の場合。
        UnsupportedOperationException - 実装が要求された値をサポートできない場合。

      • newDurationDayTime

        public Duration newDurationDayTime​(boolean isPositive,
                                   int day,
                                   int hour,
                                   int minute,
                                   int second)
        「XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration」で定義されたday、hour、minute、およびsecondを使用して、xdt:dayTimeDuration型のDurationを作成します。

        データ型xdt:dayTimeDurationは、字句表現に日、時間、分、および秒コンポーネントのみが含まれるxs:durationのサブタイプです。 このデータ型は、名前空間http://www.w3.org/2003/11/xpath-datatypesにあります。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        isPositive - falseに設定すると、負のデュレーションが作成される。 デュレーションの長さが0の場合、このパラメータは無視される。
        day - Durationの日。
        hour - Durationの時間。
        minute - Durationの分。
        second - Durationの秒。
        戻り値:
        指定されたday、hour、minute、およびsecondで作成された新しいDuration。
        例外:
        IllegalArgumentException - 値がDurationの表現として無効である場合。いずれかのフィールド(day、hour、...)が負の場合。

      • newDurationYearMonth

        public Duration newDurationYearMonth​(String lexicalRepresentation)
        String表現、「PnYnM」、「XQuery 1.0 and XPath 2.0 Data Model」の「xdt:yearMonthDuration」を構文解析することによって、xdt:yearMonthDuration型のDurationを作成します。

        データ型xdt:yearMonthDurationは、字句表現に年および月コンポーネントのみが含まれるxs:durationのサブタイプです。 このデータ型は、名前空間XMLConstants.W3C_XPATH_DATATYPE_NS_URIにあります。

        両方の値が設定されており、作成されたDurationから使用できます。

        XMLスキーマ仕様では、任意のサイズの値をとることができます。 実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。 実装容量の限界を超えている場合は、実装限界を示すメッセージとともにUnsupportedOperationExceptionがスローされます。

        パラメータ:
        lexicalRepresentation - デュレーションの字句表現。
        戻り値:
        指定されたlexicalRepresentationを使用して作成された新しいDuration。
        例外:
        IllegalArgumentException - lexicalRepresentationが年および月でのみで表されているDurationの表現として無効である場合。
        UnsupportedOperationException - 実装が要求された値をサポートできない場合。
        NullPointerException - lexicalRepresentationがnullである場合。

      • newDurationYearMonth

        public Duration newDurationYearMonth​(long durationInMilliseconds)
        「XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration」で定義された指定されたミリ秒を使用して、xdt:yearMonthDuration型のDurationを作成します。

        データ型xdt:yearMonthDurationは、字句表現に年および月コンポーネントのみが含まれるxs:durationのサブタイプです。 このデータ型は、名前空間XMLConstants.W3C_XPATH_DATATYPE_NS_URIにあります。

        両方の値は指定されたミリ秒からそれぞれの値を計算することによって設定され、作成されたDurationのgetメソッドを使って使用可能となります。 値は、次の項目に準拠し、それらによって定義されています。

        デフォルトの開始インスタンスは、GregorianCalendarが元期の開始を使うことによって定義されます。例として、Calendar.YEAR = 1970、Calendar.MONTH = Calendar.JANUARY、Calendar.DATE = 1などが挙げられます。グレゴリオ暦には変動があるため、これが重要となります。たとえば、うるう年では、month = Calendar.FEBRUARYの日数が変わるため、Duration.getMonths()の結果に影響が出る可能性があります。

        年および月を決定したあとに残るミリ秒は破棄されます。

        パラメータ:
        durationInMilliseconds - 作成するDurationのミリ秒。
        戻り値:
        指定されたdurationInMillisecondsを使用して作成された新しいDuration。

      • newDurationYearMonth

        public Duration newDurationYearMonth​(boolean isPositive,
                                     BigInteger year,
                                     BigInteger month)
        「XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration」で定義されたyearおよびmonthを使用して、xdt:yearMonthDuration型のDurationを作成します。

        XMLスキーマ仕様では、任意のサイズの値をとることができます。 実装は、大きい値または小さい値、あるいはこの両方を任意にサポートしないか、あるいはサポート不可とするかを選ぶことができます。 実装容量の限界を超えている場合は、実装限界を示すメッセージとともにUnsupportedOperationExceptionがスローされます。

        null値は、フィールドが設定されていないことを示します。

        パラメータ:
        isPositive - falseに設定すると、負のデュレーションが作成される。 デュレーションの長さが0の場合、このパラメータは無視される。
        year - Durationの年。
        month - Durationの月。
        戻り値:
        指定されたyearとmonthを使用して作成された新しいDuration。
        例外:
        IllegalArgumentException - 値がDurationの表現として無効である場合。すべてのフィールド(year、month)がnullまたはいずれかのフィールドが負の場合。
        UnsupportedOperationException - 実装が要求された値をサポートできない場合。

      • newDurationYearMonth

        public Duration newDurationYearMonth​(boolean isPositive,
                                     int year,
                                     int month)
        「XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration」で定義されたyearおよびmonthを使用して、xdt:yearMonthDuration型のDurationを作成します。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        isPositive - falseに設定すると、負のデュレーションが作成される。 デュレーションの長さが0の場合、このパラメータは無視される。
        year - Durationの年。
        month - Durationの月。
        戻り値:
        指定されたyearとmonthを使用して作成された新しいDuration。
        例外:
        IllegalArgumentException - 値がDurationの表現として無効である場合。いずれかのフィールド(year、month)が負の場合。

      • newXMLGregorianCalendar

        public abstract XMLGregorianCalendar newXMLGregorianCalendar()
        XMLGregorianCalendarの新しいインスタンスを作成します。

        すべての日時データ型フィールドは、DatatypeConstants.FIELD_UNDEFINEDまたはnullに設定されます。

        戻り値:
        すべての日時データ型フィールドがDatatypeConstants.FIELD_UNDEFINEDまたはnullに設定された新しいXMLGregorianCalendar。

      • newXMLGregorianCalendar

        public abstract XMLGregorianCalendar newXMLGregorianCalendar​(String lexicalRepresentation)
        字句表現として文字列を構文解析することによって、新しいXMLGregorianCalendarを作成します。

        字句文字列表現の解析は、「XML Schema 1.0 Part 2のセクション3.2.[7-14].1 Lexical Representation」に定義されています。

        文字列表現の先頭と末尾に空白を付けることはできません。

        この解析はフィールドごとに実行されるため、次では字句上正しい任意の文字列xを保持します。 

         newXMLGregorianCalendar(x).toXMLFormat().equals(x)

        「XML Schema 1.0 errataのセクション3.2.7.2」に記載された字句/正規表現の顕著な不一致を除きます。

        パラメータ:
        lexicalRepresentation - 8つのXML Schema日時データ型の字句表現のいずれか1つ。
        戻り値:
        lexicalRepresentationから作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - lexicalRepresentationが有効なXMLGregorianCalendarでない場合。
        NullPointerException - lexicalRepresentationがnullである場合。

      • newXMLGregorianCalendar

        public abstract XMLGregorianCalendar newXMLGregorianCalendar​(BigInteger year,
                                                             int month,
                                                             int day,
                                                             int hour,
                                                             int minute,
                                                             int second,
                                                             BigDecimal fractionalSecond,
                                                             int timezone)
        W3C XML Schema 1.0 recommendationでxsd:dateTimeおよび関連するビルトイン・データ型に許可されている完全な値空間を可能にするコンストラクタです。 yearパラメータは大きな数を任意でサポートしており、fractionalSecondには無限の精度があることに注意してください。

        null値は、フィールドが設定されていないことを示します。

        パラメータ:
        year - 作成されるXMLGregorianCalendarの年。
        month - 作成されるXMLGregorianCalendarの年。
        day - 作成されるXMLGregorianCalendarの年。
        hour - 作成されるXMLGregorianCalendarの年。
        minute - 作成されるXMLGregorianCalendarの年。
        second - 作成されるXMLGregorianCalendarの年。
        fractionalSecond - 作成されるXMLGregorianCalendarの年。
        timezone - 作成されるXMLGregorianCalendarの年。
        戻り値:
        指定値から作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendarの日時データ対応表で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によってXMLGregorianCalendar.isValid()で判定される無効なXMLGregorianCalendarインスタンスが構成される場合。

      • newXMLGregorianCalendar

        public XMLGregorianCalendar newXMLGregorianCalendar​(int year,
                                                    int month,
                                                    int day,
                                                    int hour,
                                                    int minute,
                                                    int second,
                                                    int millisecond,
                                                    int timezone)
        java.util.GregorianCalendarインスタンスをXMLGregorianCalendarインスタンスに変換する必要がある値領域のコンストラクタです。

        XMLGregorianCalendar eonおよびfractionalSecondはnullに設定されます

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        year - 作成されるXMLGregorianCalendarの年。
        month - 作成されるXMLGregorianCalendarの年。
        day - 作成されるXMLGregorianCalendarの年。
        hour - 作成されるXMLGregorianCalendarの年。
        minute - 作成されるXMLGregorianCalendarの年。
        second - 作成されるXMLGregorianCalendarの年。
        millisecond - 作成されるXMLGregorianCalendarの年。
        timezone - 作成されるXMLGregorianCalendarの年。
        戻り値:
        指定値から作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendarの日時データ対応表で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によってXMLGregorianCalendar.isValid()で判定される無効なXMLGregorianCalendarインスタンスが構成される場合。

      • newXMLGregorianCalendarDate

        public XMLGregorianCalendar newXMLGregorianCalendarDate​(int year,
                                                        int month,
                                                        int day,
                                                        int timezone)
        XML Schemaビルトイン・データ型dateまたはg*のJava表現を作成します。

        たとえば、gYearのインスタンスは、monthおよびdayパラメータにDatatypeConstants.FIELD_UNDEFINEDを設定して、このファクトリを呼び出すと作成できます。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        year - 作成されるXMLGregorianCalendarの年。
        month - 作成されるXMLGregorianCalendarの年。
        day - 作成されるXMLGregorianCalendarの年。
        timezone - 分単位のオフセット。 DatatypeConstants.FIELD_UNDEFINEDはオプションのフィールドが設定されていないことを示す。
        戻り値:
        パラメータ値から作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendarの日時データ対応表で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によってXMLGregorianCalendar.isValid()で判定される無効なXMLGregorianCalendarインスタンスが構成される場合。
        関連項目:
        DatatypeConstants.FIELD_UNDEFINED

      • newXMLGregorianCalendarTime

        public XMLGregorianCalendar newXMLGregorianCalendarTime​(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int timezone)
        XML Schemaビルトイン・データ型timeのJavaインスタンスを作成します。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        hours - 時間数
        minutes - 分数
        seconds - 秒数
        timezone - 分単位のオフセット。 DatatypeConstants.FIELD_UNDEFINEDはオプションのフィールドが設定されていないことを示す。
        戻り値:
        パラメータ値から作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendarの日時データ対応表で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によってXMLGregorianCalendar.isValid()で判定される無効なXMLGregorianCalendarインスタンスが構成される場合。
        関連項目:
        DatatypeConstants.FIELD_UNDEFINED

      • newXMLGregorianCalendarTime

        public XMLGregorianCalendar newXMLGregorianCalendarTime​(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        BigDecimal fractionalSecond,
                                                        int timezone)
        XML Schemaビルトイン・データ型timeのJavaインスタンスを作成します。

        null値は、フィールドが設定されていないことを示します。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        hours - 時間数
        minutes - 分数
        seconds - 秒数
        fractionalSecond - nullの値はこのオプションのフィールドが設定されていないことを示す。
        timezone - 分単位のオフセット。 DatatypeConstants.FIELD_UNDEFINEDはオプションのフィールドが設定されていないことを示す。
        戻り値:
        パラメータ値から作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendarの日時データ対応表で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によってXMLGregorianCalendar.isValid()で判定される無効なXMLGregorianCalendarインスタンスが構成される場合。
        関連項目:
        DatatypeConstants.FIELD_UNDEFINED

      • newXMLGregorianCalendarTime

        public XMLGregorianCalendar newXMLGregorianCalendarTime​(int hours,
                                                        int minutes,
                                                        int seconds,
                                                        int milliseconds,
                                                        int timezone)
        XML Schemaビルトイン・データ型timeのJavaインスタンスを作成します。

        DatatypeConstants.FIELD_UNDEFINED値は、フィールドが設定されていないことを示します。

        パラメータ:
        hours - 時間数
        minutes - 分数
        seconds - 秒数
        milliseconds - ミリ秒数
        timezone - 分単位のオフセット。 DatatypeConstants.FIELD_UNDEFINEDはオプションのフィールドが設定されていないことを示す。
        戻り値:
        パラメータ値から作成されたXMLGregorianCalendar。
        例外:
        IllegalArgumentException - 個々のパラメータの値が、XMLGregorianCalendarの日時データ対応表で決定されるようなフィールドの最大値制限外の場合、あるいは複合値によってXMLGregorianCalendar.isValid()で判定される無効なXMLGregorianCalendarインスタンスが構成される場合。
        関連項目:
        DatatypeConstants.FIELD_UNDEFINED