クラスSAXTransformerFactory

java.lang.Object
javax.xml.transform.TransformerFactory
javax.xml.transform.sax.SAXTransformerFactory
public abstract class SAXTransformerFactory extends TransformerFactory
このクラスは、TransformerFactoryを拡張してSAX固有のファクトリ・メソッドを提供します。 2つの型のContentHandlerを提供します。1つはTransformersの作成用で、もう1つはTemplatesオブジェクトの作成用です。

変換時に使用されるXMLReader用のErrorHandlerまたはEntityResolverをアプリケーションで設定する場合は、(getXMLReaderで) XMLReaderへの参照を提供するSAXSourceを返すためにURIResolverを使う必要があります。

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

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final String
    FEATURE
    この値を引数として渡したときにTransformerFactory.getFeature(String)がtrueを返す場合、TransformerFactory.newInstance()から戻されたTransformerFactoryは、安全にSAXTransformerFactoryにキャストできます。
    static final String
    FEATURE_XMLFILTER
    この値を引数として渡したときにTransformerFactory.getFeature(String)がtrueを返す場合、newXMLFilter(Source src)メソッドとnewXMLFilter(Templates templates)メソッドがサポートされます。

  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    SAXTransformerFactory()
    デフォルトのコンストラクタは意図的に保護されています。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract TemplatesHandler
    newTemplatesHandler()
    SAX ContentHandlerイベントを処理してTemplatesオブジェクトにすることのできるTemplatesHandlerオブジェクトを取得します。
    abstract TransformerHandler
    newTransformerHandler()
    SAX ContentHandlerイベントを処理してResultにすることのできるTransformerHandlerオブジェクトを取得します。
    abstract TransformerHandler
    newTransformerHandler(Source src)
    引数で指定された変換命令に基づいて、SAX ContentHandlerイベントを処理してResultにすることのできるTransformerHandlerオブジェクトを取得します。
    abstract TransformerHandler
    newTransformerHandler(Templates templates)
    Templates引数に基づいて、SAX ContentHandlerイベントを処理してResultにすることのできるTransformerHandlerオブジェクトを取得します。
    abstract XMLFilter
    newXMLFilter(Source src)
    指定されたSourceを変換命令として使用するXMLFilterを作成します。
    abstract XMLFilter
    newXMLFilter(Templates templates)
    Templates引数に基づいてXMLFilterを作成します。

    クラスで宣言されたメソッド TransformerFactory

    getAssociatedStylesheet, getAttribute, getErrorListener, getFeature, getURIResolver, newDefaultInstance, newInstance, newInstance, newTemplates, newTransformer, newTransformer, setAttribute, setErrorListener, setFeature, setURIResolver
    修飾子と型
    メソッド
    説明
    abstract Source
    getAssociatedStylesheet(Source source, String media, String title, String charset)
    「The xml-stylesheet processing instruction」から、指定された基準に一致するXML Sourceドキュメントに関連付けられているスタイル・シート仕様を取得します。
    abstract Object
    getAttribute(String name)
    ユーザーがベースとなる実装の特定の属性を取り出すことができるようにします。
    abstract ErrorListener
    getErrorListener()
    TransformerFactoryのエラー・イベント・ハンドラを取得します。
    abstract boolean
    getFeature(String name)
    機能の値を検索します。
    abstract URIResolver
    getURIResolver()
    document()、xsl:import、またはxsl:includeで使用されるURIを解決するために変換時にデフォルトで使用されるオブジェクトを取得します。
    static TransformerFactory
    newDefaultInstance()
    TransformerFactory組込みシステム・デフォルト実装の新しいインスタンスを作成します。
    static TransformerFactory
    newInstance()
    TransformerFactoryの新しいインスタンスを取得します。
    static TransformerFactory
    newInstance(String factoryClassName, ClassLoader classLoader)
    ファクトリ・クラス名からTransformerFactoryの新しいインスタンスを取得します。
    abstract Templates
    newTemplates(Source source)
    Sourceを処理して、ソースのコンパイル表現であるTemplatesオブジェクトにします。
    abstract Transformer
    newTransformer()
    ResultへのSourceのコピーを実行する新しいTransformerを作成します、たとえば、"「アイデンティティ変換」"。
    abstract Transformer
    newTransformer(Source source)
    SourceをTransformer Objectに処理します。
    abstract void
    setAttribute(String name, Object value)
    ユーザーがベースとなる実装に特定の属性を設定できるようにします。
    abstract void
    setErrorListener(ErrorListener listener)
    TransformerFactoryのエラー・イベント・リスナーを設定します。TransformerFactoryは、変換自体のためではなく、変換命令を処理するために使用されます。
    abstract void
    setFeature(String name, boolean value)
    このファクトリによって生成されたTransformerFactoryおよびTransformerまたはTemplateの機能を設定します。
    abstract void
    setURIResolver(URIResolver resolver)
    document()、xsl:import、またはxsl:includeで使用されるURIを解決するために変換時にデフォルトで使用されるオブジェクトを設定します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

  • コンストラクタの詳細

    • SAXTransformerFactory

      protected SAXTransformerFactory()
      デフォルトのコンストラクタは意図的に保護されています。

  • メソッドの詳細

    • newTransformerHandler

      public abstract TransformerHandler newTransformerHandler(Source src) throws TransformerConfigurationException
      引数で指定された変換命令に基づいて、SAX ContentHandlerイベントを処理してResultにすることのできるTransformerHandlerオブジェクトを取得します。
      パラメータ:
      src - 変換命令のSource。
      戻り値:
      SAXイベントを変換する準備のできたTransformerHandler。
      スロー:
      TransformerConfigurationException - 何らかの理由でTransformerHandlerを作成できない場合。

    • newTransformerHandler

      public abstract TransformerHandler newTransformerHandler(Templates templates) throws TransformerConfigurationException
      Templates引数に基づいて、SAX ContentHandlerイベントを処理してResultにすることのできるTransformerHandlerオブジェクトを取得します。
      パラメータ:
      templates - コンパイルされた変換命令。
      戻り値:
      SAXイベントを変換する準備のできたTransformerHandler。
      スロー:
      TransformerConfigurationException - 何らかの理由でTransformerHandlerを作成できない場合。

    • newTransformerHandler

      public abstract TransformerHandler newTransformerHandler() throws TransformerConfigurationException
      SAX ContentHandlerイベントを処理してResultにすることのできるTransformerHandlerオブジェクトを取得します。 この変換は、恒等(つまりコピー)変換として定義されます。たとえば、一連のSAX構文解析イベントからDOMツリーへのコピーなどです。
      戻り値:
      TransformerHandlerへのnull以外の参照。SAX構文解析イベントのContentHandlerとして使用される場合がある。
      スロー:
      TransformerConfigurationException - 何らかの理由でTransformerHandlerを作成できない場合。

    • newTemplatesHandler

      public abstract TemplatesHandler newTemplatesHandler() throws TransformerConfigurationException
      SAX ContentHandlerイベントを処理してTemplatesオブジェクトにすることのできるTemplatesHandlerオブジェクトを取得します。
      戻り値:
      TransformerHandlerへのnull以外の参照。SAX構文解析イベントのContentHandlerとして使用される場合がある。
      スロー:
      TransformerConfigurationException - 何らかの理由でTemplatesHandlerを作成できない場合。

    • newXMLFilter

      public abstract XMLFilter newXMLFilter(Source src) throws TransformerConfigurationException
      指定されたSourceを変換命令として使用するXMLFilterを作成します。
      パラメータ:
      src - 変換命令のSource。
      戻り値:
      XMLFilterオブジェクト。この機能がサポートされていない場合はnull。
      スロー:
      TransformerConfigurationException - 何らかの理由でTemplatesHandlerを作成できない場合。

    • newXMLFilter

      public abstract XMLFilter newXMLFilter(Templates templates) throws TransformerConfigurationException
      Templates引数に基づいてXMLFilterを作成します。
      パラメータ:
      templates - コンパイルされた変換命令。
      戻り値:
      XMLFilterオブジェクト。この機能がサポートされていない場合はnull。
      スロー:
      TransformerConfigurationException - 何らかの理由でTemplatesHandlerを作成できない場合。