Sampel jenis data SQLXML
Aplikasi sampel Microsoft JDBC Driver for SQL Server ini menunjukkan cara menyimpan data XML dalam database relasional, cara mengambil data XML dari database, dan cara mengurai data XML dengan jenis data Java SQLXML.
Contoh kode di bagian ini menggunakan parser SIMPLE API for XML (SAX). SAX adalah standar yang dikembangkan secara publik untuk penguraian dokumen XML berbasis peristiwa. Ini juga menyediakan antarmuka pemrograman aplikasi untuk bekerja dengan data XML. Aplikasi juga dapat menggunakan pengurai XML lainnya, seperti Model Objek Dokumen (DOM) atau API Streaming untuk XML (StAX), atau sebagainya.
Model Objek Dokumen (DOM) menyediakan representasi terprogram dari dokumen XML, fragmen, simpul, atau set simpul. Ini juga menyediakan antarmuka pemrograman aplikasi untuk bekerja dengan data XML. Demikian pula, API Streaming untuk XML (StAX) adalah API berbasis Java untuk XML pull-parsing.
Penting
Untuk menggunakan SAX parser API, Anda harus mengimpor implementasi SAX standar dari paket javax.xml.
File kode untuk sampel ini bernama SqlXmlDataType.java, dan dapat ditemukan di lokasi berikut:
\<installation directory>\sqljdbc_<version>\<language>\samples\datatypes
Persyaratan
Untuk menjalankan aplikasi sampel ini, Anda harus mengatur classpath untuk menyertakan file sqljdbc4.jar. Jika classpath kehilangan entri untuk sqljdbc4.jar, aplikasi sampel melemparkan pengecualian "Kelas tidak ditemukan". Untuk informasi selengkapnya tentang cara mengatur classpath, lihat Menggunakan Driver JDBC.
Anda juga memerlukan akses ke database sampel AdventureWorks2022 untuk menjalankan aplikasi sampel ini.
Contoh
Dalam contoh berikut, kode sampel membuat koneksi ke database AdventureWorks2022 lalu memanggil metode createSampleTables.
Metode createSampleTables menghilangkan tabel pengujian, TestTable1, dan TestTable2, jika ada. Kemudian, ia menyisipkan dua baris ke dalam TestTable1.
Selain itu, sampel kode mencakup tiga metode berikut dan satu kelas lainnya, yang diberi nama ExampleContentHandler.
Kelas ExampleContentHandler mengimplementasikan penangan konten kustom, yang menentukan metode untuk peristiwa pengurai.
Metode showGetters menunjukkan cara mengurai data di objek SQLXML dengan menggunakan SAX, ContentHandler, dan XMLReader. Pertama, sampel kode membuat instans handler konten kustom, yaitu ExampleContentHandler. Selanjutnya, ia membuat dan menjalankan pernyataan SQL yang mengembalikan sekumpulan data dari TestTable1. Kemudian, contoh kode mendapatkan pengurai SAX dan mengurai data XML.
Metode showSetters menunjukkan cara mengatur kolom xml dengan menggunakan SAX, ContentHandler, dan ResultSet. Pertama, ini membuat objek SQLXML kosong dengan menggunakan metode createSQLXML dari kelas Koneksi. Kemudian, ia mendapatkan instans handler konten untuk menulis data ke dalam objek SQLXML. Selanjutnya, contoh kode menulis data ke TestTable1. Terakhir, kode sampel melakukan iterasi melalui baris data yang ada dalam tataan hasil, dan menggunakan metode getSQLXML untuk membaca data XML.
Metode showTransformer menunjukkan cara mendapatkan data XML dari satu tabel dan menyisipkan data XML tersebut ke tabel lain dengan menggunakan SAX dan Transformer. Pertama, ia mengambil objek SQLXML sumber dari TestTable1. Kemudian, ia membuat objek SQLXML tujuan kosong dengan menggunakan metode createSQLXML dari kelas Koneksi. Selanjutnya, ini memperbarui objek SQLXML tujuan dan menulis data XML ke TestTable2. Terakhir, kode sampel melakukan iterasi melalui baris data yang ada dalam kumpulan hasil, dan menggunakan metode getSQLXML untuk membaca data XML di TestTable2.
import java.io.IOException;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.SQLXML;
import java.sql.Statement;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.sax.SAXResult;
import javax.xml.transform.sax.SAXSource;
import javax.xml.transform.sax.SAXTransformerFactory;
import org.xml.sax.Attributes;
import org.xml.sax.ContentHandler;
import org.xml.sax.Locator;
import org.xml.sax.SAXException;
import org.xml.sax.XMLReader;
public class SqlXmlDataType {
public static void main(String[] args) {
// Create a variable for the connection string.
String connectionUrl = "jdbc:sqlserver://<server>:<port>;databaseName=<database>;username=<user>;password=<password>;";
// Establish the connection.
try (Connection con = DriverManager.getConnection(connectionUrl);
Statement stmt = con.createStatement(ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_UPDATABLE)) {
// Create initial sample data.
createSampleTables(stmt);
// The showGetters method demonstrates how to parse the data in the
// SQLXML object by using the SAX, ContentHandler and XMLReader.
showGetters(stmt);
// The showSetters method demonstrates how to set the xml column
// by using the SAX, ContentHandler, and ResultSet.
showSetters(con, stmt);
// The showTransformer method demonstrates how to get an XML data
// from one table and insert that XML data to another table
// by using the SAX and the Transformer.
showTransformer(con, stmt);
}
// Handle any errors that may have occurred.
catch (Exception e) {
e.printStackTrace();
}
}
private static void showGetters(Statement stmt) throws IOException, SAXException, SQLException {
// Create an instance of the custom content handler.
ExampleContentHandler myHandler = new ExampleContentHandler();
// Create and execute an SQL statement that returns a
// set of data.
String SQL = "SELECT * FROM TestTable1";
try (ResultSet rs = stmt.executeQuery(SQL)) {
rs.next();
SQLXML xmlSource = rs.getSQLXML("Col3");
// Send SAX events to the custom content handler.
SAXSource sxSource = xmlSource.getSource(SAXSource.class);
XMLReader xmlReader = sxSource.getXMLReader();
xmlReader.setContentHandler(myHandler);
System.out.println("showGetters method: Parse an XML data in TestTable1 => ");
xmlReader.parse(sxSource.getInputSource());
}
}
private static void showSetters(Connection con, Statement stmt) {
// Create and execute an SQL statement, retrieving an updatable result set.
String SQL = "SELECT * FROM TestTable1;";
try (ResultSet rs = stmt.executeQuery(SQL)) {
// Create an empty SQLXML object.
SQLXML sqlxml = con.createSQLXML();
// Set the result value from SAX events.
SAXResult sxResult = sqlxml.setResult(SAXResult.class);
ContentHandler myHandler = sxResult.getHandler();
// Set the XML elements and attributes into the result.
myHandler.startDocument();
myHandler.startElement(null, "contact", "contact", null);
myHandler.startElement(null, "name", "name", null);
myHandler.endElement(null, "name", "name");
myHandler.startElement(null, "phone", "phone", null);
myHandler.endElement(null, "phone", "phone");
myHandler.endElement(null, "contact", "contact");
myHandler.endDocument();
// Update the data in the result set.
rs.moveToInsertRow();
rs.updateString("Col2", "C");
rs.updateSQLXML("Col3", sqlxml);
rs.insertRow();
// Display the data.
System.out.println("showSetters method: Display data in TestTable1 => ");
while (rs.next()) {
System.out.println(rs.getString("Col1") + " : " + rs.getString("Col2"));
SQLXML xml = rs.getSQLXML("Col3");
System.out.println("XML column : " + xml.getString());
}
} catch (Exception e) {
e.printStackTrace();
}
}
private static void showTransformer(Connection con, Statement stmt) throws Exception {
// Create and execute an SQL statement that returns a
// set of data.
String SQL = "SELECT * FROM TestTable1";
try (ResultSet rs = stmt.executeQuery(SQL)) {
rs.next();
// Get the value of the source SQLXML object from the database.
SQLXML xmlSource = rs.getSQLXML("Col3");
// Get a Source to read the XML data.
SAXSource sxSource = xmlSource.getSource(SAXSource.class);
// Create a destination SQLXML object without any data.
SQLXML xmlDest = con.createSQLXML();
// Get a Result to write the XML data.
SAXResult sxResult = xmlDest.setResult(SAXResult.class);
// Transform the Source to a Result by using the identity transform.
SAXTransformerFactory stf = (SAXTransformerFactory) TransformerFactory.newInstance();
Transformer identity = stf.newTransformer();
identity.transform(sxSource, sxResult);
// Insert the destination SQLXML object into the database.
try (PreparedStatement psmt = con
.prepareStatement("INSERT INTO TestTable2" + " (Col2, Col3, Col4, Col5) VALUES (?, ?, ?, ?)")) {
psmt.setString(1, "A");
psmt.setString(2, "Test data");
psmt.setInt(3, 123);
psmt.setSQLXML(4, xmlDest);
psmt.execute();
}
}
// Execute the query and display the data.
SQL = "SELECT * FROM TestTable2";
try (ResultSet rs = stmt.executeQuery(SQL)) {
System.out.println("showTransformer method : Display data in TestTable2 => ");
while (rs.next()) {
System.out.println(rs.getString("Col1") + " : " + rs.getString("Col2"));
System.out.println(rs.getString("Col3") + " : " + rs.getInt("Col4"));
SQLXML xml = rs.getSQLXML("Col5");
System.out.println("XML column : " + xml.getString());
}
}
}
private static void createSampleTables(Statement stmt) throws SQLException {
// Drop the tables.
stmt.executeUpdate("if exists (select * from sys.objects where name = 'TestTable1')" + "drop table TestTable1");
stmt.executeUpdate("if exists (select * from sys.objects where name = 'TestTable2')" + "drop table TestTable2");
// Create empty tables.
stmt.execute("CREATE TABLE TestTable1 (Col1 int IDENTITY, Col2 char, Col3 xml)");
stmt.execute("CREATE TABLE TestTable2 (Col1 int IDENTITY, Col2 char, Col3 varchar(50), Col4 int, Col5 xml)");
// Insert two rows to the TestTable1.
String row1 = "<contact><name>Contact Name 1</name><phone>XXX-XXX-XXXX</phone></contact>";
String row2 = "<contact><name>Contact Name 2</name><phone>YYY-YYY-YYYY</phone></contact>";
stmt.executeUpdate("insert into TestTable1" + " (Col2, Col3) values('A', '" + row1 + "')");
stmt.executeUpdate("insert into TestTable1" + " (Col2, Col3) values('B', '" + row2 + "')");
}
}
/**
* Handles output for XML elements for the test.
*/
class ExampleContentHandler implements ContentHandler {
public void startElement(String namespaceURI, String localName, String qName, Attributes atts) throws SAXException {
System.out.println("startElement method: localName => " + localName);
}
public void characters(char[] text, int start, int length) throws SAXException {
System.out.println("characters method");
}
public void endElement(String namespaceURI, String localName, String qName) throws SAXException {
System.out.println("endElement method: localName => " + localName);
}
public void setDocumentLocator(Locator locator) {
System.out.println("setDocumentLocator method");
}
public void startDocument() throws SAXException {
System.out.println("startDocument method");
}
public void endDocument() throws SAXException {
System.out.println("endDocument method");
}
public void startPrefixMapping(String prefix, String uri) throws SAXException {
System.out.println("startPrefixMapping method: prefix => " + prefix);
}
public void endPrefixMapping(String prefix) throws SAXException {
System.out.println("endPrefixMapping method: prefix => " + prefix);
}
public void skippedEntity(String name) throws SAXException {
System.out.println("skippedEntity method: name => " + name);
}
public void ignorableWhitespace(char[] text, int start, int length) throws SAXException {
System.out.println("ignorableWhiteSpace method");
}
public void processingInstruction(String target, String data) throws SAXException {
System.out.println("processingInstruction method: target => " + target);
}
}
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk