|
|||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectshohaku.ginkgo.Ginkgo
XMLドキュメントをオブジェクトにマッピングし生成されたオブジェクトを構造化する実行機能を提供します。
XMLドキュメントからのデータ生成に着目したライブラリです。
このライブラリはXMLで定義された情報をshohaku.ginkgo.NodeCompositeRule
の指定するルールに基づきshohaku.ginkgo.Node
のツリー構造に変換します。
値型のshohaku.ginkgo.Node
は自身と内包する要素に基づきオブジェクトを生成します。
複数のノードを再起的に合成する事により、単純なデータ型の集合から複雑なデータ構造を生成します。
また一度定義されたノードは一定の依存関係を含むものの相対的に独立するため複数の文脈で再利用することができます。
Ginkgo
のデフォルト実装には基本型と利用頻度が高いと思われるデータ型、および大半のオブジェクトが生成可能な汎用型のノードが提供されています。
また複雑な構造を容易に生成するために反復処理や条件分岐を実現する制御インターフェースが提供されています。
デフォルトノード以外の独自のノードの追加やデフォルトノードとの交換、使用するノードの選択、制約の追加も容易に実現できます。
またXMLタグ名の交換やXML属性に対するデフォルト値の指定や別名の指定を定義レベルで指定出来ます。
この仕様の応用からカスタマイズされたデータ構造の再定義や、汎用ノードを基に特殊なノードを定義する事も可能です。
Ginkgo
は汎用的なデータ構造を基に複雑なデータ構造を生成したい場合に有用に設計されています。
解決を求められている問題領域によっては他のAPIの使用を検討してください。
使用例としてshohaku.kosho
パッケージを参照する事が出来ます。
コンストラクタの概要 | |
Ginkgo()
デフォルトコンストラクタ。 |
|
Ginkgo(DocumentCompositeRule docRule)
ドキュメントの合成ルールを指定して初期化します。 |
メソッドの概要 | |
java.lang.ClassLoader |
getClassLoader()
解析処理に使用する ClassLoader を返却します. |
Document |
getDocument()
解析中又は直前に解析したドキュメントを返却します。 |
DocumentCompositeRule |
getDocumentCompositeRule()
ドキュメントの合成ルールを返却します。 |
org.apache.commons.logging.Log |
getLogger()
解析処理プロセス内で使用するログを返却します。 |
NodeCompositeRule |
getNodeCompositeRule()
解析中又は直前に使用した構成ルールを返却します。 |
SAXDocumentParser |
getSAXDocumentParser()
解析処理に使用するSAXパーサーを返却します。 |
boolean |
isErrThrowable()
解析処理内でエラーが発生した場合に例外を発生させるかを示すフラグを返却します(デフォルトはfalse)。 |
void |
parse(NodeCompositeRule rule,
org.xml.sax.InputSource input)
解析処理を実行します。 |
void |
parse(NodeCompositeRule rule,
org.xml.sax.InputSource input,
Document parent)
解析処理を実行します。 |
void |
parse(NodeCompositeRule rule,
java.io.InputStream inStream)
解析処理を実行します。 |
void |
parse(NodeCompositeRule rule,
java.io.InputStream inStream,
Document parent)
解析処理を実行します。 |
void |
setClassLoader(java.lang.ClassLoader classLoader)
解析処理に使用する ClassLoader を設定します. |
void |
setErrThrowable(boolean errThrowable)
解析処理内でエラーが発生した場合に例外を発生させるかを示すフラグを格納します。 |
void |
setLogger(org.apache.commons.logging.Log log)
解析処理プロセス内で使用するログを格納します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
public Ginkgo()
public Ginkgo(DocumentCompositeRule docRule)
docRule
- ドキュメントの合成ルールメソッドの詳細 |
public void parse(NodeCompositeRule rule, java.io.InputStream inStream)
rule
- 構成ルールinStream
- XMLデータ入力ストリーム
GinkgoException
- 構成する情報に何らかの誤りが在る場合発生します。public void parse(NodeCompositeRule rule, java.io.InputStream inStream, Document parent)
rule
- 構成ルールinStream
- XMLデータ入力ストリームparent
- 親のドキュメントオブジェクト
GinkgoException
- 構成する情報に何らかの誤りが在る場合発生します。public void parse(NodeCompositeRule rule, org.xml.sax.InputSource input)
rule
- 構成ルールinput
- XMLデータソース
GinkgoException
- 構成する情報に何らかの誤りが在る場合発生します。public void parse(NodeCompositeRule rule, org.xml.sax.InputSource input, Document parent)
rule
- 構成ルールinput
- XMLデータソースparent
- 親のドキュメントオブジェクト
GinkgoException
- 構成する情報に何らかの誤りが在る場合発生します。public org.apache.commons.logging.Log getLogger()
public void setLogger(org.apache.commons.logging.Log log)
log
- ログpublic SAXDocumentParser getSAXDocumentParser()
public java.lang.ClassLoader getClassLoader()
ClassLoader
を返却します.
ClassLoader
public void setClassLoader(java.lang.ClassLoader classLoader)
ClassLoader
を設定します.
classLoader
- 解析処理に使用するClassLoader
public boolean isErrThrowable()
true
の場合は解析処理内でエラーが発生した場合に例外を発生させるpublic void setErrThrowable(boolean errThrowable)
false
に設定されます。
errThrowable
- true
の場合は解析処理内でエラーが発生した場合に例外を発生させるpublic Document getDocument()
public NodeCompositeRule getNodeCompositeRule()
public DocumentCompositeRule getDocumentCompositeRule()
|
|||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |