類的初始化和對象初始化是 JVM 管理的類型生命周期中非常重要的兩個環(huán)節(jié)，Google 了一遍網(wǎng)絡(luò)，有關(guān)類裝載機(jī)制的文章倒是不少，然而類初始化和對象初始化的文章并不多，特別是從字節(jié)碼和 JVM 層次來分析的文章更是鮮有所見。

本文主要對類和對象初始化全過程進(jìn)行分析，通過一個實際問題引入，將源代碼轉(zhuǎn)換成 JVM 字節(jié)碼后，對 JVM 執(zhí)行過程的關(guān)鍵點進(jìn)行全面解析，并在文中穿插入了相關(guān) JVM 規(guī)范和 JVM 的部分內(nèi)部理論知識，以理論與實際結(jié)合的方式介紹對象初始化和類初始化之間的協(xié)作以及可能存在的沖突問題。

問題引入

近日我在調(diào)試一個枚舉類型的解析器程序，該解析器是將數(shù)據(jù)庫內(nèi)一萬多條枚舉代碼裝載到緩存中，為了實現(xiàn)快速定位枚舉代碼和具體枚舉類別的所有枚舉元素，該類在裝載枚舉代碼的同時對其采取兩種策略建立內(nèi)存索引。由于該類是一個公共服務(wù)類，在程序各個層面都會使用到它，因此我將它實現(xiàn)為一個單例類。這個類在我調(diào)整類實例化語句位置之前運(yùn)行正常，但當(dāng)我把該類實例化語句調(diào)整到靜態(tài)初始化語句之前時，我的程序不再為我工作了。

下面是經(jīng)過我簡化后的示例代碼：

package com.ccb.framework.enums;

import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

public class CachingEnumResolver {
	//單態(tài)實例　一切問題皆由此行引起
	private static final CachingEnumResolver SINGLE_ENUM_RESOLVER = new
	CachingEnumResolver();
	/*MSGCODE->Category內(nèi)存索引*/
	private static Map CODE_MAP_CACHE;
	static {
		CODE_MAP_CACHE = new HashMap();
		//為了說明問題,我在這里初始化一條數(shù)據(jù)
		CODE_MAP_CACHE.put("0","北京市");
	}
	
	//private, for single instance
	private CachingEnumResolver() {
		//初始化加載數(shù)據(jù)  引起問題，該方法也要負(fù)點責(zé)任
		initEnums();
	}
	
	/**
	 * 初始化所有的枚舉類型
	 */
	public static void initEnums() {		
		// ~~~~~~~~~問題從這里開始暴露 ~~~~~~~~~~~//
		if (null == CODE_MAP_CACHE) {
			System.out.println("CODE_MAP_CACHE為空,問題在這里開始暴露.");
			CODE_MAP_CACHE = new HashMap();
		}
		CODE_MAP_CACHE.put("1", "北京市");
		CODE_MAP_CACHE.put("2", "云南省");
		
		//..... other code...
	}
	
	public Map getCache() {
		return Collections.unmodifiableMap(CODE_MAP_CACHE);
	}
	
	/**
	 * 獲取單態(tài)實例
	 * 
	 * @return
	 */
	public static CachingEnumResolver getInstance() {
		return SINGLE_ENUM_RESOLVER;
	}
	
	public static void main(String[] args) {
		System.out.println(CachingEnumResolver.getInstance().getCache());
	}
}

想必大家看了上面的代碼后會感覺有些茫然，這個類看起來沒有問題啊，這的確屬于典型的餓漢式單態(tài)模式啊，怎么會有問題呢？

是的，他看起來的確沒有問題，可是如果將他 run 起來時，其結(jié)果是他不會為你正確 work。運(yùn)行該類，它的執(zhí)行結(jié)果是：

CODE_MAP_CACHE為空,問題在這里開始暴露.
{0=北京市}

我的程序怎么會這樣？為什么在 initEnum() 方法里 CODE_MAP_CACHE 為空？為什么我輸出的 CODE_MAP_CACHE 內(nèi)容只有一個元素，其它兩個元素呢？？？？！！

看到這里，如果是你在調(diào)試該程序，你此刻一定覺得很奇怪，難道是我的 Jvm 有問題嗎？非也！如果不是，那我的程序是怎么了？這絕對不是我想要的結(jié)果。可事實上無論怎么修改 initEnum() 方法都無濟(jì)于事，起碼我最初是一定不會懷疑到問題可能出在創(chuàng)建 CachingEnumResolver 實例這一環(huán)節(jié)上。正是因為我太相信我創(chuàng)建 CachingEnumResolver 實例的方法，加之對 Java 類初始化與對象實例化底層原理理解有所偏差，使我為此付出了三、四個小時--約半個工作日的大好青春。

那么問題究竟出在哪里呢？為什么會出現(xiàn)這樣的怪事呢？在解決這個問題之前，先讓我們來了解一下JVM的類和對象初始化的底層機(jī)制。

回頁首

類的生命周期

上圖展示的是類生命周期流向；在本文里，我只打算談?wù)勵惖?初始化"以及"對象實例化"兩個階段。

回頁首

類初始化

類"初始化"階段，它是一個類或接口被首次使用的前階段中的最后一項工作，本階段負(fù)責(zé)為類變量賦予正確的初始值。

Java 編譯器把所有的類變量初始化語句和類型的靜態(tài)初始化器通通收集到 <clinit> 方法內(nèi)，該方法只能被 Jvm 調(diào)用，專門承擔(dān)初始化工作。

除接口以外，初始化一個類之前必須保證其直接超類已被初始化，并且該初始化過程是由 Jvm 保證線程安全的。另外，并非所有的類都會擁有一個 <clinit>() 方法，在以下條件中該類不會擁有 <clinit>() 方法：

• 該類既沒有聲明任何類變量，也沒有靜態(tài)初始化語句；
• 該類聲明了類變量，但沒有明確使用類變量初始化語句或靜態(tài)初始化語句初始化；
• 該類僅包含靜態(tài) final 變量的類變量初始化語句，并且類變量初始化語句是編譯時常量表達(dá)式。

回頁首

對象初始化

在類被裝載、連接和初始化，這個類就隨時都可能使用了。對象實例化和初始化是就是對象生命的起始階段的活動，在這里我們主要討論對象的初始化工作的相關(guān)特點。

Java 編譯器在編譯每個類時都會為該類至少生成一個實例初始化方法--即 "<init>()" 方法。此方法與源代碼中的每個構(gòu)造方法相對應(yīng)，如果類沒有明確地聲明任何構(gòu)造方法，編譯器則為該類生成一個默認(rèn)的無參構(gòu)造方法，這個默認(rèn)的構(gòu)造器僅僅調(diào)用父類的無參構(gòu)造器，與此同時也會生成一個與默認(rèn)構(gòu)造方法對應(yīng)的 "<init>()" 方法.

通常來說，<init>() 方法內(nèi)包括的代碼內(nèi)容大概為：調(diào)用另一個 <init>() 方法；對實例變量初始化；與其對應(yīng)的構(gòu)造方法內(nèi)的代碼。

如果構(gòu)造方法是明確地從調(diào)用同一個類中的另一個構(gòu)造方法開始，那它對應(yīng)的 <init>() 方法體內(nèi)包括的內(nèi)容為：一個對本類的 <init>() 方法的調(diào)用；對應(yīng)用構(gòu)造方法內(nèi)的所有字節(jié)碼。

如果構(gòu)造方法不是通過調(diào)用自身類的其它構(gòu)造方法開始，并且該對象不是 Object 對象，那 <init>() 法內(nèi)則包括的內(nèi)容為：一個對父類 <init>() 方法的調(diào)用；對實例變量初始化方法的字節(jié)碼；最后是對應(yīng)構(gòu)造子的方法體字節(jié)碼。

如果這個類是 Object，那么它的 <init>() 方法則不包括對父類 <init>() 方法的調(diào)用。

回頁首

類的初始化時機(jī)

本文到目前為止，我們已經(jīng)大概有了解到了類生命周期中都經(jīng)歷了哪些階段，但這個類的生命周期的開始階段--類裝載又是在什么時候被觸發(fā)呢？類又是何時被初始化的呢？讓我們帶著這三個疑問繼續(xù)去尋找答案。

Java 虛擬機(jī)規(guī)范為類的初始化時機(jī)做了嚴(yán)格定義："initialize on first active use"--" 在首次主動使用時初始化"。這個規(guī)則直接影響著類裝載、連接和初始化類的機(jī)制--因為在類型被初始化之前它必須已經(jīng)被連接，然而在連接之前又必須保證它已經(jīng)被裝載了。

在與初始化時機(jī)相關(guān)的類裝載時機(jī)問題上，Java 虛擬機(jī)規(guī)范并沒有對其做嚴(yán)格的定義，這就使得 JVM 在實現(xiàn)上可以根據(jù)自己的特點提供采用不同的裝載策略。我們可以思考一下 Jboss AOP 框架的實現(xiàn)原理，它就是在對你的 class 文件裝載環(huán)節(jié)做了手腳--插入了 AOP 的相關(guān)攔截字節(jié)碼，這使得它可以對程序員做到完全透明化，哪怕你用 new 操作符創(chuàng)建出的對象實例也一樣能被 AOP 框架攔截--與之相對應(yīng)的 Spring AOP，你必須通過他的 BeanFactory 獲得被 AOP 代理過的受管對象，當(dāng)然 Jboss AOP 的缺點也很明顯--他是和 JBOSS 服務(wù)器綁定很緊密的，你不能很輕松的移植到其它服務(wù)器上。嗯~……，說到這里有些跑題了，要知道 AOP 實現(xiàn)策略足可以寫一本厚厚的書了，嘿嘿，就此打住。

說了這么多，類的初始化時機(jī)就是在"在首次主動使用時"，那么，哪些情形下才符合首次主動使用的要求呢？

首次主動使用的情形：

• 創(chuàng)建某個類的新實例時--new、反射、克隆或反序列化；
• 調(diào)用某個類的靜態(tài)方法時；
• 使用某個類或接口的靜態(tài)字段或?qū)υ撟侄钨x值時（final字段除外）；
• 調(diào)用Java的某些反射方法時
• 初始化某個類的子類時
• 在虛擬機(jī)啟動時某個含有main()方法的那個啟動類。

除了以上幾種情形以外，所有其它使用JAVA類型的方式都是被動使用的，他們不會導(dǎo)致類的初始化。

回頁首

我的問題究竟出在哪里

好了，了解了JVM的類初始化與對象初始化機(jī)制后，我們就有了理論基礎(chǔ)，也就可以理性的去分析問題了。

下面讓我們來看看前面[清單一]的JAVA源代碼反組譯出的字節(jié)碼：

public class com.ccb.framework.enums.CachingEnumResolver extends
java.lang.Object{
static {};
  Code:
   0:	new	#2; //class CachingEnumResolver
   3:	dup
   4:	invokespecial	#14; //Method "<init>":()V  ①
   7:	putstatic	#16; //Field
   SINGLE_ENUM_RESOLVER:Lcom/ccb/framework/enums/CachingEnumResolver;
   10:	new	#18; //class HashMap              ②
   13:	dup
   14:	invokespecial	#19; //Method java/util/HashMap."<init>":()V
   17:	putstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;  
   20:	getstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;  
   23:	ldc	#23; //String 0
   25:	ldc	#25; //String 北京市
   27:	invokeinterface	#31,  3; //InterfaceMethod
   java/util/Map.put:(Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object;   ③
   32:	pop
   33:	return

private com.ccb.framework.enums.CachingEnumResolver();
  Code:
   0:	aload_0
   1:	invokespecial	#34; //Method java/lang/Object."<init>":()V
   4:	invokestatic	#37; //Method initEnums:()V                  ④
   7:	return

public static void initEnums();
  Code:
   0:	getstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;    ⑤
   3:	ifnonnull	24
   6:	getstatic	#44; //Field java/lang/System.out:Ljava/io/PrintStream;
   9:	ldc	#46; //String CODE_MAP_CACHE為空,問題在這里開始暴露.
   11:	invokevirtual	#52; //Method
   java/io/PrintStream.println:(Ljava/lang/String;)V
   14:	new	#18; //class HashMap
   17:	dup
   18:	invokespecial	#19; //Method java/util/HashMap."<init>":()V      ⑥
   21:	putstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;
   24:	getstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;
   27:	ldc	#54; //String 1
   29:	ldc	#25; //String 北京市
   31:	invokeinterface	#31,  3; //InterfaceMethod
   java/util/Map.put:(Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object;   ⑦
   36:	pop
   37:	getstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;
   40:	ldc	#56; //String 2
   42:	ldc	#58; //String 云南省
   44:	invokeinterface	#31,  3; //InterfaceMethod
   java/util/Map.put:(Ljava/lang/Object;Ljava/lang/Object;)Ljava/lang/Object;    ⑧
   49:	pop
   50:	return

public java.util.Map getCache();
  Code:
   0:	getstatic	#21; //Field CODE_MAP_CACHE:Ljava/util/Map;
   3:	invokestatic	#66; //Method
   java/util/Collections.unmodifiableMap:(Ljava/util/Map;)Ljava/util/Map;
   6:	areturn

public static com.ccb.framework.enums.CachingEnumResolver getInstance();
  Code:
   0:	getstatic	#16; 
   //Field SINGLE_ENUM_RESOLVER:Lcom/ccb/framework/enums/CachingEnumResolver;   ⑨
   3:	areturn
}

如果上面［清單一］顯示，清單內(nèi)容是在 JDK1.4 環(huán)境下的字節(jié)碼內(nèi)容，可能這份清單對于很大部分兄弟來說確實沒有多少吸引力，因為這些 JVM 指令確實不像源代碼那樣漂亮易懂。但它的的確確是查找和定位問題最直接的辦法，我們想要的答案就在這份 JVM 指令清單里。

現(xiàn)在，讓我們對該類從類初始化到對象實例初始化全過程分析[清單一]中的代碼執(zhí)行軌跡。

如前面所述，類初始化是在類真正可用時的最后一項前階工作，該階段負(fù)責(zé)對所有類正確的初始化值，此項工作是線程安全的，JVM會保證多線程同步。

第１步：調(diào)用類初始化方法 CachingEnumResolver.<clinit>()，該方法對外界是不可見的，換句話說是 JVM 內(nèi)部專用方法，<clinit>() 內(nèi)包括了 CachingEnumResolver 內(nèi)所有的具有指定初始值的類變量的初始化語句。要注意的是并非每個類都具有該方法，具體的內(nèi)容在前面已有敘述。

第２步：進(jìn)入 <clinit>() 方法內(nèi)，讓我們看字節(jié)碼中的 "①" 行，該行與其上面兩行組合起來代表 new 一個 CachingEnumResolver 對象實例，而該代碼行本身是指調(diào)用 CachingEnumResolver 類的 <init>（）方法。每一個 Java 類都具有一個 <init>() 方法，該方法是 Java 編譯器在編譯時生成的，對外界不可見，<init>() 方法內(nèi)包括了所有具有指定初始化值的實例變量初始化語句和java類的構(gòu)造方法內(nèi)的所有語句。對象在實例化時，均通過該方法進(jìn)行初始化。然而到此步，一個潛在的問題已經(jīng)在此埋伏好，就等著你來犯了。

第３步：讓我們順著執(zhí)行順序向下看，"④" 行，該行所在方法就是該類的構(gòu)造器，該方法先調(diào)用父類的構(gòu)造器 <init>() 對父對象進(jìn)行初始化，然后調(diào)用 CachingEnumResolver.initEnum() 方法加載數(shù)據(jù)。

第４步："⑤" 行，該行獲取 "CODE_MAP_CACHE" 字段值，其運(yùn)行時該字段值為 null。注意，問題已經(jīng)開始顯現(xiàn)了。（作為程序員的你一定是希望該字段已經(jīng)被初始化過了，而事實上它還沒有被初始化）。通過判斷，由于該字段為 NULL，因此程序?qū)⒗^續(xù)執(zhí)行到 "⑥" 行，將該字段實例化為 HashMap()。

第５步：在 "⑦"、"⑧" 行，其功能就是為 "CODE_MAP_CACHE" 字段填入兩條數(shù)據(jù)。

第６步：退出對象初始化方法 <init>()，將生成的對象實例初始化給類字段 "SINGLE_ENUM_RESOLVER"。（注意，此刻該對象實例內(nèi)的類變量還未初始化完全，剛才由 <init>() 調(diào)用 initEnum() 方法賦值的類變量 "CODE_MAP_CACHE" 是 <clinit>() 方法還未初始化字段，它還將在后面的類初始化過程再次被覆蓋）。

第７步：繼續(xù)執(zhí)行 <clinit>（）方法內(nèi)的后繼代碼，"②" 行，該行對 "CODE_MAP_CACHE" 字段實例化為 HashMap 實例（注意：在對象實例化時已經(jīng)對該字段賦值過了，現(xiàn)在又重新賦值為另一個實例，此刻，"CODE_MAP_CACHE"變量所引用的實例的類變量值被覆蓋，到此我們的疑問已經(jīng)有了答案）。

第8步：類初始化完畢，同時該單態(tài)類的實例化工作也完成。

通過對上面的字節(jié)碼執(zhí)行過程分析，或許你已經(jīng)清楚了解到導(dǎo)致錯誤的深層原因了，也或許你可能早已被上面的分析過程給弄得暈頭轉(zhuǎn)向了，不過也沒折，雖然我也可以從源代碼的角度來闡述問題，但這樣不夠深度，同時也會有僅為個人觀點、不足可信之嫌。

回頁首

如何解決

要解決上面代碼所存在的問題很簡單，那就是將 "SINGLE_ENUM_RESOLVER" 變量的初始化賦值語句轉(zhuǎn)移到 getInstance() 方法中去即可。換句話說就是要避免在類還未初始化完成時從內(nèi)部實例化該類或在初始化過程中引用還未初始化的字段。

回頁首

寫在最后

靜下浮燥之心，仔細(xì)思量自己是否真的掌握了本文主題所引出的知識，如果您覺得您已經(jīng)完全或基本掌握了，那么很好，在最后，我將前面的代碼稍做下修改，請思考下面兩組程序是否同樣會存在問題呢？

	public class CachingEnumResolver {
	public  static Map CODE_MAP_CACHE;
	static {
		CODE_MAP_CACHE = new HashMap();
		//為了說明問題,我在這里初始化一條數(shù)據(jù)
		CODE_MAP_CACHE.put("0","北京市");
		initEnums();
	}
	

	public class CachingEnumResolver {
		private static final CachingEnumResolver SINGLE_ENUM_RESOLVER;
		public  static Map CODE_MAP_CACHE;
		static {
			CODE_MAP_CACHE = new HashMap();
			//為了說明問題,我在這里初始化一條數(shù)據(jù)
			CODE_MAP_CACHE.put("0","北京市");
			SINGLE_ENUM_RESOLVER = new CachingEnumResolver();
			initEnums();
		}
	

最后，一點關(guān)于 JAVA 群體的感言：時下正是各種開源框架盛行時期，Spring 更是大行其道，吸引著一大批 JEE 開發(fā)者的眼球（我也是 fans 中的一員）。然而，讓我們仔細(xì)觀察一下--以 Spring 群體為例，在那么多的 Spring fans 當(dāng)中，有多少人去研究過 Spring 源代碼？又有多少人對 Spring 設(shè)計思想有真正深入了解呢？當(dāng)然，我是沒有資格以這樣的口吻來說事的，我只是想表明一個觀點--學(xué)東西一定要"正本清源"。

獻(xiàn)上此文，謹(jǐn)以共勉。

• ?log4J日志器（http://jakarta.apache.org/log4j）
• JDK1.4 Logging日志器(JDK1.4自帶)
• SimpleLog日志器(把日志消息輸出到標(biāo)準(zhǔn)系統(tǒng)錯誤流System.err)
• NoOpLog(不輸出任何日志信息)
  
  通用日志包中的兩個常用接口：LogFactory和Log，分別介紹如下：
  
  
• Log接口

通用日志包把消息分為6個級別：FATAL、ERROR、WARN、INFO、DEBUG和TRACE。其中FATAL級別最高，
TRACE級別最低。 Log接口提供輸出不同級別消息的方法：

off---------------------------------最高等級的，用于關(guān)閉所有日志記錄

fatal(Object message)-------輸出FATAL級別的消息。

error(Object message)-------輸出ERROR級別的消息。

warn(Object message)-------輸出WARN級別的消息。

info(Object message)-------輸出INFO級別的消息。

debug(Object message)-------輸出DEBUG級別的消息。

trace(Object message)-------輸出TRACE級別的消息。

all----------------------------------最低等級的，用于打開所有日志記錄

注：只有當(dāng)輸出日志的級別大于或等于為日志配置器配置的日志級別時，這個方法才會執(zhí)行。

　　如何指定日志器的日志級別，不同的日志器實現(xiàn)會有不同的實現(xiàn)方案。

• LogFactory接口

LogFactory接口提供了獲得日志器實例的兩個靜態(tài)方法：

public static Log getLog(String name) throws LogConfigurationException;

public static Log getLog(Class class) throws LogConfigurationException;

注：name參數(shù)作為日志器的名字；class參數(shù)指定類名作為日志器名字。

　　　　
log4j簡介　
　　 幾乎每個大的應(yīng)用程序都有它自己的日志和跟蹤程序的API。順應(yīng)這一規(guī)則，E.U.?SEMPER項目組決定
編寫它自己的程序跟蹤API（tracing?API）。這開始于1996年早期。經(jīng)過無數(shù)的工作，更改和性能加強(qiáng)，這
個API終于成為一個十分受歡迎的Java日志軟件包，那就是log4j。這個軟件包的發(fā)行遵守open?source動議認(rèn)
證的Apache?Software?License。最新的log4j版本包括全部的源代碼，類文件和文檔資料，
可以在?http://logging.apache.org/log4j/找到它們。另外，log4j已經(jīng)被轉(zhuǎn)換成?C,?C++,?C#,?Perl,?Python,?
Ruby,?和?Eiffel?語言。
　　
　 　Log4j是Apache的一個開放源代碼項目，通過使用Log4j，我們可以控制日志信息輸送的目的地是控制臺、
文件、GUI組件、甚至是套接口服務(wù) 器、NT的事件記錄器、UNIX Syslog守護(hù)進(jìn)程等；我們也可以控制每一條
日志的輸出格式；通過定義每一條日志信息的級別，我們能夠更加細(xì)致地控制日志的生成過程。最令人感興趣
的就 是，這些可以通過一個配置文件來靈活地進(jìn)行配置，而不需要修改應(yīng)用的代碼。
　　
　　

log4j三個組件

?????? 通常，我們都提供一個名為 log4j.properties的文件，在第一次調(diào)用到Log4J時，Log4J會在類路徑
（../web-inf/class/當(dāng)然也可以放到其它任何目錄，只要該目錄被包含到類路徑中即可）中定位這個文件，并讀入
這個文件完成的配置。這個配置文件告 訴Log4J以什么樣的格式、把什么樣的信息、輸出到什么地方。
　　 Log4j有三個主要的組件：Loggers(記錄器)，Appenders(輸出源)和Layouts(布局)，這里可簡單理解為日志
類別，日志要輸出的地方和日志以何種形式輸出。綜合使用這三個組件可以輕松的記錄信息的類型和級別，并可
以在運(yùn)行時控制日志輸出的樣式和位置。下面對三個組件分別進(jìn)行說明：
　　
　　 1、 Loggers
　 　Loggers組件在此系統(tǒng)中被分為五個級別：DEBUG、INFO、WARN、ERROR和FATAL。這五個級別是有順序
的，DEBUG < INFO < WARN < ERROR < FATAL，分別用來指定這條日志信息的重要程度,明白這一點很重要，
這里L(fēng)og4j有一個規(guī)則：假設(shè)Loggers級別為P，如果在Loggers中發(fā)生了一個級別Q比P高，則可以啟動，否則屏蔽掉。
假設(shè)你定義的級別是info，那么error和warn的日志可以顯示而比他低的debug信息就不顯示了。
?　
　　 Java程序舉例來說：
　　
　　 //建立Logger的一個實例，命名為“com.foo”
　　　 Logger　logger = Logger.getLogger("com.foo"); //"com.foo"是實例進(jìn)行命名，也可以任意
　　 //設(shè)置logger的級別。通常不在程序中設(shè)置logger的級別。一般在配置文件中設(shè)置。
　　 logger.setLevel(Level.INFO);
　　 Logger barlogger = Logger.getLogger("com.foo.Bar");
　　 //下面這個請求可用，因為WARN >= INFO
　　 logger.warn("Low fuel level.");
　　 //下面這個請求不可用，因為DEBUG < INFO
　　 logger.debug("Starting search for nearest gas station.");
　　 //命名為“com.foo.bar”的實例barlogger會繼承實例“com.foo”的級別。因此，下面這個請求可用，因為INFO >= INFO
　　 barlogger.info("Located nearest gas station.");
　　 //下面這個請求不可用，因為DEBUG < INFO
　　 barlogger.debug("Exiting gas station search");
　　 這里“是否可用”的意思是能否輸出Logger信息。
　　　　 在對Logger實例進(jìn)行命名時，沒有限制，可以取任意自己感興趣的名字。一般情況下建議以類的所在位置來
命名Logger實例，這是目前來講比較有效的Logger命名方式。這樣可以使得每個類建立自己的日志信息，便于管理。
比如：
　　
　　 static Logger logger = Logger.getLogger(ClientWithLog4j.class.getName());
　　
　 　2、Appenders
　　禁用與使用日志請求只是Log4j其中的一個小小的地方，Log4j日志系統(tǒng)允許把日志輸出到不同的地方，
如控制臺（Console）、文件（Files）、根據(jù)天數(shù)或者文件大小產(chǎn)生新的文件、以流的形式發(fā)送到其它地方等等。
　　
　　 其語法表示為：
　　
　　 org.apache.log4j.ConsoleAppender（控制臺）
　　 org.apache.log4j.FileAppender（文件）
　　 org.apache.log4j.DailyRollingFileAppender（每天產(chǎn)生一個日志文件）
??? ???org.apache.log4j.RollingFileAppender（文件大小到達(dá)指定尺寸的時候產(chǎn)生一個新的文件）
　　 org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）
　　
　　 配置時使用方式為：
　　 log4j.appender.appenderName = fully.qualified.name.of.appender.class
　　 log4j.appender.appenderName.option1 = value1
　　 …
?????? log4j.appender.appenderName.option = valueN
　　 這樣就為日志的輸出提供了相當(dāng)大的便利。
　　
　　3、Layouts
　 　有時用戶希望根據(jù)自己的喜好格式化自己的日志輸出。Log4j可以在Appenders的后面附加Layouts來完成
??????這個功能。Layouts提供了 四種日志輸出樣式，如根據(jù)HTML樣式、自由指定樣式、包含日志級別與信息的樣式
??????和包含日志時間、線程、類別等信息的樣式等等。
　　
　　 其語法表示為：
　　
　　 org.apache.log4j.HTMLLayout（以HTML表格形式布局），
　　 org.apache.log4j.PatternLayout（可以靈活地指定布局模式），
　　 org.apache.log4j.SimpleLayout（包含日志信息的級別和信息字符串），
　　 org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時間、線程、類別等等信息）
　　
　　 配置時使用方式為：
　　
　　 log4j.appender.appenderName.layout =fully.qualified.name.of.layout.class
　　 log4j.appender.appenderName.layout.option1 = value1
　　 …
　　 log4j.appender.appenderName.layout.option = valueN

?

log4j基本編程方法
　　
　　 以上是從原理方面說明Log4j的使用方法，在具體Java編程使用Log4j可以參照以下示例：
　　
　　 1、 建立Logger實例：
　　 語法表示：public static Logger getLogger( String name)
　　 實際使用：static Logger logger = Logger.getLogger(ServerWithLog4j.class.getName ()) ;
　　
　　 2、 讀取配置文件：
　　 獲得了Logger的實例之后，接下來將配置Log4j使用環(huán)境：
　　 語法表示：
　　 BasicConfigurator.configure()：自動快速地使用缺省Log4j環(huán)境。
　　 PropertyConfigurator.configure(String configFilename)：讀取使用Java的特性文件編寫的配置文件。
　　 DOMConfigurator.configure(String filename)：讀取XML形式的配置文件。
　　 實際使用：
??? PropertyConfigurator.configure("ServerWithLog4j.properties");
　　
　　 3、 插入日志信息
　　 完成了以上連個步驟以后，下面就可以按日志的不同級別插入到你要記錄日志的任何地方了。
　　 語法表示：
　　 Logger.debug(Object message);//調(diào)試信息
　　 Logger.info(Object message);//一般信息
　　 Logger.warn(Object message);//警告信息
　　 Logger.error(Object message);//錯誤信息
　　 Logger.fatal(Object message);//致命錯誤信息

　　實際使用：logger.info("ServerSocket before accept: " + server);
　　
log4j配置文件

　在實際編程時，要使Log4j真正在系統(tǒng)中運(yùn)行事先還要對配置文件進(jìn)行定義。定義步驟就是對Logger、
Appender及Layout的分別使用。
??? Log4j支持兩種配置文件格式，一種是XML格式的文件，一種是java properties（key=value）
【Java特性文件（鍵=值）】。下面我們介紹使用Java特性文件做為配置文件的方法
?? 具體如下：
　　
　　 1、配置根Logger，其語法為：
　　 log4j.rootLogger = [ level ] , appenderName1, appenderName2, …
???????? level : 是日志記錄的優(yōu)先級，分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定義的級別。
Log4j建議只使用四個級別，優(yōu)先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級別，
您可以控制到應(yīng)用程序中相應(yīng)級別的日志信息的開關(guān)。比如在這里定 義了INFO級別，則應(yīng)用程序中所有DEBUG級
別的日志信息將不被打印出來。
　　 ???? appenderName:就是指定日志信息輸出到哪個地方。您可以同時指定多個輸出目的地。
?? 例如：log4j.rootLogger＝info,A1,B2,C3
　　
　　 2、配置日志信息輸出目的地，其語法為：
　　 log4j.appender.appenderName = fully.qualified.name.of.appender.class? //
　　 ? "fully.qualified.name.of.appender.class" 可以指定下面五個目的地中的一個：
??????????1.org.apache.log4j.ConsoleAppender（控制臺）
??????????2.org.apache.log4j.FileAppender（文件）
????????? 3.org.apache.log4j.DailyRollingFileAppender（每天產(chǎn)生一個日志文件）
????????? 4.org.apache.log4j.RollingFileAppender（文件大小到達(dá)指定尺寸的時候產(chǎn)生一個新的文件）
????????? 5.org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）
???????????? 1.ConsoleAppender選項
??????????????????? Threshold=WARN:指定日志消息的輸出最低層次。
??????????????????? ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
??????????????????? Target=System.err：默認(rèn)情況下是：System.out,指定輸出控制臺
??????????????2.FileAppender 選項
??????????????????? Threshold=WARN:指定日志消息的輸出最低層次。
??????????????????? ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
??????????????????? File=mylog.txt:指定消息輸出到mylog.txt文件。
??????????????????? Append=false:默認(rèn)值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內(nèi)容。
??????????? 3.DailyRollingFileAppender 選項
??????????????????? Threshold=WARN:指定日志消息的輸出最低層次。
??????????????????? ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
????????????????????File=mylog.txt:指定消息輸出到mylog.txt文件。
??????????????????? Append=false:默認(rèn)值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內(nèi)容。
??????????????????? DatePattern='.'yyyy-ww:每周滾動一次文件，即每周產(chǎn)生一個新的文件。當(dāng)然也可以指定按月、周、
????????????????????????天、時和分。即對應(yīng)的格式如下：
??????????????????? 1)'.'yyyy-MM: 每月
??????????????????? 2)'.'yyyy-ww: 每周?
??????????????????? 3)'.'yyyy-MM-dd: 每天
??????????????????? 4)'.'yyyy-MM-dd-a: 每天兩次
??????????????????? 5)'.'yyyy-MM-dd-HH: 每小時
??????????????????? 6)'.'yyyy-MM-dd-HH-mm: 每分鐘
??????????? 4.RollingFileAppender 選項
????????????????????Threshold=WARN:指定日志消息的輸出最低層次。
????????????????????ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
??????????????????? File=mylog.txt:指定消息輸出到mylog.txt文件。
??????????????????? Append=false:默認(rèn)值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內(nèi)容。
??????????????????? MaxFileSize=100KB: 后綴可以是KB, MB 或者是 GB. 在日志文件到達(dá)該大小時，將會自動滾動，即將原來
??????????????? ????的內(nèi)容移到mylog.log.1文件。
??????????????????? MaxBackupIndex=2:指定可以產(chǎn)生的滾動文件的最大數(shù)。

實際應(yīng)用：
　　 log4j.appender.A1=org.apache.log4j.ConsoleAppender //這里指定了日志輸出的第一個位置A1是控制臺ConsoleAppender

╭=========================================╮
??? 青山不改 綠水長流http://blog.csdn.net/wangyihust
????? 歡迎各位轉(zhuǎn)貼，但需聲明版權(quán)，尊重技術(shù)原創(chuàng)性 :)
?????? E-mail:wangyihust@163.com??? OICQ:76406573???
╰=========================================╯
　　
　　 3、配置日志信息的格式，其語法為：
　　 1).log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
???????????? ?"fully.qualified.name.of.layout.class" 可以指定下面4個格式中的一個：
?????????????? 1.org.apache.log4j.HTMLLayout（以HTML表格形式布局），
　　 ?????? 2.org.apache.log4j.PatternLayout（可以靈活地指定布局模式），
　　 ?????? 3.org.apache.log4j.SimpleLayout（包含日志信息的級別和信息字符串），
　　 ?????? 4.org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時間、線程、類別等等信息）
?????????????????? 1.HTMLLayout 選項
????????????????????? LocationInfo=true:默認(rèn)值是false,輸出java文件名稱和行號
????????????????????? Title=my app file: 默認(rèn)值是 Log4J Log Messages.
???????????????????2.PatternLayout 選項
????????????????????? ConversionPattern=%m%n :指定怎樣格式化指定的消息。
?????????????????? 3.XMLLayout? 選項
????????????????????? LocationInfo=true:默認(rèn)值是false,輸出java文件和行號
?? 實際應(yīng)用：
?? 　　log4j.appender.A1.layout=org.apache.log4j.PatternLayout

?????? 2). log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
?????????? 這里需要說明的就是日志信息格式中幾個符號所代表的含義：
　　 ???????? －X號: X信息輸出時左對齊；
?????????????????? %p: 輸出日志信息優(yōu)先級，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL,
?????????????????? %d: 輸出日志時間點的日期或時間，默認(rèn)格式為ISO8601，也可以在其后指定格式，
比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921
?????????????????? %r: 輸出自應(yīng)用啟動到輸出該log信息耗費(fèi)的毫秒數(shù)
?????????????????? %c: 輸出日志信息所屬的類目，通常就是所在類的全名
?????????????????? %t: 輸出產(chǎn)生該日志事件的線程名
?????????????????? %l: 輸出日志事件的發(fā)生位置，相當(dāng)于%C.%M(%F:%L)的組合,包括類目名、發(fā)生的線程，以及在代碼
中的行數(shù)。舉例：Testlog4.main(TestLog4.java:10)
?????????????????? %x: 輸出和當(dāng)前線程相關(guān)聯(lián)的NDC(嵌套診斷環(huán)境),尤其用到像java servlets這樣的多客戶多線程的應(yīng)用中。
?????????????????? %%: 輸出一個"%"字符
?????????????????? %F: 輸出日志消息產(chǎn)生時所在的文件名稱
???????????????????%L: 輸出代碼中的行號
?????????????????? %m: 輸出代碼中指定的消息,產(chǎn)生的日志具體信息
?????????????????? %n: 輸出一個回車換行符，Windows平臺為"\r\n"，Unix平臺為"\n"輸出日志信息換行
??????????? 可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如：
???????????????????? 1)%20c：指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，默認(rèn)的情況下右對齊。
???????????????????? 2)%-20c:指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，"-"號指定左對齊。
???????????????????? 3)%.30c:指定輸出category的名稱，最大的寬度是30，如果category的名稱大于30的話，就會將左邊
多出的字符截掉，但小于30的話也不會有空格。
???????????????????? 4)%20.30c:如果category的名稱小于20就補(bǔ)空格，并且右對齊，如果其名稱長于30字符，
就從左邊交遠(yuǎn)銷出的字符截掉。

　　這里上面三個步驟是對前面Log4j組件說明的一個簡化；下面給出一個具體配置例子，在程序中可以參照執(zhí)行：
　　 log4j.rootLogger=INFO,A1，B2
　　 log4j.appender.A1=org.apache.log4j.ConsoleAppender
　　 log4j.appender.A1.layout=org.apache.log4j.PatternLayout
　　 log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
?　　根據(jù)上面的日志格式，某一個程序的輸出結(jié)果如下：
　　 0　　INFO　2003-06-13 13:23:46968 ClientWithLog4j Client socket:
Socket[addr=localhost/127.0.0.1,port=8002,localport=2014]
???????? 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server says:
'Java server with log4j, Fri Jun 13 13:23:46 CST 2003'
　　 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j GOOD
　　 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Command 'HELLO' not understood.'
　　 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j HELP
　　 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j Server responds: 'Vocabulary: HELP QUIT'
　　 16　 DEBUG 2003-06-13 13:23:46984 ClientWithLog4j QUIT
?
????? 4. 當(dāng)輸出信息于回滾文件時

??????????log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender?? //指定以文件的方式輸出日志
???????????log4j.appender.ROLLING_FILE.Threshold=ERROR?
???????????log4j.appender.ROLLING_FILE.File=rolling.log? //文件位置,也可以用變量、rolling.log
???????????log4j.appender.ROLLING_FILE.Append=true?
???????????log4j.appender.ROLLING_FILE.MaxFileSize=10KB? //文件最大尺寸
???????????log4j.appender.ROLLING_FILE.MaxBackupIndex=1? //備份數(shù)
???????????log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout?
???????????log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n? 　　

???????? 5.Log4J對應(yīng)用性能的影響

???????? 如果在程序運(yùn)行中輸出大量日志，顯然會對應(yīng)用的性能造成一定的影響。Log4J對性能的影響取決于以下因素：

• 日志輸出目的地：輸出到控制臺的速度和輸出到文件系統(tǒng)的速度是不一樣的。
• 日志輸出格式：格式簡單，速度也更快。
• 日志級別：日志級別設(shè)置的越低，輸出的日志內(nèi)容越多，對性能的影響也越大。

log4j全能配置文件(轉(zhuǎn)自gmmgood)

?使用XML配置文件

首先，看看下面的XML配置文件示例：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
???????
? <appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
??? <layout class="org.apache.log4j.SimpleLayout"/>
? </appender>
? <root>
??? <priority value ="debug" />
??? <appender-ref ref="ConsoleAppender"/>
? </root>
</log4j:configuration>
???
?

文件以標(biāo)準(zhǔn)的XML聲明作為開始，后面跟著指出DTD（文檔類型定義）的DOCTYPE聲明，它定義了XML文件的結(jié)構(gòu)，
例如，什么元素可以嵌入在其他元素中等等。上面文件在log4j發(fā)行版的src/java/org/apache/log4j/xml目錄中。
接著看看封裝所有元素的 log4j:configuration 元素，它在DOCTYPE聲明中被指定為根元素。嵌入在根元素中有兩個結(jié)構(gòu)：

? <appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
??? <layout class="org.apache.log4j.SimpleLayout"/>
? </appender>?????
???
?

這里創(chuàng)建一個名叫"ConsoleAppender"的 Appender，注意，你可以選擇任何名字，該示例之所以選擇"ConsoleAppender"，
完全是為了示例的設(shè)計。接著這個appender類以全名形式給出，經(jīng)常用規(guī)范（fully qualified）類名。 Appender必須具有
一個指定的 name和class。嵌入在 Appender之內(nèi)的是 layout元素，這里它被指定為SimpleLayout。 Layout 必須具
有一個 class屬性。

? <root>
??? <priority value ="debug" />
??? <appender-ref ref="ConsoleAppender"/>
? </root>??????
???

root元素必須存在且不能被子類化。示例中的優(yōu)先級被設(shè)置為"debug"，設(shè)置appender飽含一個appender-ref元素。
還有更多的屬性或元素可以指定。查看log4j發(fā)行版中的src/java/org/apache/log4j/xml/log4j.dtd以了解關(guān)于XML配置
文件結(jié)構(gòu)的更多信息。可以用下面這種方法把配置信息文件讀入到Java程序中:

DOMConfigurator.configure("configurationfile.xml");???

DOMConfigurator 用一棵DOM樹來初始化log4j環(huán)境。這里是示例中的XML配置文件：configurationfile.xml。這里是
執(zhí)行該配置文件的java程序:

import org.apache.log4j.Logger;
import org.apache.log4j.xml.DOMConfigurator;
public class externalxmltest {
?? static Logger logger = Logger.getLogger(filetest.class);
?? public static void main(String args[]) {
????? DOMConfigurator.configure("xmllog4jconfig.xml");
????? logger.debug("Here is some DEBUG");
????? logger.info("Here is some INFO");
????? logger.warn("Here is some WARN");
????? logger.error("Here is some ERROR");
????? logger.fatal("Here is some FATAL");
?? }
}
???

對于帶有PatternLayout的FileAppender的日志記錄器Logger的XML配置文件:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
???????
? <appender name="appender" class="org.apache.log4j.FileAppender">
??? <param name="File" value="Indentify-Log.txt"/>
??? <param name="Append" value="true"/>
??? <layout class="org.apache.log4j.PatternLayout">
????? <param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
??? </layout>
? </appender>
? <root>
??? <priority value ="info"/>
??? <appender-ref ref="appender"/>
? </root>
</log4j:configuration>
???

?log4j日志寫入數(shù)據(jù)庫

首先創(chuàng)建一數(shù)據(jù)庫表:

log4j.properties如下配置:

log4j.rootLogger=DEBUG,CONSOLE,DATABASE

import sun.jdbc.odbc.*;
import java.sql.*;

import org.apache.log4j.Category;
import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
import org.apache.log4j.jdbc.*;

public class Write2Database{
? public static void main(String[] args){
??? static Logger logger = Logger.getLogger
??????????? ( write2database.class.getName () ) ;

??? PropertyConfigurator.configure ( "log4j2database.properties" ) ;

??? logger.info ( "test" ) ;
? }
}

運(yùn)行起來，你就會看到有這樣的sql語句被執(zhí)行了：
?????? INSERT INTO jws_log? VALUES ('2006-01-18 17:50:22', 'main', 'INFO',
'Wite2Database.main(Write2Database.java:18)', 'test', '')

注意 ：在賽迪論壇上有一個筆者按照上述類似的方法沒有運(yùn)行成功，現(xiàn)將他所出現(xiàn)的問題和解決方法轉(zhuǎn)載。

上述方法是利用傳統(tǒng)的數(shù)據(jù)庫連接方法，對于數(shù)據(jù)庫的管理和效率嚴(yán)重不足，在現(xiàn)在這個連接池橫行的時代,
為什么我們不能給給Log4j配上連接池，讓Log4j利用數(shù)據(jù)連接池的連接和數(shù)據(jù)庫進(jìn)行通訊。
現(xiàn)查看Log4j的Api,發(fā)現(xiàn)JDBCAppender這個類有以下幾段話：WARNING: This version of JDBCAppender is very
likely to be completely replaced in the future. Moreoever, it does not log exceptions. The JDBCAppender
provides for sending log events to a database.

For use as a base class:

• Override getConnection() to pass any connection you want. Typically this is used to enable
  application wide connection pooling.
• Override closeConnection(Connection con) -- if you override getConnection make sure to
  implement closeConnection to handle the connection you generated. Typically this would
  return the connection to the pool it came from.
• Override getLogStatement(LoggingEvent event) to produce specialized or dynamic statements.
  The default uses the sql option value.

原來log4j建議我們把其提供的JDBCAppender作為基類來使用，然后Override三個父類的方法：getConnection(),
closeConnection(Connection con)和getLogStatement(LoggingEvent event)。

原來如此，那就寫一個子類JDBCPoolAppender來替代這個JDBCAppender
　　
　　 JDBCPoolAppender代碼和其相關(guān)代碼如下：
　　
　　 JDBCPoolAppender.java:
　　
　　 package common.log;
　　 import java.sql.Connection;
　　 import org.apache.log4j.spi.LoggingEvent;
　　 import java.sql.SQLException;
　　 import java.sql.Statement;
　　 import java.util.Iterator;
　　 import org.apache.log4j.spi.ErrorCode;
　　 import org.apache.log4j.PatternLayout;
　　 import common.sql.MyDB;
　　 import common.sql.GeneralDb;
　　
　　 public class JDBCPoolAppender extends org.apache.log4j.jdbc.JDBCAppender {
　　
　　 private MyDB mydb = null;
　　 protected String sqlname=""; //增加一個數(shù)據(jù)庫jndiName的屬性
　　
　　 protected Connection connection = null;
　　 protected String sqlStatement = "";
　　 /**
　　 * size of LoggingEvent buffer before writting to the database.
　　 * Default is 1.
　　 */
　　 protected int bufferSize = 1;
　　
　　 public JDBCPoolAppender() {
　　 super();
　　 }
　　
　　 /**
　　 * ArrayList holding the buffer of Logging Events.
　　 */
　　 public void append(LoggingEvent event) {
　　 buffer.add(event);
　　 if (buffer.size() >= bufferSize)
　　 flushBuffer();
　　 }
　　
　　 /**
　　 * By default getLogStatement sends the event to the required Layout object.
　　 * The layout will format the given pattern into a workable SQL string.
　　 *
　　 * Overriding this provides direct access to the LoggingEvent
　　 * when constructing the logging statement.
　　 *
　　 */
　　 protected String getLogStatement(LoggingEvent event) {
　　 return getLayout().format(event);
　　 }
　　
　　 /**
　　 *
　　 * Override this to provide an alertnate method of getting
　　 * connections (such as caching).　One method to fix this is to open
　　 * connections at the start of flushBuffer() and close them at the
　　 * end.　I use a connection pool outside of JDBCAppender which is
　　 * accessed in an override of this method.
　　 * */
　　 protected void execute(String sql) throws SQLException {
　　 Connection con = null;
　　 Statement stmt = null;
　　 try {
　　 con = getConnection();
　　 stmt = con.createStatement();
　　 stmt.executeUpdate(sql);
　　 } catch (SQLException e) {
　　 if (stmt != null)
　　 stmt.close();
　　 throw e;
　　 }
　　 stmt.close();
　　 closeConnection(con);
　　 //System.out.println("Execute: " + sql);
　　 }
　　
　　 /**
　　 * Override this to return the connection to a pool, or to clean up the
　　 * resource.
　　 *
　　 * The default behavior holds a single connection open until the appender
　　 * is closed (typically when garbage collected).
　　 */
　　 protected void closeConnection(Connection con) {
　　 mydb=null;
　　 try {
　　 if (connection != null && !connection.isClosed())
　　 connection.close();
　　 } catch (SQLException e) {
　　 errorHandler.error("Error closing connection", e,
　　 ErrorCode.GENERIC_FAILURE);
　　 }
　　
　　 }
　　
　　 /**
　　 * Override 此函數(shù)來利用連接池返回一個Connetion對象
　　 *
　　 */
　　 protected Connection getConnection() throws SQLException {
　　 try {
　　 mydb = GeneralDb.getInstance(sqlname);
　　 connection = mydb.getConnection();
　　 } catch (Exception e) {
　　 errorHandler.error("Error opening connection", e, ErrorCode.GENERIC_FAILURE);
　　 }
　　 return connection;
　　 }
　　
　　 /**
　　 * Closes the appender, flushing the buffer first then closing the default
　　 * connection if it is open.
　　 */
　　 public void close() {
　　 flushBuffer();
　　
　　 try {
　　 if (connection != null && !connection.isClosed())
　　 connection.close();
　　 } catch (SQLException e) {
　　 errorHandler.error("Error closing connection", e,
　　 ErrorCode.GENERIC_FAILURE);
　　 }
　　 this.closed = true;
　　 }
　　
　　 /**
　　 * loops through the buffer of LoggingEvents, gets a
　　 * sql string from getLogStatement() and sends it to execute().
　　 * Errors are sent to the errorHandler.
　　 *
　　 * If a statement fails the LoggingEvent stays in the buffer!
　　 */
　　 public void flushBuffer() {
　　 //Do the actual logging
　　 removes.ensureCapacity(buffer.size());
　　 for (Iterator i = buffer.iterator(); i.hasNext(); ) {
　　 try {
　　 LoggingEvent logEvent = (LoggingEvent) i.next();
　　 String sql = getLogStatement(logEvent);
　　 execute(sql);
　　 removes.add(logEvent);
　　 } catch (SQLException e) {
　　 errorHandler.error("Failed to excute sql", e,
　　 ErrorCode.FLUSH_FAILURE);
　　 }
　　 }
　　
　　 // remove from the buffer any events that were reported
　　 buffer.removeAll(removes);
　　
　　 // clear the buffer of reported events
　　 removes.clear();
　　 }
　　
　　 /** closes the appender before disposal */
　　 public void finalize() {
　　 close();
　　 }
　　
　　 /**
　　 * JDBCAppender requires a layout.
　　 * */
　　 public boolean requiresLayout() {
　　 return true;
　　 }
　　
　　 /**
　　 *
　　 */
　　 public void setSql(String s) {
　　 sqlStatement = s;
　　 if (getLayout() == null) {
　　 this.setLayout(new PatternLayout(s));
　　 } else {
　　 ((PatternLayout) getLayout()).setConversionPattern(s);
　　 }
　　 }
　　
　　 /**
　　 * Returns pre-formated statement eg: insert into LogTable (msg) values ("%m")
　　 */
　　 public String getSql() {
　　 return sqlStatement;
　　 }
　　
　　 public void setSqlname(String sqlname){
　　 sqlname=sqlname;
　　 }
　　
　　 public String getSqlname(){
　　 return sqlname;
　　 }
　　
　　 public void setBufferSize(int newBufferSize) {
　　 bufferSize = newBufferSize;
　　 buffer.ensureCapacity(bufferSize);
　　 removes.ensureCapacity(bufferSize);
　　 }
　　
　　 public int getBufferSize() {
　　 return bufferSize;
　　 }
　　 }
　　
　　 MyDB.java:
　　 package common.sql;
　　 import java.sql.*;
　　 import com.codestudio.sql.*;　//引入開源項目Poolman數(shù)據(jù)庫連接池的包
　　
　　 public class MyDB {
　　 public static final String module = MyDB.class.getName();
　　 private String dbName = "";
　　 private PoolMan plmn = null;
　　
　　 public MyDB(String dbName) {
　　 try {
　　 if (plmn == null) {
　　 plmn = (PoolMan) Class.forName("com.codestudio.sql.PoolMan").
　　 newInstance();
　　 }
　　 } catch (Exception ec) {
　　 System.out.println(ec.toString()+module);
　　 }
　　 this.dbName = dbName;
　　 }
　　
　　 private Connection getNewConnection() {
　　 Connection conn = null;
　　 try {
　　 conn = plmn.connect("jdbc:poolman://" + dbName);
　　 conn.setAutoCommit(true);
　　 } catch (Exception ec) {
　　 System.out.println(ec.toString()+"First:Connect sqlsever failed"+module);
　　 try {
　　 Thread.sleep(1000);
　　 conn = plmn.connect("jdbc:poolman://" + dbName);
　　 conn.setAutoCommit(true);
　　 } catch (Exception ecs) {
　　 System.out.println(ecs.toString()+"Again:Connect sqlsever faile"+module);
　　 }
　　 }
　　 return conn;
　　 }
　　
　　 public Connection getConnection() {
　　 return getNewConnection();
　　 }
　　 }
　　 GeneralDb.java:
　　
　　 package common.sql;
　　
　　 package common.sql;
　　 import java.util.*;
　　
　　 public class GeneralDb {
　　 private static Hashtable dbPool;
　　 public static MyDB getInstance(String dbname) {
　　 if (dbPool == null) {
　　 dbPool = new Hashtable();
　　 }
　　 MyDB db = (MyDB) dbPool.get(dbname);
　　 if (db == null) {
　　 db = new MyDB(dbname);
　　 dbPool.put(dbname, db);
　　 }
　　 return db;
　　 }
　　 }
　　
　　 Log4j數(shù)據(jù)庫連接池的配置如下：
　　 log4j.appender.JDBC=common.log.JDBCPoolAppender
　　 log4j.appender.JDBC.sqlname=log
　　 log4j.appender.JDBC.layout=org.apache.log4j.PatternLayout
　　 log4j.appender.JDBC.sql=INSERT INTO LOGGING (log_date, log_level,
location, message) VALUES ('%d{ISO8601}', '%-5p', '%C,%L', '%m')
　　
　　 poolman.xml配置如下：
　　
　　 〈?xml version="1.0" encoding="UTF-8"?>
　　 〈poolman>
　　 〈management-mode>local〈/management-mode>
　　 〈datasource>
　　 〈dbname>log〈/dbname>
　　 〈jndiName>log〈/jndiName>
　　 〈driver>com.mysql.jdbc.Driver〈/driver>
　　 〈url>jdbc:mysql://localhost:3306/test〈/url>
　　 〈username>use〈/username>
　　 〈password>password〈/password>
　　 〈minimumSize>0〈/minimumSize>
　　 〈maximumSize>10〈/maximumSize>
　　 〈logFile>logs/mysql.log〈/logFile>
　　 〈/datasource>　　
　　 〈/poolman>

?? 運(yùn)行成功！對于JDBCPoolAppender的屬性（比如sqlname屬性）我們可以利用Log4j的反射機(jī)
制隨便添加，只要在配置文件給其附上值即可應(yīng)用，而原來的父類里面的一些屬性（username
什么的)和其get,set方法由于在連接池中不需要，所以刪除。而在JDBCPoolAppender類中，我也
只是將getConnection 方法Override ，在這個方法中我們可以根據(jù)需要生成我們的Connection
對象，另外兩個方法大家可以根據(jù)需求來決定怎樣Override。

?Log4Net? for .net framework

???? 等待研究 ?

?????? 用戶可以從http://logging.apache.org/log4net/下載log4net的源代碼。解壓軟件包后，在解壓的src目錄
下將log4net.sln載入Visual Studio .NET，編譯后可以得到log4net.dll。用戶要在自己的程序里加入日志功能，
只需將log4net.dll引入工程即可。??

hibernate中session.delete(sql),3.1與2.0的區(qū)別,導(dǎo)致的錯誤

今天使用session.delete(sql);報下面的錯誤:

?

org.hibernate.MappingException: Unknown entity: java.lang.String
?at org.hibernate.impl.SessionFactoryImpl.getEntityPersister(SessionFactoryImpl.java:569)
?at org.hibernate.impl.SessionImpl.getEntityPersister(SessionImpl.java:1086)
?at org.hibernate.event.def.DefaultDeleteEventListener.onDelete(DefaultDeleteEventListener.java:63)
?at org.hibernate.impl.SessionImpl.delete(SessionImpl.java:579)

?

查查終于知道原因:

?

??? session.delete(sql)是2.0的接口,3.1中已經(jīng)廢棄,同時廢棄的有:
??? find()、iterate()、filter()和delete(String?hqlSelectQuery),saveOrUpdateCopy()

?

? 如果要使用的話,可以采用以下方式創(chuàng)建Session實例：?

????? org.hibernate.classic.Session?session=sessionFactory.openSession();?

?

??????org.hibernate.classic.Session保留了2.0的接口

?

下面是3.1的reference里面這樣寫的,我使用了,但是還是報錯,郁悶:

?

1) Hibernate3.0執(zhí)行批量刪除的程序代碼：?
Session?session?=?sessionFactory.openSession();?
Transaction?tx?=?session.beginTransaction();?
String?hqlDelete?=?"delete?Customer?where?name?=?:oldName";?
int?deletedEntities?=?s.createQuery(?hqlDelete?)?
.setString(?"oldName",?oldName?)?
.executeUpdate();?
tx.commit();?
session.close();

?

2)Hibernate3.0執(zhí)行批量更新的程序代碼：?
Session?session?=?sessionFactory.openSession();?
Transaction?tx?=?session.beginTransaction();?
String?hqlUpdate?=?"update?Customer?set?name?=?:newName?where?name?=?:oldName";?
int?updatedEntities?=?s.createQuery(?hqlUpdate?)?
.setString(?"newName",?newName?)?
.setString(?"oldName",?oldName?)?
.executeUpdate();?
tx.commit();?
session.close();?

?

我按照上面的寫法,運(yùn)行后報錯如下:

org.hibernate.QueryException: query must begin with SELECT or FROM: delete [delete Resource r where r.nodeId=:nodeId and r.devId is not null ]
?at org.hibernate.hql.classic.ClauseParser.token(ClauseParser.java:83)
?at org.hibernate.hql.classic.PreprocessingParser.token(PreprocessingParser.java:108)
?at org.hibernate.hql.classic.ParserHelper.parse(ParserHelper.java:28)
?at org.hibernate.hql.classic.QueryTranslatorImpl.compile(QueryTranslatorImpl.java:176)
?at org.hibernate.hql.classic.QueryTranslatorImpl.compile(QueryTranslatorImpl.java:152)
?at org.hibernate.impl.SessionFactoryImpl.getQuery(SessionFactoryImpl.java:427)
?at org.hibernate.impl.SessionImpl.getQueries(SessionImpl.java:884)
?at org.hibernate.impl.SessionImpl.executeUpdate(SessionImpl.java:865)
?at org.hibernate.impl.QueryImpl.executeUpdate(QueryImpl.java:89)

昨天的問題解決了

又把hibernate3的手冊仔細(xì)的看了一遍,確認(rèn)自己的寫法是沒錯的,然后又上hibernate的論壇,幾乎沒有人有我的這個問題,這才想到是不是同事在hibernate.hbm.xml中設(shè)置了什么參數(shù),使得我不能使用3.0的特性呢?

????? 看了,果真如此,郁悶哦~

???? 里面有一句:

???? <property name="hibernate.query.factory_class">org.hibernate.hql.classic.ClassicQueryTranslatorFactory</property>

???? 這樣就使用了2.0的接口.郁悶啊.

???? 把這句去掉就OK了.

?

???? 附:

????? 因為使用了中文拼裝的hql后,中文會變成問號,大致如下:

?

????? String hql="from user u where u.name like %"+userName+"%";

?

????? 3.0版本是:

????? Query query = session.createQuery("from user u where u.name like :username").setString("username",userName);

現(xiàn)在要通過一個主鍵id去數(shù)據(jù)庫中刪除對應(yīng)的一條記錄，我該怎樣做？如果是將參數(shù)delId傳遞進(jìn)來的話，那該怎么處理？ 我這樣做的，但是報了錯 public void delfun(String delId) throws DatastoreException { Session session = HibernateUtil.getSession(); Transaction tx = null; try{ tx = session.beginTransaction(); Info info = (Info)session.load(Info.class,id); //出錯行 session.delete(delId); tx.commit(); } catch(Exception ex) { HibernateUtil.rollbackTransaction(tx); throw DatastoreException.datastoreError(ex); } finally { HibernateUtil.closeSession(session); } } 錯誤信息為： com.framework.exceptions.DatastoreException.datastoreError(DatastoreException.java:28) com.service.NpisServiceImpl.delGyinfo(NpisServiceImpl.java:131)

	回復(fù)人：pdvv(我愛花貓)	2006-3-1 17:32:22	得分:0
?	你給出的異常應(yīng)該屬于你自己框架的信息吧，沒有多少參考價值。 使用Session.load()要確保數(shù)據(jù)一定存在，還是用get()吧； 或者直接session.delete("from INFO where ID = 1");
Top

	回復(fù)人：yuanjian0211(元劍)	2006-3-1 17:46:04	得分:0
?	錯誤提示信息為： Hibernate: select gyinfo0_.id as id0_, info0_.userid as userid0_, info0_.tit le as title0_,info0_.descript as descript0_ from Info info0_ where info0_.id=? 請指點
Top

	回復(fù)人：yuanjian0211(元劍)	2006-3-1 17:56:29	得分:0
?	id在數(shù)據(jù)庫表中為bigint型 在對象中為long型
Top

	回復(fù)人：iori_powermax()	2006-03-02 01:06:00	得分:0
?	我也在學(xué)習(xí)hibernate,不知道說的對不對. 你刪除的應(yīng)該是整個對象,而不是一個id,所以應(yīng)該為: Info info = (Info)session.load(Info.class,id); session.delete(info); 或者還有一種刪除記錄的方法: info=(Info)sn.creatQuery("from Info as a where a.ID= '"+delId+"'").uniqueResult(); sn.delete(info); 另外想問一下大家: hibernate的creatSQLQuery()是不是只支持查詢?好象增刪改都不可以
Top

	回復(fù)人：ymfhcn(這痞子真帥)	2006-03-02 08:06:00	得分:0
?	creatSQLQuery()是執(zhí)行sql語句的，不過稍微有些改動，里面什么SQL語句都可以寫 ?| = | 一般分類 | 仙俠修真 | VBScript | .NET | 面試題 | 存儲過程 | Hibernate | JavaScript | J2EE | Struts 自我介紹 我選擇，所以我自由！ 切換風(fēng)格 布局：選擇頁面布局兩欄左側(cè)導(dǎo)航（缺省）兩欄右側(cè)導(dǎo)航三欄 配色：選擇配色方案純凈藍(lán)灰（缺省）浪漫紫清爽綠海藍(lán)粉紅 提示點擊帶有"..."標(biāo)記的欄目可以展開/收攏相應(yīng)的欄目 展開所有 收攏所有 訂閱我的Blog 博客日歷 ? 八月 2006 ? 一 二 三 四 五 六 日 ? 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 ? ? ? 文章歸檔... 八月 2006(1篇) 七月 2006(3篇) 六月 2006(2篇) 五月 2006(5篇) 四月 2006(16篇) 三月 2006(6篇) 最新發(fā)表... 關(guān)閉窗口的好方法！ 顯示格式為：XX月XX日－XX月XX日（前一個為上周六，后一個為本周五） 修改Web.Config文件的函數(shù)(vb.net) VBScript得到本周的周末日期函數(shù) 給定一個日期，計算此日期是一年中的第幾周！ javascript中parseInt的問題 利用javascript得到上周或下周的日期 如何得到前幾天的日期 侯捷觀點:Java反射機(jī)制[轉(zhuǎn)載] 讓JSP頁面不緩存[設(shè)置JSP頁面立即過期] 博客統(tǒng)計... 總文章數(shù): 33 總評論數(shù): 16 總引用數(shù): 0 總瀏覽數(shù): 2744 網(wǎng)站鏈接... J2EE J2EE&JAVA FAQ 資源 Powered by: Blog Provider: Designed by: =========================================================== Hibernate 的 session.delete(obj =========================================================== 作者: iceling2008(http://iceling2008.itpub.net) 發(fā)表于:2006.03.30 16:33 分類: Hibernate 出處：http://iceling2008.itpub.net/post/13270/64328 --------------------------------------------------------------- session.delete(obj)將obj的狀態(tài)變?yōu)閠ransient。兩種情況 1）obj是session的cache里邊的cache沒有的，比如： session.delete(new Employee(4)); 2）obj存在于session的cache中，比如： Employee employee = (Employee)session.load(Employee.class, new Integer(4)); session.delete(employee); 這兩種情況都是允許的，hibernate都會發(fā)送一條delete語句給數(shù)據(jù)庫。 delete執(zhí)行之后，如果調(diào)用了session.load(), 又可以分為兩種情況：1）在session.flush()之前，如： tx.beginTransaction(); 　　　 session.delete(new Employee(4)); session.load(Employee.class, new Integer(4));//發(fā)生在session.flush()之前 tx.commit(); 那么hibernate會拋出ObjectDeletedException:The object with that id was deleted: 2）在session.flush()之后，如： tx.beginTransaction(); 　　　 session.delete(new Employee(4)); session.load(Employee.class, new Integer(4)); tx.commit(); tx.beginTransaction(); session.load(Employee.class, new Integer(4));//同一個session中，上面的tx.commit()將session flush了一次。 tx.commit(); 那么這個時候hibernate僅僅會拋出ObjectNotFoundException:No row with the give... 表示找不到該object。如果第二個tx里邊采用session.get()也就不會拋出exception了。 delete執(zhí)行之后，如果調(diào)用了session.save(obj): tx.beginTransaction(); Employee employee = (Employee)session.load(Employee.class, new Integer(4)); 　　　 session.delete(employee); System.out.println(employee); session.save(employee); System.out.println(employee); tx.commit(); 這種情況是完全合理的，合法的。 delete將employee從persistent的狀態(tài)變?yōu)閠ransient的狀態(tài)。 save將employee從transient狀態(tài)變?yōu)閜ersistent的狀態(tài)。save一個被delete的obj的時候，在save處hibernate強(qiáng)制執(zhí)行session.flush()，發(fā)送delete語句，然后按照常規(guī)的save流程來進(jìn)行。為什么要這么做，還沒有完全想明白。 delete執(zhí)行之后，如果對obj對象屬性的修改，tx.commit()時不會進(jìn)行dirtyChecking。 這個道理比較顯然。 - 作者： HairRoot 2005年05月

高級 DAO 編程 學(xué)習(xí)編譯更好的 DAO 的技巧

文檔選項 將此頁作為電子郵件發(fā)送 未顯示需要 JavaScript 的文檔選項 最新推薦 Java 應(yīng)用開發(fā)源動力 － 下載免費(fèi)軟件，快速啟動開發(fā)

級別: 初級

Sean C. Sullivan , 軟件工程師

2003 年 10 月 15 日

J2EE 開發(fā)人員使用數(shù)據(jù)訪問對象(Data Access Object DAO)設(shè)計模式，以便將低級別的數(shù)據(jù)訪問邏輯與高級別的業(yè)務(wù)邏輯分離。實現(xiàn) DAO 模式涉及比編寫數(shù)據(jù)訪問代碼更多的內(nèi)容。在本文中，Java 開發(fā)人員 Sean C. Sullivan 討論了 DAO 編程中三個常常被忽略的方面：事務(wù)界定、異常處理和日志記錄。

在過去 18 個月中，我參加了一個由有才華的軟件工程師組成的小組，構(gòu)建定制的、基于 Web 的供應(yīng)鏈管理應(yīng)用程序。我們的應(yīng)用程序訪問范圍廣泛的持久性數(shù)據(jù)，包括配送狀態(tài)、供應(yīng)鏈衡量(metrics)、庫存、貨運(yùn)發(fā)票、項目管理數(shù)據(jù)和用戶信息。我們用 JDBC API 連接到我們公司的不同數(shù)據(jù)庫平臺上，并在整個應(yīng)用程序中使用 DAO 設(shè)計模式。

圖 1 顯示了應(yīng)用程序和數(shù)據(jù)源之間的關(guān)系：

在整個應(yīng)用程序中使用數(shù)據(jù)訪問對象(DAO)使我們可以將底層數(shù)據(jù)訪問邏輯與業(yè)務(wù)邏輯分離開來。我們構(gòu)建了為每一個數(shù)據(jù)源提供 GRUD (創(chuàng)建、讀取、更新、刪除)操作的 DAO 類。

在本文中，我將為您介紹構(gòu)建更好的 DAO 類的 DAO 實現(xiàn)策略和技術(shù)。更確切地說，我將討論日志、異常處理和事務(wù)界定。您將學(xué)到如何將這三者結(jié)合到自己的 DAO 類中。本文假定您熟悉 JDBC API、SQL 和關(guān)系數(shù)據(jù)庫編程。

我們將以對 DAO 設(shè)計模式和數(shù)據(jù)訪問對象的概述開始。

DAO基礎(chǔ)

DAO 模式是標(biāo)準(zhǔn) J2EE 設(shè)計模式之一。開發(fā)人員用這種模式將底層數(shù)據(jù)訪問操作與高層業(yè)務(wù)邏輯分離開。一個典型的 DAO 實現(xiàn)有以下組件：

• 一個 DAO 工廠類
• 一個 DAO 接口
• 一個實現(xiàn)了 DAO 接口的具體類
• 數(shù)據(jù)傳輸對象(有時稱為值對象)

具體的 DAO 類包含訪問特定數(shù)據(jù)源的數(shù)據(jù)的邏輯。在下面一節(jié)中您將學(xué)習(xí)設(shè)計和實現(xiàn)數(shù)據(jù)訪問對象的技術(shù)。有關(guān) DAO 設(shè)計模式的更多內(nèi)容請參閱 參考資料。

回頁首

事務(wù)界定

關(guān)于 DAO 要記住的重要一點是它們是事務(wù)性對象。由 DAO 所執(zhí)行的每一個操作 -- 如創(chuàng)建、更新或者刪除數(shù)據(jù) -- 都與一個事務(wù)相關(guān)聯(lián)。因此， 事務(wù)界定的概念就變得特別重要了。

事務(wù)界定是定義事務(wù)邊界的方式。J2EE 規(guī)范描述了兩種事務(wù)界定的模型：編程式(programmatic)和聲明式(declarative)。表 1 分析了這兩種模型：

表 1. 兩種事務(wù)界定的模型

我們將側(cè)重于編程式事務(wù)界定。

設(shè)計考慮

如前所述，DAO 是事務(wù)性對象。一個典型的 DAO 執(zhí)行像創(chuàng)建、更新和刪除這樣的事務(wù)性操作。在設(shè)計 DAO 時，首先要問自己以下問題：

• 事務(wù)要如何開始？
• 事務(wù)應(yīng)如何結(jié)束？
• 哪一個對象將負(fù)責(zé)開始一個事務(wù)？
• 哪一個對象將負(fù)責(zé)結(jié)束一個事務(wù)？
• DAO 是否要負(fù)責(zé)事務(wù)的開始和結(jié)束？
• 應(yīng)用程序是否需要通過多個 DAO 訪問數(shù)據(jù)？
• 事務(wù)涉及到一個 DAO 還是多個 DAO？
• 一個 DAO 是否調(diào)用另一個 DAO 的方法？

了解上述問題的答案將有助于您選擇最適合的 DAO 的事務(wù)界定策略。在 DAO 中有兩種主要的界定事務(wù)的策略。一種方式是讓 DAO 負(fù)責(zé)界定事務(wù)，另一種將事務(wù)界定交給調(diào)用這個 DAO 方法的對象處理。如果選擇了前一種方式，那么就將事務(wù)代碼嵌入到 DAO 中。如果選擇后一種方式，那么事務(wù)界定代碼就是在 DAO 類外面。我們將使用簡單的代碼示例幫助您更好理解每一種方式是如何工作的。

清單 1 顯示了一個有兩種數(shù)據(jù)操作的 DAO：創(chuàng)建和更新：

												
														       public void createWarehouseProfile(WHProfile profile);
       public void updateWarehouseStatus(WHIdentifier id, StatusInfo status);

												
										

清單 2 顯示了一個簡單的事務(wù)。事務(wù)界定在 DAO 類外面。注意在這個例子中調(diào)用者是如何在一個事務(wù)中結(jié)合多個 DAO 操作的。

												
														      tx.begin();    // start the transaction
      dao.createWarehouseProfile(profile);
      dao.updateWarehouseStatus(id1, status1);
      dao.updateWarehouseStatus(id2, status2);
      tx.commit();   // end the transaction

												
										

這種事務(wù)界定策略對于需要在一個事務(wù)中訪問多個 DAO 的應(yīng)用程序特別有用。

可以用 JDBC API 或者 Java 事務(wù) API(Java Transaction API JTA)實現(xiàn)事務(wù)界定。 JDBC 事務(wù)界定比 JTA 事務(wù)界定要簡單，但是 JTA 提供了更多的靈活性。在下面一節(jié)中我將更深入地分析事務(wù)界定的機(jī)制。

回頁首

用 JDBC 進(jìn)行事務(wù)界定

JDBC 事務(wù)是用 Connection 對象控制的。JDBC Connection 接口( java.sql.Connection )提供了兩種事務(wù)模式：自動提交和手工提交。 java.sql.Connection 提供了以下控制事務(wù)的方法：

• public void setAutoCommit(boolean)
• public boolean getAutoCommit()
• public void commit()
• public void rollback()

清單 3 顯示了如何用 JDBC API 界定一個事務(wù)：

												
														      import java.sql.*;
      import javax.sql.*;

      // ...
      DataSource ds = obtainDataSource();
      Connection conn = ds.getConnection();
      conn.setAutoCommit(false);
      // ...
      pstmt = conn.prepareStatement("UPDATE MOVIES ...");
      pstmt.setString(1, "The Great Escape");
      pstmt.executeUpdate();
      // ...
      conn.commit();
      // ...

												
										

使用 JDBC 事務(wù)界定時，您可以將多個 SQL 語句結(jié)合到一個事務(wù)中。JDBC 事務(wù)的一個缺點是事務(wù)的范圍局限于一個數(shù)據(jù)庫連接。一個 JDBC 事務(wù)不能跨越多個數(shù)據(jù)庫。在下面，我們將看一下如何用 JTA 進(jìn)行事務(wù)界定。因為 JTA 不像 JDBC 那樣有名，所以我們首先做一個簡介。

回頁首

JTA簡介

Java 事務(wù) API(JTA) 及其同門兄弟 Java 事務(wù)服務(wù)(Java Transaction Service JTS)為 J2EE 平臺提供了分布式事務(wù)服務(wù)。一個 分布式的事務(wù)涉及一個事務(wù)管理器和一個或者多個資源管理器。一個 資源管理器是任何類型的持久性的數(shù)據(jù)存儲。事務(wù)管理器負(fù)責(zé)協(xié)調(diào)所有事務(wù)參與者之間的通信。事務(wù)管理器與資源管理器之間的關(guān)系如圖 2 所示：

JTA 事務(wù)比 JDBC 事務(wù)功能更強(qiáng)。JDBC 事務(wù)局限為一個數(shù)據(jù)庫連接，而 JTA 事務(wù)可以有多個參與者。所有下列 Java 平臺組件都可以參與 JTA 事務(wù)：

• JDBC 連接
• JDO PersistenceManager 對象
• JMS 隊列
• JMS 主題
• 企業(yè) JavaBeans
• 符合 J2EE 連接體系結(jié)構(gòu)(J2EE Connector Architecture)規(guī)范的資源適配器

回頁首

使用 JTA 的事務(wù)界定

要用 JTA 進(jìn)行事務(wù)界定，應(yīng)用程序要調(diào)用 javax.transaction.UserTransaction 接口中的方法。清單 4 顯示了對 UserTransaction 對象的典型 JNDI 查詢：

												
														      import javax.transaction.*;
      import javax.naming.*;
      // ...
      InitialContext ctx = new InitialContext();
      Object txObj = ctx.lookup("java:comp/UserTransaction");
      UserTransaction utx = (UserTransaction) txObj;


												
										

當(dāng)應(yīng)用程序找到了 UserTransaction 對象后，就可以開始事務(wù)了，如清單 5 所示：

												
														      utx.begin();
      // ...
      DataSource ds = obtainXADataSource();
      Connection conn = ds.getConnection();
      pstmt = conn.prepareStatement("UPDATE MOVIES ...");
      pstmt.setString(1, "Spinal Tap");
      pstmt.executeUpdate();
      // ...
      utx.commit();
      // ...


												
										

當(dāng)應(yīng)用程序調(diào)用 commit() 時，事務(wù)管理器用一個兩階段的提交協(xié)議結(jié)束事務(wù)。

回頁首

控制事務(wù)的 JTA 方法

javax.transaction.UserTransaction 接口提供了以下事務(wù)控制方法：

• public void begin()
• public void commit()
• public void rollback()
• public int getStatus()
• public void setRollbackOnly()
• public void setTransactionTimeout(int)

應(yīng)用程序調(diào)用 begin() 開始事務(wù)。應(yīng)用程序調(diào)用 commit() 或者 rollback() 結(jié)束事務(wù)。參閱 參考資料以了解更多關(guān)于用 JTA 進(jìn)行事務(wù)管理的內(nèi)容。

回頁首

使用 JTA 和 JDBC

開發(fā)人員通常在 DAO 類中用 JDBC 進(jìn)行底層數(shù)據(jù)操作。如果計劃用 JTA 界定事務(wù)，那么就需要有一個實現(xiàn) javax.sql.XADataSource 、 javax.sql.XAConnection 和 javax.sql.XAResource 接口的 JDBC 驅(qū)動程序。一個實現(xiàn)了這些接口的驅(qū)動程序?qū)⒖梢詤⑴c JTA 事務(wù)。一個 XADataSource 對象就是一個 XAConnection 對象的工廠。 XAConnection s 是參與 JTA 事務(wù)的 JDBC 連接。

您將需要用應(yīng)用服務(wù)器的管理工具設(shè)置 XADataSource 。從應(yīng)用服務(wù)器和 JDBC 驅(qū)動程序的文檔中可以了解到相關(guān)的指導(dǎo)。

J2EE 應(yīng)用程序用 JNDI 查詢數(shù)據(jù)源。一旦應(yīng)用程序找到了數(shù)據(jù)源對象，它就調(diào)用 javax.sql.DataSource.getConnection() 以獲得到數(shù)據(jù)庫的連接。

XA 連接與非 XA 連接不同。一定要記住 XA 連接參與了 JTA 事務(wù)。這意味著 XA 連接不支持 JDBC 的自動提交功能。同時，應(yīng)用程序一定不要對 XA 連接調(diào)用 java.sql.Connection.commit() 或者 java.sql.Connection.rollback() 。相反，應(yīng)用程序應(yīng)該使用 UserTransaction.begin()、UserTransaction.commit() 和 serTransaction.rollback() 。

回頁首

選擇最好的方式

我們討論了如何用 JDBC 和 JTA 界定事務(wù)。每一種方式都有其優(yōu)點，您需要決定哪一種最適合于您的應(yīng)用程序。

在最近的許多項目中，我們小組是用 JDBC API 進(jìn)事務(wù)界定來構(gòu)建 DAO 類的。這些 DAO 類可以總結(jié)如下：

• 事務(wù)界定代碼嵌入在 DAO 類中。
• DAO 類使用 JDBC API 進(jìn)行事務(wù)界定。
• 調(diào)用者不能界定事務(wù)。
• 事務(wù)范圍局限于單個 JDBC 連接。

JDBC 事務(wù)并不總是適合復(fù)雜的企業(yè)應(yīng)用程序。如果您的事務(wù)要跨越多個 DAO 或者多個數(shù)據(jù)庫，那么下列實現(xiàn)策略也許更合適：

• 事務(wù)用 JTA 界定。
• 事務(wù)界定代碼從 DAO 中分離出來。
• 調(diào)用者負(fù)責(zé)界定事務(wù)。
• DAO 加入一個全局事務(wù)。

JDBC 方式由于其簡單性而具有吸引力，JTA　方式提供了更大的靈活性。您所選擇的實現(xiàn)將取決于應(yīng)用程序的特定需求。

回頁首

日志記錄和 DAO

一個良好實現(xiàn)的 DAO 類將使用日志記錄來捕捉有關(guān)其運(yùn)行時行為的細(xì)節(jié)。您可以選擇記錄異常、配置信息、連接狀態(tài)、JDBC 驅(qū)動程序元數(shù)據(jù)、或者查詢參數(shù)。日志對于開發(fā)的所有階段都很有用。我經(jīng)常在開發(fā)時、測試時和生產(chǎn)中分析應(yīng)用程序日志。

在本節(jié)，我將展示一個顯示如何將 Jakarta Commons Logging 加入到 DAO 中的代碼示例。在這之前，讓我們回顧一下一些基本知識。

選擇日志庫

許多開發(fā)人員使用一種原始格式進(jìn)行日志記錄： System.out.println 和 System.err.println 。 Println 語句速度快且使用方便，但是它們沒有提供全功能的日志記錄系統(tǒng)所具有的功能。表 2 列出了 Java 平臺的日志庫：

表 2. Java 平臺的日志庫

Jakarta Commons Logging 可以與 java.util.logging 或者 Jakarta Log4j 一同使用。Commons Logging 是一個日志抽象層，它隔離了應(yīng)用程序與底層日志實現(xiàn)。使用 Commons Logging，您可以通過改變配置文件更換底層日志實現(xiàn)。Commons Logging 在 Jakarta Struts 1.1 和 Jakarta HttpClient 2.0 中使用。

一個日志記錄示例

清單 7 顯示了如何在 DAO 類中使用 Jakarta Commons Logging：

												
														import org.apache.commons.logging.*;

class DocumentDAOImpl implements DocumentDAO
{
      static private final Log log = LogFactory.getLog(DocumentDAOImpl.class);

      public void deleteDocument(String id)
      {
          // ...
          log.debug("deleting document: " + id);
          // ...
          try
          {
              // ... data operations ...
          }
          catch (SomeException ex)
          {
              log.error("Unable to delete document", ex);
              // ... handle the exception ...
	}
      }
}

												
										

日志記錄是所有任務(wù)關(guān)鍵型應(yīng)用程序的重要部分。如果在 DAO 中遇到故障，那么日志通常可以提供判斷出錯位置的最好信息。將日志加入到 DAO 可以保證您有機(jī)會進(jìn)行調(diào)試和故障排除。

回頁首

DAO 中的異常處理

我們討論過了事務(wù)界定和日志，現(xiàn)在對于如何在數(shù)據(jù)訪問對象上應(yīng)用它們有了更深入的理解。我們的第三個和最后一個討論議題是異常處理。遵從幾個簡單的異常處理指導(dǎo)可以使您的 DAO 更容易使用、更健壯及更易于維護(hù)。

在實現(xiàn) DAO 模式時，考慮以下問題：

• DAO 的公共接口中的方法是否拋出檢查過的異常？
• 如果是的話，拋出何種檢查過的異常？
• 在 DAO 實現(xiàn)類中如何處理異常？

在使用 DAO 模式的過程中，我們的小組開發(fā)了一些處理異常的原則。遵從這些原則可以極大地改進(jìn)您的 DAO：

• DAO 方法應(yīng)該拋出有意義的異常。
• DAO 方法不應(yīng)該拋出 java.lang.Exception 。 java.lang.Exception 太一般化了。它不傳遞關(guān)于底層問題的任何信息。
  
• DAO 方法不應(yīng)該拋出 java.sql.SQLException 。SQLException 是一個低級別的 JDBC 異常。一個 DAO 應(yīng)該力爭封裝 JDBC 而不是將 JDBC 公開給應(yīng)用程序的其余部分。
  
• 只有在可以合理地預(yù)期調(diào)用者可以處理異常時，DAO 接口中的方法才應(yīng)該拋出檢查過的異常。如果調(diào)用者不能以有意義的方式處理這個異常，那么考慮拋出一個未檢查的(運(yùn)行時)異常。
• 如果數(shù)據(jù)訪問代碼捕獲了一個異常，不要忽略它。忽略捕獲的異常的 DAO 是很難進(jìn)行故障診斷的。
• 使用鏈接的異常將低級別的異常轉(zhuǎn)化為高級別的異常。
• 考慮定義標(biāo)準(zhǔn) DAO 異常類。Spring Framework (參閱 參考資料)提供了很好的一套預(yù)定義的 DAO 異常類。

有關(guān)異常和異常處理技術(shù)的更多信息參閱 參考資料。

回頁首

實現(xiàn)實例： MovieDAO

MovieDAO 是一個展示本文中討論的所有技術(shù)的 DAO：事務(wù)界定、日志和異常處理。您可以在 參考資料一節(jié)中找到 MovieDAO 源代碼。代碼分為三個包：

• daoexamples.exception
• daoexamples.movie
• daoexamples.moviedemo

DAO 模式的這個實現(xiàn)包含下面列出的類和接口：

• daoexamples.movie.MovieDAOFactory
• daoexamples.movie.MovieDAO
• daoexamples.movie.MovieDAOImpl
• daoexamples.movie.MovieDAOImplJTA
• daoexamples.movie.Movie
• daoexamples.movie.MovieImpl
• daoexamples.movie.MovieNotFoundException
• daoexamples.movie.MovieUtil

MovieDAO 接口定義了 DAO 的數(shù)據(jù)操作。這個接口有五個方法，如下所示：

• public Movie findMovieById(String id)
• public java.util.Collection findMoviesByYear(String year)
• public void deleteMovie(String id)
• public Movie createMovie(String rating, String year, String, title)
• public void updateMovie(String id, String rating, String year, String title)

daoexamples.movie 包包含 MovieDAO 接口的兩個實現(xiàn)。每一個實現(xiàn)使用一種不同的方式進(jìn)行事務(wù)界定，如表 3 所示：

表 3. MovieDAO 實現(xiàn)

MovieDAO 演示應(yīng)用程序

這個演示應(yīng)用程序是一個名為 daoexamples.moviedemo.DemoServlet 的 servlet 類。 DemoServlet 使用這兩個 Movie DAO 查詢和更新表中的電影數(shù)據(jù)。

這個 servlet 展示了如何將支持 JTA 的 MovieDAO 和 Java 消息服務(wù)(Java Message Service)結(jié)合到一個事務(wù)中，如清單 8 所示。

												
															UserTransaction utx = MovieUtil.getUserTransaction();
	utx.begin();
	batman = dao.createMovie("R",
			"2008",
			"Batman Reloaded");
	publisher = new MessagePublisher();
	publisher.publishTextMessage("I'll be back");
	dao.updateMovie(topgun.getId(),
			"PG-13",
			topgun.getReleaseYear(),
			topgun.getTitle());
	dao.deleteMovie(legallyblonde.getId());
	utx.commit();

												
										

?當(dāng)前位置: 首頁 >> 數(shù)據(jù)庫 >> Oracle >> 我的權(quán)限控制(JBX + struts + hibernate + ORACLE)
?
我的權(quán)限控制(JBX + struts + hibernate + ORACLE)?

--------------------------------------------------------------------------------
?
作者：:???? 來源：???? 發(fā)表時間：2006-06-08???? 瀏覽次數(shù)：18??? 字號：大? 中? 小
　　
通過過濾器判斷用戶權(quán)限.
第一步:建立UserPermissionFilter類.

import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.util.*;

import test.system.SysUserApi;
import test.vo.SysUserVO;
import test.system.dao.SysUserDao;
import test.Const;

public class UserPermissionFilter extends HttpServlet implements Filter {

? protected FilterConfig filterConfig = null;

? public void destroy() {
??? this.filterConfig = null;
? }

? public void doFilter(
????? ServletRequest request,
????? ServletResponse response,
????? FilterChain filterChain) throws IOException, ServletException {
??? try {
????? HttpServletRequest req = (HttpServletRequest) request;
????? SysUserVO userSession = new SysUserVO();
????? userSession = (SysUserVO)req.getSession().getAttribute(Const.SESSION_USER);
????? if (userSession == null) {
??????? HttpServletResponse rep = (HttpServletResponse) response;

??????? rep.sendRedirect("/admin/login.jsp");
???????????? }else{
??????? filterChain.doFilter(request, response);
????? }
??? }
??? catch (Exception e) {}
? }
? public void init(FilterConfig filterConfig) throws ServletException {
??? this.filterConfig = filterConfig;
? }
? public FilterConfig getFilterConfig() {
??? return filterConfig;
? }

? public void setFilterConfig(FilterConfig filterConfig) {
??? this.filterConfig = filterConfig;
? }

}

第二步:配置WEB.xml文件
設(shè)置過濾器:
? <filter>
??? <filter-name>userpermission</filter-name>
??? <filter-class>sports.tools.UserPermissionFilter</filter-class>
? </filter>
設(shè)置過濾器映射,因為過濾器不能過濾全部的程序,所以可以用列表的形式來增加需要過濾的文件.如下.一個過濾器可以過濾多個映射文件.
? <filter-mapping>
??? <filter-name>userpermission</filter-name>
??? <url-pattern>/admin/index.jsp</url-pattern>
? </filter-mapping>

? <filter-mapping>
??? <filter-name>userpermission</filter-name>
??? <url-pattern>/admin/edit/*</url-pattern>
? </filter-mapping>
?
?
?
======================================
http://www.itwenzhai.com/data/2006/0608/article_22958.htm
=========================================
http://www.itwenzhai.com/data/2006/0626/article_25178.htm
=========================================

? 不重復(fù)DAO
===============

?

由于 Java? 5 泛型的采用，有關(guān)泛型類型安全 Data Access Object (DAO) 實現(xiàn)的想法變得切實可行。在本文中，系統(tǒng)架構(gòu)師 Per Mellqvist 展示了基于 Hibernate 的泛型 DAO 實現(xiàn)類。然后展示如何使用 Spring AOP introductions 將類型安全接口添加到類中以便于查詢執(zhí)行。
對于大多數(shù)開發(fā)人員，為系統(tǒng)中的每個 DAO 編寫幾乎相同的代碼到目前為止已經(jīng)成為一種習(xí)慣。雖然所有人都將這種重復(fù)標(biāo)識為 “代碼味道”，但我們大多數(shù)都已經(jīng)學(xué)會忍受它。其實有解決方案。可以使用許多 ORM 工具來避免代碼重復(fù)。例如，使用 Hibernate，您可以簡單地為所有的持久域?qū)ο笾苯邮褂脮挷僮鳌＿@種方法的缺點是損失了類型安全。

為什么您要為數(shù)據(jù)訪問代碼提供類型安全接口？我會爭辯說，當(dāng)它與現(xiàn)代 IDE 工具一起使用時，會減少編程錯誤并提高生產(chǎn)率。首先，類型安全接口清楚地指明哪些域?qū)ο缶哂锌捎玫某志么鎯ΑＦ浯危艘壮鲥e的類型強(qiáng)制轉(zhuǎn)換的需要（這是一個在查詢操作中比在 CRUD 中更常見的問題）。最后，它有效利用了今天大多數(shù) IDE 具備的自動完成特性。使用自動完成是記住什么查詢可用于特定域類的快捷方法。

在本文中，我將為您展示如何避免再三地重復(fù) DAO 代碼，而仍保留類型安全接口的優(yōu)點。事實上，您需要為每個新 DAO 編寫的只是 Hibernate 映射文件、無格式舊 Java 接口以及 Spring 配置文件中的 10 行。

DAO 實現(xiàn)

DAO 模式對任何企業(yè) Java 開發(fā)人員來說都應(yīng)該很熟悉。但是模式的實現(xiàn)各不相同，所以我們來澄清一下本文提供的 DAO 實現(xiàn)背后的假設(shè)：

系統(tǒng)中的所有數(shù)據(jù)庫訪問都通過 DAO 進(jìn)行以實現(xiàn)封裝。
每個 DAO 實例負(fù)責(zé)一個主要域?qū)ο蠡驅(qū)嶓w。如果域?qū)ο缶哂歇毩⑸芷冢鼞?yīng)具有自己的 DAO。
DAO 負(fù)責(zé)域?qū)ο蟮膭?chuàng)建、讀取（按主鍵）、更新和刪除（creations, reads, updates, and deletions，CRUD）。
DAO 可允許基于除主鍵之外的標(biāo)準(zhǔn)進(jìn)行查詢。我將之稱為查找器方法 或查找器。查找器的返回值通常是 DAO 負(fù)責(zé)的域?qū)ο蠹稀?
DAO 不負(fù)責(zé)處理事務(wù)、會話或連接。這些不由 DAO 處理是為了實現(xiàn)靈活性。
泛型 DAO 接口

泛型 DAO 的基礎(chǔ)是其 CRUD 操作。下面的接口定義泛型 DAO 的方法：

清單 1. 泛型 DAO 接口
public interface GenericDao <T, PK extends Serializable> {

??? /** Persist the newInstance object into database */
??? PK create(T newInstance);

??? /** Retrieve an object that was previously persisted to the database using
???? *?? the indicated id as primary key
???? */
??? T read(PK id);

??? /** Save changes made to a persistent object.? */
??? void update(T transientObject);

??? /** Remove an object from persistent storage in the database */
??? void delete(T persistentObject);
}

?

實現(xiàn)接口

用 Hibernate 實現(xiàn)清單 1 中的接口十分簡單，如清單 2 所示。它只需調(diào)用底層 Hibernate 方法和添加強(qiáng)制類型轉(zhuǎn)換。Spring 負(fù)責(zé)會話和事務(wù)管理。（當(dāng)然，我假設(shè)這些函數(shù)已做了適當(dāng)?shù)脑O(shè)置，但該主題在 Hibernate 和 Springt 手冊中有詳細(xì)介紹。）

清單 2. 第一個泛型 DAO 實現(xiàn)
public class GenericDaoHibernateImpl <T, PK extends Serializable>
??? implements GenericDao<T, PK>, FinderExecutor {
??? private Class<T> type;

??? public GenericDaoHibernateImpl(Class<T> type) {
??????? this.type = type;
??? }

??? public PK create(T o) {
??????? return (PK) getSession().save(o);
??? }

??? public T read(PK id) {
??????? return (T) getSession().get(type, id);
??? }

??? public void update(T o) {
??????? getSession().update(o);
??? }

??? public void delete(T o) {
??????? getSession().delete(o);
??? }

??? // Not showing implementations of getSession() and setSessionFactory()
??????????? }
?

Spring 配置

最后，在 Spring 配置中，我創(chuàng)建了 GenericDaoHibernateImpl 的一個實例。必須告訴 GenericDaoHibernateImpl 的構(gòu)造函數(shù) DAO 實例將負(fù)責(zé)哪個域類。只有這樣，Hibernate 才能在運(yùn)行時知道由 DAO 管理的對象類型。在清單 3 中，我將域類 Person 從示例應(yīng)用程序傳遞給構(gòu)造函數(shù)，并將先前配置的 Hibernate 會話工廠設(shè)置為已實例化的 DAO 的參數(shù)：

清單 3. 配置 DAO
<bean id="personDao" class="genericdao.impl.GenericDaoHibernateImpl">
??????? <constructor-arg>
??????????? <value>genericdaotest.domain.Person</value>
??????? </constructor-arg>
??????? <property name="sessionFactory">
??????????? <ref bean="sessionFactory"/>
??????? </property>
</bean>
????????
2。
我還沒有完成，但我所完成的確實已經(jīng)可以使用了。在清單 4 中，可以看到原封不動使用該泛型 DAO 的示例：

清單 4. 使用 DAO
public void someMethodCreatingAPerson() {
??? ...
??? GenericDao dao = (GenericDao)
???? beanFactory.getBean("personDao"); // This should normally be injected

??? Person p = new Person("Per", 90);
??? dao.create(p);
}
????????

?

現(xiàn)在，我有一個能夠進(jìn)行類型安全 CRUD 操作的泛型 DAO。讓子類 GenericDaoHibernateImpl 為每個域?qū)ο筇砑硬樵兡芰⒎浅：侠怼Ｒ驗楸疚牡哪康脑谟谡故救绾尾粸槊總€查詢編寫顯式的 Java 代碼來實現(xiàn)查詢，但是，我將使用其他兩個工具將查詢引入 DAO，也就是 Spring AOP 和 Hibernate 命名的查詢。

Spring AOP introductions

可以使用 Spring AOP 中的 introductions 將功能添加到現(xiàn)有對象，方法是將功能包裝在代理中，定義應(yīng)實現(xiàn)的接口，并將所有先前未支持的方法指派到單個處理程序。在我的 DAO 實現(xiàn)中，我使用 introductions 將許多查找器方法添加到現(xiàn)有泛型 DAO 類中。因為查找器方法是特定于每個域?qū)ο蟮模虼藢⑵鋺?yīng)用于泛型 DAO 的類型化接口。

Spring 配置如清單 5 所示：

清單 5. FinderIntroductionAdvisor 的 Spring 配置
<bean id="finderIntroductionAdvisor" class="genericdao.impl.FinderIntroductionAdvisor"/>

<bean id="abstractDaoTarget"
??????? class="genericdao.impl.GenericDaoHibernateImpl" abstract="true">
??????? <property name="sessionFactory">
??????????? <ref bean="sessionFactory"/>
??????? </property>
</bean>

<bean id="abstractDao"
??????? class="org.springframework.aop.framework.ProxyFactoryBean" abstract="true">
??????? <property name="interceptorNames">
??????????? <list>
??????????????? <value>finderIntroductionAdvisor</value>
??????????? </list>
??????? </property>
</bean>
????????

?

在清單 5 的配置文件中，我定義了三個 Spring bean。第一個 bean 是 FinderIntroductionAdvisor，它處理引入到 DAO 的所有方法，這些方法在 GenericDaoHibernateImpl 類中不可用。我稍后將詳細(xì)介紹 Advisor bean。

第二個 bean 是 “抽象的”。在 Spring 中，這意味著該 bean 可在其他 bean 定義中被重用，但不被實例化。除了抽象特性之外，該 bean 定義只指出我想要 GenericDaoHibernateImpl 的實例以及該實例需要對 SessionFactory 的引用。注意，GenericDaoHibernateImpl 類僅定義一個構(gòu)造函數(shù)，該構(gòu)造函數(shù)接受域類作為其參數(shù)。因為該 bean 定義是抽象的，所以我將來可以無數(shù)次地重用該定義，并將構(gòu)造函數(shù)參數(shù)設(shè)置為合適的域類。

最后，第三個也是最有趣的 bean 將 GenericDaoHibernateImpl 的 vanilla 實例包裝在代理中，賦予其執(zhí)行查找器方法的能力。該 bean 定義也是抽象的，不指定希望引入到 vanilla DAO 的接口。該接口對于每個具體的實例是不同的。注意，清單 5 顯示的整個配置僅定義一次。

3。

擴(kuò)展 GenericDAO

當(dāng)然，每個 DAO 的接口都基于 GenericDao 接口。我只需使該接口適應(yīng)特定的域類并擴(kuò)展該接口以包括查找器方法。在清單 6 中，可以看到為特定目的擴(kuò)展的 GenericDao 接口示例：

清單 6. PersonDao 接口
public interface PersonDao extends GenericDao<Person, Long> {
??? List<Person> findByName(String name);
}

?

?

很明顯，清單 6 中定義的方法旨在按名稱查找 Person。必需的 Java 實現(xiàn)代碼全部是泛型代碼，在添加更多 DAO 時不需要任何更新。

配置 PersonDao

因為 Spring 配置依賴于先前定義的 “抽象” bean，因此它變得相當(dāng)簡潔。我需要指出 DAO 負(fù)責(zé)哪個域類，并且需要告訴 Springs 該 DAO 應(yīng)實現(xiàn)哪個接口（一些方法是直接使用，一些方法則是通過使用 introductions 來使用）。清單 7 展示了 PersonDAO 的 Spring 配置文件：

清單 7. PersonDao 的 Spring 配置
<bean id="personDao" parent="abstractDao">
??? <property name="proxyInterfaces">
??????? <value>genericdaotest.dao.PersonDao</value>
??? </property>
??? <property name="target">
??????? <bean parent="abstractDaoTarget">
??????????? <constructor-arg>
??????????????? <value>genericdaotest.domain.Person</value>
??????????? </constructor-arg>
??????? </bean>
??? </property>
</bean>
????????

?

在清單 8 中，可以看到使用了這個更新后的 DAO 版本：

清單 8. 使用類型安全接口
public void someMethodCreatingAPerson() {
??? ...
??? PersonDao dao = (PersonDao)
???? beanFactory.getBean("personDao"); // This should normally be injected

??? Person p = new Person("Per", 90);
??? dao.create(p);

??? List<Person> result = dao.findByName("Per"); // Runtime exception
}
????????

?

雖然清單 8 中的代碼是使用類型安全 PersonDao 接口的正確方法，但 DAO 的實現(xiàn)并不完整。調(diào)用 findByName() 會導(dǎo)致運(yùn)行時異常。問題在于我還沒有實現(xiàn)調(diào)用 findByName() 所必需的查詢。剩下要做的就是指定查詢。為更正該問題，我使用了 Hibernate 命名查詢。

?

Hibernate 命名查詢

使用 Hibernate，可以在 Hibernate 映射文件 (hbm.xml) 中定義 HQL 查詢并為其命名。稍后可以通過簡單地引用給定名稱來在 Java 代碼中使用該查詢。該方法的優(yōu)點之一是能夠在部署時優(yōu)化查詢，而無需更改代碼。您一會將會看到，另一個優(yōu)點是無需編寫任何新 Java 實現(xiàn)代碼，就可以實現(xiàn) “完整的” DAO。清單 9 是帶有命名查詢的映射文件的示例：

清單 9. 帶有命名查詢的映射文件
?<hibernate-mapping package="genericdaotest.domain">
???? <class name="Person">
???????? <id name="id">
???????????? <generator class="native"/>
???????? </id>
???????? <property name="name" />
???????? <property name="weight" />
???? </class>

???? <query name="Person.findByName">
???????? <![CDATA[select p from Person p where p.name = ? ]]>
???? </query>
?</hibernate-mapping>
????????

?

清單 9 定義了域類 Person 的 Hibernate 映射，該域類具有兩個屬性：name 和 weight。Person 是具有上述屬性的簡單 POJO。該文件還包含一個在數(shù)據(jù)庫中查找 Person 所有實例的查詢，其中 “name” 等于提供的參數(shù)。Hibernate 不為命名查詢提供任何真正的名稱空間功能。出于討論目的，我為所有查詢名稱都加了域類的短（非限定）名稱作為前綴。在現(xiàn)實世界中，使用包括包名稱的完全類名可能是更好的主意。

?

逐步概述

您已經(jīng)看到了為任何域?qū)ο髣?chuàng)建和配置新 DAO 所必需的全部步驟。三個簡單的步驟是：

定義一個接口，它擴(kuò)展 GenericDao 并包含所需的任何查找器方法。
將每個查找器的命名查詢添加到域?qū)ο蟮?hbm.xml 映射文件。
為 DAO 添加 10 行 Spring 配置文件。
查看執(zhí)行查找器方法的代碼（只編寫了一次！）來結(jié)束我的討論。

4。

可重用的 DAO 類

使用的 Spring advisor 和 interceptor 很簡單，事實上它們的工作是向后引用 GenericDaoHibernateImplClass。方法名以 “find” 打頭的所有調(diào)用都傳遞給 DAO 和單個方法 executeFinder()。

清單 10. FinderIntroductionAdvisor 的實現(xiàn)
public class FinderIntroductionAdvisor extends DefaultIntroductionAdvisor {
??? public FinderIntroductionAdvisor() {
??????? super(new FinderIntroductionInterceptor());
??? }
}

public class FinderIntroductionInterceptor implements IntroductionInterceptor {

??? public Object invoke(MethodInvocation methodInvocation) throws Throwable {

??????? FinderExecutor genericDao = (FinderExecutor) methodInvocation.getThis();

??????? String methodName = methodInvocation.getMethod().getName();
??????? if (methodName.startsWith("find")) {
??????????? Object[] arguments = methodInvocation.getArguments();
??????????? return genericDao.executeFinder(methodInvocation.getMethod(), arguments);
??????? } else {
??????????? return methodInvocation.proceed();
??????? }
??? }

??? public boolean implementsInterface(Class intf) {
??????? return intf.isInterface() && FinderExecutor.class.isAssignableFrom(intf);
??? }
}
?

?

executeFinder() 方法

清單 10 的實現(xiàn)中惟一缺少的是 executeFinder() 實現(xiàn)。該代碼查看調(diào)用的類和方法的名稱，并使用配置上的約定將其與 Hibernate 查詢的名稱相匹配。還可以使用 FinderNamingStrategy 來支持其他命名查詢的方法。默認(rèn)實現(xiàn)查找叫做 “ClassName.methodName” 的查詢，其中 ClassName 是不帶包的短名稱。清單 11 完成了泛型類型安全 DAO 實現(xiàn)：

清單 11. executeFinder() 的實現(xiàn)
public List<T> executeFinder(Method method, final Object[] queryArgs) {
???? final String queryName = queryNameFromMethod(method);
???? final Query namedQuery = getSession().getNamedQuery(queryName);
???? String[] namedParameters = namedQuery.getNamedParameters();
???? for(int i = 0; i < queryArgs.length; i++) {
???????????? Object arg = queryArgs[i];
???????????? Type argType =? namedQuery.setParameter(i, arg);
????? }
????? return (List<T>) namedQuery.list();
?}

?public String queryNameFromMethod(Method finderMethod) {
???? return type.getSimpleName() + "." + finderMethod.getName();
?}
?

?

結(jié)束語

在 Java 5 之前，該語言不支持編寫既類型安全又 泛型的代碼，您必須只能選擇其中之一。在本文中，您已經(jīng)看到一個結(jié)合使用 Java 5 泛型與 Spring 和 Hibernate（以及 AOP）等工具來提高生產(chǎn)率的示例。泛型類型安全 DAO 類相當(dāng)容易編寫 —— 您只需要單個接口、一些命名查詢和為 Spring 配置添加的 10 行代碼 —— 而且可以極大地減少錯誤并節(jié)省時間。

幾乎本文的所有代碼都是可重用的。盡管您的 DAO 類可能包含此處沒有實現(xiàn)的查詢和操作類型（比如，批操作），但使用我所展示的技術(shù)，您至少應(yīng)該能夠?qū)崿F(xiàn)其中的一部分。參閱 參考資料 了解其他泛型類型安全 DAO 類實現(xiàn)。

致謝

自 Java 語言中出現(xiàn)泛型以來，單個泛型類型安全 DAO 的概念已經(jīng)成為主題。我曾在 JavaOne 2004 中與 Don Smith 簡要討論了泛型 DAO 的靈活性。本文使用的 DAO 實現(xiàn)類旨在作為示例實現(xiàn)，實際上還存在其他實現(xiàn)。例如，Christian Bauer 已經(jīng)發(fā)布了帶有 CRUD 操作和標(biāo)準(zhǔn)搜索的實現(xiàn)，Eric Burke 也在該領(lǐng)域做出了工作。我確信將會有更多的實現(xiàn)出現(xiàn)。我要額外感謝 Christian，他目睹了我編寫泛型類型安全 DAO 的第一次嘗試并提出改進(jìn)建議。最后，我要感謝 Ramnivas Laddad 的無價幫助，他審閱了本文。

?