UserType and CompositeUserType為
Hibernate中提供的用戶類型自定義接口。根據這個接口，可以實現自定義的數據類型。
最近看<<深入淺出
Hibernate>>,作者在書中介紹了
Hibernate 提供的用戶自定義數據類型，于是效仿書中的方法，在數據庫表中添加一個字段用于記錄所有好友的userid，每個userid之間用";"加以分隔，同時將該字段映射為一個特殊的List集合，利用UserType interface實現String解析后將各個userid封裝在List中，將List中的記錄封裝成以";"分隔的String。
使用UserType接口，實現了較好的設計風格，以及更好的重用性。
/*
* 用戶自定義的數據類型，對應數據庫中的一個字段，在該字段中，保存了
* 多個用戶需要的信息，之間用";"加以分隔.
* @Author:Paul
* @Date:April 18th,2008
*/
package com.globalhands.
hibernate.userTypes;
import java.io.Serializable;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.ArrayList;
import java.util.List;
import java.sql.Types;
import org.
hibernate.
Hibernate;
import org.
hibernate.HibernateException;
import org.
hibernate.usertype.UserType;
public class SpecialList implements UserType {
private List specialList;
private static final char SPLITTER = ';';
private static final int[] TYPES = new int[] { Types.VARCHAR };
public String assemble(Serializable arg0, Object arg1)
throws HibernateException {
return null;
}
/*
* 將List封裝為一個String對象
*/
public String assemble(List specialList) throws HibernateException {
StringBuffer sb = new StringBuffer();
for (int i = 0; i < specialList.size() - 1; i++) {
sb.append(specialList.get(i)).append(this.SPLITTER);
}
sb.append(specialList.get(specialList.size() - 1));
return sb.toString();
}
/*
* 創建一個新的List實例，包含原有的List實例中的所有元素.
*/
public Object deepCopy(Object value) throws HibernateException {
List sourceList = (List) value;
List targetList = new ArrayList();
targetList.addAll(sourceList);
return targetList;
}
public Serializable disassemble(Object arg0) throws HibernateException {
return null;
}
/*
* 判斷specialList是否發生變化
*/
public boolean equals(Object x, Object y) throws HibernateException {
if (x == y) {
return true;
}
if (x != null && y != null) {
List xList = (List) x;
List yList = (List) y;
if (xList.size() != yList.size()) {
return false;
}
for (int i = 0; i <= xList.size() - 1; i++) {
String str1 = (String) xList.get(i);
String str2 = (String) yList.get(i);
if (!xList.equals(yList)) {
return false;
}
}
return true;
}
return false;
}
public int hashCode(Object arg0) throws HibernateException {
return 0;
}
public boolean isMutable() {
return false;
}
/*
* 從resultset中取出email字段，并將其解析為List類型后返回
*/
public Object nullSafeGet(ResultSet rs, String[] names, Object owner)
throws HibernateException, SQLException {
String value = (String)
Hibernate.STRING.nullSafeGet(rs, names[0]);
if (value != null) {
return parse(value);
} else {
return null;
}
}
/*
* 將以";"分隔的字符串解析為一個字符串數組
*/
private List parse(String value) {
String[] strs = value.split(";");
List specialList = new ArrayList();
for (int i = 0; i <= strs.length - 1; i++) {
specialList.add(strs[i]);
}
return specialList;
}
/*
* 將List型的email信息組裝成字符串之后保存到email字段
*/
public void nullSafeSet(PreparedStatement st, Object value, int index)
throws HibernateException, SQLException {
if (value != null) {
String str = assemble((List) value);
Hibernate.STRING.nullSafeSet(st, str, index);
} else {
Hibernate.STRING.nullSafeSet(st, value, index);
}
}
public Object replace(Object arg0, Object arg1, Object arg2)
throws HibernateException {
return null;
}
public Class returnedClass() {
return List.class;
}
public int[] sqlTypes() {
return TYPES;
}
}
同時，修改相應的[ormapping_filename].hbm.xml中相應字段的映射信息
<property name="buddy"
type="com.globalhands.hibernate.userTypes.SpecialList">
<column name="buddy" length="2000" not-null="true" />
</property>
之后，修改POJO類中該字段的返回類型為List。
使用JUnit測試程序。
posted @
2009-05-24 19:57 lanxin1020 閱讀(594) |
評論 (0) |
編輯 收藏posted @
2009-05-21 22:13 lanxin1020 閱讀(160) |
評論 (0) |
編輯 收藏什么是 ASM？
ASM 是一個 Java 字節碼操控框架。它能被用來動態生成類或者增強既有類的功能。ASM 可以直接產生二進制 class 文件，也可以在類被加載入 Java 虛擬機之前動態改變類行為。Java class 被存儲在嚴格格式定義的 .class 文件里，這些類文件擁有足夠的元數據來解析類中的所有元素：類名稱、方法、屬性以及 Java 字節碼（指令）。ASM 從類文件中讀入信息后，能夠改變類行為，分析類信息，甚至能夠根據用戶要求生成新類。
與 BCEL 和 SERL 不同，ASM 提供了更為現代的編程模型。對于 ASM 來說，Java class 被描述為一棵樹；使用 “Visitor” 模式遍歷整個二進制結構；事件驅動的處理方式使得用戶只需要關注于對其編程有意義的部分，而不必了解 Java 類文件格式的所有細節：ASM 框架提供了默認的 “response taker”處理這一切。
為什么要動態生成 Java 類？
動態生成 Java 類與 AOP 密切相關的。AOP 的初衷在于軟件設計世界中存在這么一類代碼，零散而又耦合：零散是由于一些公有的功能（諸如著名的 log 例子）分散在所有模塊之中；同時改變 log 功能又會影響到所有的模塊。出現這樣的缺陷，很大程度上是由于傳統的 面向對象編程注重以繼承關系為代表的“縱向”關系，而對于擁有相同功能或者說方面 （Aspect）的模塊之間的“橫向”關系不能很好地表達。例如，目前有一個既有的銀行管理系統，包括 Bank、Customer、Account、Invoice 等對象，現在要加入一個安全檢查模塊， 對已有類的所有操作之前都必須進行一次安全檢查。
圖 1. ASM – AOP
然而 Bank、Customer、Account、Invoice 是代表不同的事務，派生自不同的父類，很難在高層上加入關于 Security Checker 的共有功能。對于沒有多繼承的 Java 來說，更是如此。傳統的解決方案是使用 Decorator 模式，它可以在一定程度上改善耦合，而功能仍舊是分散的 —— 每個需要 Security Checker 的類都必須要派生一個 Decorator，每個需要 Security Checker 的方法都要被包裝（wrap）。下面我們以 Account 類為例看一下 Decorator：
首先，我們有一個 SecurityChecker 類，其靜態方法 checkSecurity 執行安全檢查功能：
public class SecurityChecker { public static void checkSecurity() { System.out.println("SecurityChecker.checkSecurity ..."); //TODO real security check } }
|
另一個是 Account 類：
public class Account { public void operation() { System.out.println("operation..."); //TODO real operation } }
|
若想對 operation 加入對 SecurityCheck.checkSecurity() 調用，標準的 Decorator 需要先定義一個 Account 類的接口：
public interface Account { void operation(); }
|
然后把原來的 Account 類定義為一個實現類：
public class AccountImpl extends Account{ public void operation() { System.out.println("operation..."); //TODO real operation } }
|
定義一個 Account 類的 Decorator，并包裝 operation 方法：
public class AccountWithSecurityCheck implements Account { private Account account; public AccountWithSecurityCheck (Account account) { this.account = account; } public void operation() { SecurityChecker.checkSecurity(); account.operation(); } }
|
在這個簡單的例子里，改造一個類的一個方法還好，如果是變動整個模塊，Decorator 很快就會演化成另一個噩夢。動態改變 Java 類就是要解決 AOP 的問題，提供一種得到系統支持的可編程的方法，自動化地生成或者增強 Java 代碼。這種技術已經廣泛應用于最新的 Java 框架內，如 Hibernate，Spring 等。
為什么選擇 ASM？
最直接的改造 Java 類的方法莫過于直接改寫 class 文件。Java 規范詳細說明了class 文件的格式，直接編輯字節碼確實可以改變 Java 類的行為。直到今天，還有一些 Java 高手們使用最原始的工具，如 UltraEdit 這樣的編輯器對 class 文件動手術。是的，這是最直接的方法，但是要求使用者對 Java class 文件的格式了熟于心：小心地推算出想改造的函數相對文件首部的偏移量，同時重新計算 class 文件的校驗碼以通過 Java 虛擬機的安全機制。
Java 5 中提供的 Instrument 包也可以提供類似的功能：啟動時往 Java 虛擬機中掛上一個用戶定義的 hook 程序，可以在裝入特定類的時候改變特定類的字節碼，從而改變該類的行為。但是其缺點也是明顯的：
- Instrument 包是在整個虛擬機上掛了一個鉤子程序，每次裝入一個新類的時候，都必須執行一遍這段程序，即使這個類不需要改變。
- 直接改變字節碼事實上類似于直接改寫 class 文件，無論是調用
ClassFileTransformer. transform(ClassLoader loader, String className, Class classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer)，還是 Instrument.redefineClasses(ClassDefinition[] definitions)，都必須提供新 Java 類的字節碼。也就是說，同直接改寫 class 文件一樣，使用 Instrument 也必須了解想改造的方法相對類首部的偏移量，才能在適當的位置上插入新的代碼。
盡管 Instrument 可以改造類，但事實上，Instrument 更適用于監控和控制虛擬機的行為。
一種比較理想且流行的方法是使用 java.lang.ref.proxy。我們仍舊使用上面的例子，給 Account 類加上 checkSecurity 功能:
首先，Proxy 編程是面向接口的。下面我們會看到，Proxy 并不負責實例化對象，和 Decorator 模式一樣，要把 Account 定義成一個接口，然后在 AccountImpl 里實現 Account 接口，接著實現一個 InvocationHandler Account 方法被調用的時候，虛擬機都會實際調用這個 InvocationHandler 的 invoke 方法：
class SecurityProxyInvocationHandler implements InvocationHandler { private Object proxyedObject; public SecurityProxyInvocationHandler(Object o) { proxyedObject = o; } public Object invoke(Object object, Method method, Object[] arguments) throws Throwable { if (object instanceof Account && method.getName().equals("opertaion")) { SecurityChecker.checkSecurity(); } return method.invoke(proxyedObject, arguments); } }
|
最后，在應用程序中指定 InvocationHandler 生成代理對象：
public static void main(String[] args) { Account account = (Account) Proxy.newProxyInstance( Account.class.getClassLoader(), new Class[] { Account.class }, new SecurityProxyInvocationHandler(new AccountImpl()) ); account.function(); }
|
其不足之處在于：
- Proxy 是面向接口的，所有使用 Proxy 的對象都必須定義一個接口，而且用這些對象的代碼也必須是對接口編程的：Proxy 生成的對象是接口一致的而不是對象一致的：例子中
Proxy.newProxyInstance 生成的是實現 Account 接口的對象而不是 AccountImpl 的子類。這對于軟件架構設計，尤其對于既有軟件系統是有一定掣肘的。
- Proxy 畢竟是通過反射實現的，必須在效率上付出代價：有實驗數據表明，調用反射比一般的函數開銷至少要大 10 倍。而且，從程序實現上可以看出，對 proxy class 的所有方法調用都要通過使用反射的 invoke 方法。因此，對于性能關鍵的應用，使用 proxy class 是需要精心考慮的，以避免反射成為整個應用的瓶頸。
ASM 能夠通過改造既有類，直接生成需要的代碼。增強的代碼是硬編碼在新生成的類文件內部的，沒有反射帶來性能上的付出。同時，ASM 與 Proxy 編程不同，不需要為增強代碼而新定義一個接口，生成的代碼可以覆蓋原來的類，或者是原始類的子類。它是一個普通的 Java 類而不是 proxy 類，甚至可以在應用程序的類框架中擁有自己的位置，派生自己的子類。
相比于其他流行的 Java 字節碼操縱工具，ASM 更小更快。ASM 具有類似于 BCEL 或者 SERP 的功能，而只有 33k 大小，而后者分別有 350k 和 150k。同時，同樣類轉換的負載，如果 ASM 是 60% 的話，BCEL 需要 700%，而 SERP 需要 1100% 或者更多。
ASM 已經被廣泛應用于一系列 Java 項目：AspectWerkz、AspectJ、BEA WebLogic、IBM AUS、OracleBerkleyDB、Oracle TopLink、Terracotta、RIFE、EclipseME、Proactive、Speedo、Fractal、EasyBeans、BeanShell、Groovy、Jamaica、CGLIB、dynaop、Cobertura、JDBCPersistence、JiP、SonarJ、Substance L&F、Retrotranslator 等。Hibernate 和 Spring 也通過 cglib，另一個更高層一些的自動代碼生成工具使用了 ASM。
Java 類文件概述
所謂 Java 類文件，就是通常用 javac 編譯器產生的 .class 文件。這些文件具有嚴格定義的格式。為了更好的理解 ASM，首先對 Java 類文件格式作一點簡單的介紹。Java 源文件經過 javac 編譯器編譯之后，將會生成對應的二進制文件（如下圖所示）。每個合法的 Java 類文件都具備精確的定義，而正是這種精確的定義，才使得 Java 虛擬機得以正確讀取和解釋所有的 Java 類文件。
圖 2. ASM – Javac 流程
Java 類文件是 8 位字節的二進制流。數據項按順序存儲在 class 文件中，相鄰的項之間沒有間隔，這使得 class 文件變得緊湊，減少存儲空間。在 Java 類文件中包含了許多大小不同的項，由于每一項的結構都有嚴格規定，這使得 class 文件能夠從頭到尾被順利地解析。下面讓我們來看一下 Java 類文件的內部結構，以便對此有個大致的認識。
例如，一個最簡單的 Hello World 程序：
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello world"); } }
|
經過 javac 編譯后，得到的類文件大致是：
圖 3. ASM – Java 類文件
從上圖中可以看到，一個 Java 類文件大致可以歸為 10 個項：
- Magic：該項存放了一個 Java 類文件的魔數（magic number）和版本信息。一個 Java 類文件的前 4 個字節被稱為它的魔數。每個正確的 Java 類文件都是以 0xCAFEBABE 開頭的，這樣保證了 Java 虛擬機能很輕松的分辨出 Java 文件和非 Java 文件。
- Version：該項存放了 Java 類文件的版本信息，它對于一個 Java 文件具有重要的意義。因為 Java 技術一直在發展，所以類文件的格式也處在不斷變化之中。類文件的版本信息讓虛擬機知道如何去讀取并處理該類文件。
- Constant Pool：該項存放了類中各種文字字符串、類名、方法名和接口名稱、final 變量以及對外部類的引用信息等常量。虛擬機必須為每一個被裝載的類維護一個常量池，常量池中存儲了相應類型所用到的所有類型、字段和方法的符號引用，因此它在 Java 的動態鏈接中起到了核心的作用。常量池的大小平均占到了整個類大小的 60% 左右。
- Access_flag：該項指明了該文件中定義的是類還是接口（一個 class 文件中只能有一個類或接口），同時還指名了類或接口的訪問標志，如 public，private, abstract 等信息。
- This Class：指向表示該類全限定名稱的字符串常量的指針。
- Super Class：指向表示父類全限定名稱的字符串常量的指針。
- Interfaces：一個指針數組，存放了該類或父類實現的所有接口名稱的字符串常量的指針。以上三項所指向的常量，特別是前兩項，在我們用 ASM 從已有類派生新類時一般需要修改：將類名稱改為子類名稱；將父類改為派生前的類名稱；如果有必要，增加新的實現接口。
- Fields：該項對類或接口中聲明的字段進行了細致的描述。需要注意的是，fields 列表中僅列出了本類或接口中的字段，并不包括從超類和父接口繼承而來的字段。
- Methods：該項對類或接口中聲明的方法進行了細致的描述。例如方法的名稱、參數和返回值類型等。需要注意的是，methods 列表里僅存放了本類或本接口中的方法，并不包括從超類和父接口繼承而來的方法。使用 ASM 進行 AOP 編程，通常是通過調整 Method 中的指令來實現的。
- Class attributes：該項存放了在該文件中類或接口所定義的屬性的基本信息。
事實上，使用 ASM 動態生成類，不需要像早年的 class hacker 一樣，熟知 class 文件的每一段，以及它們的功能、長度、偏移量以及編碼方式。ASM 會給我們照顧好這一切的，我們只要告訴 ASM 要改動什么就可以了 —— 當然，我們首先得知道要改什么：對類文件格式了解的越多，我們就能更好地使用 ASM 這個利器。
ASM 3.0 編程框架
ASM 通過樹這種數據結構來表示復雜的字節碼結構，并利用 Push 模型來對樹進行遍歷，在遍歷過程中對字節碼進行修改。所謂的 Push 模型類似于簡單的 Visitor 設計模式，因為需要處理字節碼結構是固定的，所以不需要專門抽象出一種 Vistable 接口，而只需要提供 Visitor 接口。所謂 Visitor 模式和 Iterator 模式有點類似，它們都被用來遍歷一些復雜的數據結構。Visitor 相當于用戶派出的代表，深入到算法內部，由算法安排訪問行程。Visitor 代表可以更換，但對算法流程無法干涉，因此是被動的，這也是它和 Iterator 模式由用戶主動調遣算法方式的最大的區別。
在 ASM 中，提供了一個 ClassReader 類，這個類可以直接由字節數組或由 class 文件間接的獲得字節碼數據，它能正確的分析字節碼，構建出抽象的樹在內存中表示字節碼。它會調用 accept 方法，這個方法接受一個實現了 ClassVisitor 接口的對象實例作為參數，然后依次調用 ClassVisitor 接口的各個方法。字節碼空間上的偏移被轉換成 visit 事件時間上調用的先后，所謂 visit 事件是指對各種不同 visit 函數的調用，ClassReader 知道如何調用各種 visit 函數。在這個過程中用戶無法對操作進行干涉，所以遍歷的算法是確定的，用戶可以做的是提供不同的 Visitor 來對字節碼樹進行不同的修改。ClassVisitor 會產生一些子過程，比如 visitMethod 會返回一個實現 MethordVisitor 接口的實例，visitField 會返回一個實現 FieldVisitor 接口的實例，完成子過程后控制返回到父過程，繼續訪問下一節點。因此對于 ClassReader 來說，其內部順序訪問是有一定要求的。實際上用戶還可以不通過 ClassReader 類，自行手工控制這個流程，只要按照一定的順序，各個 visit 事件被先后正確的調用，最后就能生成可以被正確加載的字節碼。當然獲得更大靈活性的同時也加大了調整字節碼的復雜度。
各個 ClassVisitor 通過職責鏈 （Chain-of-responsibility） 模式，可以非常簡單的封裝對字節碼的各種修改，而無須關注字節碼的字節偏移，因為這些實現細節對于用戶都被隱藏了，用戶要做的只是覆寫相應的 visit 函數。
ClassAdaptor 類實現了 ClassVisitor 接口所定義的所有函數，當新建一個 ClassAdaptor 對象的時候，需要傳入一個實現了 ClassVisitor 接口的對象，作為職責鏈中的下一個訪問者 （Visitor），這些函數的默認實現就是簡單的把調用委派給這個對象，然后依次傳遞下去形成職責鏈。當用戶需要對字節碼進行調整時，只需從 ClassAdaptor 類派生出一個子類，覆寫需要修改的方法，完成相應功能后再把調用傳遞下去。這樣，用戶無需考慮字節偏移，就可以很方便的控制字節碼。
每個 ClassAdaptor 類的派生類可以僅封裝單一功能，比如刪除某函數、修改字段可見性等等，然后再加入到職責鏈中，這樣耦合更小，重用的概率也更大，但代價是產生很多小對象，而且職責鏈的層次太長的話也會加大系統調用的開銷，用戶需要在低耦合和高效率之間作出權衡。用戶可以通過控制職責鏈中 visit 事件的過程，對類文件進行如下操作：
-
刪除類的字段、方法、指令：只需在職責鏈傳遞過程中中斷委派，不訪問相應的 visit 方法即可，比如刪除方法時只需直接返回 null，而不是返回由 visitMethod 方法返回的 MethodVisitor 對象。
class DelLoginClassAdapter extends ClassAdapter { public DelLoginClassAdapter(ClassVisitor cv) { super(cv); } public MethodVisitor visitMethod(final int access, final String name, final String desc, final String signature, final String[] exceptions) { if (name.equals("login")) { return null; } return cv.visitMethod(access, name, desc, signature, exceptions); } }
|
-
修改類、字段、方法的名字或修飾符：在職責鏈傳遞過程中替換調用參數。
class AccessClassAdapter extends ClassAdapter { public AccessClassAdapter(ClassVisitor cv) { super(cv); } public FieldVisitor visitField(final int access, final String name, final String desc, final String signature, final Object value) { int privateAccess = Opcodes.ACC_PRIVATE; return cv.visitField(privateAccess, name, desc, signature, value); } }
|
-
增加新的類、方法、字段
ASM 的最終的目的是生成可以被正常裝載的 class 文件，因此其框架結構為客戶提供了一個生成字節碼的工具類 —— ClassWriter。它實現了 ClassVisitor 接口，而且含有一個 toByteArray() 函數，返回生成的字節碼的字節流，將字節流寫回文件即可生產調整后的 class 文件。一般它都作為職責鏈的終點，把所有 visit 事件的先后調用（時間上的先后），最終轉換成字節碼的位置的調整（空間上的前后），如下例：
ClassWriter classWriter = new ClassWriter(ClassWriter.COMPUTE_MAXS); ClassAdaptor delLoginClassAdaptor = new DelLoginClassAdapter(classWriter); ClassAdaptor accessClassAdaptor = new AccessClassAdaptor(delLoginClassAdaptor); ClassReader classReader = new ClassReader(strFileName); classReader.accept(classAdapter, ClassReader.SKIP_DEBUG);
|
綜上所述，ASM 的時序圖如下：
圖 4. ASM – 時序圖
使用 ASM3.0 進行 AOP 編程
我們還是用上面的例子，給 Account 類加上 security check 的功能。與 proxy 編程不同，ASM 不需要將 Account 聲明成接口，Account 可以仍舊是一個實現類。ASM 將直接在 Account 類上動手術，給 Account 類的 operation 方法首部加上對 SecurityChecker.checkSecurity 的調用。
首先，我們將從 ClassAdapter 繼承一個類。ClassAdapter 是 ASM 框架提供的一個默認類，負責溝通 ClassReader 和 ClassWriter。如果想要改變 ClassReader 處讀入的類，然后從 ClassWriter 處輸出，可以重寫相應的 ClassAdapter 函數。這里，為了改變 Account 類的 operation 方法，我們將重寫 visitMethdod 方法。
class AddSecurityCheckClassAdapter extends ClassAdapter{ public AddSecurityCheckClassAdapter(ClassVisitor cv) { //Responsechain 的下一個 ClassVisitor，這里我們將傳入 ClassWriter， //負責改寫后代碼的輸出 super(cv); } //重寫 visitMethod，訪問到 "operation" 方法時， //給出自定義 MethodVisitor，實際改寫方法內容 public MethodVisitor visitMethod(final int access, final String name, final String desc, final String signature, final String[] exceptions) { MethodVisitor mv = cv.visitMethod(access, name, desc, signature,exceptions); MethodVisitor wrappedMv = mv; if (mv != null) { //對于 "operation" 方法 if (name.equals("operation")) { //使用自定義 MethodVisitor，實際改寫方法內容 wrappedMv = new AddSecurityCheckMethodAdapter(mv); } } return wrappedMv; } }
|
下一步就是定義一個繼承自 MethodAdapter 的 AddSecurityCheckMethodAdapter，在“operation”方法首部插入對 SecurityChecker.checkSecurity() 的調用。
class AddSecurityCheckMethodAdapter extends MethodAdapter { public AddSecurityCheckMethodAdapter(MethodVisitor mv) { super(mv); } public void visitCode() { visitMethodInsn(Opcodes.INVOKESTATIC, "SecurityChecker", "checkSecurity", "()V"); } }
|
其中，ClassReader 讀到每個方法的首部時調用 visitCode()，在這個重寫方法里，我們用visitMethodInsn(Opcodes.INVOKESTATIC, "SecurityChecker","checkSecurity", "()V"); 插入了安全檢查功能。
最后，我們將集成上面定義的 ClassAdapter，ClassReader和ClassWriter 產生修改后的 Account 類文件:
import java.io.File; import java.io.FileOutputStream; import org.objectweb.asm.*; public class Generator{ public static void main() throws Exception { ClassReader cr = new ClassReader("Account"); ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_MAXS); ClassAdapter classAdapter = new AddSecurityCheckClassAdapter(cw); cr.accept(classAdapter, ClassReader.SKIP_DEBUG); byte[] data = cw.toByteArray(); File file = new File("Account.class"); FileOutputStream fout = new FileOutputStream(file); fout.write(data); fout.close(); } }
|
執行完這段程序后，我們會得到一個新的 Account.class 文件，如果我們使用下面代碼：
public class Main { public static void main(String[] args) { Account account = new Account(); account.operation(); } }
|
使用這個 Account，我們會得到下面的輸出：
SecurityChecker.checkSecurity ... operation...
|
也就是說，在 Account 原來的 operation 內容執行之前，進行了 SecurityChecker.checkSecurity() 檢查。
將動態生成類改造成原始類 Account 的子類
上面給出的例子是直接改造 Account 類本身的，從此 Account 類的 operation 方法必須進行 checkSecurity 檢查。但事實上，我們有時仍希望保留原來的 Account 類，因此把生成類定義為原始類的子類是更符合 AOP 原則的做法。下面介紹如何將改造后的類定義為 Account 的子類 Account$EnhancedByASM。其中主要有兩項工作:
- 改變 Class Description, 將其命名為
Account$EnhancedByASM，將其父類指定為 Account。
- 改變構造函數，將其中對父類構造函數的調用轉換為對
Account 構造函數的調用。
在 AddSecurityCheckClassAdapter 類中，將重寫 visit 方法：
public void visit(final int version, final int access, final String name, final String signature, final String superName, final String[] interfaces) { String enhancedName = name + "$EnhancedByASM"; //改變類命名 enhancedSuperName = name; //改變父類，這里是”Account” super.visit(version, access, enhancedName, signature, enhancedSuperName, interfaces); }
|
改進 visitMethod 方法，增加對構造函數的處理：
public MethodVisitor visitMethod(final int access, final String name, final String desc, final String signature, final String[] exceptions) { MethodVisitor mv = cv.visitMethod(access, name, desc, signature, exceptions); MethodVisitor wrappedMv = mv; if (mv != null) { if (name.equals("operation")) { wrappedMv = new AddSecurityCheckMethodAdapter(mv); } else if (name.equals("<init>")) { wrappedMv = new ChangeToChildConstructorMethodAdapter(mv, enhancedSuperName); } } return wrappedMv; }
|
這里 ChangeToChildConstructorMethodAdapter 將負責把 Account 的構造函數改造成其子類 Account$EnhancedByASM 的構造函數：
class ChangeToChildConstructorMethodAdapter extends MethodAdapter { private String superClassName; public ChangeToChildConstructorMethodAdapter(MethodVisitor mv, String superClassName) { super(mv); this.superClassName = superClassName; } public void visitMethodInsn(int opcode, String owner, String name, String desc) { //調用父類的構造函數時 if (opcode == Opcodes.INVOKESPECIAL && name.equals("<init>")) { owner = superClassName; } super.visitMethodInsn(opcode, owner, name, desc);//改寫父類為superClassName } }
|
最后演示一下如何在運行時產生并裝入產生的 Account$EnhancedByASM。 我們定義一個 Util 類，作為一個類工廠負責產生有安全檢查的 Account 類：
public class SecureAccountGenerator { private static AccountGeneratorClassLoader classLoader = new AccountGeneratorClassLoade(); private static Class secureAccountClass; public Account generateSecureAccount() throws ClassFormatError, InstantiationException, IllegalAccessException { if (null == secureAccountClass) { ClassReader cr = new ClassReader("Account"); ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_MAXS); ClassAdapter classAdapter = new AddSecurityCheckClassAdapter(cw); cr.accept(classAdapter, ClassReader.SKIP_DEBUG); byte[] data = cw.toByteArray(); secureAccountClass = classLoader.defineClassFromClassFile( "Account$EnhancedByASM",data); } return (Account) secureAccountClass.newInstance(); } private static class AccountGeneratorClassLoader extends ClassLoader { public Class defineClassFromClassFile(String className, byte[] classFile) throws ClassFormatError { return defineClass("Account$EnhancedByASM", classFile, 0, classFile.length()); } } }
|
靜態方法 SecureAccountGenerator.generateSecureAccount() 在運行時動態生成一個加上了安全檢查的 Account 子類。著名的 Hibernate 和 Spring 框架，就是使用這種技術實現了 AOP 的“無損注入”。
小結
最后，我們比較一下 ASM 和其他實現 AOP 的底層技術：
posted @
2009-05-12 12:43 lanxin1020 閱讀(255) |
評論 (0) |
編輯 收藏以下是一份完整的struts-config.xml文件,配置元素的說明詳見注釋.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.1//EN"
"http://jakarta.apache.org/struts/dtds/struts-config.dtd">
<!-- struts-config.xml中的元素必須按照上述doc指令中的dtd文檔定義順序書寫，本例即遵從了dtd定義順序 -->
<!-- struts-config是整個xml的根元素，其他元素必須被包含其內 -->
<struts-config>
<!--
名稱:data-sources
描述：data-sources元素定義了web App所需要使用的數據源
數量：最多一個
子元素:data-source
-->
<data-sources>
<!--
名稱：data-source
描述：data-source元素定義了具體的數據源
數量：任意多個
屬性：
@key：當需要配置多個數據源時，相當于數據源的名稱，用來數據源彼此間進行區別
@type：可以使用的數據源實現的類，一般來自如下四個庫
Poolman，開放源代碼軟件
Expresso，Jcorporate
JDBC Pool，開放源代碼軟件
DBCP，Jakarta
-->
<data-source key="firstOne" type="org.apache.commons.dbcp.BasicDataSource">
<!--
名稱：set-property
描述：用來設定數據源的屬性
屬性：
@autoCommit:是否自動提交 可選值：true/false
@description:數據源描述
@driverClass:數據源使用的類
@maxCount:最大數據源連接數
@minCount:最小數據源連接數
@user:數據庫用戶
@password:數據庫密碼
@url:數據庫url
-->
<set-property property="autoCommit" value="true"/>
<set-property property="description" value="Hello!"/>
<set-property property="driverClass" value="com.mysql.jdbc.Driver"/>
<set-property property="maxCount" value="10"/>
<set-property property="minCount" value="2"/>
<set-property property="user" value="root"/>
<set-property property="password" value=""/>
<set-property property="url" value="jdbc:mysql://localhost:3306/helloAdmin"/>
</data-source>
</data-sources>
<!--
名稱：form-beans
描述：用來配置多個ActionForm Bean
數量：最多一個
子元素：form-bean
-->
<form-beans>
<!--
名稱：form-bean
描述：用來配置ActionForm Bean
數量：任意多個
子元素：form-property
屬性：
@className：指定與form-bean元素相對應的配置類，一般默認使用org.apaceh.struts.config.FormBeanConfig，如果自定義，則必須繼承 FormBeanConfig
@name：必備屬性！為當前form-bean制定一個全局唯一的標識符，使得在整個Struts框架內，可以通過該標識符來引用這個ActionForm Bean。
@type：必備屬性！指明實現當前ActionForm Bean的完整類名。
-->
<form-bean name="Hello" type="myPack.Hello">
<!--
名稱：form-property
描述：用來設定ActionForm Bean的屬性
數量：根據實際需求而定，例如，ActionForm Bean對應的一個登陸Form中有兩個文本框，name和password，ActionForm Bean中也有這兩個字段，則此處編寫兩個form-property來設定屬性
屬性：
@className：指定與form-property相對應的配置類，默認是org.apache.struts.config.FormPropertyConfig，如果自定義，則必須繼承FormPropertyConfig類
@name：所要設定的ActionForm Bean的屬性名稱
@type：所要設定的ActionForm Bean的屬性值的類
@initial：當前屬性的初值
-->
<form-property name="name" type="java.lang.String"/>
<form-property name="number" type="java.lang.Iteger" initial="18"/>
</form-bean>
</form-beans>
<!--
名稱：global-exceptions
描述：處理異常
數量：最多一個
子元素：exception
-->
<global-exceptions>
<!--
名稱：exception
描述：具體定義一個異常及其處理
數量：任意多個
屬性：
@className:指定對應exception的配置類，默認為org.apache.struts.config.ExceptionConfig
@handler:指定異常處理類，默認為org.apache.struts.action.ExceptionHandler
@key:指定在Resource Bundle種描述該異常的消息key
@path:指定當發生異常時，進行轉發的路徑
@scope:指定ActionMessage實例存放的范圍，默認為request，另外一個可選值是session
@type:必須要有！指定所需要處理異常類的名字。
@bundle:指定資源綁定
-->
<exception
key=""hello.error
path="/error.jsp"
scope="session"
type="hello.HandleError"/>
</global-exceptions>
<!--
名稱：global-forwards
描述：定義全局轉發
數量：最多一個
子元素：forward
-->
<global-forwards>
<!--
名稱：forward
描述：定義一個具體的轉發
數量：任意多個
屬性：
@className:指定和forward元素對應的配置類，默認為org.apache.struts.action.ActionForward
@contextRelative:如果為true，則指明使用當前上下文，路徑以“/”開頭，默認為false
@name:必須配有！指明轉發路徑的唯一標識符
@path:必須配有！指明轉發或者重定向的URI。必須以"/"開頭。具體配置要與contextRelative相應。
@redirect:為true時，執行重定向操作，否則執行請求轉發。默認為false
-->
<forward name="A" path="/a.jsp"/>
<forward name="B" path="/hello/b.do"/>
</global-forwards>
<!--
名稱：action-mappings
描述：定義action集合
數量：最多一個
子元素：action
-->
<action-mappings>
<!--
名稱：action
描述：定義了從特定的請求路徑到相應的Action類的映射
數量：任意多個
子元素：exception,forward（二者均為局部量）
屬性：
@attribute:制定與當前Action相關聯的ActionForm Bean在request和session范圍內的名稱（key）
@className:與Action元素對應的配置類。默認為org.apache.struts.action.ActionMapping
@forward:指名轉發的URL路徑
@include:指名包含的URL路徑
@input:指名包含輸入表單的URL路徑，表單驗證失敗時，請求會被轉發到該URL中
@name:指定和當前Acion關聯的ActionForm Bean的名字。該名稱必須在form-bean元素中定義過。
@path:指定訪問Action的路徑，以"/"開頭，沒有擴展名
@parameter:為當前的Action配置參數，可以在Action的execute()方法中，通過調用ActionMapping的getParameter()方法來獲取參數
@roles:指定允許調用該Aciton的安全角色。多個角色之間用逗號分割。處理請求時，RequestProcessor會根據該配置項來決定用戶是否有調用該Action的權限
@scope:指定ActionForm Bean的存在范圍，可選值為request和session。默認為session
@type:指定Action類的完整類名
@unknown:值為true時，表示可以處理用戶發出的所有無效的Action URL。默認為false
@validate:指定是否要先調用ActionForm Bean的validate()方法。默認為true
注意：如上屬性中，forward/include/type三者相斥，即三者在同一Action配置中只能存在一個。
-->
<action path="/search"
type="addressbook.actions.SearchAction"
name="searchForm"
scope="request"
validate="true"
input="/search.jsp">
<forward name="success" path="/display.jsp"/>
</action>
</action-mappings>
<!--
名稱：controller
描述：用于配置ActionServlet
數量：最多一個
屬性：
@bufferSize:指定上傳文件的輸入緩沖的大小.默認為4096
@className:指定當前控制器的配置類.默認為org.apache.struts.config.ControllerConfig
@contentType:指定相應結果的內容類型和字符編碼
@locale:指定是否把Locale對象保存到當前用戶的session中,默認為false
@processorClass:指定負責處理請求的Java類的完整類名.默認org.apache.struts.action.RequestProcessor
@tempDir:指定文件上傳時的臨時工作目錄.如果沒有設置,將才用Servlet容器為web應用分配的臨時工作目錄.
@nochache:true時,在相應結果中加入特定的頭參數:Pragma ,Cache-Control,Expires防止頁面被存儲在可數瀏覽器的緩存中,默認為false
-->
<controller
contentType="text/html;charset=UTF-8"
locale="true"
processorClass="CustomRequestProcessor">
</controller>
<!--
名稱:message-resources
描述:配置Resource Bundle.
數量:任意多個
屬性:
@className:指定和message-resources對應的配置類.默認為org.apache.struts.config.MessageResourcesConfig
@factory:指定資源的工廠類,默認為org.apache.struts.util.PropertyMessageResourcesFactory
@key:
@null:
@parameter:
-->
<message-resources
null="false"
parameter="defaultResource"/>
<message-resources
key="images"
null="false"
parameter="ImageResources"/>
<!--
名稱:plug-in
描述:用于配置Struts的插件
數量:任意多個
子元素:set-property
屬性:
@className:指定Struts插件類.此類必須實現org.apache.struts.action.PlugIn接口
-->
<plug-in
className="org.apache.struts.validator.ValidatorPlugIn">
<!--
名稱:set-property
描述:配置插件的屬性
數量:任意多個
屬性:
@property:插件的屬性名稱
@value:該名稱所配置的值
-->
<set-property
property="pathnames"
value="/WEB-INF/validator-rules.xml,/WEB-INF/vlaidation.xml"/>
</plug-in>
</struts-config>
posted @
2009-05-11 16:26 lanxin1020 閱讀(279) |
評論 (0) |
編輯 收藏
過濾器是一個程序，它先于與之相關的servlet或JSP頁面運行在服務器上。過濾器可附加到一個或多個servlet或JSP頁面上，并且可以檢查進入這些資源的請求信息。在這之后，過濾器可以作如下的選擇：
1. 以常規的方式調用資源（即，調用servlet或JSP頁面）。個人理解為請求通過過濾執行其他的操作
2.利用修改過的請求信息調用資源。對請求的信息加以修改，然后繼續執行
3. 調用資源，但在發送響應到客戶機前對其進行修改
4. 阻止該資源調用，代之以轉到其他的資源，返回一個特定的狀態代碼或生成替換輸出。個人理解為請求被攔截時強制執行（跳轉）的操作
過濾器提供了幾個重要好處 ：
首先，它以一種模塊化的或可重用的方式封裝公共的行為。你有30個不同的serlvet或JSP頁面，需要壓縮它們的內容以減少下載時間嗎？沒問題：構造一個壓縮過濾器，然后將它應用到30個資源上即可。
其次，利用它能夠將高級訪問決策與表現代碼相分離。這對于JSP特別有價值，其中一般希望將幾乎整個頁面集中在表現上，而不是集中在業務邏輯上。例如，希 望阻塞來自某些站點的訪問而不用修改各頁面（這些頁面受到訪問限制）嗎？沒問題：建立一個訪問限制過濾器并把它應用到想要限制訪問的頁面上即可。
最后，過濾器使你能夠對許多不同的資源進行批量性的更改。你有許多現存資源，這些資源除了公司名要更改外其他的保持不變，能辦到么？沒問題：構造一個串替換過濾器，只要合適就使用它。
但要注意，過濾器只在與servlet規范2.3版兼容的服務器上有作用。如果你的Web應用需要支持舊版服務器，就不能使用過濾器。
1． 建立基本過濾器
建立一個過濾器涉及下列五個步驟：
1）建立一個實現Filter接口的類。這個類需要三個方法，分別是：doFilter、init和destroy。
doFilter方法包含主要的過濾代碼（見第2步），init方法建立設置操作，而destroy方法進行清楚。
2）在doFilter方法中放入過濾行為。doFilter方法的第一個參數為ServletRequest對象。此對象給過濾器提供了對進入的信息 （包括表單數據、cookie和HTTP請求頭）的完全訪問。第二個參數為ServletResponse，通常在簡單的過濾器中忽略此參數。最后一個參 數為FilterChain，如下一步所述，此參數用來調用servlet或JSP頁。
3）調用FilterChain對象的doFilter方法。Filter接口的doFilter方法取一個FilterChain對象作為它的一個參 數。在調用此對象的doFilter方法時，激活下一個相關的過濾器。如果沒有另一個過濾器與servlet或JSP頁面關聯，則servlet或JSP 頁面被激活。
4）對相應的servlet和JSP頁面注冊過濾器。在部署描述符文件（web.xml）中使用filter和filter-mapping元素。
5）禁用激活器servlet。防止用戶利用缺省servlet URL繞過過濾器設置。
1.1 建立一個實現Filter接口的類
所有過濾器都必須實現javax.servlet.Filter。這個接口包含三個方法，分別為doFilter、init和destroy。
public void doFilter(ServletRequset request,
ServletResponse response,
FilterChain chain)
thows ServletException, IOException
每當調用一個過濾器（即，每次請求與此過濾器相關的servlet或JSP頁面）時，就執行其doFilter方法。正是這個方法包含了大部分過濾邏輯。 第一個參數為與傳入請求有關的ServletRequest。對于簡單的過濾器，大多數過濾邏輯是基于這個對象的。如果處理HTTP請求，并且需要訪問諸 如getHeader或getCookies等在ServletRequest中無法得到的方法，就要把此對象構造成 HttpServletRequest。
第二個參數為ServletResponse。除了在兩個情形下要使用它以外，通常忽略這個參數。首先，如果希望完全阻塞對相關servlet或JSP頁 面的訪問。可調用response.getWriter并直接發送一個響應到客戶機。其次，如果希望修改相關的servlet或JSP頁面的輸出，可把響 應包含在一個收集所有發送到它的輸出的對象中。然后，在調用serlvet或JSP頁面后，過濾器可檢查輸出，如果合適就修改它，之后發送到客戶機。
DoFilter的最后一個參數為FilterChain對象。對此對象調用doFilter以激活與servlet或JSP頁面相關的下一個過濾器。如果沒有另一個相關的過濾器，則對doFilter的調用激活servlet或JSP本身。
public void init(FilterConfig config) thows ServletException
init方法只在此過濾器第一次初始化時執行，不是每次調用過濾器都執行它。對于簡單的過濾器，可提供此方法的一個空體，但有兩個原因需要使用init。 首先，FilterConfig對象提供對servlet環境及web.xml文件中指派的過濾器名的訪問。因此，普遍的辦法是利用init將 FilterConfig對象存放在一個字段中，以便doFilter方法能夠訪問servlet環境或過濾器名.其次，FilterConfig對象具 有一個getInitParameter方法，它能夠訪問部署描述符文件（web.xml）中分配的過濾器初始化參數。
public void destroy( )
大多數過濾器簡單地為此方法提供一個空體，不過，可利用它來完成諸如關閉過濾器使用的文件或數據庫連接池等清除任務。
1.2 將過濾行為放入doFilter方法
doFilter方法為大多數過濾器地關鍵部分。每當調用一個過濾器時，都要執行doFilter。對于大多數過濾器來說，doFilter執行的步驟是 基于傳入的信息的。因此，可能要利用作為doFilter的第一個參數提供的ServletRequest。這個對象常常構造為 HttpServletRequest類型，以提供對該類的更特殊方法的訪問。
1.3 調用FilterChain對象的doFilter方法
Filter接口的doFilter方法以一個FilterChain對象作為它的第三個參數。在調用該對象的doFilter方法時，激活下一個相關的 過濾器。這個過程一般持續到鏈中最后一個過濾器為止。在最后一個過濾器調用其FilterChain對象的doFilter方法時，激活servlet或 頁面自身。
但是，鏈中的任意過濾器都可以通過不調用其FilterChain的doFilter方法中斷這個過程。在這樣的情況下，不再調用JSP頁面的serlvet，并且中斷此調用過程的過濾器負責將輸出提供給客戶機。
1.4 對適當的servlet和JSP頁面注冊過濾器
部署描述符文件的2.3版本引入了兩個用于過濾器的元素，分別是：filter和filter-mapping。filter元素向系統注冊一個過濾對象，filter-mapping元素指定該過濾對象所應用的URL。
1.filter元素
filter元素位于部署描述符文件（web.xml）的前部，所有filter-mapping、servlet或servlet-mapping元素之前。filter元素具有如下六個可能的子元素：
1、 icon 這是一個可選的元素，它聲明IDE能夠使用的一個圖象文件。
2、filter-name 這是一個必需的元素，它給過濾器分配一個選定的名字。
3、display-name 這是一個可選的元素，它給出IDE使用的短名稱。
4、 description 這也是一個可選的元素，它給出IDE的信息，提供文本文檔。
5、 filter-class 這是一個必需的元素，它指定過濾器實現類的完全限定名。
6、 init-param 這是一個可選的元素，它定義可利用FilterConfig的getInitParameter方法讀取的初始化參數。單個過濾器元素可包含多個init-param元素。
請注意，過濾是在serlvet規范2.3版中初次引入的。因此，web.xml文件必須使用DTD的2.3版本。下面介紹一個簡單的例子：
<xml version="1.0" encoding="ISO-8859-1"?>
DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "
<web-app>
<filter>
<filter-name>MyFilterfilter-name>
<filter-class>myPackage.FilterClassfilter-class>
filter>
<filter-mapping>...filter-mapping>
<web-app>
2.filter-mapping元素
filter-mapping元素位于web.xml文件中filter元素之后serlvet元素之前。它包含如下三個可能的子元素：
1、 filter-name 這個必需的元素必須與用filter元素聲明時給予過濾器的名稱相匹配。
2、 url-pattern 此元素聲明一個以斜杠（/）開始的模式，它指定過濾器應用的URL。所有filter-mapping元素中必須提供url-pattern或 servlet-name。但不能對單個filter-mapping元素提供多個url-pattern元素項。如果希望過濾器適用于多個模式，可重復 整個filter-mapping元素。
3、 servlet-name 此元素給出一個名稱，此名稱必須與利用servlet元素給予servlet或JSP頁面的名稱相匹配。不能給單個filter-mapping元素提供 多個servlet-name元素項。如果希望過濾器適合于多個servlet名，可重復這個filter-mapping元素。
下面舉一個例子：
xml version="1.0" encoding="ISO-8859-1"?>
DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
<web-app>
<filter>
<filter-name>MyFilterfilter-name>
<filter-class>myPackage.FilterClassfilter-class>
filter>
<filter-mapping>
<filter-name>MyFilterfilter-name>
<url-pattern>/someDirectory/SomePage.jspurl-pattern>
filter-mapping>
web-app>
1.5 禁用激活器servlet
在對資源應用過濾器時，可通過指定要應用過濾器的URL模式或servlet名來完成。如果提供servlet名，則此名稱必須與web.xml的 servlet元素中給出的名稱相匹配。如果使用應用到一個serlvet的URL模式，則此模式必須與利用web.xml的元素servlet- mapping指定的模式相匹配。但是，多數服務器使用“激活器servlet”為servlet體統一個缺省的URL：http: //host/WebAppPrefix/servlet/ServletName。需要保證用戶不利用這個URL訪問servlet（這樣會繞過過濾器 設置）。
例如，假如利用filter和filter-mapping指示名為SomeFilter的過濾器應用到名為SomeServlet的servlet，則如下：
<filter>
<filter-name>SomeFilterfilter-name>
<filter-class>somePackage.SomeFilterClassfilter-class>
<filter>
<filter-mapping>
<filter-name>SomeFilterfilter-name>
<servlet-name>SomeServletservlet-name>
<filter-mapping>
接著，用servlet和servlet-mapping規定URL http://host/webAppPrefix/Blah 應該調用SomeSerlvet，如下所示：
<filter>
<filter-name>SomeFilterfilter-name>
<filter-class>somePackage.SomeFilterClassfilter-class>
filter>
<filter-mapping>
<filter-name>SomeFilterfilter-name>
<servlet-name>/Blahservlet-name>
<filter-mapping>
現在，在客戶機使用URL http://host/webAppPrefix/Blah 時就會調用過濾器。過濾器不應用到
http://host/webAppPrefix/servlet/SomePackage.SomeServletClass。
盡管有關閉激活器的服務器專用方法。但是，可移植最強的方法時重新映射Web應用鐘的/servlet模式，這樣使所有包含此模式的請求被送到相同的 servlet中。為了重新映射此模式，首先應該建立一個簡單的servlet，它打印一條錯誤消息，或重定向用戶到頂層頁。然后，使用servlet和 servlet-mapping元素發送包含/servlet模式的請求到該servlet。程序清單9-1給出了一個簡短的例子。
程序清單9-1 web.xml（重定向缺省servlet URL的摘錄）
xml version="1.0" encoding="ISO-8859-1"?>
DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
<web-app>
<servlet>
<servlet-name>Errorservlet-name>
<servlet-class>somePackage.ErrorServletservlet-class>
servlet>
<servlet-mapping>
<servlet-name>Errorservlet-name>
<url-pattern>/servlet/*url-pattern>
servlet-mapping>
<web-app>
本文參考:http://www.javaeye.com/topic/140553
posted @
2009-05-10 09:33 lanxin1020 閱讀(259) |
評論 (0) |
編輯 收藏struts的validator的客戶端驗證，不能進行多表單頁面的驗證，原因是由<html:script>標簽生成的javascipt是根據每個表單，生成一段代碼。例如：
<html:javascript formName="searchSgbySjForm" dynamicJavascript="true" staticJavascript="false"/>
生成 :
var bCancel = false;
function validateSearchSgbySjForm(form)
{
if (bCancel) return true;
else return validateRequired(form) && validateDate(form);
}
function required ()
{
this.aa = new Array("sgfssjq", "事故發生時間起 不可為空.", new Function ("varName", "this.datePatternStrict='yyy-MM-dd'; return thisvarName];"));
this.ab = new Array("sgfssjz", "事故發生時間止 不可為空.", new Function ("varName", "this.datePatternStrict='yyy-MM-dd'; return this[varName];"));
}
function DateValidations ()
{
this.aa = new Array("sgfssjq", "事故發生時間起 不是有效的日期類型.", new Function ("varName", "this.datePatternStrict='yyy-MM-dd'; return this [varName];"));
this.ab = new Array("sgfssjz", "事故發生時間止 不是有效的日期類型.", new Function ("varName", "this.datePatternStrict='yyy-MM-dd'; return this[varName];"));
}
如果有多個的話required和DateValidations 都會重復的，而javascript是只認最后一個函數的。所以，會導致驗證出錯。
再寫一個標簽 ，主要根據原來的代碼修改，代碼如下:
package com.tmri.acd.tag;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.BodyTagSupport;
import org.apache.commons.validator.Field;
import org.apache.commons.validator.Form;
import org.apache.commons.validator.ValidatorAction;
import org.apache.commons.validator.ValidatorResources;
import org.apache.commons.validator.util.ValidatorUtils;
import org.apache.commons.validator.Var;
import org.apache.struts.Globals;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.config.ModuleConfig;
import com.tmri.acd.tag.TagUtils;
import org.apache.struts.util.MessageResources;
import org.apache.struts.validator.Resources;
import org.apache.struts.validator.ValidatorPlugIn;
import java.util.StringTokenizer;
public class JavascriptValidatorTag extends BodyTagSupport
{
private static final Comparator actionComparator = new Comparator()
{
public int compare(Object o1, Object o2)
{
ValidatorAction va1 = (ValidatorAction) o1;
ValidatorAction va2 = (ValidatorAction) o2;
if ((va1.getDepends() == null || va1.getDepends().length() == 0) && (va2.getDepends() == null || va2.getDepends().length() == 0))
{
return 0;
}
else if ( (va1.getDepends() != null && va1.getDepends().length() > 0) && (va2.getDepends() == null || va2.getDepends().length() == 0))
{
return 1;
}
}
posted @
2009-05-09 22:59 lanxin1020 閱讀(186) |
評論 (0) |
編輯 收藏
HTML 注釋
在客戶端顯示一個注釋.
JSP 語法
<!-- comment [ <%= expression %> ] -->
例子 1
<!-- This file displays the user login screen -->
在客戶端的HTML源代碼中產生和上面一樣的數據：
<!-- This file displays the user login screen -->
例子 2
<!-- This page was loaded on <%= (new java.util.Date()).toLocaleString() %> -->
在客戶端的HTML源代碼中顯示為:
<!-- This page was loaded on January 1, 2000 -->
描述
這種注釋和HTML中很像，也就是它可以在"查看源代碼"中看到.
唯一有些不同的就是，你可以在這個注釋中用表達式（例子2所示).這個表達示是不定的，由頁面不同而不同，你能夠使用各種表達式，只要是合法的就行。更多的請看表達式
隱藏注釋
寫在JSP程序中，但不是發給客戶。
JSP 語法
<%-- comment --%>
例子：
<%@ page language="java" %> <html> <head><title>A Comment Test</title></head> <body> <h2>A Test of Comments</h2> <%-- This comment will not be visible in the page source --%> </body> </html>
描述
用隱藏注釋標記的字符會在JSP編譯時被忽略掉。這個注釋在你希望隱藏或注釋你的JSP程序時是很有用的。JSP編譯器不是會對<%--and--%>之間的語句進行編譯的，它不會顯示在客戶的瀏覽器中，也不會在源代碼中看到
聲明
在JSP程序中聲明合法的變量和方法
JSP 語法
<%! declaration; [ declaration; ]+ ... %>
例子
<%! int i = 0; %>
<%! int a, b, c; %>
<%! Circle a = new Circle(2.0); %>
描述
聲明你將要在JSP程序中用到的變量和方法。你也必須這樣做，不然會出錯.
你可以一次性聲明多個變量和方法，只要以";"結尾就行，當然這些聲明在Java中要是合法的。
當你聲明方法或變量時，請注意以下的一些規則:
聲明必須以";"結尾(Scriptlet有同樣的規則，但是 表達式就不同了).
你可以直接使用在<% @ page %>中被包含進來的已經聲明的變量和方法，不需要對它們重新進行聲明.
一個聲明僅在一個頁面中有效。如果你想每個頁面都用到一些聲明，最好把它們寫成一個單獨的文件，然后用<%@ include %>或<jsp:include >元素包含進來。
表達式
包含一個符合JSP語法的表達式
JSP 語法
<%= expression %>
例子
<font color="blue"><%= map.size() %></font>
<b><%= numguess.getHint() %></b>.
描述
表達式元素表示的是一個在腳本語言中被定義的表達式，在運行后被自動轉化為字符串，然后插入到這個表達示在JSP文件的位置顯示。因為這個表達式的值已經被轉化為字符串，所以你能在一行文本中插入這個表達式（形式和ASP完全一樣).
當你在JSP中使用表達式時請記住以下幾點：
你不能用一個分號（"；"）來作為表達式的結束符.但是同樣的表達式用在scriptlet中就需要以分號來結尾了！查看Scriptlet
這個表達式元素能夠包括任何在Java Language Specification中有效的表達式.
有時候表達式也能做為其它JSP元素的屬性值.一個表達式能夠變得很復雜，它可能由一個或多個表達式組成，這些表達式的順序是從左到右。
[/b]Scriptlet [/b]
包含一個有效的程序段.
JSP 語法
<% code fragment %>
例子
<%
String name = null;
if (request.getParameter("name") == null) {
%>
<%@ include file="error.html" %>
<%
} else {
foo.setName(request.getParameter("name"));
if (foo.getName().equalsIgnoreCase("integra"))
name = "acura";
if (name.equalsIgnoreCase( "acura" )) {
%>
描述
一個scriptlet能夠包含多個jsp語句，方法，變量，表達式
因為scriptlet,我們便能做以下的事:
聲明將要用到的變量或方法（參考 聲明).
編寫JSP表達式（參考 表達式).
使用任何隱含的對象和任何用<jsp:useBean>聲明過的對象
編寫JSP語句 (如果你在使用Java語言，這些語句必須遵從Java Language Specification,).
任何文本，HTML標記，JSP元素必須在scriptlet之外
當JSP收到客戶的請求時，scriptlet就會被執行，如果scriptlet有顯示的內容，這些顯示的內容就被存在out對象中。
Include 指令
在JSP中包含一個靜態的文件，同時解析這個文件中的JSP語句.
JSP 語法
<%@ include file="relativeURL" %>
例子
include.jsp:
<html> <head><title>An Include Test</title></head> <body bgcolor="white"> <font color="blue"> The current date and time are <%@ include file="date.jsp" %> </font> </body> </html>
date.jsp:
<%@ page import="java.util.*" %> <%= (new java.util.Date() ).toLocaleString() %>
Displays in the page:
The current date and time are
Aug 30, 1999 2:38:40
描述
<%@include %>指令將會在JSP編譯時插入一個包含文本或代碼的文件，當你使用<%@ include %>指命時，這個包含的過程就當是靜態的。靜態的包含就是指這個被包含的文件將會被插入到JSP文件中去，這個包含的文件可以是JSP文件，HTML文件，文本文件。如果包含的是JSP文件，這個包含的JSP的文件中代碼將會被執行。
如果你僅僅只是用include 來包含一個靜態文件。那么這個包含的文件所執行的結果將會插入到JSP文件中放<% @ include %>的地方。一旦包含文件被執行，那么主JSP文件的過程將會被恢復，繼續執行下一行.
這個被包含文件可以是html文件，jsp文件，文本文件，或者只是一段Java代碼，但是你得注意在這個包含文件中不能使用<html>,</html>,<body>,</body>標記，因為這將會影響在原JSP文件中同樣的標記 ，這樣做有時會導致錯誤.
有一些<%@ include %>指命的行為是以特殊的JSP編譯條件為基礎，比如：
這個被包含的文件必須對所有客戶都有開放且必須f有效，或者它有安全限制
如果這個包含文件被改變，包含此文件的JSP文件將被重新編譯
屬性:
file="relativeURL"
這個包含文件的路徑名一般來說是指相對路徑，不需要什么端口，協議，和域名，如下:
"error.jsp""templates/onlinestore.html""/beans/calendar.jsp"
如果這個路徑以"/"開頭，那么這個路徑主要是參照JSP應用的上下關系路徑，如果路徑是以文件名或目錄名開頭，那么這個路徑就是正在使用的JSP文件的當前路徑.
Page 指令
定義JSP文件中的全局屬性.
JSP 語法
<%@ page
[ language="java" ]
[ extends="package.class" ]
[ import="{package.class | package.*}, ..." ]
[ session="true | false" ]
[ buffer="none | 8kb | sizekb" ]
[ autoFlush="true | false" ]
[ isThreadSafe="true | false" ]
[ info="text" ]
[ errorPage="relativeURL" ]
[ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ]
[ isErrorPage="true | false" ]
%>
例子
<%@ page import="java.util.*, java.lang.*" %>
<%@ page buffer="5kb" autoFlush="false" %>
<%@ page errorPage="error.jsp" %>
描述
<%@ page %>指令作用于整個JSP頁面，同樣包括靜態的包含文件。但是<% @ page %>指令不能作用于動態的包含文件，比如 <jsp:include>
你可以在一個頁面中用上多個<% @ page %>指令，但是其中的屬性只能用一次，不過也有個例外，那就是import屬性。因為import屬性和Java中的import語句差不多(參照Java Language)，所以你就能多用此屬性幾次了.
無論你把<% @ page %>指令放在JSP的文件的哪個地方，它的作用范圍都是整個JSP頁面。不過，為了JSP程序的可讀性，以及好的編程習慣，最好還是把它放在JSP文件的頂部.
屬性
language="java"
聲明腳本語言的種類，暫時只能用"java"
extends="package.class"
標明JSP編譯時需要加入的Java Class的全名，但是得慎重的使用它，它會限制JSP的編譯能力.
import="{package.class | package.* }, ..."
需要導入的Java包的列表，這些包就作用于程序段，表達式，以及聲明。
下面的包在JSP編譯時已經導入了，所以你就不需要再指明了:
java.lang.*
javax.servlet.*
javax.servlet.jsp.*
javax.servlet.http.*
session="true | false"
設定客戶是否需要HTTP Session.（學過ASP的人，應該對它不陌生)如果它為true,那么Session是有用的。
如果它有false,那么你就不能使用session對象，以及定義了scope=session的<jsp:useBean>元素。這樣的使用會導致錯誤.
缺省值是true.
buffer="none | 8kb | sizekb"
buffer的大小被out對象用于處理執行后的JSP對客戶瀏覽器的輸出。缺省值是8kb
autoFlush="true | false"
設置如果buffer溢出，是否需要強制輸出，如果其值被定義為true(缺省值)，輸出正常，如果它被設置為false,如果這個buffer溢出，就會導致一個意外錯誤的發生.如果你把buffer設置為none,那么你就不能把autoFlush設置為false.
isThreadSafe="true | false"
設置Jsp文件是否能多線程使用。缺省值是true,也就是說，JSP能夠同時處理多個用戶的請求，如果設置為false，一個jsp只能一次處理一個請求
info="text"
一個文本在執行JSP將會被逐字加入JSP中，你能夠使用Servlet.getServletInfo方法取回。
errorPage="relativeURL"
設置處理異常事件的JSP文件。
isErrorPage="true | false"
設置此頁是否為出錯頁，如果被設置為true,你就能使用exception對象.
contentType="mimeType [ ;charset=characterSet ]" | "text/html;charset=ISO-8859-1"
設置MIME類型 。缺省MIME 類型是: text/html, 缺省字符集為 ISO-8859-1.
<jsp:forward>
重定向一個HTML文件，JSP文件，或者是一個程序段.
JSP 語法
<jsp:forward page={"relativeURL" | "<%= expression %>"} />
or
<jsp:forward page={"relativeURL" | "<%= expression %>"} >
<jsp:param name="parameterName"
value="{parameterValue | <%= expression %>}" />+
</jsp:forward>
例子
<jsp:forward page="/servlet/login" />
<jsp:forward page="/servlet/login">
<jsp:param name="username" value="jsmith" />
</jsp:forward>
描述
<jsp:forward>標簽從一個JSP文件向另一個文件傳遞一個包含用戶請求的request對象.<jsp:forward>標簽以下的代碼，將不能執行.
你能夠向目標文件傳送參數和值，在這個例子中我們傳遞的參數名為username,值為scott,如果你使用了<jsp:param>標簽的話，目標文件必須是一個動態的文件，能夠處理參數.
如果你使用了非緩沖輸出的話，那么使用<jsp:forward>時就要小心。如果在你使用<jsp:forward>之前，jsp文件已經有了數據，那么文件執行就會出錯.
屬性
page="{relativeURL | <%= expression %>}"
這里是一個表達式或是一個字符串用于說明你將要定向的文件或URL.這個文件可以是JSP,程序段，或者其它能夠處理request對象的文件(如asp,cgi,php).
<jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />+
向一個動態文件發送一個或多個參數，這個文件一定是動態文件.
如果你想傳遞多個參數，你可以在一個JSP文件中使用多個<jsp:param>。name指定參數名，value指定參數值.
<jsp:getProperty>
獲取Bean的屬性值，用于顯示在頁面中
JSP 語法
<jsp:getProperty name="beanInstanceName" property="propertyName" />
例子
<jsp:useBean id="calendar" scope="page" class="employee.Calendar" />
<h2>
Calendar of <jsp:getProperty name="calendar" property="username" />
</h2>
描述
這個<jsp:getProperty>元素將獲得Bean的屬性值，并可以將其使用或顯示在JSP頁面中.在你使用<jsp:getProperty>之前，你必須用<jsp:useBean>創建它.
<jsp:getProperty>元素有一些限制:
你不能使用<jsp:getProperty>來檢索一個已經被索引了的屬性
你能夠和JavaBeans組件一起使用<jsp:getProperty>,但是不能與Enterprise Bean一起使用。
屬性
name="beanInstanceName"
bean的名字,由<jsp:useBean>指定
property="propertyName"
所指定的Bean的屬性名。
技巧:
在sun的JSP參考中提到，如果你使用<jsp:getProperty>來檢索的值是空值，那么NullPointerException將會出現，同時如果使用程序段或表達式來檢索其值，那么在瀏覽器上出現的是null（空).
<jsp:include>
包含一個靜態或動態文件.
JSP 語法
<jsp:include page="{relativeURL | <%= expression%>}" flush="true" />
or
<jsp:include page="{relativeURL | <%= expression %>}" flush="true" >
<jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />+
</jsp:include>
Examples
<jsp:include page="scripts/login.jsp" />
<jsp:include page="copyright.html" />
<jsp:include page="/index.html" />
<jsp:include page="scripts/login.jsp">
<jsp:param name="username" value="jsmith" />
</jsp:include>
描述
<jsp:include>元素允許你包含動態文件和靜態，這兩種包含文件的結果是不同的。如果文件僅是靜態文件，那么這種包含僅僅是把包含文件的內容加到jsp文件中去，而如果這個文件動態的，那么這個被包含文件也會被Jsp編譯器執行(這一切與asp相似)
你不能從文件名上判斷一個文件是動態的還是靜態的，比如aspcn.asp 就有可能只是包含一些信息而已，而不需要執行。<jsp:include>能夠同時處理這兩種文件，因此你就不需要包含時還要判斷此文件是動態的還是靜態的.
如果這個包含文件是動態的，那么你還可以用<jsp:param>還傳遞參數名和參數值。
屬性
page="{relativeURL | <%= expression %>}"
參數為一相對路徑，或者是代表相對路徑的表達式.
flush="true"
這里你必須使用flush="true",你不能使用false值.缺省值為false
<jsp:param name="parameterName" value="{parameterValue | <%= expression %> }" />+
<jsp:param>子句能讓你傳遞一個或多個參數給動態文件
你能在一個頁面中使用多個<jsp:param>來傳遞多個參數，
<jsp:plugin>
執行一個applet或Bean,有可能的話還要下載一個Java插件用于執行它.
JSP 語法
<jsp:plugin
type="bean | applet"
code="classFileName"
codebase="classFileDirectoryName"
[ name="instanceName" ]
[ archive="URIToArchive, ..." ]
[ align="bottom | top | middle | left | right" ]
[ height="displayPixels" ]
[ width="displayPixels" ]
[ hspace="leftRightPixels" ]
[ vspace="topBottomPixels" ]
[ jreversion="JREVersionNumber | 1.1" ]
[ nspluginurl="URLToPlugin" ]
[ iepluginurl="URLToPlugin" ] >
[ <jsp:params>
[ <jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" /> ]+
</jsp:params> ]
[ <jsp:fallback> text message for user </jsp:fallback> ]
</jsp:plugin>
例子
<jsp:plugin type=applet code="Molecule.class" codebase="/html">
<jsp:params>
<jsp:param name="molecule" value="molecules/benzene.mol" />
</jsp:params>
<jsp:fallback>
<p>Unable to load applet</p>
</jsp:fallback>
</jsp:plugin>
描述
<jsp:plugin>元素用于在瀏覽器中播放或顯示一個對象（典型的就是applet和Bean),而這種顯示需要在瀏覽器的java插件。
當Jsp文件被編譯，送往瀏覽器時，<jsp:plugin>元素將會根據瀏覽器的版本替換成<object>或者<embed>元素。注意，<object>用于HTML 4.0 ，<embed>用于HTML 3.2.
一般來說，<jsp:plugin>元素會指定對象是Applet還是Bean,同樣也會指定class的名字，還有位置，另外還會指定將從哪里下載這個Java插件。具體如下:
屬性
type="bean | applet"
.將被執行的插件對象的類型，你必須得指定這個是Bean還是applet,因為這個屬性沒有缺省值.
code="classFileName"
將會被Java插件執行的Java Class的名字，必須以.class結尾。這個文件必須存在于codebase屬性指定的目錄中.
codebase="classFileDirectoryName"
將會被執行的Java Class文件的目錄（或者是路徑)，如果你沒有提供此屬性，那么使用<jsp:plugin>的jsp文件的目錄將會被使用.
name="instanceName"
這個Bean或applet實例的名字，它將會在Jsp其它的地方調用.
archive="URIToArchive, ..."
一些由逗號分開的路徑名，這些路徑名用于預裝一些將要使用的class,這會提高applet的性能.
align="bottom | top | middle | left | right"
圖形，對象，Applet的位置,有以下值:
bottom
top
middle
left
right
height="displayPixels" width="displayPixels"
Applet或Bean將要顯示的長寬的值，此值為數字，單位為象素.
hspace="leftRightPixels" vspace="topBottomPixels"
Applet或Bean顯示時在屏幕左右，上下所需留下的空間，單位為象素.
jreversion="JREVersionNumber | 1.1"
Applet或Bean運行所需的Java Runtime Environment (JRE) 的版本. 缺省值是 1.1.
nspluginurl="URLToPlugin"
Netscape Navigator用戶能夠使用的JRE的下載地址，此值為一個標準的URL，如http://www.aspcn.com/jsp
iepluginurl="URLToPlugin"
IE用戶能夠使用的JRE的下載地址，此值為一個標準的URL，如http://www.aspcn.com/jsp
<jsp:params> [ <jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" /> ]+ </jsp:params>
你需要向applet或Bean傳送的參數或參數值。
<jsp:fallback> text message for user </jsp:fallback>
一段文字用于Java 插件不能啟動時顯示給用戶的，如果插件能夠啟動而applet或Bean不能，那么瀏覽器會有一個出錯信息彈出.
<jsp:setProperty>
設置Bean中的屬性值.
JSP語法
<jsp:setProperty
name="beanInstanceName"
{
property= "*" |
property="propertyName" [ param="parameterName" ] |
property="propertyName" value="{string | <%= expression %>}"
}
/>
例子
<jsp:setProperty name="mybean" property="*" />
<jsp:setProperty name="mybean" property="username" />
<jsp:setProperty name="mybean" property="username" value="Steve" />
描述
<jsp:setProperty>元素使用Bean給定的setter方法，在Bean中設置一個或多個屬性值。你在使用這個元素之前必須得使用<jsp:useBean>聲明此Bean.因為，<jsp:useBean>和<jsp:setProperty>是聯系在一起的，同時這他們使用的Bean實例的名字也應當相匹配（就是說，在<jsp:setProperty>中的name的值應當和<jsp:useBean>中id的值相同)
你能使用多種方法利用<jsp:setProperty>來設定屬性值 :
通過用戶輸入的所有值(被做為參數儲存中request對象中)來匹配Bean中的屬性
通過用戶輸入的指定的值來匹配Bean中指定的屬性
在運行時使用一個表達式來匹配Bean的屬性
每一種設定屬性值的方法都有其特定的語法，下面我們會來講解
屬性及其用法
name="beanInstanceName"
表示已經在<jsp:useBean>中創建的Bean實例的名字.
property="*"
儲存用戶在Jsp輸入的所有值，用于匹配Bean中的屬性。在Bean中的屬性的名字必須和request對象中的參數名一致.
從客戶傳到服器上的參數值一般都是字符類型 ，這些字符串為了能夠在Bean中匹配就必須轉換成其它的類型，下面的表中列出了Bean屬性的類型以及他們的轉換方法.
把字符串轉化為其它類型的方法. Property 類型
方法
boolean or Boolean
java.lang.Boolean.valueOf(String)
byte or Byte
java.lang.Byte.valueOf(String)
char or Character
java.lang.Character.valueOf(String)
double or Double
java.lang.Double.valueOf(String)
integer or Integer
java.lang.Integer.valueOf(String)
float or Float
java.lang.Float.valueOf(String)
long or Long
java.lang.Long.valueOf(String)
如果request對象的參數值中有空值，那么對應的Bean屬性將不會設定任何值。同樣的，如果Bean中有一個屬性沒有與之對應的Request參數值，那么這個屬性同樣也不會設定.
property="propertyName" [ param="parameterName" ]
使用request中的一個參數值來指定Bean中的一個屬性值。在這個語法中，property指定Bean的屬性名，param指定request中的參數名.
如果bean屬性和request參數的名字不同，那么你就必須得指定property和param ，如果他們同名，那么你就只需要指明property就行了.
如查參數值為空（或未初始化),對應的Bean屬性不被設定.
property="propertyName" value="{string | <%= expression %>}"
使用指定的值來設定Bean屬性。這個值可以是字符串，也可以是表達式。如果這個字符串，那么它就會被轉換成Bean屬性的類型（查看上面的表).如果它是一個表達式，那么它類型就必須和它將要設定的屬性值的類型一致。
如果參數值為空，那么對應的屬性值也不會被設定。另外，你不能在一個<jsp:setProperty>中同時使用param和value
技巧
如果你使用了property="*",那么Bean的屬性沒有必要按Html表單中的順序排序
<jsp:useBean>
創建一個Bean實例并指定它的名字和作用范圍.
JSP 語法
<jsp:useBean
id="beanInstanceName"
scope="page | request | session | application"
{
class="package.class" |
type="package.class" |
class="package.class" type="package.class" |
beanName="{package.class | <%= expression %>}" type="package.class"
}
{
/> |
> other elements </jsp:useBean>
}
例子
<jsp:useBean id="cart" scope="session" class="session.Carts" />
<jsp:setProperty name="cart" property="*" />
<jsp:useBean id="checking" scope="session" class="bank.Checking" >
<jsp:setProperty name="checking" property="balance" value="0.0" />
</jsp:useBean>
描述
<jsp:useBean>用于定位或示例一個JavaBeans組件。<jsp:useBean>首先會試圖定位一個Bean實例，如果這個Bean不存在，那么<jsp:useBean>就會從一個class或模版中進行示例。
為了定位或示例一個Bean，<jsp:useBean>會進行以下步聚，順序如下:
通過給定名字和范圍試圖定位一個Bean.
對這個Bean對象引用變量以你指定的名字命名.
如果發現了這個Bean,將會在這個變量中儲存這個引用。如果你也指定了類型，那么這個Bean也設置為相應的類型.
如果沒有發現這個Bean,將會從你指定的class中示例，并將此引用儲存到一個新的變量中去。如果這個class的名字代表的是一個模版，那么這個Bean被java.beans.Beans.instantiate示例.
如果<jsp:useBean>已經示例（不是定位）了Bean,同時<jsp:useBean>和</jsp:useBean>中有元素，那么將會執行其中的代碼.
<jsp:useBean>元素的主體通常包含有<jsp:setProperty>元素，用于設置Bean的屬性值。正如上面第五步所說的，<jsp:useBean>的主體僅僅只有在<jsp:useBean>示例Bean時才會被執行，如果這個Bean已經存在，<jsp:useBean>能夠定位它，那么主體中的內容將不會起作用
屬性以及用法
id="beanInstanceName"
在你所定義的范圍中確認Bean的變量，你能在后面的程序中使用此變量名來分辨不同的Bean
這個變量名對大小寫敏感，必須符合你所使用的腳本語言的規定，在Java Programming Language中，這個規定在Java Language 規范已經寫明。如果這個Bean已經在別的<jsp:useBean>中創建，那么這個id的值必須與原來的那個id值一致.
scope="page | request | session | application"
Bean存在的范圍以及id變量名的有效范圍。缺省值是page,以下是詳細說明：
page - 你能在包含<jsp:useBean>元素的JSP文件以及此文件中的所有靜態包含文件中使用Bean,直到頁面執行完畢向客戶端發回響應或轉到另一個文件為止。
request - 你在任何執行相同請求的Jsp文件中使用Bean,直到頁面執行完畢向客戶端發回響應或轉到另一個文件為止。你能夠使用Request對象訪問Bean,比如request.getAttribute(beanInstanceName)
session - 從創建Bean開始，你就能在任何使用相同session的Jsp文件中使用Bean.這個Bean存在于整個Session生存周期內，任何在分享此Session的Jsp文件都能使用同一Bean.注意在你創建Bean的Jsp文件中<% @ page %>指令中必須指定session=true
application - 從創建Bean開始，你就能在任何使用相同application的Jsp文件中使用Bean.這個Bean存在于整個application生存周期內，任何在分享此application的Jsp文件都能使用同一Bean.
class="package.class"
使用new關鍵字以及class構造器從一個class中示例一個bean.這個class不能是抽象的，必須有一個公用的，沒有參數的構造器.這個package的名字區別大小寫。
type="package.class"
如果這個Bean已經在指定的范圍中存在，那么寫這個Bean一個新的數據庫類型 。如果你沒有使用class或beanName指定type，Bean將不會被示例.package和class的名字，區分大小寫.
beanName="{package.class | <%= expression %>}" type="package.class"
使用java.beans.Beans.instantiate方法來從一個class或連續模版中示例一個Bean,同時指定Bean的類型。
beanName可以是package和class也可以是表達式,它的值會傳給Beans.instantiate.tupe的值可以和Bean相同。
package 和 class 名字區分大小寫.
posted @
2009-05-09 11:58 lanxin1020 閱讀(192) |
評論 (0) |
編輯 收藏