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

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

問(wèn)題引入

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

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

package com.ccb.framework.enums;

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

public class CachingEnumResolver {
	//單態(tài)實(shí)例　一切問(wèn)題皆由此行引起
	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();
		//為了說(shuō)明問(wèn)題,我在這里初始化一條數(shù)據(jù)
		CODE_MAP_CACHE.put("0","北京市");
	}
	
	//private, for single instance
	private CachingEnumResolver() {
		//初始化加載數(shù)據(jù)  引起問(wèn)題，該方法也要負(fù)點(diǎn)責(zé)任
		initEnums();
	}
	
	/**
	 * 初始化所有的枚舉類型
	 */
	public static void initEnums() {		
		// ~~~~~~~~~問(wèn)題從這里開始暴露 ~~~~~~~~~~~//
		if (null == CODE_MAP_CACHE) {
			System.out.println("CODE_MAP_CACHE為空,問(wèn)題在這里開始暴露.");
			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)實(shí)例
	 * 
	 * @return
	 */
	public static CachingEnumResolver getInstance() {
		return SINGLE_ENUM_RESOLVER;
	}
	
	public static void main(String[] args) {
		System.out.println(CachingEnumResolver.getInstance().getCache());
	}
}

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

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

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

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

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

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

回頁(yè)首

類的生命周期

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

回頁(yè)首

類初始化

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

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

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

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

回頁(yè)首

對(duì)象初始化

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

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

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

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

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

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

回頁(yè)首

類的初始化時(shí)機(jī)

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

Java 虛擬機(jī)規(guī)范為類的初始化時(shí)機(jī)做了嚴(yán)格定義："initialize on first active use"--" 在首次主動(dòng)使用時(shí)初始化"。這個(gè)規(guī)則直接影響著類裝載、連接和初始化類的機(jī)制--因?yàn)樵陬愋捅怀跏蓟八仨氁呀?jīng)被連接，然而在連接之前又必須保證它已經(jīng)被裝載了。

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

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

首次主動(dòng)使用的情形：

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

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

回頁(yè)首

我的問(wèn)題究竟出在哪里

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

下面讓我們來(lái)看看前面[清單一]的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為空,問(wèn)題在這里開始暴露.
   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)容，可能這份清單對(duì)于很大部分兄弟來(lái)說(shuō)確實(shí)沒(méi)有多少吸引力，因?yàn)檫@些 JVM 指令確實(shí)不像源代碼那樣漂亮易懂。但它的的確確是查找和定位問(wèn)題最直接的辦法，我們想要的答案就在這份 JVM 指令清單里。

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

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

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

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

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

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

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

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

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

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

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

回頁(yè)首

如何解決

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

回頁(yè)首

寫在最后

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

	public class CachingEnumResolver {
	public  static Map CODE_MAP_CACHE;
	static {
		CODE_MAP_CACHE = new HashMap();
		//為了說(shuō)明問(wèn)題,我在這里初始化一條數(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();
			//為了說(shuō)明問(wèn)題,我在這里初始化一條數(shù)據(jù)
			CODE_MAP_CACHE.put("0","北京市");
			SINGLE_ENUM_RESOLVER = new CachingEnumResolver();
			initEnums();
		}
	

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• LogFactory接口

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

public static Log getLog(String name) throws LogConfigurationException;

public static Log getLog(Class class) throws LogConfigurationException;

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

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

log4j三個(gè)組件

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

?

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

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

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

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

╭=========================================╮
??? 青山不改 綠水長(zhǎng)流http://blog.csdn.net/wangyihust
????? 歡迎各位轉(zhuǎn)貼，但需聲明版權(quán)，尊重技術(shù)原創(chuàng)性 :)
?????? E-mail:wangyihust@163.com??? OICQ:76406573???
╰=========================================╯
　　
　　 3、配置日志信息的格式，其語(yǔ)法為：
　　 1).log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
???????????? ?"fully.qualified.name.of.layout.class" 可以指定下面4個(gè)格式中的一個(gè)：
?????????????? 1.org.apache.log4j.HTMLLayout（以HTML表格形式布局），
　　 ?????? 2.org.apache.log4j.PatternLayout（可以靈活地指定布局模式），
　　 ?????? 3.org.apache.log4j.SimpleLayout（包含日志信息的級(jí)別和信息字符串），
　　 ?????? 4.org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時(shí)間、線程、類別等等信息）
?????????????????? 1.HTMLLayout 選項(xiàng)
????????????????????? LocationInfo=true:默認(rèn)值是false,輸出java文件名稱和行號(hào)
????????????????????? Title=my app file: 默認(rèn)值是 Log4J Log Messages.
???????????????????2.PatternLayout 選項(xiàng)
????????????????????? ConversionPattern=%m%n :指定怎樣格式化指定的消息。
?????????????????? 3.XMLLayout? 選項(xiàng)
????????????????????? LocationInfo=true:默認(rèn)值是false,輸出java文件和行號(hào)
?? 實(shí)際應(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
?????????? 這里需要說(shuō)明的就是日志信息格式中幾個(gè)符號(hào)所代表的含義：
　　 ???????? －X號(hào): X信息輸出時(shí)左對(duì)齊；
?????????????????? %p: 輸出日志信息優(yōu)先級(jí)，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL,
?????????????????? %d: 輸出日志時(shí)間點(diǎn)的日期或時(shí)間，默認(rèn)格式為ISO8601，也可以在其后指定格式，
比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921
?????????????????? %r: 輸出自應(yīng)用啟動(dò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)用中。
?????????????????? %%: 輸出一個(gè)"%"字符
?????????????????? %F: 輸出日志消息產(chǎn)生時(shí)所在的文件名稱
???????????????????%L: 輸出代碼中的行號(hào)
?????????????????? %m: 輸出代碼中指定的消息,產(chǎn)生的日志具體信息
?????????????????? %n: 輸出一個(gè)回車換行符，Windows平臺(tái)為"\r\n"，Unix平臺(tái)為"\n"輸出日志信息換行
??????????? 可以在%與模式字符之間加上修飾符來(lái)控制其最小寬度、最大寬度、和文本的對(duì)齊方式。如：
???????????????????? 1)%20c：指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，默認(rèn)的情況下右對(duì)齊。
???????????????????? 2)%-20c:指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，"-"號(hào)指定左對(duì)齊。
???????????????????? 3)%.30c:指定輸出category的名稱，最大的寬度是30，如果category的名稱大于30的話，就會(huì)將左邊
多出的字符截掉，但小于30的話也不會(huì)有空格。
???????????????????? 4)%20.30c:如果category的名稱小于20就補(bǔ)空格，并且右對(duì)齊，如果其名稱長(zhǎng)于30字符，
就從左邊交遠(yuǎn)銷出的字符截掉。

　　這里上面三個(gè)步驟是對(duì)前面Log4j組件說(shuō)明的一個(gè)簡(jiǎn)化；下面給出一個(gè)具體配置例子，在程序中可以參照?qǐng)?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ù)上面的日志格式，某一個(gè)程序的輸出結(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)輸出信息于回滾文件時(shí)

??????????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對(duì)應(yīng)用性能的影響

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

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

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聲明中被指定為根元素。嵌入在根元素中有兩個(gè)結(jié)構(gòu)：

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

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

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

root元素必須存在且不能被子類化。示例中的優(yōu)先級(jí)被設(shè)置為"debug"，設(shè)置appender飽含一個(gè)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樹來(lái)初始化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");
?? }
}
???

對(duì)于帶有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ù)庫(kù)

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

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)行起來(lái)，你就會(huì)看到有這樣的sql語(yǔ)句被執(zhí)行了：
?????? INSERT INTO jws_log? VALUES ('2006-01-18 17:50:22', 'main', 'INFO',
'Wite2Database.main(Write2Database.java:18)', 'test', '')

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

上述方法是利用傳統(tǒng)的數(shù)據(jù)庫(kù)連接方法，對(duì)于數(shù)據(jù)庫(kù)的管理和效率嚴(yán)重不足，在現(xiàn)在這個(gè)連接池橫行的時(shí)代,
為什么我們不能給給Log4j配上連接池，讓Log4j利用數(shù)據(jù)連接池的連接和數(shù)據(jù)庫(kù)進(jìn)行通訊。
現(xiàn)查看Log4j的Api,發(fā)現(xiàn)JDBCAppender這個(gè)類有以下幾段話：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.

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

原來(lái)如此，那就寫一個(gè)子類JDBCPoolAppender來(lái)替代這個(gè)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=""; //增加一個(gè)數(shù)據(jù)庫(kù)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ù)來(lái)利用連接池返回一個(gè)Connetion對(duì)象
　　 *
　　 */
　　 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.*;　//引入開源項(xiàng)目Poolman數(shù)據(jù)庫(kù)連接池的包
　　
　　 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ù)庫(kù)連接池的配置如下：
　　 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)行成功！對(duì)于JDBCPoolAppender的屬性（比如sqlname屬性）我們可以利用Log4j的反射機(jī)
制隨便添加，只要在配置文件給其附上值即可應(yīng)用，而原來(lái)的父類里面的一些屬性（username
什么的)和其get,set方法由于在連接池中不需要，所以刪除。而在JDBCPoolAppender類中，我也
只是將getConnection 方法Override ，在這個(gè)方法中我們可以根據(jù)需要生成我們的Connection
對(duì)象，另外兩個(gè)方法大家可以根據(jù)需求來(lái)決定怎樣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)致的錯(cuò)誤

今天使用session.delete(sql);報(bào)下面的錯(cuò)誤:

?

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)廢棄,同時(shí)廢棄的有:
??? find()、iterate()、filter()和delete(String?hqlSelectQuery),saveOrUpdateCopy()

?

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

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

?

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

?

下面是3.1的reference里面這樣寫的,我使用了,但是還是報(bào)錯(cuò),郁悶:

?

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)行后報(bào)錯(cuò)如下:

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)

昨天的問(wèn)題解決了

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

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

???? 里面有一句:

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

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

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

?

???? 附:

????? 因?yàn)槭褂昧酥形钠囱b的hql后,中文會(huì)變成問(wèn)號(hào),大致如下:

?

????? 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)在要通過(guò)一個(gè)主鍵id去數(shù)據(jù)庫(kù)中刪除對(duì)應(yīng)的一條記錄，我該怎樣做？如果是將參數(shù)delId傳遞進(jìn)來(lái)的話，那該怎么處理？ 我這樣做的，但是報(bào)了錯(cuò) 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); //出錯(cuò)行 session.delete(delId); tx.commit(); } catch(Exception ex) { HibernateUtil.rollbackTransaction(tx); throw DatastoreException.datastoreError(ex); } finally { HibernateUtil.closeSession(session); } } 錯(cuò)誤信息為： 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)該屬于你自己框架的信息吧，沒(méi)有多少參考價(jià)值。 使用Session.load()要確保數(shù)據(jù)一定存在，還是用get()吧； 或者直接session.delete("from INFO where ID = 1");
Top

	回復(fù)人：yuanjian0211(元?jiǎng)?	2006-3-1 17:46:04	得分:0
?	錯(cuò)誤提示信息為： 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=? 請(qǐng)指點(diǎn)
Top

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

	回復(fù)人：iori_powermax()	2006-03-02 01:06:00	得分:0
?	我也在學(xué)習(xí)hibernate,不知道說(shuō)的對(duì)不對(duì). 你刪除的應(yīng)該是整個(gè)對(duì)象,而不是一個(gè)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); 另外想問(wèn)一下大家: hibernate的creatSQLQuery()是不是只支持查詢?好象增刪改都不可以
Top

	回復(fù)人：ymfhcn(這痞子真帥)	2006-03-02 08:06:00	得分:0
?	creatSQLQuery()是執(zhí)行sql語(yǔ)句的，不過(guò)稍微有些改動(dòng)，里面什么SQL語(yǔ)句都可以寫 ?| = | 一般分類 | 仙俠修真 | VBScript | .NET | 面試題 | 存儲(chǔ)過(guò)程 | Hibernate | JavaScript | J2EE | Struts 自我介紹 我選擇，所以我自由！ 切換風(fēng)格 布局：選擇頁(yè)面布局兩欄左側(cè)導(dǎo)航（缺?。?/option>兩欄右側(cè)導(dǎo)航三欄 配色：選擇配色方案純凈藍(lán)灰（缺?。?/option>浪漫紫清爽綠海藍(lán)粉紅 提示點(diǎ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日（前一個(gè)為上周六，后一個(gè)為本周五） 修改Web.Config文件的函數(shù)(vb.net) VBScript得到本周的周末日期函數(shù) 給定一個(gè)日期，計(jì)算此日期是一年中的第幾周！ javascript中parseInt的問(wèn)題 利用javascript得到上周或下周的日期 如何得到前幾天的日期 侯捷觀點(diǎn):Java反射機(jī)制[轉(zhuǎn)載] 讓JSP頁(yè)面不緩存[設(shè)置JSP頁(yè)面立即過(guò)期] 博客統(tǒng)計(jì)... 總文章數(shù): 33 總評(píng)論數(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沒(méi)有的，比如： session.delete(new Employee(4)); 2）obj存在于session的cache中，比如： Employee employee = (Employee)session.load(Employee.class, new Integer(4)); session.delete(employee); 這兩種情況都是允許的，hibernate都會(huì)發(fā)送一條delete語(yǔ)句給數(shù)據(jù)庫(kù)。 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會(huì)拋出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));//同一個(gè)session中，上面的tx.commit()將session flush了一次。 tx.commit(); 那么這個(gè)時(shí)候hibernate僅僅會(huì)拋出ObjectNotFoundException:No row with the give... 表示找不到該object。如果第二個(gè)tx里邊采用session.get()也就不會(huì)拋出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一個(gè)被delete的obj的時(shí)候，在save處hibernate強(qiáng)制執(zhí)行session.flush()，發(fā)送delete語(yǔ)句，然后按照常規(guī)的save流程來(lái)進(jìn)行。為什么要這么做，還沒(méi)有完全想明白。 delete執(zhí)行之后，如果對(duì)obj對(duì)象屬性的修改，tx.commit()時(shí)不會(huì)進(jìn)行dirtyChecking。 這個(gè)道理比較顯然。 - 作者： HairRoot 2005年05月

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

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

級(jí)別: 初級(jí)

Sean C. Sullivan , 軟件工程師

2003 年 10 月 15 日

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

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

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

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

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

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

DAO基礎(chǔ)

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

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

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

回頁(yè)首

事務(wù)界定

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

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

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

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

設(shè)計(jì)考慮

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

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

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

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

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

												
										

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

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

												
										

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

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

回頁(yè)首

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

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

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

清單 3 顯示了如何用 JDBC API 界定一個(gè)事務(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ù)界定時(shí)，您可以將多個(gè) SQL 語(yǔ)句結(jié)合到一個(gè)事務(wù)中。JDBC 事務(wù)的一個(gè)缺點(diǎn)是事務(wù)的范圍局限于一個(gè)數(shù)據(jù)庫(kù)連接。一個(gè) JDBC 事務(wù)不能跨越多個(gè)數(shù)據(jù)庫(kù)。在下面，我們將看一下如何用 JTA 進(jìn)行事務(wù)界定。因?yàn)?JTA 不像 JDBC 那樣有名，所以我們首先做一個(gè)簡(jiǎn)介。

回頁(yè)首

JTA簡(jiǎn)介

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

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

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

回頁(yè)首

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

要用 JTA 進(jìn)行事務(wù)界定，應(yīng)用程序要調(diào)用 javax.transaction.UserTransaction 接口中的方法。清單 4 顯示了對(duì) UserTransaction 對(duì)象的典型 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 對(duì)象后，就可以開始事務(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() 時(shí)，事務(wù)管理器用一個(gè)兩階段的提交協(xié)議結(jié)束事務(wù)。

回頁(yè)首

控制事務(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)容。

回頁(yè)首

使用 JTA 和 JDBC

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

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

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

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

回頁(yè)首

選擇最好的方式

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

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

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

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

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

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

回頁(yè)首

日志記錄和 DAO

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

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

選擇日志庫(kù)

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

表 2. Java 平臺(tái)的日志庫(kù)

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

一個(gè)日志記錄示例

清單 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 中遇到故障，那么日志通常可以提供判斷出錯(cuò)位置的最好信息。將日志加入到 DAO 可以保證您有機(jī)會(huì)進(jìn)行調(diào)試和故障排除。

回頁(yè)首

DAO 中的異常處理

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

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

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

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

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

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

回頁(yè)首

實(shí)現(xiàn)實(shí)例： MovieDAO

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

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

DAO 模式的這個(gè)實(shí)現(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ù)操作。這個(gè)接口有五個(gè)方法，如下所示：

• 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 接口的兩個(gè)實(shí)現(xiàn)。每一個(gè)實(shí)現(xiàn)使用一種不同的方式進(jìn)行事務(wù)界定，如表 3 所示：

表 3. MovieDAO 實(shí)現(xiàn)

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

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

這個(gè) servlet 展示了如何將支持 JTA 的 MovieDAO 和 Java 消息服務(wù)(Java Message Service)結(jié)合到一個(gè)事務(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)前位置: 首頁(yè) >> 數(shù)據(jù)庫(kù) >> Oracle >> 我的權(quán)限控制(JBX + struts + hibernate + ORACLE)
?
我的權(quán)限控制(JBX + struts + hibernate + ORACLE)?

--------------------------------------------------------------------------------
?
作者：:???? 來(lái)源：???? 發(fā)表時(shí)間：2006-06-08???? 瀏覽次數(shù)：18??? 字號(hào)：大? 中? 小
　　
通過(guò)過(guò)濾器判斷用戶權(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è)置過(guò)濾器:
? <filter>
??? <filter-name>userpermission</filter-name>
??? <filter-class>sports.tools.UserPermissionFilter</filter-class>
? </filter>
設(shè)置過(guò)濾器映射,因?yàn)檫^(guò)濾器不能過(guò)濾全部的程序,所以可以用列表的形式來(lái)增加需要過(guò)濾的文件.如下.一個(gè)過(guò)濾器可以過(guò)濾多個(gè)映射文件.
? <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) 實(shí)現(xiàn)的想法變得切實(shí)可行。在本文中，系統(tǒng)架構(gòu)師 Per Mellqvist 展示了基于 Hibernate 的泛型 DAO 實(shí)現(xiàn)類。然后展示如何使用 Spring AOP introductions 將類型安全接口添加到類中以便于查詢執(zhí)行。
對(duì)于大多數(shù)開發(fā)人員，為系統(tǒng)中的每個(gè) DAO 編寫幾乎相同的代碼到目前為止已經(jīng)成為一種習(xí)慣。雖然所有人都將這種重復(fù)標(biāo)識(shí)為 “代碼味道”，但我們大多數(shù)都已經(jīng)學(xué)會(huì)忍受它。其實(shí)有解決方案。可以使用許多 ORM 工具來(lái)避免代碼重復(fù)。例如，使用 Hibernate，您可以簡(jiǎn)單地為所有的持久域?qū)ο笾苯邮褂脮?huì)話操作。這種方法的缺點(diǎn)是損失了類型安全。

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

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

DAO 實(shí)現(xiàn)

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

系統(tǒng)中的所有數(shù)據(jù)庫(kù)訪問(wèn)都通過(guò) DAO 進(jìn)行以實(shí)現(xiàn)封裝。
每個(gè) DAO 實(shí)例負(fù)責(zé)一個(gè)主要域?qū)ο蠡驅(qū)嶓w。如果域?qū)ο缶哂歇?dú)立生命周期，它應(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ù)、會(huì)話或連接。這些不由 DAO 處理是為了實(shí)現(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);
}

?

實(shí)現(xiàn)接口

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

清單 2. 第一個(gè)泛型 DAO 實(shí)現(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 的一個(gè)實(shí)例。必須告訴 GenericDaoHibernateImpl 的構(gòu)造函數(shù) DAO 實(shí)例將負(fù)責(zé)哪個(gè)域類。只有這樣，Hibernate 才能在運(yùn)行時(shí)知道由 DAO 管理的對(duì)象類型。在清單 3 中，我將域類 Person 從示例應(yīng)用程序傳遞給構(gòu)造函數(shù)，并將先前配置的 Hibernate 會(huì)話工廠設(shè)置為已實(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。
我還沒(méi)有完成，但我所完成的確實(shí)已經(jīng)可以使用了。在清單 4 中，可以看到原封不動(dòng)使用該泛型 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)在，我有一個(gè)能夠進(jìn)行類型安全 CRUD 操作的泛型 DAO。讓子類 GenericDaoHibernateImpl 為每個(gè)域?qū)ο筇砑硬樵兡芰⒎浅：侠?。因?yàn)楸疚牡哪康脑谟谡故救绾尾粸槊總€(gè)查詢編寫顯式的 Java 代碼來(lái)實(shí)現(xiàn)查詢，但是，我將使用其他兩個(gè)工具將查詢引入 DAO，也就是 Spring AOP 和 Hibernate 命名的查詢。

Spring AOP introductions

可以使用 Spring AOP 中的 introductions 將功能添加到現(xiàn)有對(duì)象，方法是將功能包裝在代理中，定義應(yīng)實(shí)現(xiàn)的接口，并將所有先前未支持的方法指派到單個(gè)處理程序。在我的 DAO 實(shí)現(xiàn)中，我使用 introductions 將許多查找器方法添加到現(xiàn)有泛型 DAO 類中。因?yàn)椴檎移鞣椒ㄊ翘囟ㄓ诿總€(gè)域?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 的配置文件中，我定義了三個(gè) Spring bean。第一個(gè) bean 是 FinderIntroductionAdvisor，它處理引入到 DAO 的所有方法，這些方法在 GenericDaoHibernateImpl 類中不可用。我稍后將詳細(xì)介紹 Advisor bean。

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

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

3。

擴(kuò)展 GenericDAO

當(dāng)然，每個(gè) 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 實(shí)現(xiàn)代碼全部是泛型代碼，在添加更多 DAO 時(shí)不需要任何更新。

配置 PersonDao

因?yàn)?Spring 配置依賴于先前定義的 “抽象” bean，因此它變得相當(dāng)簡(jiǎn)潔。我需要指出 DAO 負(fù)責(zé)哪個(gè)域類，并且需要告訴 Springs 該 DAO 應(yīng)實(shí)現(xiàn)哪個(gè)接口（一些方法是直接使用，一些方法則是通過(guò)使用 introductions 來(lái)使用）。清單 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 中，可以看到使用了這個(gè)更新后的 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 的實(shí)現(xiàn)并不完整。調(diào)用 findByName() 會(huì)導(dǎo)致運(yùn)行時(shí)異常。問(wèn)題在于我還沒(méi)有實(shí)現(xiàn)調(diào)用 findByName() 所必需的查詢。剩下要做的就是指定查詢。為更正該問(wèn)題，我使用了 Hibernate 命名查詢。

?

Hibernate 命名查詢

使用 Hibernate，可以在 Hibernate 映射文件 (hbm.xml) 中定義 HQL 查詢并為其命名。稍后可以通過(guò)簡(jiǎn)單地引用給定名稱來(lái)在 Java 代碼中使用該查詢。該方法的優(yōu)點(diǎn)之一是能夠在部署時(shí)優(yōu)化查詢，而無(wú)需更改代碼。您一會(huì)將會(huì)看到，另一個(gè)優(yōu)點(diǎn)是無(wú)需編寫任何新 Java 實(shí)現(xiàn)代碼，就可以實(shí)現(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 映射，該域類具有兩個(gè)屬性：name 和 weight。Person 是具有上述屬性的簡(jiǎn)單 POJO。該文件還包含一個(gè)在數(shù)據(jù)庫(kù)中查找 Person 所有實(shí)例的查詢，其中 “name” 等于提供的參數(shù)。Hibernate 不為命名查詢提供任何真正的名稱空間功能。出于討論目的，我為所有查詢名稱都加了域類的短（非限定）名稱作為前綴。在現(xiàn)實(shí)世界中，使用包括包名稱的完全類名可能是更好的主意。

?

逐步概述

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

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

4。

可重用的 DAO 類

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

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

清單 11. executeFinder() 的實(shí)現(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é)束語(yǔ)

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

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

致謝

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

?