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