java.lang.Object com.ibm.etools.sqltoxml.SQLToXML
パブリック・クラス SQLToXML は java.lang.Object を拡張します。
このクラスは、データベース照会を行うためにアプリケーションが使用するメソッド (SQL から XML へのウィザードのような) を提供します。 照会結果は XML フォーマットで獲得されます。 オプションとして、対応する DTD、XML スキーマ、および結果の XSL ファイルが生成されます。
コンストラクター | 記述 |
---|---|
SQLToXML(QueryProperties) | これはコンストラクターのみです。 |
メソッド | 記述 |
---|---|
void execute() | コンストラクターの引き数として与えられた QueryProperties からのの情報を基にして照会を実行します。 |
void execute(PrintWriter, , String, PrintWriter) 推奨されない。 | QueryProperties からの情報を基にして照会を実行し、そして結果は PrintWriters またはファイル、または両者に書き込まれます。 |
void execute(String, PrintWriter, String, String, PrintWriter) 推奨されない。 | QueryProperties からの情報を基にして照会を実行し、そして結果は PrintWriters またはファイル、または両者に書き込まれます。 |
void execute(String, String, String, String) 推奨されない。 | QueryProperties からの情報を基にして照会を実行し、そして結果はファイルに書き込まれます。 |
void finalize() | これが SQLToXML によって作成されたものである場合はこの接続をクローズする。 |
Connection getConnection() | データベース接続を戻す。 |
Document getCurrentDocument() | execute() メソッドに対する最新の呼び出しの結果である XML 文書を戻す。 |
Document[] getCurrentDocuments() | execute() メソッドに対する最新の呼び出しの結果である XML 文書配列を戻す。 |
String getDTDFile() | 生成される現行の DTD ファイル名を戻す。 |
String getNextAllQuery() | 有効な照会ストリングを戻す。 |
Vector getNextQueries() | 有効な照会ストリングのシーケンスを戻す。 |
String getParameters() | where 文節のパラメーター値を戻す。 |
String getXMLFile() | 生成される現行の XML ファイル名を戻す。 |
PrintWriter getXMLWriter() | XML 出力用の現行の印刷プログラムを戻す。 |
String getXSDFile() | 生成される現行の XML スキーマ・ファイル名を戻す。 |
String getXSLFile() | 生成される現行の XSL ファイル名を戻す。 |
PrintWriter getXSLWriter() | XSL 出力用の現行の PrintWriter を戻す。 |
void setConnection(Connection) | XML ファイルを生成するために使用する JDBC 接続を提供する。 |
void setDTDFile(String) | 生成される DTD ファイル名を設定する。 |
void setGenDocType(Boolean) Deprecated. | 妥当性検査の目的で DTD または XML スキーマ・ファイルを生成するかどうかコントロールする。 |
void setIndenting(Boolean) | インデントのオン/オフを設定する。 |
void setMaxRows(int) | 生成された XML 内で検索する最大行数の限度を最大に設定する。 |
void setParameters(String) | where 文節のパラメーター値を設定する。 |
void setQueryProperties(QueryProperties) | 現行の queryProperties をオーバーライドする。 |
void setXMLFile(String) | 生成される XML ファイル名を設定する。 |
void setXMLWriter(String) | 生成される XML が送信される印刷プログラムを設定する。 |
void setXSDFile(String) | 生成される現行の XML スキーマ・ファイル名を設定する。 |
void setXSLFile(String) | 生成される XSL ファイル名を設定する。 |
void setXSLWriter(String) | 生成される XSL が送信される印刷プログラムを設定する。 |
クラス java.lang.Object から継承されたメソッド |
equals、getClass、hashCode、notify、notifyAll、toString、wait、wait、wait |
public void execute() throws java.lang.Exception
コンストラクターの引き数として与えられた QueryProperties からのの情報を基にして照会を実行します。 生成される成果物は、XML、XML スキーマ、DTD、および XSL ファイルを含みます。 XML 以外の成果物を生成するためには、ファイル名または印刷プログラムは、このメソッドを使用する前に関係のあるアクセス機構を使用して 提供してもらう必要があります。 さらに追加して、XML 出力は、getCurrentDocument() または getCurrentDocuments() メソッド呼び出しを経由して DOM 文書として取得することができます。
スローする: java.lang.Exception - 実行が失敗するとスローされます。
public void execute(PrintWriter xml, String dtdfile, String xsdfile, PrintWriter xsl) throws Exception
推奨されない。 QueryProperties からの情報を基にして照会を実行し、そして結果は印刷プログラムまたはファイル、または両者に書き込まれます。 'xml' 以外のいずれかの引き数がヌルの場合、その特定の引き数について結果は生成されません。 また、dtdfile および xsdfile が両方とも指定されていると、xsdfile のみ生成されます。
public void execute(String params, PrintWriter xml, String dtdfile, String xsdfile, PrintWriter xsl) throws Exception
推奨されない。 QueryProperties からの情報を基にして照会を実行し、そして結果は印刷プログラムまたはファイル、または両者に書き込まれます。 'xml' 以外のいずれかの引き数がヌルの場合、その特定の引き数について結果は生成されません。 また、dtdfile および xsdfile が両方とも指定されていると、xsdfile のみ生成されます。 このメソッドは、照会に where 文節が含まれていて、その制約が 'params' ストリング引き数内に与えられているときに使用されます。 これらの制約パラメーターは、引き数内でコンマ (,) の区切り文字で区切られています。
public void execute(String xmlfile, String dtdfile, String xsdfile, String xslfile) throws Exception
推奨されない。 QueryProperties からの情報を基にして照会を実行し、そして結果はファイルに書き込まれます。 'xml' 以外のいずれかの引き数がヌルの場合、その特定の引き数について結果は生成されません。 また、dtdfile および xsdfile が両方とも指定されていると、xsdfile のみ生成されます。
public void finalize()
これが SQLToXML によって作成されたものである場合はこの接続をクローズする。 接続が外部から提供されていた場合 (setConnection() を使用して)、接続はクローズされません。 SQLToXML がゴミ収集されたときには、このメソッドは JVM によって呼び出されます。
public Connection getConnection() throws Exception
データベース接続を戻します。 接続がない場合、このメソッドは QueryProperties からの値を使用して新規接続を作成します。
public Document getCurrentDocument()
execute() メソッドに対する最新の呼び出しの結果である XML 文書を戻す。 RECURSIVE オプション付きの GENERATE_ID_AND_IDREF を使用すると、メインの XML 文書が戻されます。
public Document[] getCurrentDocuments()
execute() メソッドに対する最新の呼び出しの結果である XML 文書配列を戻す。 RECURSIVE オプション付きの GENERATE_ID_AND_IDREF を使用しない限り、結果は 1 つの文書のみを含みます。
public java.lang.String getDTDFile()
生成される現行の DTD ファイル名を戻す。
public String getNextAllQuery()
有効な照会ストリングを戻す。 このメソッドは、以下の場合にのみ有効な照会ストリングを戻します。
1) フォーマット・オプションが ID_AND_IDREF であり、そして 2) 再帰オプションが 'TRUE' の場合。たとえば、現行の照会からの列が、テーブル A の基本キー列への外部キーの場合、これはストリング 'select * from A' を戻します。 このメソッドの標準的な使用法については、サンプル・サーブレット、XMLIntegratorServlet.java を参照してください。
public Vector getNextQueries()
有効な照会ストリングのシーケンスを戻す。 このメソッドは、以下の場合にのみ有効な照会ストリングのベクトルを戻します。
1) フォーマット・オプションが ID_AND_IDREF であり、そして 2) 再帰オプションが 'TRUE' の場合。たとえば、現行の照会からの列が、テーブル A の基本キー列 ID (値 123 の) への外部キーの場合、これはストリング 'select * from A where ID = 123' を戻します。 このメソッドの標準的な使用法については、サンプル・サーブレット、XMLIntegratorServlet.java を参照してください。
public java.lang.String getParameters()
where 文節のパラメーター値を戻す。
public java.lang.String getXMLFile()
生成される現行の XML ファイル名を戻す。
public java.io.PrintWriter getXMLWriter()
XML 出力用の現行の印刷プログラムを戻す。
public java.lang.String getXSDFile()
生成される現行の XML スキーマ・ファイル名を戻す。
public java.lang.String getXSLFile()
生成される現行の XSL ファイル名を戻す。
public java.io.PrintWriter getXSLWriter()
XSL 出力用の現行の PrintWriter を戻す。
public void setConnection(Connection jdbcConnection)
XML ファイルを生成するために使用する JDBC 接続を提供します。 アプリケーション・プログラムが、接続プールのような自身の接続管理メカニズムを使用したい場合には、このメソッドが役に立ちます。 このメソッドを、いずれかの execute() メソッドの前に呼び出したことがない場合、SQLToXML は QueryProperties からの値を使用して自身の接続を作成します。
public void setDTDFile(java.lang.String filename) throws java.lang.Exception
生成される DTD ファイル名を設定します。このメソッドは setXSDFile(String) との組み合わせで使用することはできません。
public void setGenDocType(Boolean value)
推奨されない。 検証の目的で DTD または XML スキーマ・ファイルを生成するかどうかコントロールする。 デフォルトでは、開発時間用に値が 真 に設定され、実行時間用に 偽 に設定される。 サーブレットのある程度のパフォーマンス低下のようなランタイム・アプリケーションに対する 真 の値の設定 。
public void setIndenting(Boolean flag)
インデントのオン/オフを設定する。 デフォルトでインデントはオン。
public void setMaxRows(int max)
生成された XML 内で検索する最大行数の限度を最大に設定する。 デフォルトでトレースは限度なしです。
public void setParameters(java.lang.String parameters)
select * from EMPLOYEE where EMP_NO = :empno上の例からは、 :empno について置き換えられる値はパラメーターの引き数から与えられます。 もし複数の制約値がある場合、それらは下記の例のように、パラメーター内で括弧内のコンマ (,) の区切り文字で区切られています。
String params = "87316,'Toronto'"; sqltoxml.setParameters(params);
public void setQueryProperties(QueryProperties qProperties)
現行の queryProperties をオーバーライドする。
public void setXMLFile(java.lang.String filename) throws java.lang.Exception
生成される XML ファイル名を設定する。 このメソッドは setXMLWriter(PrintWriter) との組み合わせで使用することはできません。
public void setXMLWriter(java.io.PrintWriter writer) throws java.lang.Exception
生成される XML が送信される印刷プログラムを設定する。 このメソッドは setXMLFile(String) との組み合わせで使用することはできません。
public void setXSDFile(java.lang.String filename) throws java.lang.Exception
生成される現行の XML スキーマ・ファイル名を設定する。このメソッドは setDTDFile(String) との組み合わせで使用することはできません。
public void setXSLFile(java.lang.String filename) throws java.lang.Exception
生成される XSL ファイル名を設定する。 このメソッドは setXSLWriter(PrintWriter) との組み合わせで使用することはできません。
public void setXSLWriter(java.io.PrintWriter writer) throws java.lang.Exception
生成される XSL が送信される印刷プログラムを設定する。 このメソッドは setXSLFile(String) との組み合わせで使用することはできません。