Membina kod kustom dengan Java API untuk XML Binding (JAXB) - dummies

Anda boleh membina kod tersuai dengan JAXB - API API untuk Mengikat XML . Dengan JAXB, anda mengambil dokumen XML dan anda membuat fail kelas Java yang sesuai untuk memproses dokumen. Apabila keperluan anda berubah dan kelas tidak lagi melakukan apa yang anda mahu lakukan, anda hanya menanam subclass baru.

Apabila anda menulis kod SAX atau DOM, anda membuat program pemprosesan XML. Program anda membaca dokumen, dan menggunakan dokumen untuk melakukan kerja yang berguna - bermula dengan sesuatu yang tidak berbahaya seperti startElement atau node awam yang tidak sah. getNodeName (). Sama ada cara, program anda tidak membuat andaian tentang apa yang ada dalam dokumen itu. Dokumen ini mempunyai elemen akar, beberapa elemen kanak-kanak, dan itu sahaja. Apa-apa anggapan istimewa yang anda buat tentang dokumen ini sebenarnya mempersempit kegunaan kod tersebut.

Kod serba versus berbanding kod tersuai

Pertimbangkan kod dalam Senarai 1 dan 2. Penyenaraian 1, mengimbas lima nod dalam pokok dokumen. Mereka lima nod perlu disusun dengan cara tertentu, atau program tersebut crash. (Penyenaraian itu mahu komen dan nod akar, dengan sekurang-kurangnya dua anak secara langsung di bawah nod akar.)

Senarai 1: Memaparkan beberapa nod

org import. w3c. dom. Nod;

import org. w3c. dom. NamedNodeMap;

kelas MyTreeTraverser

{

MyTreeTraverser (nod nod)

{

System. keluar. println (node getNodeName ());

nod = nod. getFirstChild (); Sistem

. keluar. println (node getNodeName ());

nod = nod. getNextSibling (); Sistem

. keluar. println (node getNodeName ());

nod = nod. getFirstChild (); Sistem

. keluar. println (node getNodeName ());

nod = nod. getNextSibling (); Sistem

. keluar. println (node getNodeName ());

}

Penyenaraian 2: Mengembara org import

org. w3c. dom. Nod;

import org. w3c. dom. NamedNodeMap;

kelas MyTreeTraverser

{

Node node;

MyTreeTraverser (nod nod)

{

ini. nod = nod;

displayName ();

displayValue ();

jika (node getNodeType () == Node ELEMENT_NODE)

displayAttributes (); Sistem

. keluar. println ();

paparanChildren ();

}

void displayName ()

{

System. keluar. cetak ("Nama:"); Sistem

. keluar. println (node getNodeName ());

}

void displayValue ()

{

String nodeValue = node. getNodeValue ();

jika (nodeValue! = Null)

nodeValue = nodeValue. trim (); Sistem

. keluar. cetak ("Nilai:"); Sistem

. keluar. println (nodeValue);

}

void displayAtributes ()

{

NamedNodeMap attribs = node. getAttributes ();

untuk (int i = 0; i

{

System. keluar. println (); Sistem

. keluar. cetak ("Atribut:"); Sistem

. keluar. cetak (attribs item (i). getNodeName ()); Sistem

. keluar. cetak ("="); Sistem

. keluar. println (attribs item (i). getNodeValue ());

}

void displayChildren ()

{

Node child = node. getFirstChild ();

manakala (anak! = Null)

{

MyTreeTraverser baru (kanak-kanak);

anak = anak. getNextSibling ();

}

Kod dalam Listing 2 adalah lebih umum. Kod ini menyemak struktur dokumen semasa ia berjalan. Apabila kod itu menemui nod kanak-kanak, ia memindai anak itu dan mencari cucu-cucu. Jika tidak ada cucu, kod itu mencari adik-beradik. Kod ini boleh mengendalikan mana-mana pokok dokumen - sama ada ia mempunyai satu nod atau seribu nod.

Oleh itu, Penyenaraian 2 lebih fleksibel daripada Penyenaraian 1. Walau bagaimanapun, kepelbagaian ini datang dengan kekurangan - termasuk kemungkinan overhead yang tinggi. Kod dalam Listing 2 harus mengurai seluruh dokumen XML - dan kemudian meletakkan perwakilan pokok dokumen itu ke dalam memori komputer. Sekiranya dokumen itu sangat besar, maka perwakilannya adalah besar: Memori akan kembung dengan semua data sementara itu, dan kod dalam Penyenaraian 2 melancarkan kepada merangkak.

Manfaat penyesuaian

Bayangkan anda cuba memandu ke Faneuil Hall di Boston, Massachusetts. Tidak kira di mana anda bermula; perjalanan akan sentiasa mengelirukan dan sukar. Bagaimanapun, anda perlu merancang laluan anda. Anda boleh tersesat di Revere berdekatan atau Cambridge atau di pusat bandar Boston. Bergantung kepada sumber anda, anda mempunyai dua pilihan:

Anda boleh berhenti di stesen minyak dan membeli peta. Sekiranya anda berbuat demikian, maka anda tidak boleh sampai ke Faneuil Hall. Lagipun, anda perlu mencari di mana anda berada di peta, cari laluan alternatif, memilih laluan, dan kemudian (surga membantu anda) cuba mengikuti laluan tanpa tersesat lagi.
Anda boleh memberitahu sistem GPS yang mahal dan bercakap yang anda ingin masuk ke Faneuil Hall. Sistem ini akan merancang laluan tersuai dan membimbing anda, berpaling dengan belokan, dari mana-mana tempat yang menyedihkan anda ke laluan optimum yang membawa dari sana ke Faneuil Hall. Laluan ini sangat disesuaikan supaya suara GPS mengatakan (contohnya), "Tidak ada tanda di persimpangan ini, tetapi belok kiri pula. "Kemudian, suara itu berkata" Terdapat dua tanda di persimpangan ini, dan tanda-tanda bercanggah antara satu sama lain. Tetapi matikan pula. "

Menggunakan peta kertas mengambil lebih banyak kerja (lebih banyak masa, usaha, ketangkasan, dan kesabaran) daripada menggunakan GPS bercakap. Mengapa? Kerana peta kertas tidak disesuaikan dengan keperluan khusus anda; sebenarnya, ia berkata, "Inilah seluruh kawasan metropolitan Boston. Faneuil Hall ada di sana di suatu tempat. Anda tahu apa yang harus dilakukan selanjutnya. "

Sistem tersuai adalah (seperti yang anda harapkan) lebih mudah digunakan daripada yang tidak disesuaikan dengan situasi terdekat anda. Oleh itu, kod pemprosesan XML Listing 2 menjadikan pohon DOM yang besar dan sumber daya dalam ruang ingatan komputer anda ("Ini pokok - anda memikirkan apa yang perlu dilakukan seterusnya …") kerana kod itu tidak ' t disesuaikan.Kod ini berfungsi untuk mana-mana dokumen lama - bukan hanya yang anda ada di tangan - dan sentiasa gobbles sumber untuk melakukannya.

Inti dari JAXB

Idea di belakang JAXB adalah untuk membuat kelas khusus yang sesuai untuk memenuhi keperluan anda sekarang. Anda mengambil keterangan dokumen XML, jalankan melalui program khas yang dipanggil skema pengkompil , dan dapatkan kelas baru yang dipanggil kelas yang dijana . Kelas yang dihasilkan ini diperkemas untuk berfungsi dengan dokumen XML tertentu.

Sebagai contoh, jika dokumen XML anda mempunyai unsur bernama Jumlah, maka kelas yang dijana boleh mempunyai setTotal dan getTotal methods. Jika elemen dokumen mempunyai atribut penuh, maka kelas yang dihasilkan boleh mempunyai setFullName dan kaedah GetFullName. (Lihat Rajah 1.)

Sambungan antara sebahagian dokumen XML dan sebahagian daripada kelas Java dipanggil mengikat . Dengan semua pengikatan ini, contoh kelas mewakili satu dokumen XML.