內(nèi)容: 很多開發(fā)人員一直都在抱怨，除了java代碼，他們還要管理眾多的XML配置文件。有了最近增加到j(luò)ava的元數(shù)據(jù)，通過使用標(biāo)注（注解），框架里的普通詳細配置信息現(xiàn)在都可以嵌入java文件里了。Sun的文章“J2SE 5.0 概要（J2SE 5.0 in a Nutshell.）對元數(shù)據(jù)和標(biāo)注進行了簡要介紹。這篇文章中，我們將總結(jié)現(xiàn)今的配置數(shù)據(jù)是如何管理的，緊接著的一個實現(xiàn)，標(biāo)注如何在一個簡單的驗證框架使用，描述了日后元數(shù)據(jù)將提供什么樣的功能。版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時請務(wù)必保留以下作者信息和鏈接作者:Jacob Hookomginge(作者的Blog:http://blog.matrix.org.cn/page/ginge)原文:http://www.onjava.com/pub/a/onjava/2005/01/19/metadata_validation.html譯文:http://www.matrix.org.cn/resource/article/44/44151_metadata_validation.html關(guān)鍵字:metadata;validation使用框架的今天 在我們?nèi)粘５淖鳂I(yè)中，我們都使用了框架來處理這些事情，例如持久化，用戶輸入，驗證，web服務(wù)以及工作流。為了與這些框架一起工作，我們不得不通過不同的方法在業(yè)務(wù)對象里做綁定。一些開發(fā)人員使用的與框架綁定的方法是：1，實現(xiàn)或者繼承框架提供的類。一個這樣的例子就是為了處理用戶的輸入，Struts里繼承ActionForm。為了能夠使用該框架，這是強制的，并且需要開發(fā)人員編寫和維護專門的業(yè)務(wù)對象（Employee對象和EmployeeForm）。2，維護單獨的配置文件，這些配置文件把Java對象和方法映射到該框架。Hibernate，Struts以及JavaServerFace都大量的使用了XML配置文件。然而，這些對于Java代碼很不顯眼，我們失去了編譯時驗證以及不得不在不同的位置維護數(shù)據(jù)――在XML文件和在不同的Java文件中。元數(shù)據(jù)將提供什么？元數(shù)據(jù)允許我們綁定框架相關(guān)的配置數(shù)據(jù)到我們的業(yè)務(wù)對象而無須改變或者繼承任何對象固有的職責(zé)。我喜歡將元數(shù)據(jù)跟Javadoc注釋做比較。如果你改變了一個Javadoc注釋，它并不會改變你的代碼的行為的，除非你確實用到Javadoc命令。概念上，元數(shù)據(jù)以相似的方式運作。你可以把配置數(shù)據(jù)添加到你的對象，不用改變代碼的行為，除非你要尋找該特定的元數(shù)據(jù)。既然元數(shù)據(jù)以這樣的方式運作，你可以使用標(biāo)注（Java元數(shù)據(jù)）來支持持久化，支持你的web應(yīng)用框架。斟酌這個例子：@Column('usrEmail')@ValidateEmailpublic void setEmail(String email) { this.email = email;}在上面的例子里，@Column('usrEmail')是一個會在你的持久化框架使用的標(biāo)注，而@ValidateEmail是在你的web框架里為了驗證用戶輸入使用的。注意到支持這兩個框架我們不需要改變setEmail(String)方法，從而保持了它的原汁原味，以及通有的簡單性。最后，如前所述，主要的好處就是配置數(shù)據(jù)可以在你的java對象里以一種類型安全的方式維護。不需要額外的剪切和粘貼類名，方法名到單獨的XML文件里，卻同時確保了名稱與java代碼相一致。以此代替的是僅僅通過標(biāo)注在你的代碼里的方法里聲明配置數(shù)據(jù)。驗證用戶輸入一個的使用元數(shù)據(jù)的優(yōu)秀例子是在一個簡單的框架哩驗證用戶輸入。有了這個框架，結(jié)果是允許開發(fā)人員去像這樣去裝飾對象：@ValidateRequired@ValidateEmailpublic void setEmail(String email) { this.email = email;}@ValidateRequired@ValidateLength(min=6,max=12)public void setPassword(String password) { this.password = password;}同時，開發(fā)人員應(yīng)該能夠?qū)σ粋€已標(biāo)注bean的屬性驗證輸入：Validator.validate(loginBean, 'email', '[email protected]');Validator.validate(loginBean, 'password', ''); // 非法實現(xiàn)元數(shù)據(jù)驗證讓我們來看可以定義多種驗證的情形。這里有一個關(guān)于ValidateLength 和 ValidateExpr標(biāo)注是怎樣的例子：//例子 @ValidateLength(min=6,max=8)public @interface ValidateLength { int min() default 0; int max() default Integer.MAX_VALUE;}// 例子 @ValidateExpr('^(w){0,2}$');public @interface ValidateExpr { String value();}當(dāng)在一個框架里使用標(biāo)注的時候一些問題出現(xiàn)了。首先，我們除了綁定狀態(tài)，不能給標(biāo)注綁定任何的行為或者操作。其次，沒有任何方法知道有哪些標(biāo)注是用于驗證的。這是因為標(biāo)注不允許繼承（extends 或者 implements），也就意味著進行標(biāo)注自省時，沒有instanceof能力。那么，我們怎樣才能夠在我們的框架里插入 驗證元數(shù)據(jù)？僅僅對標(biāo)注進行標(biāo)注！@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.ANNOTATION_TYPE)public @interface Validate { Class<? extends ValidateHandler> value();}如你在上面所看到的Validate標(biāo)注將為運行時反射保留（@Retention(RetentionPolicy.RUNTIME)）同時它也被聲明為標(biāo)注其他的標(biāo)注（@Target(ElementType.ANNOTATION_TYPE)）。另外，這個將處理驗證邏輯的Validate標(biāo)注僅有一個指定了一個ValidateHandler實例的Class變量。在我們進一步深入之前，讓我們來看看Validate是如何應(yīng)用到我們的ValidateExpr標(biāo)注的：@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.METHOD)@Validate(ValidateExprHandler.class)public @interface ValidateExpr { String value();}有三個標(biāo)注已添加到我們ValidateExpr標(biāo)注里了。前兩個是明了的，但是第三個，@Validate(ValidateExprHandler.class)解決了前面提及到的在一個框架里使用標(biāo)注所碰到的兩個問題。我們現(xiàn)在提供了一個方法，就是標(biāo)記所有Validate標(biāo)注的驗證器，而這些Validate標(biāo)注可以通過反射找到。同時，我們通過ValidateExprHandler提供了一個支持處理ValidaeExpr標(biāo)注的Class類型。讓我們看看ValidateExprHandler是如何被實現(xiàn)的（在這篇文章底部的Resources包含了這個和其他例子樣例源碼.zip）// 如在Validate標(biāo)注使用的接口public interface ValidateHandler{ public void validate(T settings, Object value) throws ValidationException; public Class getSettingsType();}// 與ValidateExpr標(biāo)注使用的處理者public class ValidateExprHandler implements ValidateHandler{ public void validate(ValidateExpr settings, Object value) throws ValidationException { String i = (value != null) ? value.toString() : ''; if (!Pattern.matches(settings.value(), i)) { throw new ValidationException(i + ' does not match the pattern ' + settings.value()); } } public Class getSettingsType() { return ValidateExpr.class; } }快速總結(jié)一下我們迄今所完成的：對于每個驗證器，我們定義一個標(biāo)注，實現(xiàn)一個ValidateHandler類以提供標(biāo)注實際的行為。既然對于Java元數(shù)據(jù)沒有任何繼承機制，我們用一個標(biāo)記標(biāo)注（Validate）以使我們的驗證框架可以在運行時使用反射找到驗證器的實現(xiàn)。Validatehandler接口允許一個標(biāo)注委派其行為，這些行為將在處理時被使用。處理驗證器現(xiàn)在該是時候操作處理我們的驗證標(biāo)注了。在本文前面，我展示了一個驗證器工具的例子，也就是關(guān)注找尋和處理聲明在你的Bean里的驗證器。Validator.validate(loginBean, 'email', '[email protected]');Validator.validate(loginBean, 'password', '');本質(zhì)上，目的是使用loginBean，為email (setEmail(String)找到setter方法。在J2SE 5.0，Method實現(xiàn)了AnnotatedElement，這使得我們可以為驗證器編寫一個一般的標(biāo)注處理方法：public static void validate(AnnotatedElement element, Object value) throws ValidationException{ Validate v; ValidateHandler vh; Annotation a; // 抓取所有標(biāo)注 Annotation[] ma = element.getAnnotations(); for (int i = 0; i < ma.length; i++) { // 如果一個標(biāo)注擁有一個驗證標(biāo)注 v = ma[i].annotationType().getAnnotation(Validate.class); if (v != null) { try { // 使用Validate的值創(chuàng)建一個ValidateHandler vh = v.value().newInstance();// 使用當(dāng)前標(biāo)注作為ValidateHandler的狀態(tài) // 會拋出 ValidationException異常 vh.validate(ma[i], value); } catch (InstantiationException ie) { } catch (IllegalAccessException iae) { }更加詳細的描述處理：1，從元素（setEmail(String)）里抓取所有的標(biāo)注。2，迭代所有標(biāo)注檢查每個標(biāo)注是否聲明了一個Validate標(biāo)注3，如果找到一個Validate標(biāo)注，則用其值創(chuàng)建一個ValidateHandler的新實例4，使用從數(shù)組里得到的原始標(biāo)注，將其傳遞給該ValidateHandler的實例做處理這就是所有要做的處理。允許你的框架的用戶毫不費力的在他們的bean屬性上聲明類型安全的標(biāo)注，目的就是以一個不顯眼的方式為用戶簡化處理的細節(jié)。確實，重要的是使其他人更加容易的使用你的框架。路在何方？像EJB 3.0之類的規(guī)范已經(jīng)增強了元數(shù)據(jù)對持久化映射的支持了。此外，很多開發(fā)人員已經(jīng)熟悉了XDoclet提供以及使用Javadoc元數(shù)據(jù)如何對已有框架提供配置細節(jié)的了。隨著XDclet的流行，使我驚奇的是，在日后發(fā)行版本中，框架的開發(fā)人員逐漸不再承擔(dān)提供標(biāo)注支持了。就JavaServerFaces而言，John Reynolds最近寫了關(guān)于驗證邏輯改放到何處，以及不贊成當(dāng)前使用方法的blog。在這篇文章中，為驗證框架修改了我們寫就的一些代碼，你應(yīng)該結(jié)合UIComponent的理念進入到驗證處理里。這樣就允許了程序員直接在他們的bean里聲明驗證元數(shù)據(jù)，而不是分散在JSP頁面里。思索一下，在當(dāng)今，為了讓你的對象在框架里運作需要什么，或者為了迎合你的雇主，你要學(xué)習(xí)什么API以及規(guī)范？XML和Java反射機制是簡化我們開發(fā)應(yīng)用和與框架工作方面的一個進步。現(xiàn)在，讓我們繼續(xù)朝著這條路走和以一種認真的看待Java元數(shù)據(jù)。相關(guān)資源：Sample source code for the validation utility'J2SE 5.0 in a Nutshell with an Introduction to Metadata'J2SE 5.0 Annotations API關(guān)于作者Jacob Hookom 是一個 McKesson Medical-Surgical的開發(fā)人員，一個Sun's JavaServerFaces RI的貢獻者，同時也是JavaServerFaces專家組（JavaServerFaces Expert Group）的一個活躍成員。 Java, java, J2SE, j2se, J2EE, j2ee, J2ME, j2me, ejb, ejb3, JBOSS, jboss, spring, hibernate, jdo, struts, webwork, ajax, AJAX, mysql, MySQL, Oracle, Weblogic, Websphere, scjp, scjd 很多開?