DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
Castor 資料綁定實作 第 1 篇:下載、安裝與環境配置
編輯:XML詳解     

資料綁定為什麼紅

在 XML 新聞群組、郵件論壇與網站的討論區裡,資料綁定大概是出現頻率最高的話題之一。Java 與 XML 開發者都在找同一個答案:有沒有一種簡單的方法,能在 Java 物件與 XML 文件之間雙向轉換?

Sun 靠著 JAXB(Java Architecture for XML Binding)在這個領域占了先機——順帶一提,JAXB 這個縮寫的官方展開說法幾乎每年都在變,在別處看到不同版本不用太意外。但 JAXB 有幾個明顯的短板:更新速度慢,介面設計也稱不上友善,而且無法直接對應到關聯式資料庫,而這恰恰是業界最常提出的需求之一。

Castor 的出現

正是在這樣的空隙之間,Castor 出現了。這是一套開放原始碼框架,填補了 JAXB 力有未逮之處。它的歷史其實比 JAXB 的程式碼庫與 Sun 的資料綁定規範都更早,一路持續演進;後來也加入了對 JAXB 做法的支援,因此原本使用 JAXB 的開發者要遷移程式碼並不困難。

選擇 Castor 的理由

在動手安裝之前,先說清楚值得投入的理由:

  • 它幾乎是 JAXB 的替代品。既有 JAXB 程式碼轉移到 Castor 的門檻很低,新手也能快速上手。
  • 功能面更廣:不需要綱要(schema)就能在 Java 與 XML 之間轉換、提供比 JAXB 更易用的綁定方式,並且能對關聯式資料庫與 XML 文件進行編組(marshal)與解組(unmarshal)。
  • 額外提供 JDO 功能。JDO(Java Data Objects)是驅動 Java-to-RDBMS 編組/解組的底層技術。雖然它已不如往年熱門,但作為一項 Sun 規範,至少不必面對語意含混的自家 API。

下載 Castor

安裝流程相當直觀。先到 Castor 官方網站,在左側選單點 Download,選擇最新的 milestone release,再往下捲到 Download sets。你會看到可以整包下載的 Castor JAR、DTD、doc、相依元件等,預先打包好的壓縮檔省下不少工夫。

圖 1. Castor 網站的下載套件

本文使用 1.1.2.1 版,選擇的是 ZIP 格式的「The Castor JARs, docs, DTDs, command line tools, and examples」套件。解開後會得到一批 JAR 檔、文件與範例程式。

圖 2. 解開後的 Castor 檔案

把檔案放到正確的位置

第三方程式庫集中管理

我強烈建議把所有第三方 Java 程式庫放在同一個根目錄下。任由它們散落在系統各處,後果會很棘手:

  • 需要時找不到東西。
  • 同一個套件的多個版本分散在不同路徑,你得花大量時間確認到底用了哪一版。
  • classpath 會變得又長又難讀。

我的做法是把所有庫放在 /usr/local/java/ 底下,每個庫各自一個子目錄,目錄名稱通常帶有版本號。因此解開的 Castor 也移到位於 /usr/local/java/castor-1.1.2.1。

為 JavaDoc 加書籤

另一個容易被忽略的步驟是把文件的位置連結好。多數 Java 庫都附帶 HTML 格式的本地文件副本,Castor 也不例外,路徑是 castor-1.1.2.1/doc/。我在瀏覽器裡為 index.html 加了一個書籤。

圖 3. 本地開啟的 Castor 文件

堅持使用本地文件有兩個理由。第一,它在沒有網路的場合格外有用——在飛機上寫程式、連不上咖啡店的 Wi-Fi 時,本地文件就是你唯一的救生索,而且讀取速度更快。第二,本地文件的版本永遠與你安裝的庫一致。線上文件往往是最新版,跟你手上這版 Castor 的行為可能已經不同;版本錯位所帶來的困惑與挫折,是很多人都吃過的暗虧。

取得相依元件

Castor 有一批相依項:

  • Apache Ant
  • Jakarta Commons
  • JDBC 2.0 Standard Extensions
  • Log4J 日誌工具
  • Apache Xerces XML 解析器

這已是涵蓋大多數操作的精簡清單。如果你想從原始碼自行編譯 Castor、跑完整範例與測試,或深入研究的話,需要更多相依項。無論如何,這些 JAR 都必須進到 classpath,Castor 才能正常運作。

麻煩但可控的做法

比較費工的方式是:先到下載頁記下每個相依項的指定版本,然後逐一造訪各自的網站、找到該版本、下載並加入 classpath。耗時,但控制力最強。如果你系統裡大部分庫已經就緒,這條路依然可行。

輕鬆的做法

幸運的是還有更省事的路。回到下載頁,找到穩定版本,然後選擇另一個名為「Full SVN snapshot: All sources, docs, and 3rd party libraries (big)」的套件。雖說被標為「big」,實際上只有約 10 MB,對寬頻使用者來說不成負擔。下載解壓後:

圖 4. 完整的 SVN 快照(已解開)

進入 lib/ 目錄,裡頭那一整批 JAR 就是 Castor 需要的全部庫。

替這些庫安個家

建立一個新目錄——放在 Castor 安裝目錄之內或與其並列皆可——把剛下載的 JAR 全部搬進去。以下是我的實際操作:

[bmclaugh:~] cd /usr/local/java
[bmclaugh:/usr/local/java] ls
castor-1.1.2.1  xalan-j_2_7_0
[bmclaugh:/usr/local/java] cd castor-1.1.2.1/
[bmclaugh:/usr/local/java/castor-1.1.2.1] ls
CHANGELOG              castor-1.1.2.1.jar
castor-1.1.2.1-anttasks.jar    doc
castor-1.1.2.1-codegen.jar     jdbc-se2.0.jar
castor-1.1.2.1-ddlgen.jar      jta1.0.1.jar
castor-1.1.2.1-jdo.jar         schema
castor-1.1.2.1-xml.jar
[bmclaugh:/usr/local/java/castor-1.1.2.1] mkdir lib
[bmclaugh:/usr/local/java/castor-1.1.2.1] cd lib
[bmclaugh:/usr/local/java/castor-1.1.2.1/lib]
cp ~/downloads/castor-1.1.2.1/lib/*.jar .

設定 classpath

接著要把這些東西全部掛上 classpath。我在 Mac OS X 上透過 .profile 統一處理;你可以採用同樣思路,或在 Windows 上設定系統環境變數。無論哪一種,至少這四個 JAR 必須進 classpath:

  • castor-1.1.2.1.jar(Castor 主目錄)
  • castor-1.1.2.1-xml.jar(Castor 主目錄)
  • xerces-J-1.4.0.jar(與其他相依庫同處一地)
  • commons-logging-1.1.jar(同上)

以下是我的 .profile 供參考:

export JAVA_BASE=/usr/local/java
export JAVA_HOME=/Library/Java/Home
export XERCES_HOME=$JAVA_BASE/xerces-2_6_2
export XALAN_HOME=$JAVA_BASE/xalan-j_2_7_0
export CASTOR_HOME=$JAVA_BASE/castor-1.1.2.1
export EDITOR=vi

export CASTOR_CLASSES=$CASTOR_HOME/castor-1.1.2.1.jar:
$CASTOR_HOME/castor-1.1.2.1-xml.jar:
$CASTOR_HOME/lib/xerces-J_1.4.0.jar:
$CASTOR_HOME/lib/commons-logging-1.1.jar

export CVS_RSH=ssh
export PS1="[`whoami`:w] "

export CLASSPATH=$XALAN_HOME/xalan.jar:$XALAN_HOME/xml-apis.jar:
$XALAN_HOME/xercesImpl.jar:
~/lib/mclaughlin-xml.jar:$CASTOR_CLASSES:.

確認檔案都進了 classpath,就可以做個快速驗證了。

驗證安裝

我們用一個極簡的例子來確認環境正常:一個 CD 類,加上一組負責編組與解組的程式。這不是功能展示,只是「能跑起來」的體檢。

清單 1. 測試用的 CD 類

package ibm.xml.castor;

import java.util.ArrayList;
import java.util.List;

/** A class to represent CDs */
public class CD implements java.io.Serializable {

  /** The name of the CD */
  private String name = null;

  /** The artist of the CD */
  private String artist = null;

  /** Track listings */
  private List tracks = null;

  /** Required no-args constructor */
  public CD() {
    super();
  }

  /** Create a new CD */
  public CD(String name, String artist) {
    super();
    this.name = name;
    this.artist = artist;
  }

  public void setName(String name) { this.name = name; }
  public String getName() { return name; }

  public void setArtist(String artist) { this.artist = artist; }
  public String getArtist() { return artist; }

  public void setTracks(List tracks) { this.tracks = tracks; }
  public List getTracks() { return tracks; }

  public void addTrack(String trackName) {
    if (tracks == null) {
      tracks = new ArrayList();
    }
    tracks.add(trackName);
  }
}

再來一個負責編組的類。

清單 2. 編組測試類

package ibm.xml.castor;

import java.io.FileWriter;
import org.exolab.castor.xml.Marshaller;

public class MarshalTester {
  public static void main(String[] args) {
    try {
      CD sessions = new CD("Sessions for Robert J", "Eric Clapton");
      sessions.addTrack("Little Queen of Spades");
      sessions.addTrack("Terraplane Blues");

      FileWriter writer = new FileWriter("cds.xml");
      Marshaller.marshal(sessions, writer);
    } catch (Exception e) {
      System.err.println(e.getMessage());
      e.printStackTrace(System.err);
    }
  }
}

最後是解組的類。

清單 3. 解組測試類

package ibm.xml.castor;

import java.io.FileReader;
import java.util.Iterator;
import java.util.List;
import org.exolab.castor.xml.Unmarshaller;

public class UnmarshalTester {
  public static void main(String[] args) {
    try {
      FileReader reader = new FileReader("cds.xml");
      CD cd = (CD) Unmarshaller.unmarshal(CD.class, reader);

      System.out.println("CD title: " + cd.getName());
      System.out.println("CD artist: " + cd.getArtist());

      List tracks = cd.getTracks();
      if (tracks == null) {
        System.out.println("No tracks.");
      } else {
        for (Iterator i = tracks.iterator(); i.hasNext(); ) {
          System.out.println("Track: " + i.next());
        }
      }
    } catch (Exception e) {
      System.err.println(e.getMessage());
      e.printStackTrace(System.err);
    }
  }
}

編譯這三個類別:

[bmclaugh:~/Documents/developerworks/castor] javac -d . *.java
Note: CD.java uses unchecked or unsafe operations.
Note: Recompile with -Xlint:unchecked for details.

若使用 Java 5 以上版本而 CD.java 沒有使用參數化型別,就會看到上述提示。這不影響結果,可以忽略。接著執行編組程式:

[bmclaugh:~/Documents/developerworks/castor] java ibm.xml.castor.MarshalTester

打開產生的 cds.xml,內容應該類似:

<?xml version="1.0" encoding="UTF-8"?>
<cd>
  <artist>Eric Clapton</artist>
  <name>Sessions for Robert J</name>
  <tracks xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:type="java:java.lang.String">Little Queen of Spades</tracks>
  <tracks xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:type="java:java.lang.String">Terraplane Blues</tracks>
</cd>

可讀性確實普通,但 MarshalTester 中設定的所有資訊都確實寫進 XML 了。

接著驗證反向流程——把 XML 轉回 Java:

[bmclaugh:~/Documents/developerworks/castor] java ibm.xml.castor.UnmarshalTester
CD title: Sessions for Robert J
CD artist: Eric Clapton
Track: Little Queen of Spades
Track: Terraplane Blues

看到這樣的輸出,就代表 Castor 已經成功讀取 XML 並還原成 Java 物件。你還沒讓它做任何複雜的事,只是確認了三件事:JAR 檔位置正確、環境設定無誤、編組與解組都能正常運作。

結語

至此你已經擁有一個可運作的 Castor 環境。上面三份清單讓你對它的運作方式有了初步概念——不妨自己動手試試編組與解組。下一篇我們會往裡看得更深:Castor 的 XML 特性,以及對應檔(mapping file)的用法。在那之前,先把玩一下手上的工具吧。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved