java.lang.Object com.ibm.etools.sqltoxml.SQLToXML
public class SQLToXML extends 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 출력에 대한 현재 PrintWriter를 리턴합니다. |
String getXSDFile() | 생성될 현재 XML 스키마 파일 이름을 리턴합니다. |
String getXSLFile() | 생성될 현재 XSL 파일 이름을 리턴합니다. |
PrintWriter getXSLWriter() | XSL 출력에 대한 현재 PrintWriter를 리턴합니다. |
void setConnection(Connection) | XML 파일 생성에 사용될 JDBC 연결을 제공합니다. |
void setDTDFile(String) | 생성될 DTD 파일 이름을 설정합니다. |
void setGenDocType(Boolean) 권장하지 않음. | 유효성 검증을 목적으로 DTD 또는 XML 스키마 파일의 생성 여부를 제어합니다. |
void setIndenting(Boolean) | 들여쓰기를 ON 및 OFF로 설정합니다. |
void setMaxRows(int) | 생성된 XML에서 검색될 행의 최대수에 대한 한계를 최대로 설정합니다. |
void setParameters(String) | Where 절에 대한 매개변수 값을 설정합니다. |
void setQueryProperties(QueryProperties) | 현재 queryProperties를 대체합니다. |
void setXMLFile(String) | 생성될 XML 파일 이름을 설정합니다. |
void setXMLWriter(String) | 생성된 XML이 지정된 것으로 PrintWriter를 설정합니다. |
void setXSDFile(String) | 생성될 XML 스키마 파일 이름을 설정합니다. |
void setXSLFile(String) | 생성될 XSL 파일 이름을 설정합니다. |
void setXSLWriter(String) | 생성된 XSL이 지정된 것으로 PrintWriter를 설정합니다. |
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 이외의 아티팩트를 생성하려면 파일 이름 또는 PrintWriters가 이 메소드를 사용하기 전에 관련된 설정 액세서를 사용하여 제공되어야 합니다. 또한 XML 출력은 getCurrentDocument() 또는 getCurrentDocuments() 메소드 호출을 통해 DOM 문서로 얻을 수 있습니다.
처리: java.lang.Exception - 실행 실패 시 발생합니다.
public void execute(PrintWriter xml, String dtdfile, String xsdfile, PrintWriter xsl) throws Exception
권장하지 않음. QueryProperties의 정보를 기반으로 조회를 실행하고 결과는 PrintWriters 및/또는 파일에 기록됩니다. 'xml'이 아닌 인수가 널일 때 특정 인수에 대해 결과가 생성되지 않습니다. 또한 모든 dtdfile과 xsdfile이 지정되면 xsdfile만 생성됩니다.
public void execute(String params, PrintWriter xml, String dtdfile, String xsdfile, PrintWriter xsl) throws Exception
권장하지 않음. QueryProperties의 정보를 기반으로 조회를 실행하고 결과는 PrintWriters 및/또는 파일에 기록됩니다. '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가 사용되지 않으면, 결과에 문서가 하나만 있습니다.
public java.lang.String getDTDFile()
생성될 현재 DTD 파일 이름을 리턴합니다.
public String getNextAllQuery()
올바른 조회 문자열을 리턴합니다. 이 메소드는 다음의 경우에만 올바른 조회 문자열을 리턴합니다.
1) 형식 옵션이 ID_AND_IDREF일 때 2) 반복 옵션이 'true'일 때예를 들어, 현재 조회의 열이 테이블 A의 1차 키 열에 대한 외부 키일 때, 이는 문자열 'select * from A'를 리턴합니다. 이 메소드에 대한 일반적인 사용법은 샘플 Servlet XMLIntegratorServlet.java를 참조하십시오.
public Vector getNextQueries()
올바른 조회 문자열의 순서를 리턴합니다. 이 메소드는 다음의 경우에만 올바른 조회 문자열의 벡터를 리턴합니다.
1) 형식 옵션이 ID_AND_IDREF일 때 2) 반복 옵션이 'true'일 때예를 들어, 현재 조회의 열이 테이블 A의 1차 키 열 ID(값 123의)에 대한 외부 키일 때, 이는 문자열 'select * from A where ID = 123'을 리턴합니다. 이 메소드에 대한 일반적인 사용법은 샘플 Servlet XMLIntegratorServlet.java를 참조하십시오.
public java.lang.String getParameters()
Where 절에 대한 매개변수 값을 리턴합니다.
public java.lang.String getXMLFile()
생성될 현재 XML 파일 이름을 리턴합니다.
public java.io.PrintWriter getXMLWriter()
XML 출력에 대한 현재 PrintWriter를 리턴합니다.
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 스키마 파일의 생성 여부를 제어합니다. 기본적으로 값은 개발 시간에 대해서는 true로, 런타임에 대해서는 false로 설정됩니다. Servlet과 같은 런타임 응용프로그램에서 값을 true로 설정하면 일부 성능이 저하됩니다.
public void setIndenting(Boolean flag)
들여쓰기를 ON 및 OFF로 설정합니다. 기본적으로 들여쓰기는 ON으로 설정되어 있습니다.
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이 지정된 것으로 PrintWriter를 설정합니다. 이 메소드는 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이 지정된 것으로 PrintWriter를 설정합니다. 이 메소드는 setXSLFile(String)과 조합하여 함께 사용될 수 없습니다.