鐵手劍譜

第2.7式. 訪問來自于數(shù)據(jù)庫中的消息資源

問題

你想要將所有標注、消息和其他靜態(tài)文本都保存在數(shù)據(jù)庫中而不知一個屬性文件中，并且仍然可以通過bean:message標簽來進行訪問。

動作要領(lǐng)

1. 下載OJBMessageResources分發(fā)包，地址是：http://prdownloads.sourceforge.net/struts/ojb-message-resources.zip?download.
2. 將ZIP 文件解包到一個本地目錄；
3. 將ojb-msg-res.jar文件從ojb-message-resources/dist文件夾拷貝到你的應(yīng)用的WEB-INF/lib文件夾。
4. 將屬性文件、XML 和DTD 文件從ojb-message-resources/config文件夾拷貝到你的應(yīng)用的src文件夾。當你build 你的應(yīng)用的時候是，這些文件必須被拷貝到WEB-INF/classes文件夾中。
5. 創(chuàng)建數(shù)據(jù)庫表來保存對象關(guān)系橋(OJB) 的元數(shù)據(jù)。OJB 使用表來保持內(nèi)部的映射關(guān)系。Example 2-12 列出了在MYSQL中創(chuàng)建這些表的SQL。對于其他數(shù)據(jù)庫的語句，包含在OJB 分發(fā)包中。

Example 2-12. OJB 元數(shù)據(jù)DDL (MySQL)

CREATE TABLE ojb_dlist (
  ID int NOT NULL default '0',
  SIZE_ int default NULL,
  PRIMARY KEY  (ID)
) TYPE=MyISAM;

CREATE TABLE ojb_dlist_entries (
  ID int NOT NULL default '0',
  DLIST_ID int NOT NULL default '0',
  POSITION_ int default NULL,
  OID_ longblob,
  PRIMARY KEY  (ID)
) TYPE=MyISAM;

CREATE TABLE ojb_dmap (
  ID int NOT NULL default '0',
  SIZE_ int default NULL,
  PRIMARY KEY  (ID)
) TYPE=MyISAM;

CREATE TABLE ojb_dmap_entries (
  ID int NOT NULL default '0',
  DMAP_ID int NOT NULL default '0',
  KEY_OID longblob,
  VALUE_OID longblob,
  PRIMARY KEY  (ID)
) TYPE=MyISAM;

CREATE TABLE ojb_dset (
  ID int NOT NULL default '0',
  SIZE_ int default NULL,
  PRIMARY KEY  (ID)
) TYPE=MyISAM;

CREATE TABLE ojb_dset_entries (
  ID int NOT NULL default '0',
  DLIST_ID int NOT NULL default '0',
  POSITION_ int default NULL,
  OID_ longblob,
  PRIMARY KEY  (ID)
) TYPE=MyISAM;

CREATE TABLE ojb_hl_seq (
  TABLENAME varchar(175) NOT NULL default '',
  FIELDNAME varchar(70) NOT NULL default '',
  MAX_KEY int default NULL,
  GRAB_SIZE int default NULL,
  PRIMARY KEY  (TABLENAME,FIELDNAME)
) TYPE=MyISAM;

CREATE TABLE ojb_lockentry (
  OID_ varchar(250) NOT NULL default '',
  TX_ID varchar(50) NOT NULL default '',
  TIMESTAMP_ decimal(10,0) default NULL,
  ISOLATIONLEVEL int default NULL,
  LOCKTYPE int default NULL,
  PRIMARY KEY  (OID_,TX_ID)
) TYPE=MyISAM;

CREATE TABLE ojb_nrm (
  NAME varchar(250) NOT NULL default '',
  OID_ longblob,
  PRIMARY KEY  (NAME)
) TYPE=MyISAM;

CREATE TABLE ojb_seq (
  TABLENAME varchar(175) NOT NULL default '',
  FIELDNAME varchar(70) NOT NULL default '',
  LAST_NUM int default NULL,
  PRIMARY KEY  (TABLENAME,FIELDNAME)
) TYPE=MyISAM;

6. 使用Example 2-13中的SQL DDL來創(chuàng)建保存消息資源數(shù)據(jù)的表。

Example 2-13. MessageResources DDL

create table application_resources ( 
  subApp            varchar(100)     not null,
  bundleKey         varchar(100)     not null,
  locale            varchar(10)      not null,
  msgKey            varchar(255)     not null,
  val               varchar(255),
  Primary Key(
    subApp,
    bundleKey,
    locale,
    msgKey
  )
);

• 將消息資源裝入數(shù)據(jù)庫表格中。Example 2-14 展示了一個如何使用SQL語句組裝表格數(shù)據(jù)的簡便方法。

Example 2-14. SQL to load message resources table

insert into application_resources ( 
    subApp, bundleKey, locale, msgKey, val ) 
  values ('', '', '', 'label.index.title', 
          'Struts Cookbook');
insert into application_resources ( 
    subApp, bundleKey, locale, msgKey, val ) 
  values ('', '', 'fr', 'label.index.title', 
          'Struts Livre de Cuisine');

修改Struts 配置文件來使用OJBMessageResourcesfactory。

<message-resources 
   factory="org.apache.struts.util.OJBMessageResourcesFactory"
   parameter="."/>

修改WEB-INF/classes文件夾中的repository.xml (第4步中拷貝的) 來使用專門針對你的數(shù)據(jù)庫的數(shù)據(jù)庫連接屬性。Example 2-15展示了針對MySQL 數(shù)據(jù)庫的配置信息。

Example 2-15. 針對MySQL的OJB 連接描述

<jdbc-connection-descriptor
     platform="MySQL"
     jdbc-level="2.0"
     driver="com.mysql.jdbc.Driver"
     protocol="jdbc"
     subprotocol="mysql"
     dbalias="http://localhost:3306/test"
     username="user"
     password="pass"
/>

動作變化

Struts MessageResources工具管理著諸如錯誤消息、字段標注、表格頭部以及窗口標題等靜態(tài)文本。通過這個工具，文本被保存在成為資源束的一個或者多個.properties文件的名值對中；名稱是一個邏輯關(guān)鍵字而值則是要顯示文本的值。如果你的應(yīng)用需要針對某個特定國家和語言進行本地化，你將創(chuàng)建一個（套）新的屬性文件。你可以使用對屬性文件名稱添加一個由國家代碼和語言代碼組成的后綴來將一個文件關(guān)聯(lián)到一個特定的場所。比如，針對加拿大法語的MessageResources.properties文件可能是MessageResources_fr_CA.properties。本地化文件中的屬性包含有專門針對該場所的值。這種本地化的方式實際上是Java自身決定的。

這個工具對大多數(shù)中型和小型的應(yīng)用工作的很不錯。但是，你可能想要使用一種更加具有可管理性的持久性手段，比如數(shù)據(jù)庫來保存它。雖然Struts 本身并不支持這種方式，但是可以通過其他擴展來支持。在幕后， Struts 使用MessageResourcesFactory的實現(xiàn)來創(chuàng)建在運行時保存在servlet context中的MessageResources對象。你可以提供定制的Struts MessageResourcesFactory實現(xiàn)，并且在Struts 配置文件中聲明你的實現(xiàn)：

<message-resources 
  factory="com.foo.CustomMessageResourcesFactory"
  parameter="moduleName.bundleKey"/>

parameter 屬性指定消息資源工廠要針對創(chuàng)建的Struts module 名稱和bundle 關(guān)鍵字(bundle 名稱) 。

所以，你可以創(chuàng)建你自己的從數(shù)據(jù)庫中讀取資源的消息資源工廠。幸運的是，這個麻煩的工作已經(jīng)有人做了。James Mitchell, 一個長期的Struts 志愿者，創(chuàng)建了一個OJBMessageResources實現(xiàn)。這些類利用了對象關(guān)系映射框架OJB來提供易用的數(shù)據(jù)庫驅(qū)動的MessageResources實現(xiàn)。

如果你不熟悉OJB，也不會阻止你練習這一招技術(shù)。你不需要完全了解OJB來能使用OJBMessageResources。OJB 中僅涉及到將關(guān)系數(shù)據(jù)映射到對象數(shù)據(jù)的部分內(nèi)容。如果你使用本方案中指定的table schema ，對于映射數(shù)據(jù)不需要再作其他修改。然而，如果你想要使用一個不同的schema，你就需要對 OJB 基于XML的配置文件中的映射配置進行修改易適合你的需要。你不需要對實現(xiàn)MessageResourcesFactory的具體Java代碼做任何修改。OJBMessageResources的文檔也不錯，并且有一個逐步的安裝和配置指導的README文件。上面的動作要領(lǐng)就來自于這些指導。

為了最有效的使用OJBMessageResources ，理解數(shù)據(jù)庫schema 如何映射到對象數(shù)據(jù)是很有幫助的。首先，schema 金需要創(chuàng)建一個表格來保存消息資源(第6步)。使用一個表簡化了數(shù)據(jù)映射。Table 2-2 表述了組成該表的列，以及它們?nèi)绾卧赟truts中使用。

記住，雖然OJBMessageResources 使用一個單表來保存消息資源，每一個資源集都仍然必須在struts-config.xml中通過message-resources元素進行配置。換句話說，對由bundleKey 和 subApp區(qū)分的每一個消息資源集都將需要一個message-resource元素。關(guān)于多個消息資源，參見第2.6式。

相關(guān)招式

第2.6式描述了如何配置Struts 來使用多個消息資源束。第13段的動作中會描述如何進行Struts 應(yīng)用的國際化。

OJB 是Apache 大傘之下的一個項目。詳細信息清訪問呢：http://db.apache.org/ojb.

有人正在努力將Struts 消息資源重構(gòu)到一些更加通用的類中。這就是Commons Resources 項目，可以訪問http://jakarta.apache.org/commons/sandbox/resources/獲取相關(guān)信息。它可以提供屬性文件支持的消息資源機制，或者其他持久性機制支持的消息資源機制，比如OBJ, Hibernate, Torque, 和直接JDBC。也許將來的Struts將使用這個通用的消息資源機制。