Java注解编写

项目里如方法异常上报、记录敏感操作等需求适合用注解完成。实现步骤包括引入依赖和编写注解。

项目中有些需求,比如方法异常上报、记录敏感操作等,这种需求就很适合使用注解完成。

1.引入依赖

        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
        </dependency>
        <!--下面这个依赖和编写注解本身没有关系,只是在处理切面时使用到了里面的方法-->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.4</version>
        </dependency>

2.编写注解

OperateTypeEnum:
package com.example.study.annotation;

public enum OperateTypeEnum {
    CREATE(1, "新增"),
    READ(2, "查询"),
    UPDATE(3, "编辑"),
    DELETE(4, "删除"),
    IMPORT(5, "导入"),
    EXPORT(6, "导出"),
    CREATE_OR_UPDATE(7, "新增或编辑");
    private Integer type;
    private String desc;

    OperateTypeEnum(Integer type, String desc) {
        this.type = type;
        this.desc = desc;
    }

    public Integer getType() {
        return type;
    }

    public String getDesc() {
        return desc;
    }
}


OperateLog:
package com.example.study.annotation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface OperateLog {
    OperateTypeEnum value();

    String desc();
}
OperateAspect:
package com.example.study.annotation;

import org.apache.commons.lang3.StringUtils;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.springframework.stereotype.Component;

import java.lang.reflect.Field;

@Aspect
@Component
public class OperateAspect {
    private static final String SEPARATOR = System.getProperty("line.separator");

    @Pointcut("@annotation(com.example.study.annotation.OperateLog)")
    private void pointCut() {
    }

    @Before("pointCut() && @annotation(operateLog)")
    public void before(JoinPoint joinPoint, OperateLog operateLog) {
        System.out.println("-----before");
    }

    @After("pointCut()")
    public void after(JoinPoint joinPoint) {
        System.out.println("-----after");
    }

    @AfterReturning(value = "pointCut()", returning = "result")
    public void afterReturning(JoinPoint joinPoint, Object result) {
        System.out.println("-----afterReturning");
        System.out.println(result == null ? "null" : result.toString());
    }

    @AfterThrowing(value = "pointCut()", throwing = "e")
    public void afterThrowing(JoinPoint joinPoint, Exception e) {
        System.out.println("-----afterThrowing");
        e.printStackTrace();
    }


    @Around("pointCut() && @annotation(operateLog)")
    public Object saveOperateLog(ProceedingJoinPoint point, OperateLog operateLog) throws Throwable {
        StringBuilder sb = new StringBuilder();
        String methodName = point.getSignature().getName();
        Object target = point.getTarget();
        sb.append("调用方法名:").append(methodName)
                .append(SEPARATOR).append("目标对象:").append(target.toString())
                .append(SEPARATOR).append("方法参数:");
        for (Object arg : point.getArgs()) {
            sb.append(SEPARATOR).append(arg.toString());
        }

        System.out.println(sb.toString());
        OperateTypeEnum operateType = operateLog.value();
        if (operateType.equals(OperateTypeEnum.CREATE_OR_UPDATE)) {
            for (Object arg : point.getArgs()) {
                Field id;
                try {
                    id = arg.getClass().getDeclaredField("id");
                } catch (Exception e) {
                    continue;
                }
                Object idValue = null;
                if (id != null) {
                    id.setAccessible(true);
                    idValue = id.get(arg);
                }
                if (idValue == null || StringUtils.isBlank(idValue.toString())) {
                    operateType = OperateTypeEnum.CREATE;
                } else {
                    operateType = OperateTypeEnum.UPDATE;
                }
                break;
            }
        }
        Object obj = point.proceed();
        System.out.println("操作类型:" + operateType.getType() + "\t" + operateType.getDesc()
                + SEPARATOR + "操作描述:" + operateLog.desc());
        return obj;
    }
}

 

 

 

Java 中,注解(Annotation)本身不会自动生成文档,但可以通过结合 Javadoc 工具生成 API 文档。Javadoc 是 Java 提供的一种标准文档生成工具,能够从源代码中提取类、接口、方法和字段的注释,并生成 HTML 格式的文档。 ### 一、编写 Java 注解并添加文档说明 你可以为自定义注解及其使用处添加 Javadoc 注释,这样在生成文档时就能清晰地描述注解的作用与用法。 #### 示例:定义一个自定义注解并为其添加文档 ```java /** * 自定义注解,用于标记某个方法是实验性功能 */ public @interface Experimental { } ``` #### 使用该注解并在方法上添加文档 ```java public class Feature { /** * 这是一个实验性的功能方法。 * <p> * 注意:此方法可能会在未来版本中更改或移除。 * * @return 返回一个字符串表示实验结果 */ @Experimental public String experimentalMethod() { return "This is an experimental feature."; } } ``` ### 二、生成文档 使用 JDK 自带的 `javadoc` 命令来生成文档: ```bash javadoc -d docs -sourcepath src -subpackages your.package.name ``` - `-d docs` 表示输出目录为 `docs` - `-sourcepath src` 表示源码在 `src` 目录下 - `-subpackages your.package.name` 表示要处理的包名 生成后,在浏览器中打开 `docs/index.html` 即可查看带有注解信息的文档。 --- ### 三、高级用法:通过注解处理器生成文档(可选) 如果你希望更自动化地生成文档,可以使用注解处理器(Annotation Processor),例如结合 [Dagger](https://dagger.dev/) 或 [AutoService](https://github.com/google/auto/tree/master/service) 等框架实现。不过这种方式较为复杂,适合大型项目需要动态生成配置或文档的情况。 --- ### 四、解释 1. **@interface**:定义一个注解类型。 2. **Javadoc 注释**:以 `/** ... */` 包裹,支持标签如 `@param`, `@return`, `@throws` 等。 3. **生成文档工具**:Java 官方提供了 `javadoc` 工具,它会读取所有 Javadoc 注释并生成结构化的 API 文档。 4. **文档内容**:包括类、方法、字段以及注解本身的描述。 --- ###
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值