个人在项目中的使用方法,有问题还请不吝指正,积极讨论
自定义注解类
package org.jeecg.common.aspect.annotation;
import org.jeecg.common.constant.CommonConstant;
import org.jeecg.common.constant.enums.ModuleType;
import java.lang.annotation.*;
/**
* 系统日志注解
*/
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface AutoLog {
/**
* 日志内容
*
* @return
*/
String value() default "";
/**
* 日志类型
*
* @return 0:操作日志;1:登录日志;2:定时任务;
*/
int logType() default CommonConstant.LOG_TYPE_2;
/**
* 操作日志类型
*
* @return (1查询,2添加,3修改,4删除)
*/
int operateType() default 0;
/**
* 模块类型 默认为common
* @return
*/
ModuleType module() default ModuleType.COMMON;
}
切面类
package org.jeecg.common.aspect;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.serializer.PropertyFilter;
import org.apache.commons.lang3.StringUtils;
import org.apache.shiro.SecurityUtils;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
import org.aspectj.lang.reflect.MethodSignature;
import org.jeecg.common.api.dto.LogDTO;
import org.jeecg.common.api.vo.Result;
import org.jeecg.common.aspect.annotation.AutoLog;
import org.jeecg.common.constant.CommonConstant;
import org.jeecg.common.constant.enums.ModuleType;
import org.jeecg.common.constant.enums.OperateTypeEnum;
import org.jeecg.modules.base.service.BaseCommonService;
import org.jeecg.common.system.vo.LoginUser;
import org.jeecg.common.util.IpUtils;
import org.jeecg.common.util.SpringContextUtils;
import org.jeecg.common.util.oConvertUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.LocalVariableTableParameterNameDiscoverer;
import org.springframework.stereotype.Component;
import org.springframework.validation.BindingResult;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.http.HttpServletRequest;
import java.lang.reflect.Method;
import java.util.*;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.atomic.AtomicReference;
/**
* 系统日志,切面处理类
*/
@Aspect
@Component
public class AutoLogAspect {
@Resource
private BaseCommonService baseCommonService;
@Pointcut("@annotation(org.jeecg.common.aspect.annotation.AutoLog)")
public void logPointCut() {
}
@Around("logPointCut()")
public Object around(ProceedingJoinPoint point) throws Throwable {
long beginTime = System.currentTimeMillis();
//执行方法
Object result = point.proceed();
//执行时长(毫秒)
long time = System.currentTimeMillis() - beginTime;
//保存日志
saveSysLog(point, time, result);
return result;
}
/**
* 处理注解中的动态参数,把变量占位符替换成实际的变量值
*/
private static String dynamicParam(String logContent, Map<String,Object> paramsMap){
AtomicReference<String> actual = new AtomicReference<>(logContent);
if(StringUtils.isBlank(logContent)){
return actual.get();
}
paramsMap.entrySet().stream().forEach(p->{
if(actual.get().contains(p.getKey())){
actual.set(actual.get().replaceAll(p.getKey(), p.getValue() + ""));
}
});
return actual.get();
}
private static boolean isSimpleType(String name){
AtomicBoolean result = new AtomicBoolean(false);
String[] className = {"String","Integer","Long","int","float","double","char"};
Arrays.asList(className).forEach(n->{
if(name.contains(n)) {
result.set(name.contains(n));
}
});
return result.get();
}
private void saveSysLog(ProceedingJoinPoint joinPoint, long time, Object obj) {
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
Method method = signature.getMethod();
// 解析切面的所有参数,放入一个Map
Map<String, Object> paramsMap = produceParamsMap(joinPoint, signature);
LogDTO dto = new LogDTO();
AutoLog syslog = method.getAnnotation(AutoLog.class);
if (syslog != null) {
//update-begin-author:taoyan date:
//解析注解传进来的日志内容
String content = dynamicParam(syslog.value(), paramsMap);
// String content = syslog.value();
if (syslog.module() == ModuleType.ONLINE) {
content = getOnlineLogContent(obj, content);
}
//注解上的描述,操作日志内容
dto.setLogType(syslog.logType());
dto.setLogContent(content);
}
//请求的方法名
String className = joinPoint.getTarget().getClass().getName();
String methodName = signature.getName();
dto.setMethod(className + "." + methodName + "()");
//设置操作类型
if (CommonConstant.LOG_TYPE_2 == dto.getLogType()) {
dto.setOperateType(getOperateType(methodName, syslog.operateType()));
}
//获取request
HttpServletRequest request = SpringContextUtils.getHttpServletRequest();
//请求的参数
dto.setRequestParam(getRequestParams(request, joinPoint));
//设置IP地址
dto.setIp(IpUtils.getIpAddr(request));
//获取登录用户信息
LoginUser sysUser = (LoginUser) SecurityUtils.getSubject().getPrincipal();
if (sysUser != null) {
dto.setUserid(sysUser.getUsername());
dto.setUsername(sysUser.getRealname());
}
//耗时
dto.setCostTime(time);
dto.setCreateTime(new Date());
//saas
dto.setTenantId(request.getHeader(CommonConstant.TENANT_ID));
//保存系统日志
baseCommonService.addLog(dto);
}
/**
* 把切面中的各种不同类型的参数信息,统一放入一个Map,从而不需要再去别的变量里面寻找参数
*/
private Map<String, Object> produceParamsMap(ProceedingJoinPoint joinPoint, MethodSignature signature) {
Map<String,Object> paramsMap = new HashMap<>(); // 包含此切面的所有参数值的Map
String[] argNames = signature.getParameterNames(); // 参数名
Object[] argObjects = joinPoint.getArgs(); // 参数
List<String> argNameList = Arrays.asList(argNames);
for(int i = 0; i < argNameList.size(); i++){
Class<?> clazz = argObjects[i].getClass();
// 把简单数据类型的参数放入参数Map (包括了Request对象中的ParameterMap)
Object currentParam = joinPoint.getArgs()[i];
if(isSimpleType(clazz.getName())){
paramsMap.put(argNameList.get(i), currentParam);
continue;
}
// 把Request对象中的Attribute属性放入参数Map
if (currentParam instanceof ServletRequest) {
ServletRequest request = (ServletRequest) currentParam;
Enumeration<String> attr = request.getAttributeNames();
while(attr.hasMoreElements()){
String attrName = attr.nextElement();
String attrValue = "";
if (request.getAttribute(attrName) != null) {
attrValue = request.getAttribute(attrName).toString();
}
paramsMap.put(attrName, attrValue);
}
continue;
}
// 把不属于以上两种类型的参数(即Spring MVC/Spring Boot自动接收的Bean类型)放入参数Map
JSONObject object = (JSONObject) JSONObject.toJSON(currentParam);
object.keySet().stream().forEach(p->{
paramsMap.put(p,object.get(p));
});
}
return paramsMap;
}
/**
* 获取操作类型
*/
private int getOperateType(String methodName, int operateType) {
if (operateType > 0) {
return operateType;
}
return OperateTypeEnum.getTypeByMethodName(methodName);
}
/**
* 获取请求参数
*
*/
private String getRequestParams(HttpServletRequest request, JoinPoint joinPoint) {
String httpMethod = request.getMethod();
String params = "";
if ("POST".equals(httpMethod) || "PUT".equals(httpMethod) || "PATCH".equals(httpMethod)) {
Object[] paramArray = paramArray(joinPoint);
params = JSONObject.toJSONString(paramArray);
} else {
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
Method method = signature.getMethod();
// 请求的方法参数值
Object[] args = joinPoint.getArgs();
// 请求的方法参数名称
LocalVariableTableParameterNameDiscoverer u = new LocalVariableTableParameterNameDiscoverer();
String[] paramNames = u.getParameterNames(method);
if (args != null && paramNames != null) {
for (int i = 0; i < args.length; i++) {
params += " " + paramNames[i] + ": " + args[i];
}
}
}
return params;
}
private Object[] paramArray(JoinPoint joinPoint) {
// 存放方法参数的数组
Object[] paramArray = new Object[joinPoint.getArgs().length];
if (joinPoint.getArgs() != null && joinPoint.getArgs().length > 0) {
for (int i = 0; i < joinPoint.getArgs().length; i++) {
if (joinPoint.getArgs()[i] instanceof ServletRequest || joinPoint.getArgs()[i] instanceof ServletResponse || joinPoint.getArgs()[i] instanceof MultipartFile) {
// 跳过Servlet类型的参数
continue;
}
paramArray[i] = joinPoint.getArgs()[i];
}
}
return paramArray;
}
/**
* @param request: request
* @param joinPoint: joinPoint
* @Description: 获取请求参数
* @Return: java.lang.String
*/
private String getReqestParams(HttpServletRequest request, JoinPoint joinPoint) {
String httpMethod = request.getMethod();
String params = "";
if (CommonConstant.HTTP_POST.equals(httpMethod) || CommonConstant.HTTP_PUT.equals(httpMethod) || CommonConstant.HTTP_PATCH.equals(httpMethod)) {
Object[] paramsArray = joinPoint.getArgs();
// java.lang.IllegalStateException: It is illegal to call this method if the current request is not in asynchronous mode (i.e. isAsyncStarted() returns false)
// https://my.oschina.net/mengzhang6/blog/2395893
Object[] arguments = new Object[paramsArray.length];
for (int i = 0; i < paramsArray.length; i++) {
if (paramsArray[i] instanceof BindingResult || paramsArray[i] instanceof ServletRequest || paramsArray[i] instanceof ServletResponse || paramsArray[i] instanceof MultipartFile) {
//ServletRequest不能序列化,从入参里排除,否则报异常:java.lang.IllegalStateException: It is illegal to call this method if the current request is not in asynchronous mode (i.e. isAsyncStarted() returns false)
//ServletResponse不能序列化 从入参里排除,否则报异常:java.lang.IllegalStateException: getOutputStream() has already been called for this response
continue;
}
arguments[i] = paramsArray[i];
}
//update-begin-author:taoyan date:20200724 for:日志数据太长的直接过滤掉
PropertyFilter profilter = new PropertyFilter() {
@Override
public boolean apply(Object o, String name, Object value) {
int length = 500;
if (value != null && value.toString().length() > length) {
return false;
}
return true;
}
};
params = JSONObject.toJSONString(arguments, profilter);
//update-end-author:taoyan date:20200724 for:日志数据太长的直接过滤掉
} else {
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
Method method = signature.getMethod();
// 请求的方法参数值
Object[] args = joinPoint.getArgs();
// 请求的方法参数名称
LocalVariableTableParameterNameDiscoverer u = new LocalVariableTableParameterNameDiscoverer();
String[] paramNames = u.getParameterNames(method);
if (args != null && paramNames != null) {
for (int i = 0; i < args.length; i++) {
params += " " + paramNames[i] + ": " + args[i];
}
}
}
return params;
}
/**
* online日志内容拼接
*
* @param obj
* @param content
* @return
*/
private String getOnlineLogContent(Object obj, String content) {
if (Result.class.isInstance(obj)) {
Result res = (Result) obj;
String msg = res.getMessage();
String tableName = res.getOnlTable();
if (oConvertUtils.isNotEmpty(tableName)) {
content += ",表名:" + tableName;
}
if (res.isSuccess()) {
content += "," + (oConvertUtils.isEmpty(msg) ? "操作成功" : msg);
} else {
content += "," + (oConvertUtils.isEmpty(msg) ? "操作失败" : msg);
}
}
return content;
}
}
使用方式
// 这里的name在参数实体中要有,或者在方法执行完成之前给这个属性赋值 使用在方法上
@AutoLog(value = "测试日志内容-文章名称:name")
request实体
package org.jeecg.modules;
import lombok.Data;
@Data
public class Request {
private String id;
private String name;
}
service中
//方法执行完之前都可以设置
request.setName("母猪产后护理讲解");
最后日志输出
测试日志内容-文章名称:母猪产后护理讲解
表结构
SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;
-- ----------------------------
-- Table structure for sys_log
-- ----------------------------
DROP TABLE IF EXISTS `sys_log`;
CREATE TABLE `sys_log` (
`id` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
`log_type` int NULL DEFAULT NULL COMMENT '日志类型(1登录日志,2操作日志)',
`log_content` varchar(4000) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '日志内容',
`operate_type` int NULL DEFAULT NULL COMMENT '操作类型',
`userid` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '操作用户账号',
`username` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '操作用户名称',
`ip` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT 'IP',
`method` varchar(500) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '请求java方法',
`request_url` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '请求路径',
`request_param` longtext CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '请求参数',
`request_type` varchar(10) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '请求类型',
`cost_time` bigint NULL DEFAULT NULL COMMENT '耗时',
`create_by` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '创建人',
`create_time` datetime(0) NULL DEFAULT NULL COMMENT '创建时间',
`update_by` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '更新人',
`update_time` datetime(0) NULL DEFAULT NULL COMMENT '更新时间',
`tenant_id` int NULL DEFAULT 0,
`integrity` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '完整性',
PRIMARY KEY (`id`) USING BTREE,
INDEX `idx_sl_userid`(`userid`) USING BTREE,
INDEX `idx_sl_log_type`(`log_type`) USING BTREE,
INDEX `idx_sl_operate_type`(`operate_type`) USING BTREE,
INDEX `idx_sl_create_time`(`create_time`) USING BTREE
) ENGINE = MyISAM AUTO_INCREMENT = 1 CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = '系统日志表' ROW_FORMAT = DYNAMIC;
SET FOREIGN_KEY_CHECKS = 1;