SQLXML 인터페이스
JDBC 드라이버는 java.sql.SQLXML 인터페이스를 도입하는 JDBC 4.0 API를 지원합니다. SQLXML 인터페이스는 XML 데이터와 상호 작용하고 조작하는 메서드를 정의합니다. SQLXML 데이터 형식은 SQL Server xml 데이터 형식에 매핑됩니다.
SQLXML 인터페이스는 String, Reader 또는 Writer 또는 Stream으로서 XML 값에 액세스하는 메서드를 제공합니다. XML 값은 원본을 통해 액세스하거나 결과로 설정할 수도 있습니다. 이 값은 XSLT 변환 및 XPath뿐만 아니라 DOM(문서 개체 모델), SAX(Simple API for XML), StAX(Streaming API for XML)와 같은 XML 파서 API와 함께 사용됩니다.
설명
다음 테이블에서는 SQLXML 인터페이스에 정의된 메서드에 대해 설명합니다.
| 메서드 구문 | 메서드 설명 |
|---|---|
| void free() | 이 메서드는 SQLXML 개체 및 이 개체가 보유한 리소스를 해제합니다. |
| InputStream getBinaryStream() | SQLXML에서 데이터를 읽을 입력 스트림을 반환합니다. |
| Reader getCharacterStream() | XML 데이터를 java.io.Reader 개체 또는 문자 스트림으로 반환합니다. |
| T extends Source T getSource(Class<T> sourceClass) | 이 SQLXML 개체에서 지정한 XML 값을 읽기 위한 소스를 반환 합니다. 참고: getSource 메서드는 원본 javax.xml.transform.dom.DOMSource, javax.xml.transform.sax.SAXSource, javax.xml.transform.stax.StAXSource 및 java.io.InputStream을 지원합니다. |
| String getString() | 이 SQLXML 개체에서 지정한 XML 값의 문자열 표현을 반환합니다. |
| OutputStream setBinaryStream() | 이 SQLXML 개체가 나타내는 XML 값을 쓰는 데 사용할 수 있는 스트림을 검색합니다. |
| Writer setCharacterStream() | 이 SQLXML 개체가 나타내는 XML 값을 쓰는 데 사용되는 스트림을 반환합니다. |
| T extends Result T setResult(Class<T> resultClass) | 이 SQLXML 개체에서 지정한 XML 값을 설정하기 위한 결과를 반환 합니다. 참고: setResult 메서드는 javax.xml.transform.dom.DOMResult, javax.xml.transform.sax.SAXResult, javax.xml.transform.stax.StaxResult, java.io.OutputStream.원본을 지원합니다. |
| void setString(문자열 값) | 이 SQLXML 개체에서 지정한 XML 값을 지정된 문자열 표현으로 설정합니다. |
애플리케이션은 SQLXML 개체에 XML 값을 한 번만 읽고 쓸 수 있습니다.
free() 메서드가 호출되면 SQLXML 개체가 유효하지 않게 되고 읽거나 쓸 수 없습니다. 응용 프로그램이 free() 메서드 이외의 SQLXML 개체에서 메서드를 호출하려고 하면 예외가 발생합니다.
애플리케이션에서 getter 메서드인 getSource, getCharacterStream, getBinaryStream 및 getString 중 하나를 호출하면 SQLXML 개체를 읽거나 쓸 수 없게 됩니다.
응용 프로그램에서 setResult, setCharacterStream, setBinaryStream, setString과 같은 setter 메서드를 호출하면 SQLXML 개체를 쓰거나 읽을 수 없게 됩니다.