Hugo 日志 AOP AspectJ

发布时间：2023-09-06 01:51责任编辑：郭大石关键词：暂无标签

GitHub：https://github.com/JakeWharton/hugo

Hugo是JakeWharton大神开发的一个通过注解触发的Debug日志库。它是一个非常好的AOP框架，在Debug模式下，Hugo利用aspectj库来进行切面编程，插入日志代码，用极小的代价帮我们实现优雅的函数监控。

GitHub 简介

Annotation-triggered注解触发 method call方法调用 logging for your debug builds调试版本.

As a programmer, you often add log statements片段、语句 to print method calls, their arguments, their return values, and the time it took to execute.

This is not a question. Every one of you does this. Shouldn‘t it be easier?

Simply add @DebugLog to your methods and you will automatically自动 get all of the things listed above logged for free.

@DebugLogpublic String getName(String first, String last) { ?SystemClock.sleep(15); // Don‘t ever really do this! ?return first + " " + last;}

@DebugLog

public String getName(String first, String last) {

 SystemClock.sleep(15); // Don‘t ever really do this!

 return first + " " + last;

V/Example: ? getName(first="Jake", last="Wharton")V/Example: ? getName [16ms] = "Jake Wharton"

V/Example: ? getName(first="Jake", last="Wharton")

V/Example: ? getName [16ms] = "Jake Wharton"

The logging will only happen in debug builds and the annotation itself is never present存在于 in the compiled class file编译的类文件 for any build type.

This means you can keep the annotation and check it into检入 source control源代码控制. It has zero effect on non-debug builds.

Add it to your project today!

Local Development

(不知道这几个步骤是搞什么玩意的)Working on this project? Here‘s some helpful Gradle tasks:

install - Install plugin, runtime, and annotations into local repo.
cleanExample- Clean the example project build.
assembleExample - Build the example project. Must run install first.
installExample - Build and install the example project debug APK onto a device.

使用步骤

1、在project 的build.gradle 中添加：

buildscript { ?repositories { ???mavenCentral() ?} ?dependencies { ???classpath ‘com.jakewharton.hugo:hugo-plugin:1.2.1‘ ?}}

buildscript {

 repositories {

  mavenCentral()

?}

 dependencies {

  classpath ‘com.jakewharton.hugo:hugo-plugin:1.2.1‘

?}

实现原理简介

Hugo可以用极小的代价帮我们实现优雅的函数监控。

Hugo虽然是一个比较小的项目，但是里面却包含了很多非常优秀的思想以及先进的技术：AOP、Aspect、注解、Gradle、gradle-maven等。

Hugo给我们提供了一种思路，即在Android中，也可以利用AOP的思路实现优雅的面向切面编程，例如用来统计打点等。

源码分析可参考：Hugo源码分析和Hugo探究

其实，从源码上来看，除了一个Hugo 类外，这个库没有其他什么内容了。

当然，此库依赖了org.aspectj.lang 包。

一个注解 DebugLog：

@Target({TYPE, METHOD, CONSTRUCTOR}) ?//注意类是TYPE的一种)和方法，所以可以用在类上@Retention(CLASS) ?//保留策略为CLASS，即编译器将把注解记录在类文件中，因为不是RUNTIME，所以运行时注解丢掉了//注意，如果我们需要在运行时获取注解信息(比如注解中有字段且需要在运行时获取到此字段的值)，则Retention必须设为【RUNTIME】public @interface DebugLog {}

@Target({TYPE, METHOD, CONSTRUCTOR}) //注意类是TYPE的一种)和方法，所以可以用在类上

@Retention(CLASS) //保留策略为CLASS，即编译器将把注解记录在类文件中，因为不是RUNTIME，所以运行时注解丢掉了

//注意，如果我们需要在运行时获取注解信息(比如注解中有字段且需要在运行时获取到此字段的值)，则Retention必须设为【RUNTIME】

public @interface DebugLog {

Hugo.java 类，也就一百行代码，其中与我们业务相关的核心代码为 logAndExecute(ProceedingJoinPoint)：

@Around("method() || constructor()")public Object logAndExecute(ProceedingJoinPoint joinPoint) throws Throwable {enterMethod(joinPoint); ?//ProceedingJoinPoint有参数信息，输出参数的值long startNanos = System.nanoTime();//函数执行前记录时间，像我们手动做的一样Object result = joinPoint.proceed();//这里代表我们监控的函数long stopNanos = System.nanoTime();//函数执行结束时，打点记录时间，并计算耗时long lengthMillis = TimeUnit.NANOSECONDS.toMillis(stopNanos - startNanos);exitMethod(joinPoint, result, lengthMillis);//输出函数的值，执行耗时return result;}

@Around("method() || constructor()")

public Object logAndExecute(ProceedingJoinPoint joinPoint) throws Throwable {

 ???enterMethod(joinPoint); //ProceedingJoinPoint有参数信息，输出参数的值

 ???long startNanos = System.nanoTime();//函数执行前记录时间，像我们手动做的一样

 ???Object result = joinPoint.proceed();//这里代表我们监控的函数

 ???long stopNanos = System.nanoTime();//函数执行结束时，打点记录时间，并计算耗时

 ???long lengthMillis = TimeUnit.NANOSECONDS.toMillis(stopNanos - startNanos);

 ???exitMethod(joinPoint, result, lengthMillis);//输出函数的值，执行耗时

 ???return result;

知识推荐

我的编程学习网——分享web前端后端开发技术知识。垃圾信息处理邮箱 tousu563@163.com 网站地图