久久亚洲中文字幕无码,久久久久亚洲AV成人网人人软件,亚洲一级毛片免费在线观看

ASM(�?

lanxin1020 — Tue, 12 May 2009 04:43:00 GMT

ASM 是一�?Java 字节码操控框架。它能被用来动态生成类或者增强既有类的功能。ASM 可以直接产生二进�?class 文�g�Q�也可以在类被加载入 Java 虚拟��Z��前动态改变类行�ؓ。Java class 被存储在严格格式定义�?.class 文�g里，�q�些�c�L��件拥有��够的元数据来解析�c�M��的所有元素：�c�d��U�、方法、属性以�?Java 字节码（指��o�Q�。ASM 从类文�g中读入信息后�Q�能够改变类行�ؓ�Q�分析类信息�Q�甚臌��够根据用戯��求生成新�c�R�?/p>

�?BCEL �?SERL 不同�Q�ASM 提供了更为现代的�~�程模型。对�?ASM 来说�Q�Java class 被描�q�Cؓ一��|��Q��?“Visitor” 模式遍历整个二进制结构；事�g驱动的处理方式��得用户只需要关注于对其�~�程有意义的部分�Q�而不必了�?Java �c�L��件格式的所有细节：ASM 框架提供了默认的 “response taker”处理�q�一切�?/p>

��Z��么要动态生�?Java �c�？

动态生�?Java �c�M�� AOP 密切相关的。AOP 的初衷在于��Y件设计世界中存在�q�么一�c�M��码，零散而又耦合�Q�零散是�׃��一些公有的功能�Q�诸如著名的 log 例子�Q�分散在所有模块之中；同时改变 log 功能又会影响到所有的模块。出现这��L��~�陷�Q�很大程度上是由于传�l�的面向对象�~�程注重以��承关�p�Mؓ代表�?#8220;�U�向”关系�Q�而对于拥有相同功能或者说斚w�� Q�Aspect�Q�的模块之间�?#8220;横向”关系不能很好地表达。例如，目前有一个既有的银行��理�pȝ��Q�包�?Bank、Customer、Account、Invoice �{�对象，现在要加入一个安全检查模块，对已有类的所有操作之前都必须�q�行一�ơ安全检查�?/p>
�?1. ASM – AOP

然�?Bank、Customer、Account、Invoice 是代表不同的事务�Q�派生自不同的父�c�，很难在高层上加入关于 Security Checker 的共有功能。对于没有多�l�承�?Java 来说�Q�更是如此。传�l�的解决�Ҏ��是��?Decorator 模式�Q�它可以在一定程度上改善耦合�Q�而功能仍旧是分散�?—�?每个需�?Security Checker 的类都必��要�z��一�?Decorator�Q�每个需�?Security Checker 的方法都要被包装�Q�wrap�Q�。下面我们以 Account �c�Mؓ例看一�?Decorator�Q?/p>

首先�Q�我们有一�?SecurityChecker �c�，光��态方�?checkSecurity 执行安全��查功能：

public class SecurityChecker {   public static void checkSecurity() {    System.out.println("SecurityChecker.checkSecurity ...");    //TODO real security check   }   }

另一个是 Account �c�：

public class Account {   public void operation() {    System.out.println("operation...");    //TODO real operation   }  }

若想�?operation 加入�?SecurityCheck.checkSecurity() 调用�Q�标准的 Decorator 需要先定义一�?Account �cȝ��接口�Q?/p>

public interface Account {   void operation();   }

然后把原来的 Account �c�d��义�ؓ一个实现类�Q?/p>

public class AccountImpl extends Account{   public void operation() {    System.out.println("operation...");    //TODO real operation   }  }

定义一�?Account �cȝ�� Decorator�Q��ƈ包装 operation �Ҏ��Q?/p>

public class AccountWithSecurityCheck implements Account {    private  Account account;   public AccountWithSecurityCheck (Account account) {    this.account = account;   }   public void operation() {    SecurityChecker.checkSecurity();    account.operation();   }  }

在这个简单的例子里，攚w��一个类的一个方法还好，如果是变动整个模块，Decorator 很快��׃��演化成另一个噩梦。动态改�?Java �c�d��是要解决 AOP 的问题，提供一�U�得到系�l�支持的可编�E�的�Ҏ��Q�自动化地生成或者增�?Java 代码。这�U�技术已�l�广泛应用于最新的 Java 框架内，�?Hibernate�Q�Spring �{��?/p>

��Z��么选择 ASM�Q?/span>

最直接的改�?Java �cȝ��Ҏ��莫过于直接改�?class 文�g。Java 规范详细说明了class 文�g的格式，直接�~�辑字节码确实可以改�?Java �cȝ��行�ؓ。直��C��天，�q�有一�?Java 高手们��用最原始的工��P��?UltraEdit �q�样的编辑器�?class 文�g动手术。是的，�q�是最直接的方法，但是要求使用者对 Java class 文�g的格式了熟于心：��心地推��出��x��造的函数相对文�g首部的偏�U�量�Q�同旉��新计��?class 文�g的校验码以通过 Java 虚拟机的安全机制�?/p>

Java 5 中提供的 Instrument 包也可以提供�c�M��的功能：启动时往 Java 虚拟��Z��挂上一个用户定义的 hook �E�序�Q�可以在装入特定�cȝ��时候改变特定类的字节码�Q�从而改变该�cȝ��行�ؓ。但是其�~�点也是明显的：

Instrument 包是在整个虚拟机上挂了一个钩子程序，每次装入一个新�cȝ��时候，都必��L��行一遍这�D늨�序，即�ɘq�个�c�M��需要改变�?
直接改变字节码事实上�c�M��于直接改�?class 文�g�Q�无论是调用 ClassFileTransformer. transform(ClassLoader loader, String className, Class classBeingRedefined, ProtectionDomain protectionDomain, byte[] classfileBuffer)�Q�还�?Instrument.redefineClasses(ClassDefinition[] definitions)�Q�都必须提供�?Java �cȝ��字节码。也��是��_��同直接改�?class 文�g一��P��使用 Instrument 也必��M��解想攚w��的�Ҏ��相对�c�首部的偏移量，才能在适当的位�|�上插入新的代码�?

��管 Instrument 可以攚w��类�Q�但事实上，Instrument 更适用于监控和控制虚拟机的行�ؓ�?/p>

一�U�比较理想且��行的方法是使用 java.lang.ref.proxy。我们仍旧��用上面的例子�Q�给 Account �c�d��?checkSecurity 功能:

首先�Q�Proxy �~�程是面向接口的。下面我们会看到�Q�Proxy �q�不负责实例化对象，�?Decorator 模式一��P��要把 Account 定义成一个接口，然后�?AccountImpl 里实�?Account 接口�Q�接着实现一�?InvocationHandler Account �Ҏ��被调用的时候，虚拟机都会实际调用这�?InvocationHandler �?invoke �Ҏ��Q?/p>

class SecurityProxyInvocationHandler implements InvocationHandler {   private Object proxyedObject;   public SecurityProxyInvocationHandler(Object o) {    proxyedObject = o;   }       public Object invoke(Object object, Method method, Object[] arguments)    throws Throwable {       if (object instanceof Account && method.getName().equals("opertaion")) {     SecurityChecker.checkSecurity();    }    return method.invoke(proxyedObject, arguments);   }  }

最后，在应用程序中指定 InvocationHandler 生成代理对象�Q?/p>

public static void main(String[] args) {   Account account = (Account) Proxy.newProxyInstance(    Account.class.getClassLoader(),    new Class[] { Account.class },    new SecurityProxyInvocationHandler(new AccountImpl())   );   account.function();  }

其不��之处在于：

Proxy 是面向接口的�Q�所有��?Proxy 的对象都必须定义一个接口，而且用这些对象的代码也必��L��Ҏ��口编�E�的�Q�Proxy 生成的对象是接口一致的而不是对象一致的�Q�例子中 Proxy.newProxyInstance 生成的是实现 Account 接口的对象而不�?AccountImpl 的子�c�R��这对于软�g架构设计�Q�尤其对于既有��Y件系�l�是有一定掣肘的�?
Proxy 毕竟是通过反射实现的，必须在效率上付出代�h�Q�有实验数据表明�Q�调用反��比一般的函数开销臛_��要大 10 倍。而且�Q�从�E�序实现上可以看出，�?proxy class 的所有方法调用都要通过使用反射�?invoke �Ҏ��。因此，对于性能关键的应用，使用 proxy class 是需要精心考虑的，以避免反��成为整个应用的瓉��?

ASM 能够通过攚w��既有类�Q�直接生成需要的代码。增强的代码是硬�~�码在新生成的类文�g内部的，没有反射带来性能上的付出。同�Ӟ��ASM �?Proxy �~�程不同�Q�不需要�ؓ增强代码而新定义一个接口，生成的代码可以覆盖原来的�c�，或者是原始�cȝ��子类。它是一个普通的 Java �c�而不�?proxy �c�，甚至可以在应用程序的�c�L��架中拥有自己的位�|�，�z��自己的子�c�R�?/p>

相比于其他流行的 Java 字节码操�U�工��P��ASM 更小更快。ASM ��h��c�M��?BCEL 或�?SERP 的功能，而只�?33k 大小�Q�而后者分别有 350k �?150k。同�Ӟ��同样�c��{换的负蝲�Q�如�?ASM �?60% 的话�Q�BCEL 需�?700%�Q��?SERP 需�?1100% 或者更多�?/p>

ASM 已经被广泛应用于一�p�d�� Java ��目�Q�AspectWerkz、AspectJ、BEA WebLogic、IBM AUS、OracleBerkleyDB、Oracle TopLink、Terracotta、RIFE、EclipseME、Proactive、Speedo、Fractal、EasyBeans、BeanShell、Groovy、Jamaica、CGLIB、dynaop、Cobertura、JDBCPersistence、JiP、SonarJ、Substance L&F、Retrotranslator �{�。Hibernate �?Spring 也通过 cglib�Q�另一个更高层一些的自动代码生成工具使用�?ASM�?/p>

回页�?/strong>

Java �c�L��件概�q?/span>

所�?Java �c�L��Ӟ��是通常�?javac �~�译器��生的 .class 文�g。这些文件具有严格定义的格式。�ؓ了更好的理解 ASM�Q�首先对 Java �c�L��件格式作一点简单的介绍。Java 源文件经�q?javac �~�译器编译之后，��会生成对应的二�q�制文�g�Q�如下图所�C�）。每个合法的 Java �c�L��仉��具备�_��的定义，而正是这�U�精��的定义�Q�才使得 Java 虚拟机得以正��读取和解释所有的 Java �c�L��件�?/p>
�?2. ASM – Javac ��程

Java �c�L��件是 8 位字节的二进制流。数据项按顺序存储在 class 文�g中，盔R��的项之间没有间隔�Q�这使得 class 文�g变得紧凑�Q�减��存储空间。在 Java �c�L��件中包含了许多大��不同的��，�׃��每一��的�l�构都有严格规定�Q�这使得 class 文�g能够从头到尾被顺利地解析。下面让我们来看一�?Java �c�L��件的内部�l�构�Q�以便对此有个大致的认识�?/p>

例如�Q�一个最��单的 Hello World �E�序�Q?/p>

public class HelloWorld {   public static void main(String[] args) {    System.out.println("Hello world");   }  }

�l�过 javac �~�译后，得到的类文�g大致是：

�?3. ASM – Java �c�L��?/strong>

从上图中可以看到�Q�一�?Java �c�L��件大致可以归�?10 个项�Q?/p>

Magic�Q?/strong>该项存放了一�?Java �c�L��件的��数�Q�magic number�Q�和版本信息。一�?Java �c�L��件的�?4 个字节被�U�Cؓ它的��数。每个正��的 Java �c�L��仉��是以 0xCAFEBABE 开头的�Q�这样保证了 Java 虚拟��很轻杄��分��L�?Java 文�g和非 Java 文�g�?
Version�Q?/strong>该项存放�?Java �c�L��件的版本信息�Q�它对于一�?Java 文�g��h��重要的意义。因�?Java 技术一直在发展�Q�所以类文�g的格式也处在不断变化之中。类文�g的版本信息让虚拟机知道如何去��d��q�处理该�c�L��件�?
Constant Pool�Q?/strong>该项存放了类中各�U�文字字�W�串、类名、方法名和接口名�U�、final 变量以及对外部类的引用信息等帔R��。虚拟机必须为每一个被装蝲的类�l�护一个常量池�Q�常量池中存储了相应�c�d��所用到的所有类型、字�D�和�Ҏ��的符号引用，因此它在 Java 的动态链接中起到了核心的作用。常量池的大��^均占��C��整个�c�d��的 60% 左右�?
Access_flag�Q?/strong>该项指明了该文�g中定义的是类�q�是接口�Q�一�?class 文�g中只能有一个类或接口）�Q�同时还指名了类或接口的讉K��标志�Q�如 public�Q�private, abstract �{�信息�?
This Class�Q?/strong>指向表示该类全限定名�U�的字符串常量的指针�?
Super Class�Q?/strong>指向表示父类全限定名�U�的字符串常量的指针�?
Interfaces�Q?/strong>一个指针数�l�，存放了该�c�L��父类实现的所有接口名�U�的字符串常量的指针。以上三��Ҏ��指向的常量，特别是前两项�Q�在我们�?ASM 从已有类�z��新类时一般需要修改：��类名称改�ؓ子类名称�Q�将父类改�ؓ�z��前的�c�d��U�ͼ�如果有必要，增加新的实现接口�?
Fields�Q?/strong>该项对类或接口中声明的字�D�进行了�l�致的描�q�。需要注意的是，fields 列表中仅列出了本�c�L��接口中的字段�Q��ƈ不包括从��类和父接口�l�承而来的字�D�c�?
Methods�Q?/strong>该项对类或接口中声明的方法进行了�l�致的描�q�。例如方法的名称、参数和�q�回值类型等。需要注意的是，methods 列表里仅存放了本�c�L��本接口中的方法，�q�不包括从超�c�d��父接口��承而来的方法。��?ASM �q�行 AOP �~�程�Q�通常是通过调整 Method 中的指��o来实现的�?
Class attributes�Q?/strong>该项存放了在该文件中�c�L��接口所定义的属性的基本信息�?

事实上，使用 ASM 动态生成类�Q�不需要像早年�?class hacker 一��P��熟知 class 文�g的每一�D�，以及它们的功能、长度、偏�U�量以及�~�码方式。ASM 会给我们照顾好这一切的�Q�我们只要告�?ASM 要改动什么就可以�?—�?当然�Q�我们首先得知道要改什么：对类文�g格式了解的越多，我们��p��更好��C��?ASM �q�个利器�?/p>

回页�?/strong>

ASM 3.0 �~�程框架

ASM 通过树这�U�数据结构来表示复杂的字节码�l�构�Q��ƈ利用 Push 模型来对树进行遍历，在遍历过�E�中对字节码�q�行修改。所谓的 Push 模型�c�M��于简单的 Visitor 设计模式�Q�因为需要处理字节码�l�构是固定的�Q�所以不需要专门抽象出一�U?Vistable 接口�Q�而只需要提�?Visitor 接口。所�?Visitor 模式�?Iterator 模式有点�c�M��Q�它们都被用来遍历一些复杂的数据�l�构。Visitor 相当于用��h��出的代表�Q�深入到��法内部�Q�由��法安排讉K��行程。Visitor 代表可以更换�Q�但对算法流�E�无法干涉，因此是被动的�Q�这也是它和 Iterator 模式��q��户主动调遣算法方式的最大的区别�?/p>
�?ASM 中，提供了一�?ClassReader �c�，�q�个�c�d��以直接由字节数组或由 class 文�g间接的获得字节码数据�Q�它能正��的分析字节码，构徏出抽象的树在内存中表�C�字节码。它会调�?accept �Ҏ��Q�这个方法接受一个实��C�� ClassVisitor 接口的对象实例作为参敎ͼ�然后依次调用 ClassVisitor 接口的各个方法。字节码�I�间上的偏移被�{换成 visit 事�g旉��上调用的先后�Q�所�?visit 事�g是指对各�U�不�?visit 函数的调用，ClassReader 知道如何调用各种 visit 函数。在�q�个�q�程中用��h��法对操作�q�行�q�涉�Q�所以遍历的��法是确定的�Q�用户可以做的是提供不同�?Visitor 来对字节码树�q�行不同的修攏V�?code>ClassVisitor 会��生一些子�q�程�Q�比�?visitMethod 会返回一个实�?MethordVisitor 接口的实例，visitField 会返回一个实�?FieldVisitor 接口的实例，完成子过�E�后控制�q�回到父�q�程�Q��l�访问下一节点。因此对�?ClassReader 来说�Q�其内部��序讉K��是有一定要求的。实际上用户�q�可以不通过 ClassReader �c�，自行手工控制�q�个��程�Q�只要按照一定的��序�Q�各�?visit 事�g被先后正��的调用�Q�最后就能生成可以被正确加蝲的字节码。当然获得更大灵�z�L��的同时也加大了调整字节码的复杂度�?/p>
各个 ClassVisitor 通过职责�?�Q�Chain-of-responsibility�Q?模式�Q�可以非常简单的��装对字节码的各�U�修改，而无��d��注字节码的字节偏�U�，因�ؓ�q�些实现�l�节对于用户都被隐藏了，用户要做的只是覆写相应的 visit 函数�?/p>
ClassAdaptor �c�d��C�� ClassVisitor 接口所定义的所有函敎ͼ�当新��Z��?ClassAdaptor 对象的时候，需要传入一个实��C�� ClassVisitor 接口的对象，作�ؓ职责链中的下一个访问�?�Q�Visitor�Q�，�q�些函数的默认实现就是简单的把调用委�z��q�个对象�Q�然后依�ơ传递下��dŞ成职责链。当用户需要对字节码进行调整时�Q�只需�?ClassAdaptor �c�L��生出一个子�c�，覆写需要修改的�Ҏ��Q�完成相应功能后再把调用传递下厅R��这��P��用户无需考虑字节偏移�Q�就可以很方便的控制字节码�?/p>
每个 ClassAdaptor �cȝ��z��c�d��以仅��装单一功能�Q�比如删除某函数、修改字�D�可见性等�{�，然后再加入到职责链中�Q�这栯��合更小�Q�重用的概率也更大，但代��h��产生很多��对象，而且职责铄��层次太长的话也会加大�pȝ��调用的开销�Q�用户需要在低耦合和高效率之间作出权衡。用户可以通过控制职责链中 visit 事�g的过�E�，对类文�g�q�行如下操作�Q?/p>

删除�cȝ��字段、方法、指令：只需在职责链传递过�E�中中断委派�Q�不讉K��相应�?visit �Ҏ��卛_��Q�比如删除方法时只需直接�q�回 null�Q�而不是返回由 visitMethod �Ҏ��q�回�?MethodVisitor 对象�?/p>

class DelLoginClassAdapter extends ClassAdapter { public DelLoginClassAdapter(ClassVisitor cv) { super(cv); } public MethodVisitor visitMethod(final int access, final String name, final String desc, final String signature, final String[] exceptions) { if (name.equals("login")) { return null; } return cv.visitMethod(access, name, desc, signature, exceptions); } }

修改�c�R��字�D�c��方法的名字或修饰符�Q�在职责链传递过�E�中替换调用参数�?/p>

class AccessClassAdapter extends ClassAdapter { public AccessClassAdapter(ClassVisitor cv) { super(cv); } public FieldVisitor visitField(final int access, final String name, final String desc, final String signature, final Object value) { int privateAccess = Opcodes.ACC_PRIVATE; return cv.visitField(privateAccess, name, desc, signature, value); } }

增加新的�c�R��方法、字�D?/p>

ASM 的最�l�的目的是生成可以被正常装蝲�?class 文�g�Q�因此其框架�l�构为客��h��供了一个生成字节码的工��L�� —�?ClassWriter。它实现�?ClassVisitor 接口�Q�而且含有一�?toByteArray() 函数�Q�返回生成的字节码的字节��，��字节流写回文�g卛_��生��调整后的 class 文�g。一般它都作��责链的终点，把所�?visit 事�g的先后调用（旉��上的先后�Q�，最�l��{换成字节码的位置的调��_��I�间上的前后�Q�，如下例：

ClassWriter classWriter = new ClassWriter(ClassWriter.COMPUTE_MAXS); ClassAdaptor delLoginClassAdaptor = new DelLoginClassAdapter(classWriter); ClassAdaptor accessClassAdaptor = new AccessClassAdaptor(delLoginClassAdaptor); ClassReader classReader = new ClassReader(strFileName); classReader.accept(classAdapter, ClassReader.SKIP_DEBUG);

�l�g��所�q�ͼ�ASM 的时序图如下�Q?/p>
�?4. ASM – 时序�?/strong>

回页�?/strong>

使用 ASM3.0 �q�行 AOP �~�程

我们�q�是用上面的例子�Q�给 Account �c�d��?security check 的功能。与 proxy �~�程不同�Q�ASM 不需要将 Account 声明成接口，Account 可以仍旧是一个实现类。ASM ��直接在 Account �c�M��动手术，�l?Account �cȝ�� operation �Ҏ��首部加上�?SecurityChecker.checkSecurity 的调用�?/p>
首先�Q�我们将�?ClassAdapter �l�承一个类�?code>ClassAdapter �?ASM 框架提供的一个默认类�Q�负责沟�?ClassReader �?ClassWriter。如果想要改�?ClassReader 处读入的�c�，然后�?ClassWriter 处输出，可以重写相应�?ClassAdapter 函数。这里，��Z��改变 Account �cȝ�� operation �Ҏ��Q�我们将重写 visitMethdod �Ҏ��?/p>

class AddSecurityCheckClassAdapter extends ClassAdapter{ public AddSecurityCheckClassAdapter(ClassVisitor cv) { //Responsechain 的下一�?ClassVisitor�Q�这里我们将传入 ClassWriter�Q? //负责改写后代码的输出 super(cv); } //重写 visitMethod�Q�访问到 "operation" �Ҏ��Ӟ�� //�l�出自定�?MethodVisitor�Q�实际改写方法内�? public MethodVisitor visitMethod(final int access, final String name, final String desc, final String signature, final String[] exceptions) { MethodVisitor mv = cv.visitMethod(access, name, desc, signature,exceptions); MethodVisitor wrappedMv = mv; if (mv != null) { //对于 "operation" �Ҏ�� if (name.equals("operation")) { //使用自定�?MethodVisitor�Q�实际改写方法内�? wrappedMv = new AddSecurityCheckMethodAdapter(mv); } } return wrappedMv; } }　　　

下一步就是定义一个��承自 MethodAdapter �?AddSecurityCheckMethodAdapter�Q�在“operation”�Ҏ��首部插入�?SecurityChecker.checkSecurity() 的调用�?/p>

class AddSecurityCheckMethodAdapter extends MethodAdapter { public AddSecurityCheckMethodAdapter(MethodVisitor mv) { super(mv); } public void visitCode() { visitMethodInsn(Opcodes.INVOKESTATIC, "SecurityChecker", "checkSecurity", "()V"); } }

其中�Q?code>ClassReader ��d��每个�Ҏ��的首部时调用 visitCode()�Q�在�q�个重写�Ҏ��里，我们�?code>visitMethodInsn(Opcodes.INVOKESTATIC, "SecurityChecker","checkSecurity", "()V"); 插入了安全检查功能�?/p>
最后，我们��集成上面定义的 ClassAdapter�Q?code>ClassReader�?code>ClassWriter 产生修改后的 Account �c�L��?

import java.io.File; import java.io.FileOutputStream; import org.objectweb.asm.*; public class Generator{ public static void main() throws Exception { ClassReader cr = new ClassReader("Account"); ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_MAXS); ClassAdapter classAdapter = new AddSecurityCheckClassAdapter(cw); cr.accept(classAdapter, ClassReader.SKIP_DEBUG); byte[] data = cw.toByteArray(); File file = new File("Account.class"); FileOutputStream fout = new FileOutputStream(file); fout.write(data); fout.close(); } }

执行完这�D늨�序后�Q�我们会得到一个新�?Account.class 文�g�Q�如果我们��用下面代码：

public class Main { public static void main(String[] args) { Account account = new Account(); account.operation(); } }

使用�q�个 Account�Q�我们会得到下面的输出：

SecurityChecker.checkSecurity ... operation...

也就是说�Q�在 Account 原来�?operation 内容执行之前�Q�进行了 SecurityChecker.checkSecurity() ��查�?/p>
��动态生成类攚w��成原始�c?Account 的子�c?/span>

上面�l�出的例子是直接攚w�?Account �c�L��w�的�Q�从�?Account �cȝ�� operation �Ҏ��必须�q�行 checkSecurity ��查。但事实上，我们有时仍希望保留原来的 Account �c�，因此把生成类定义为原始类的子�c�L��更符�?AOP 原则的做法。下面介�l�如何将攚w��后的类定义�?Account 的子�c?Account$EnhancedByASM。其中主要有两项工作:

改变 Class Description, ��其命名�?Account$EnhancedByASM�Q�将其父�c�L��定�ؓ Account�?
改变构造函敎ͼ��其中对父类构造函数的调用转换为对 Account 构造函数的调用�?

�?AddSecurityCheckClassAdapter �c�M��Q�将重写 visit �Ҏ��Q?/p>

public void visit(final int version, final int access, final String name, final String signature, final String superName, final String[] interfaces) { String enhancedName = name + "$EnhancedByASM"; //改变�c�d��? enhancedSuperName = name; //改变父类�Q�这里是”Account” super.visit(version, access, enhancedName, signature, enhancedSuperName, interfaces); }

改进 visitMethod �Ҏ��Q�增加对构造函数的处理�Q?/p>

public MethodVisitor visitMethod(final int access, final String name, final String desc, final String signature, final String[] exceptions) { MethodVisitor mv = cv.visitMethod(access, name, desc, signature, exceptions); MethodVisitor wrappedMv = mv; if (mv != null) { if (name.equals("operation")) { wrappedMv = new AddSecurityCheckMethodAdapter(mv); } else if (name.equals("")) { wrappedMv = new ChangeToChildConstructorMethodAdapter(mv, enhancedSuperName); } } return wrappedMv; }

�q�里 ChangeToChildConstructorMethodAdapter ��负责把 Account 的构造函数改造成其子�c?Account$EnhancedByASM 的构造函敎ͼ�

class ChangeToChildConstructorMethodAdapter extends MethodAdapter { private String superClassName; public ChangeToChildConstructorMethodAdapter(MethodVisitor mv, String superClassName) { super(mv); this.superClassName = superClassName; } public void visitMethodInsn(int opcode, String owner, String name, String desc) { //调用父类的构造函数时 if (opcode == Opcodes.INVOKESPECIAL && name.equals("")) { owner = superClassName; } super.visitMethodInsn(opcode, owner, name, desc);//改写父类为superClassName } }

最后演�C�Z��下如何在�q�行时��生�ƈ装入产生�?Account$EnhancedByASM�?我们定义一�?Util �c�，作�ؓ一个类工厂负责产生有安全检查的 Account �c�：

public class SecureAccountGenerator { private static AccountGeneratorClassLoader classLoader = new AccountGeneratorClassLoade(); private static Class secureAccountClass; public Account generateSecureAccount() throws ClassFormatError, InstantiationException, IllegalAccessException { if (null == secureAccountClass) { ClassReader cr = new ClassReader("Account"); ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_MAXS); ClassAdapter classAdapter = new AddSecurityCheckClassAdapter(cw); cr.accept(classAdapter, ClassReader.SKIP_DEBUG); byte[] data = cw.toByteArray(); secureAccountClass = classLoader.defineClassFromClassFile( "Account$EnhancedByASM",data); } return (Account) secureAccountClass.newInstance(); } private static class AccountGeneratorClassLoader extends ClassLoader { public Class defineClassFromClassFile(String className, byte[] classFile) throws ClassFormatError { return defineClass("Account$EnhancedByASM", classFile, 0, classFile.length()); } } }

静态方�?SecureAccountGenerator.generateSecureAccount() 在运行时动态生成一个加上了安全��查的 Account 子类。著名的 Hibernate �?Spring 框架�Q�就是��用这�U�技术实��C�� AOP �?#8220;无损注入”�?/p>

回页�?/strong>

��结

最后，我们比较一�?ASM 和其他实�?AOP 的底层技术：

lanxin1020 2009-05-12 12:43 发表评论

lanxin1020 — Mon, 04 May 2009 09:19:00 GMT

Log4J是Apache的一个开放源代码��目(http://logging.apache.org/log4j/docs/)�Q�它是一个日志操作包。通过使用Log4J,可以指定日志信息输出的目的地�Q�控制每一条日志的输出格式�Q�定义日志信息的�U�别。所有这些功能通过一个配�|�文件灵�z�进行配�|��?

一、LOG4J�l�成

    LOG4J主要�׃��大组件组成：
    . Logger: 军_��什么日志信息应该被输出、什么日志信息应该被忽略�Q?br />     . Appender: 指定日志信息应该输出��C��么地�? �q�些地方可以是控制台、文件、网�l�设备；
    . Layout: 指定日志信息的输出格式；

    一个Logger可以有多个Appender�Q�也��是说日志信息可以同时输出到多个讑֤�上，每个Appender对应
    一�U�Layout(�C�Z��见下�?�?/p>
              �?nbsp; Appender1 → Layout
     �Q?nbsp;
    Logger
     �H?
              �?nbsp; Appender2 → Layout

二、Logger�l��g

    1. Logger�l��g提供的方法：

       Logger�l��g是LOG4J的核心组�Ӟ��它代表了Log4J的日志记录器�Q�它能够�Ҏ��志信息进行分�cȝ��选。它由org.apache.log4j.Logger�c�d��玎ͼ�提供了如下方法：

java 代码

package org.apache.log4j;

public class Logger {

           // Creation & retrieval methods:
           public static Logger getRootLogger();
           public static Logger getLogger(String name);

           // printing methods:
           public void debug(Object message);
           public void info(Object message);
           public void warn(Object message);
           public void error(Object message);
           public void fatal(Object message);

           // generic printing method:
           public void log(Priority p, Object message);
}

    2. 在配�|�文件中配置Logger�l��g

       可在Log4J配置文�g中配�|�自��q��Logger�l��g�Q�示例：

       log4j.logger.myLogger=WARN

       以上代码定义了一个Logger�l��g�Q�名�U�CؓmyLogger�Q�日志��别�ؓWARN�?br />
    3. 日志�U�别�U�类�Q?/p>
       一共有五种�Q��别由高到低依�ơ是�Q�fatal、error、warn、info、debug。获得Logger实例后，我们可调用以下方法之一输出日志信息�Q?/p>
       public void debug(Object message);          //输出debug�U�别的日志信息；
       public void info(Object message);           //输出info�U�别的日志信息；
       public void warn(Object message);           //输出warn�U�别的日志信息；
       public void error(Object message);          //输出error�U�别的日志信息；
       public void fatal(Object message);          //输出fatal�U�别的日志信息；
       public void log(Priority p, Object message);//输出参数Priority指定�U�别的日志信息；

       以上�Ҏ��只有当它的��别大于或�{�于Logger�l��g配置的日志��别时才调用。以前面我们配置的myLogger��Z��Q�它的日志��别�ؓWARN, 那么在程序中�Q�它的warn()、error()、fatal()�Ҏ��会被执行。对于log()�Ҏ��Q�只有当它的参数Priority指定的日志��别大于或�{�于WARN�Ӟ��它才会被执行�?/p>
    4. ��Z��么需要对日志�q�行分��Q?br />
       在写�E�序的时候，��Z��调试�E�序�Q�我们会在很多出错的地方输出大量的日志信息。当�E�序调试完，不需要这些信息时�Q�将�E�序中这些输出日志信息代码删除吗�Q�这栯��时费力，对于大型�E�序几乎不可行。通过�Ҏ��志分�U�，假如不想输出WARN�U�别的日志信息，则Logger�l��g的��别调高即可，省时省心�?/p>
    5. Logger�l��g的��承�?/p>
       Log4J提供了一个root Logger�Q�它是所有Logger�l��g�?#8220;��先”,它永�q�存在，且不能通过名字��索或引用�Q�通过Logger.getRootLogger()�Ҏ��取得它。配�|�root Logger代码�Q?/p>
       log4j.rootLogger=INFO,console

       可在配置文�g中方便地配置存在�l�承关系的Logger�l��g�Q�凡是在�W�号“.”后面的组仉��会成为在�W�号“.”前面的Logger�l��g的子�c�R��例如：

       log4j.apache.myLogger=WARN
       log4j.apache.myLogger.mySonLogger=,file

       以上代码�? mySonLogger是myLogger的子�c�Logger�l��g。Logger�l��g的��承关�p�：
       . 如果子类Logger�l��g没有定义日志�U�别�Q�则��承父�cȝ��日志�U�别;
       . 如果子类Logger�l��g定义了日志��别，��׃��会��承父�cȝ��日志�U�别;
       . 黙认情况下，子类Logger�l��g会��承父�c�L��有的Appender�Q�把它们加入到自��q��Appener;
       . 如果把子�c�Logger�l��g的additivity标志设�ؓfalse�Q�那么它��׃��会��承父�c�Appender。additivity标志默认��gؓfalse�Q?/p>
       以上配置的三个Logger�l�承关系�C�Z��如图�Q?br />
       root Logger: 日志�U�别=INFO appender清单=console
                            ↑
       myLogger: 日志�U�别=WARN appender清单=null
                            ↑
       mySonLogger: 日志�U�别=null appender清单=file

       �q�三个Logger�l��g实际日志�U�别和Appender如下表：

       Logger�l��g          日志�U�别          Appender清单
       root Logger         INFO              console
       myLogger            WARN              console(�l�承)
       mySonLogger         WARN(�l�承)        file�Q�console(�l�承)

三、Appender�l��g

    Appender�l��g军_��日志信息输出到什么地斏V��支持以下目的地�Q?br />     . 控制�?Console);
    . 文�g(File);
    . GUI�l��g(GUI component);
    . 套接口服务器(Remote socket server);
    . NT的事件记录器(NT Event Logger);
    . UNIX Syslog守护�q�程(Remote UNIX Syslog daemon);

    一个Logger可同时对应多个Appender�Q�示例：myLogger配置二个Appender: 一个file, 一个是console�Q?/p>
    log4j.logger.myAppender=WARN,file,console

    log4j.appender.file=org.apache.log4j.RollingFileAppender
    log4j.appender.file.File=log.txt

    log4j.apender.console=org.apache.log4j.ConsoleAppender

四、Layout�l��g

    Layout�l��g军_��日志输出格式�Q�有以下几种�c�d��Q?br />     . org.apache.log4j.HTMLLayout(以HTML表格形式布局);
    . org.apache.log4j.PatternLayout(可以灉|��地指定布局模式);
    . org.apache.log4j.SimpleLayout(包含日志信息的��别和信息字符�?;
    . org.apache.log4j.TTCCLayout(包含日志产生的时间、线�E�和�c�d��{�信�?;

    为名�U�Cؓconsole的Appender配置SimpleLayout�Q�代码如下：

    log4j.appender.console.layout=org.apache.log4j.SimpleLayout

    输出日志格式如下�Q?/p>
    WARN - This is a log message from the myLogger

    为名�U�Cؓfile的Appender配置PatternLayout�Q�代码如下：

    log4j.appender.file.layout=org.apache.log4j.PatternLayout
    log4j.appender.file.layout.ConversionPattern=%t %p - %m%n

    输出日志格式如下�Q?/p>
    THREAD-1 WARN - This is a log message from the myLogger

    PatternLayout让开发者依照ConversionPattern定义输出格式。ConversionPattern中一些指定日志内容和格式的预定义�W�号说明如下�Q?/p>
    �W�号         描述
    %r           自程序开始后消耗的毫秒�?br />     %t           表示日志记录��h��生成的线�E?br />     %p           表示日专语句的优先��
    %r           与日志请求相关的�c�d��名称
    %c           日志信息所在的�c�d��
    %m%n         表示日志信息的内�?/p>
五、Log4J的基本用�?/p>
    1. 定义配置文�g
       Log4J支持二种配置文�g格式�Q�XML和Java属性文�?采用“�?�?#8221;形式)。以下�ؓJava属性文�?br />        格式配置文�g�Q?br />
       . 配置Logger�l��g

         配置root Logger语法为：log4j.rootLogger=[priority],appenderName,appenderName,...
         配置自定义Logger�l��g语法为：log4j.logger.loggerName=[priority],appenderName,appenderName,...

         其中�Q�priority为日志��别，可选值包括FATAL、ERROR、WARN、INFO、DEBUG、ALL�Q?br />                appenderName指定Appender�l��g�Q�可指定多个;

       . 配置Appender�l��g

         配置日志信息输出目的地Appender, 语法为：
         log4j.appender.appenderName=fully.ualified.name.of.appender.class
         log4j.appender.appenderName.option1=value1
         ...
         log4j.appender.appenderName.optionN=valueN

         Log4J提供的Appender有以下几�U�：

         a. org.apache.log4j.ConsoleAppender(控制�?;
         b. org.apache.log4j.FileAppender(文�g);
         c. org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文�?;
         d. org.apache.log4j.RollingFileAppender(文�g大小到指定尺��生一个新的文�?;
         e. org.apache.log4j.WriteAppender(��日志信息以��格式发送到��L��指定地方);

       . 配置Layout�l��g

         配置Layout�l��g语法为：
         log4j.appender.appenderName.layout=fully.ualified.name.of.appender.class
         log4j.appender.appenderName.layout.option1=value1
         ...
         log4j.appender.appenderName.layout.optionN=valueN

         下面��Z��配置文�g�C�Z��Q�文件名为log4j.properties�Q?/p>
         ## LOGGERS ##

         #configure root logger
         log4j.rootLogger=INFO,console
         #define a logger named myLogger
         log4j.logger.myLogger=WARN
         #define a second logger that is a child to myLogger
         log4j.logger.myLogger.mySonLogger=,file

         ## APPENDERS ##

         #define an appender named console, which is set to be a ConsoleAppender
         log4j.appender.console=org.apache.log4j.ConsoleAppender

         # define an appender named file, which is set to be a RollingFileAppender
         log4j.appender.file=org.apache.log4j.FileAppender
         log4j.appender.file.File=log.txt

         ## LAYOUTS ##
         # assian a SimpleLayout to console appender
         log4j.appender.console.layout=org.apache.log4j.SimpleLayout

         # assian a PatternLayout to file appender
         log4j.appender.file.layout=org.apache.log4j.PatternLayout
         log4j.appender.file.layout.ConversionPattern=%t%p-%m%n

    2. �E�序中��用Log4j

       . 获得日志记录器：

         获得rootLogger�Q�Logger rootLogger=Logger.getRootLogger();
         获得自定义Logger�Q�Logger myLogger = Logger.getLogger("log4j.logger.myLogger");

       . ��d��日志记录器，配置Log4J环境;

         a. BasicConfigurator.configure(): 自动快速地使用默认Log4J环境;
         b. Property.configurator.configure(String configFilename): ��d��使用Java属性格式的配置文�g�q��|�Log4J环境�Q?br />          c. DOMConfigurator.configure(String filename): ��d��XML形式的配�|�文件�ƈ配置LOG4J环境;

       . 输出日志信息;

         在程序代码中需要生成日志的地方�Q�调用Logger的各�U�输出日志方法输��Z��同��别的日志�Q�例如：

         myLogger.debug("Thie is a log message from the " + myLogger.getName());

         下面��Z��使用Log4J的程序，�E�序名�ؓTest.java�Q?/p>
java 代码

import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;

public class Test {

   public static void main(String[] args) {
     //Get an instance of the myLogger
     Logger myLogger = Logger.getLogger("myLogger");

     //Get an instance of the childLogger
     Logger mySonLogger = Logger.getLogger("myLogger.mySonLogger");
     //Load the proerties using the PropertyConfigurator
     PropertyConfigurator.configure("log4j.properties");

     //Log Messages using the Parent Logger
     myLogger.debug("Thie is a log message from the " + myLogger.getName());
     myLogger.info("Thie is a log message from the " + myLogger.getName());
     myLogger.warn("Thie is a log message from the " +  myLogger.getName());
     myLogger.error("Thie is a log message from the " + myLogger.getName());
     myLogger.fatal("Thie is a log message from the " + myLogger.getName());

     mySonLogger.debug("Thie is a log message from the " + mySonLogger.getName());
     mySonLogger.info("Thie is a log message from the " + mySonLogger.getName());
     mySonLogger.warn("Thie is a log message from the " +  mySonLogger.getName());
     mySonLogger.error("Thie is a log message from the " + mySonLogger.getName());
     mySonLogger.fatal("Thie is a log message from the " + mySonLogger.getName());
   }
}

        �E�序�q�行�l�果�?

        WARN - Thie is a log message from the myLogger
        ERROR - Thie is a log message from the myLogger
        FATAL - Thie is a log message from the myLogger
        WARN - Thie is a log message from the myLogger.mySonLogger
        ERROR - Thie is a log message from the myLogger.mySonLogger
        FATAL - Thie is a log message from the myLogger.mySonLogger

        另在Test.class所在的目录下看��C��个log.txt文�g�Q�内容如下：

        WARN - Thie is a log message from the myLogger.mySonLogger
        ERROR - Thie is a log message from the myLogger.mySonLogger
        FATAL - Thie is a log message from the myLogger.mySonLogger

        如将配置文�glog4j.properties中语�?/p>
log4j.logger.myLogger.mySonLogger=,file

改�ؓ

log4j.logger.myLogger.mySonLogger=,file,console

再次�q�行�E�序�Q�结果如下：

        WARN - Thie is a log message from the myLogger
        ERROR - Thie is a log message from the myLogger
        FATAL - Thie is a log message from the myLogger
        WARN - Thie is a log message from the myLogger.mySonLogger
        WARN - Thie is a log message from the myLogger.mySonLogger
        ERROR - Thie is a log message from the myLogger.mySonLogger
        ERROR - Thie is a log message from the myLogger.mySonLogger
        FATAL - Thie is a log message from the myLogger.mySonLogger
        FATAL - Thie is a log message from the myLogger.mySonLogger

        mySonLogger的日志在控制��C��输出了二�ơ，�q�是因�ؓmySonLogger�l�承了父�c�console Appender�Q?br />         本��n又定义了一个console Appender, 因而有二个console Appender�?/p>
六、在web应用中��用Log4J

    创徏一个Servlet�Q�在它初始化�Ҏ��中读取Log4J配置文�g�q��|�Log4J环境�Q�这个Servlet在Web应用�?br />     动时候被加蝲和初始化�Q�然后就可在其它Web�l��g中获取Logger对象�q�输出日志�?/p>
    1. 创徏用于配置Log4J环境的Servlet

java 代码

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

import org.apache.log4j.PropertyConfigurator;

public class Log4JServlet extends HttpServlet {
      public void init() throws ServletException {
           String path = getServletContext().getRealPath("/");
           //getInitParameter("propfile")�Ҏ��从web.xml文�g中读取Log4J配置文�g的名�?profile"�?
           String propfile = path + getInitParameter("propfile");
           PropertyConfigurator.configure(propfile);
      }
}


      该Servlet在web.xml中的配置如下�Q?br />

xml 代码

<servlet>
  <servlet-name>log4jServletservlet-name>
  <servlet-class>Log4JServletservlet-class>
  <init-param>
    <param-name>propfileparam-name>
    <param-value>/WEB-INF/log4j.propertiesparam-value>
  init-param>
  <load-on-startup>1load-on-startup>
servlet>

2. 在login.jsp中输出日�?br />        <%@page import="org.apache.log4j.Logger"%>


           login


           <%
             Logger myLogger = Logger.getLogger("myLogger");
             Logger mySonLogger = Logger.getLogger("myLogger.mySonLogger");
             myLogger.debug("Thie is a log message from the " + myLogger.getName());
             myLogger.info("Thie is a log message from the " + myLogger.getName());
             myLogger.warn("Thie is a log message from the " + myLogger.getName());
             myLogger.error("Thie is a log message from the " + myLogger.getName());
             myLogger.fatal("Thie is a log message from the " + myLogger.getName());

             mySonLogger.debug("Thie is a log message from the " + mySonLogger.getName());
             mySonLogger.info("Thie is a log message from the " + mySonLogger.getName());
             mySonLogger.warn("Thie is a log message from the " + mySonLogger.getName());
             mySonLogger.error("Thie is a log message from the " + mySonLogger.getName());
             mySonLogger.fatal("Thie is a log message from the " + mySonLogger.getName());
           %>




             username:


             password:








    3. 发布�q�行使用Log4J的web应用
       1) ��Log4J的JAR文�g拯��至目录：        2) 创徏Log4J的配�|�文件log4j.properties, 存放目录为：        3) �~�译Log4JServlet, 存放至目录：        4) 修改web.xml文�g�Q�加入以下内容：

xml 代码

<servlet>
  <servlet-name>log4jServletservlet-name>
  <servlet-class>Log4JServletservlet-class>
  <init-param>
    <param-name>profileparam-name>
    <param-value>/WEB-INF/log4j.propertiesparam-value>
  init-param>
  <load-on-startup>1load-on-startup>
servlet>

       5) 启动服务器，讉K��login.jsp��面�Q�在服务器控制台上看到如下日志：
          WARN - Thie is a log message from the myLogger
          ERROR - Thie is a log message from the myLogger
          FATAL - Thie is a log message from the myLogger
          WARN - Thie is a log message from the myLogger.mySonLogger
          ERROR - Thie is a log message from the myLogger.mySonLogger
          FATAL - Thie is a log message from the myLogger.mySonLogger

          另在
          WARN - Thie is a log message from the myLogger.mySonLogger
          ERROR - Thie is a log message from the myLogger.mySonLogger
          FATAL - Thie is a log message from the myLogger.mySonLogger

lanxin1020 2009-05-04 17:19 发表评论

log4j(�?

lanxin1020 — Mon, 04 May 2009 06:40:00 GMT

在实际编�E�时�Q�要�?span class="hilite1">Log4j真正在系�l�中�q�行事先�q�要寚w��|�文件进行定义。定义步骤就是对Logger、Appender及Layout的分别��用�?br /> Log4j支持两种配置文�g格式�Q�一�U�是XML格式的文�Ӟ��一�U�是java properties�Q�key=value�Q�【Java�Ҏ��文�Ӟ��?��|��】。下面我们介�l��用Java�Ҏ��文件做为配�|�文件的�Ҏ��
具体如下�Q?br /> 　　
　　1、配�|�根Logger �Q?/strong> 其语法�ؓ�Q?br /> 　　log4j.rootLogger = [ level ] , appenderName1, appenderName2, …
level : 是日志记录的优先�U�，分�ؓOFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的��别�?span class="hilite1">Log4j��只��用四个��别，优先�U�从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的�U�别�Q�您可以控制到应用程序中相应�U�别的日志信息的开兟뀂比如在�q�里�?义了INFO�U�别�Q�则应用�E�序中所有DEBUG�U�别的日志信息将不被打印出来�?br /> 　　appenderName:��是指定日志信息输出到哪个地斏V��您可以同时指定多个输出目的地�?br /> 例如�Q?span class="hilite1">log4j.rootLogger�Q�info,A1,B2,C3
　　
　　2、配�|�日志信息输出目的地 �Q�其语法为：
　　log4j.appender.appenderName = fully.qualified.name.of.appender.class //
　　 "fully.qualified.name.of.appender.class" 可以指定下面五个目的��C��的一个：
1.org.apache.log4j.ConsoleAppender�Q�控制台�Q?br /> 2.org.apache.log4j.FileAppender�Q�文�Ӟ��
3.org.apache.log4j.DailyRollingFileAppender�Q�每天��生一个日志文�Ӟ��
4.org.apache.log4j.RollingFileAppender�Q�文件大��到达指定尺寸的时候��生一个新的文�Ӟ��
5.org.apache.log4j.WriterAppender�Q�将日志信息以流格式发送到��L��指定的地方）
1.ConsoleAppender选项
Threshold=WARN:指定日志消息的输出最低层�ơ�?br /> ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立卌��出�?br /> Target=System.err�Q�默认情况下是：System.out,指定输出控制�?br /> 2.FileAppender 选项
Threshold=WARN:指定日志消息的输出最低层�ơ�?br /> ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立卌��出�?br /> File=mylog.txt:指定消息输出到mylog.txt文�g�?br /> Append=false:默认值是true,卛_��消息增加到指定文件中�Q�false指将消息覆盖指定的文件内宏V�?br /> 3.DailyRollingFileAppender 选项
Threshold=WARN:指定日志消息的输出最低层�ơ�?br /> ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立卌��出�?br /> File=mylog.txt:指定消息输出到mylog.txt文�g�?br /> Append=false:默认值是true,卛_��消息增加到指定文件中�Q�false指将消息覆盖指定的文件内宏V�?br /> DatePattern='.'yyyy-ww:每周滚动一�ơ文�Ӟ��x��周��生一个新的文件。当然也可以指定按月、周、天、时和分。即对应的格式如下：
1)'.'yyyy-MM: 每月
2)'.'yyyy-ww: 每周
3)'.'yyyy-MM-dd: 每天
4)'.'yyyy-MM-dd-a: 每天两次
5)'.'yyyy-MM-dd-HH: 每小�?br /> 6)'.'yyyy-MM-dd-HH-mm: 每分�?br /> 4.RollingFileAppender 选项
Threshold=WARN:指定日志消息的输出最低层�ơ�?br /> ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立卌��出�?br /> File=mylog.txt:指定消息输出到mylog.txt文�g�?br /> Append=false:默认值是true,卛_��消息增加到指定文件中�Q�false指将消息覆盖指定的文件内宏V�?br /> MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小�Ӟ��会自动滚动�Q�即��原来的内容�U�d��mylog.log.1文�g�?br /> MaxBackupIndex=2:指定可以产生的滚动文件的最大数�?实际应用�Q?br /> 　　log4j.appender.A1=org.apache.log4j.ConsoleAppender //�q�里指定了日志输出的�W�一个位�|�A1是控制台ConsoleAppender
　　
　　3、配�|�日志信息的格式 �Q?/span> 其语法�ؓ�Q?br /> 　　A. log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
"fully.qualified.name.of.layout.class" 可以指定下面4个格式中的一个：
1.org.apache.log4j.HTMLLayout�Q�以HTML表格形式布局�Q�，
　　 2.org.apache.log4j.PatternLayout�Q�可以灵�z�d��指定布局模式�Q�，
　　 3.org.apache.log4j.SimpleLayout�Q�包含日志信息的�U�别和信息字�W�串�Q�，
　　 4.org.apache.log4j.TTCCLayout�Q�包含日志��生的旉��、线�E�、类别等�{�信息）
1.HTMLLayout 选项
LocationInfo=true:默认值是false,输出java文�g名称和行�?br /> Title=my app file: 默认值是 Log4J Log Messages.
2.PatternLayout 选项
ConversionPattern=%m%n :指定怎样格式化指定的消息�?br /> 3.XMLLayout 选项
LocationInfo=true:默认值是false,输出java文�g和行�?br /> 实际应用�Q?br /> 　　log4j.appender.A1.layout=org.apache.log4j.PatternLayout
B . log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
�q�里需要说明的��是日志信息格式中几个符��h��代表的含义：
　　 �Q�X�? X信息输出时左寚w��Q?br /> %p: 输出日志信息优先�U�，即DEBUG�Q�INFO�Q�WARN�Q�ERROR�Q�FATAL,
%d: 输出日志旉��点的日期或时��_��默认格式为ISO8601�Q�也可以在其后指定格式，比如�Q?d{yyy MMM dd HH:mm:ss,SSS}�Q�输出类��|��2002�q?0�?8�?22�Q?0�Q?8�Q?21
%r: 输出自应用启动到输出该log信息耗费的毫�U�数
%c: 输出日志信息所属的�cȝ��Q�通常��是所在类的全�?br /> %t: 输出产生该日志事件的�U�程�?br /> %l: 输出日志事�g的发生位�|�，相当�?C.%M(%F:%L)的组�?包括�cȝ��名、发生的�U�程�Q�以及在代码中的行数。�D例：Testlog4.main(TestLog4.java:10)
%x: 输出和当前线�E�相兌��的NDC(嵌套诊断环境),��其用到像java servlets�q�样的多客户多线�E�的应用中�?br /> %%: 输出一�?%"字符
%F: 输出日志消息产生时所在的文�g名称
%L: 输出代码中的行号
%m: 输出代码中指定的消息,产生的日志具体信�?br /> %n: 输出一个回车换行符�Q�Windows�q�_��?\r\n"�Q�Unix�q�_��?\n"输出日志信息换行
可以�?与模式字�W�之间加上修饰符来控制其最��宽度、最大宽度、和文本的对齐方式。如�Q?br /> 1)%20c�Q�指定输出category的名�U�ͼ�最��的宽度�?0�Q�如果category的名�U�小�?0的话�Q�默认的情况下右寚w��?br /> 2)%-20c:指定输出category的名�U�ͼ�最��的宽度�?0�Q�如果category的名�U�小�?0的话�Q?-"��h��定左寚w��?br /> 3)%.30c:指定输出category的名�U�ͼ�最大的宽度�?0�Q�如果category的名�U�大�?0的话�Q�就会将左边多出的字�W�截掉，但小�?0的话也不会有�I�格�?br /> 4)%20.30c:如果category的名�U�小�?0��p��I�格�Q��ƈ且右寚w��Q�如果其名称长于30字符�Q�就从左边交�q�销出的字符截掉�?br /> 　　�q�里上面三个步骤是对前面Log4j�l��g说明的一个简化；下面�l�出一个具体配�|�例子，在程序中可以参照执行�Q?br /> 　　log4j.rootLogger=INFO,A1�Q�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
　　�Ҏ��上面的日志格式，某一个程序的输出�l�果如下�Q?br /> 　　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. # 当输��Z��息于回滚文�g�?/span>
log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender //指定以文件的方式输出日志
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log //文�g位置,也可以用变量${java.home}、rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=10KB //文�g最大尺�?br /> log4j.appender.ROLLING_FILE.MaxBackupIndex=1 //备䆾�?br /> 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 　　
××××××××××××××××××××××××××××××××××××××××××××××××

附：Log4j比较全面的配�|?/span>
LOG4J的配�|�之��单��它遍及于��来��多的应用中了：Log4J配置文�g实现了输出到控制台、文件、回滚文件、发送日志邮件、输出到数据库日志表、自定义标签�{�全套功能。择其一二��用就够用了，
log4j.rootLogger=DEBUG,CONSOLE,A1,im
log4j.addivity.org.apache=true
# 应用于控制台
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n
#应用于文�?
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=file.log
log4j.appender.FILE.Append=false
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# Use this layout for LogFactor 5 analysis
# 应用于文件回�?
log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log //文�g位置,也可以用变量${java.home}、rolling.log
log4j.appender.ROLLING_FILE.Append=true //true:��d�� false:覆盖
log4j.appender.ROLLING_FILE.MaxFileSize=10KB //文�g最大尺�?br /> log4j.appender.ROLLING_FILE.MaxBackupIndex=1 //备䆾�?br /> 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

#应用于socket
log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
# Set up for Log Facter 5
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n

# Log Factor 5 Appender
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
# 发送日志给邮�g
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=web@www.wuset.com
log4j.appender.MAIL.SMTPHost=www.wusetu.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=web@www.wusetu.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# 用于数据�?
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=SampleMessages.log4j
log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
#自定义Appender
log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender
log4j.appender.im.host = mail.cybercorlin.net
log4j.appender.im.username = username
log4j.appender.im.password = password
log4j.appender.im.recipient = corlin@cybercorlin.net
log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

lanxin1020 2009-05-04 14:40 发表评论

log4j(�?

lanxin1020 — Mon, 04 May 2009 06:37:00 GMT
Log4j下蝲
在apache�|�站�Q�jakarta.apache.org/log4j 可以免费下蝲�?span class="hilite1">Log4j最新版本的软�g包�?

Log4j使用
Log4j的包下蝲完成后，解压�Q�将其中打包好的�?span class="hilite1">log4j-1.x.x.jar导入你的工程LIB中�?
Log4j之所以受�Ƣ迎的原因之一是它的灵�z�L��?span class="hilite1">Log4j提供了灵�zȝ��配置�Ҏ��Q�默认是调用BasicConfigurator.configure()来进行配�|�，但如果只是简单的调用BasicConfigurator.configure()来进行配�|�工作，那么所有的配置都是固定的，不方便以后修攚w��|�。另一�U�是动态配�|�，Log4j提供了PropertyConfigurator.configure(……)来动态配�|�，参数可以是一个properties文�g所在�\径的String对象�Q�可以是一个properties文�g所在�\径的URL对象�Q�也可以是一个properties对象。如果要用XML文�g来配�|�信息，则可用类型的DOMConfigurator()函数来从一个XML文�g中加载配�|�信息。这�U�方式更方便修改配置�?

动态配�|?

Java代码

package http;



import org.apache.log4j.BasicConfigurator;

import org.apache.log4j.Logger;

import org.apache.log4j.PropertyConfigurator;

import org.apache.log4j.xml.DOMConfigurator;



public class Log4jDemo {

    static Logger log = Logger.getLogger(Log4jDemo.class.getClass());

    /**

     * main

     * @param args

     */

    public static void main(String[] args) {

        BasicConfigurator.configure();//默认配置

        PropertyConfigurator.configure("c:/log4j.properties");

        //动态配�|?参数可以是一个properties文�g所在�\径的String对象

        //可以是一个properties文�g所在�\径的URL对象�Q�也可以是一个properties对象



        DOMConfigurator.configure("c:/log4j.xml");//XML配置文�g



        //PropertyConfigurator.configure()的参数还可以是XML、Properties对象



        //下面��可使用log4j

        log.info("info");

        log.debug("debug");

        log.error("error");

        log.warn("warn");

    }



}

package http; import org.apache.log4j.BasicConfigurator; import org.apache.log4j.Logger; import org.apache.log4j.PropertyConfigurator; import org.apache.log4j.xml.DOMConfigurator; public class Log4jDemo { static Logger log = Logger.getLogger(Log4jDemo.class.getClass()); /** * main * @param args */ public static void main(String[] args) { BasicConfigurator.configure();//默认配置 PropertyConfigurator.configure("c:/log4j.properties"); //动态配�|?参数可以是一个properties文�g所在�\径的String对象 //可以是一个properties文�g所在�\径的URL对象�Q�也可以是一个properties对象 DOMConfigurator.configure("c:/log4j.xml");//XML配置文�g //PropertyConfigurator.configure()的参数还可以是XML、Properties对象 //下面��可使用log4j log.info("info"); log.debug("debug"); log.error("error"); log.warn("warn"); } }

J2EE应用log4j
上面代码描述�?span class="hilite1">Log4j的简单应用，其实使用Log4j也就是这��L��单方�ѝ��当焉��了上面的配置�Ҏ��Q�还有其它，比如做一个J2EE应用�Q�在J2EE应用使用Log4j�Q�必��d��在启动服务时加蝲Log4j的配�|�文件进行初始化�Q�可以在web.xml中进行�?

java 代码

Java代码

import java.io.IOException;

import java.io.PrintWriter;



import javax.servlet.ServletException;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;







public class J2eeLog4jDemo extends HttpServlet {



    public void destroy() {

        super.destroy();

    }

    public void doGet(HttpServletRequest request, HttpServletResponse response)

            throws ServletException, IOException {

    }

    public void doPost(HttpServletRequest request, HttpServletResponse response)

            throws ServletException, IOException {

    }

    public void init() throws ServletException {

        //通过web.xml来动态取得配�|�文�?nbsp;

        String prefix = getServletContext().getRealPath("/");

        String file = getInitParameter("log4j");



        //如果没有�l�出相应的配�|�文�Ӟ��则不�q�行初始�?nbsp;

        if(file != null)

        {

            PropertyConfigurator.configure(prefix+file);

        }

    }



}

import java.io.IOException; import java.io.PrintWriter; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class J2eeLog4jDemo extends HttpServlet { public void destroy() { super.destroy(); } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { } public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { } public void init() throws ServletException { //通过web.xml来动态取得配�|�文�? String prefix = getServletContext().getRealPath("/"); String file = getInitParameter("log4j"); //如果没有�l�出相应的配�|�文�Ӟ��则不�q�行初始�? if(file != null) { PropertyConfigurator.configure(prefix+file); } } }

Web.xml 代码

Java代码



j2eelog4jdemoservlet-name>

class>J2eeLog4jDemoservlet-class>



log4jparam-name>

log4j.propertiesparam-value>

init-param>

1load-on-startup>  //设�ؓ1�Ӟ��Web容器启动卌��行加�?nbsp;

servlet

j2eelog4jdemoservlet-name> J2eeLog4jDemoservlet-class> log4jparam-name> log4j.propertiesparam-value> init-param> 1load-on-startup> //设�ؓ1�Ӟ��Web容器启动卌��行加�? servlet

Spring配置Log4j
Spring中配�|?span class="hilite1">Log4j只要配置applicationContext.xml文�g�Q?span class="hilite1">Log4j的配�|�文件放在Web工程的根目录下，默认是objectname/root�?可以在web.xml中设�|�工�E�根目录.

讄��根目�?

web.xml 代码

Java代码





  webAppRootKeyparam-name>

  webapp.rootparam-value>

context-param>

webAppRootKeyparam-name> webapp.rootparam-value> context-param>

配置applicationContext.xml

applicationContext.xml 代码

Java代码





log4jConfigLocationparam-name>

/WEB-INF/log4j.propertiesparam-value>



context-param>











log4jRefreshIntervalparam-name>

60000param-value>

context-param>



log4jConfigLocationparam-name> /WEB-INF/log4j.propertiesparam-value> context-param> log4jRefreshIntervalparam-name> 60000param-value> context-param>