Struts2拦截器记录系统操作日志

• 前言

　　最近开发了一个项目，由于项目在整个开发过程中处于赶时间状态（每个项目都差不多如此）所以项目在收尾阶段发现缺少记录系统日志功能，以前系统都是直接写在每个模块的代码中，然后存入表单，在页面可以查看部分日志。这个系统并没有此要求，因此便想到了做一个系统通用的日志记录，主要记录数据有：操作时间、操作对象、操作方法、操作的一些参数以及操作结果。刚开始直接想到的是利用aspect实现aop记录日志，但实际应用中发现aspect并不能友好的拦截action,而是主要用作拦截service层业务。由于系统框架是基于ssh框架的，所以最终考虑使用struts2的自带拦截器Interceptor。

• 什么拦截器？

　　拦截器是动态拦截Action调用的对象。它提供了一种机制可以使开发者可以定义在一个action执行的前后执行的代码，也可以在一个action执行前阻止其执行。同时也是提供了一种可以提取action中可重用的部分的方式。谈到拦截器，还有一个词大家应该知道——拦截器链（Interceptor Chain，在Struts 2中称为拦截器栈Interceptor Stack）。拦截器链就是将拦截器按一定的顺序联结成一条链。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。

•  拦截器的原理和大致流程

　　1.ActionInvocation初始化时，根据配置，加载Action相关的所有Interc eptor。

　　 2. 通过ActionInvocation.invoke方法调用Action实现时，执行Interceptor。

Interceptor将很多功能从我们的Action中独立出来，大量减少了我们Action的代码，独立出来的行为具有很好的重用性。XWork、WebWork的许多功能都是有Interceptor实现，可以在配置文件中组装Action用到的Interceptor，它会按照你指定的顺序，在Action执行前后运行。

• 项目实现拦截器代码

 package com.mnsn.utils;

 import java.io.BufferedWriter;
 import java.io.File;
 import java.io.FileWriter;
 import java.util.Calendar;
 import java.util.Map;
 import java.util.Set;

 import org.apache.struts2.ServletActionContext;

 import com.mnsn.project.user.User;
 import com.opensymphony.xwork2.ActionInvocation;
 import com.opensymphony.xwork2.interceptor.Interceptor;
 import com.opensymphony.xwork2.interceptor.PreResultListener;

 /**
  * 系统日志拦截器
  * @AUTHER LiuLonglong
  * @Motto Goals determine what you are going to be.
  * @URL http://www.cnblogs.com/mvilplss/
  * @Time 下午04:09:37
  * @Version
  */
 public class Dolog implements Interceptor {

     private static final long serialVersionUID = 1L;

     public String intercept(ActionInvocation ai) throws Exception {

         ai.addPreResultListener(new PreResultListener() {

             public void beforeResult(ActionInvocation ai, String arg1) {
                 try {
                     StringBuffer sb = new StringBuffer();
                     sb.append(MyUtils.getDataYmdhms2() + ":");
                     Map<String, Object> session = ai.getInvocationContext().getSession();
                     User user = (User) session.get("loginUser");
                     if (user != null) {
                         sb.append("操作人：" + user.getName());
                     } else {
                         sb.append("操作人：系统未获取");
                     }
                     sb.append("类名：" + ai.getAction() + " ");
                     sb.append("方法名：" + ai.getInvocationContext().getName()+ " ");
                     Map<String, Object> map = ai.getInvocationContext().getParameters();
                     Set<String> keys = map.keySet();
                     sb.append("参数：");
                     for (String key : keys) {
                         sb.append(key + "=" + ((Object[]) map.get(key))[0]+ "#");
                     }
                     sb.append(" ");
                     sb.append("执行结果：" + ai.getResultCode() + " ");
                     String appPath = ServletActionContext.getServletContext().getRealPath("/");
                     saveLog(appPath + "operLog", sb.toString());
                 } catch (Exception e) {
                     e.printStackTrace();
                 }

             }
         });

         return ai.invoke();
     }

     public static void saveLog(String dir, String content) {
         try {
             File path = new File(dir);
             if (!path.exists()) {
                 path.mkdir();
             }
             File LogDir = new File(path + "/"
                     + (Calendar.getInstance().get(Calendar.MONTH) + 1));
             if (!LogDir.exists()) {
                 LogDir.mkdir();
             }
             File file = new File(LogDir + "/"
                     + Calendar.getInstance().get(Calendar.DAY_OF_MONTH)
                     + ".log");
             if (!file.exists()) {
                 file.createNewFile();
             }
             BufferedWriter br = new BufferedWriter(new FileWriter(file, true));
             br.write(content);
             br.newLine();
             br.flush();
             br.close();

             File LogDirOld = new File(
                     path
                             + "/"
                             + (Calendar.getInstance().get(Calendar.MONTH) - 2 > 0 ? (Calendar
                                     .getInstance().get(Calendar.MONTH) - 2)
                                     : Calendar.getInstance()
                                             .get(Calendar.MONTH) + 10));
             if (LogDirOld.exists()) {
                 File[] fileOlds = LogDirOld.listFiles();
                 for (File f : fileOlds) {
                     f.delete();
                 }
                 LogDirOld.delete();
             }
         } catch (Exception e) {
             e.printStackTrace();
         }

     }

     public void destroy() {

     }

     public void init() {

     }
 }

• 项目部分配置

<!-- 配置拦截器 -->
        <interceptors>
            <interceptor name="dolog" class="com.mnsn.utils.Dolog"></interceptor>
            <interceptor-stack name="defaultStack">
                <interceptor-ref name="dolog"></interceptor-ref>
                   <interceptor-ref name="defaultStack"></interceptor-ref>
               </interceptor-stack>
        </interceptors>

• 执行结果

取自于文件：C:\Program Files (x86)\tomcat-6.0.43-myeclipse\webapps\qzdl\operLog\3\10.log

20150310173309:操作人：系统未获取类名：com.mnsn.project.user.UserAction@b2c940 方法名：login 参数：loginname=ss#password=ss#x=31#y=11# 执行结果：pass
20150310173313:操作人：钦州老大类名：com.mnsn.project.user.UserAction@1a2157e 方法名：list 参数： 执行结果：list
20150310173322:操作人：钦州老大类名：com.mnsn.project.user.UserAction@108a2d1 方法名：delete 参数：users[0].id=402881ec4b38cf8f014b38d4510f0001# 执行结果：toList
20150310173323:操作人：钦州老大类名：com.mnsn.project.user.UserAction@13e3101 方法名：list 参数： 执行结果：list
20150310173326:操作人：钦州老大类名：com.mnsn.project.user.UserAction@158a9b 方法名：toOper 参数：user.id=402881fd4becf4d5014becf8253c0000# 执行结果：oper
20150310173328:操作人：钦州老大类名：com.mnsn.project.user.UserAction@174edfd 方法名：update 参数：toWhere=#user.createtime=2015-03-06 10:44:20.0#user.group.id=402881ef4a9f4536014a9f69be6c0005#user.id=402881fd4becf4d5014becf8253c0000#user.job=部门主管#user.loginname=wml#user.mobilephone=18758010019#user.name=王明路#user.office_telephone=0571-6856156#user.password=123456#user.remark=此人为部门管理员#user.unit.id=402881fd4becf4d5014bed053ce80001# 执行结果：toList
20150310173328:操作人：钦州老大类名：com.mnsn.project.user.UserAction@11efcc2 方法名：list 参数： 执行结果：list 

• 总结

　　struts2的拦截器相对aspect来说还是比较容易上手和理解的，对于要求一般的系统操作日志可以采用拦截器，而aspect重要用于细粒度的控制方法的出口和入口，实现逻辑层的增强，例如声明式事物。

• 备注

　　本文在工作繁忙中码出来的，如有错误在所难免，望读者指出，谢谢！