From fba7ce6b2c69617fbd574f00687d9e3dbdd66948 Mon Sep 17 00:00:00 2001 From: huoyo <1729913829@qq.com> Date: Tue, 27 Apr 2021 22:14:07 +0800 Subject: [PATCH] update docs --- README.md | 74 ----------------------------------------------- docs/getstart.md | 6 ++++ docs/index.html | 2 +- docs/questions.md | 11 ++++++- 4 files changed, 17 insertions(+), 76 deletions(-) diff --git a/README.md b/README.md index 97be1f9..681f085 100644 --- a/README.md +++ b/README.md @@ -22,69 +22,6 @@ http://huoyo.gitee.io/ko-time > * 由于对项目中每个方法进行监控,在性能层面会有一点影响,建议在开发阶段使用 -#### 使用教程 - -1. 引入依赖 或者 下载发行版本 -``` - - cn.langpy - ko-time - 1.8 - -``` - -``` - - org.springframework.boot - spring-boot-starter-${freemarker或者thymeleaf任选一个} - -``` -2. 配置信息 - -在application.yml中配置 -``` -spring.profiles.active=koTime -koTime.log.enable=false # 是否开启控制输出,非必填,默认false -koTime.log.language=chinese # 控制台输出语言(english/chinese)非必填,默认chinese -koTime.time.threshold=800.0 # 时间阈值,用于前端展示,大于阈值显示红色,小于阈值显示绿色,非必填,默认800 -koTime.pointcut=execution(* com.huoyo.demo.controller.*(..)) || execution(* com.huoyo.demo.service.*(..)) 需要监测的切面范围(比如监测controller层和service层),参考aop的@pointcut v1.4开始加入的功能,用来替代下面的步骤3 -koTime.ui.template=thymeleaf 前端页面模板,非必填,默认为freemarker,可选thymeleaf 与引入的pom依赖对应 -``` - - - -3. 新建一个类,实现ComputeTimeHandlerInterface,并在 @Pointcut 写入 需要监测的范围 - -`注意:v1.3之前需要该步骤,v1.4及以上使用koTime.pointcut配置即可,无需此步骤` - -```java -@Component -@Aspect -public class RunTimeHandler implements ComputeTimeHandlerInterface { - @Override - @Pointcut("execution(* com.huoyo..*.*(..))") - public void prog() { - - } -} - -``` - -4. 启动项目访问 `/koTime` 路径即可 - -比如:`http://localhost:8080/koTime` -如果项目自定义的contextpath,访问如`http://localhost:8080/xxx服务/koTime` - -5. 其他使用 - -对于单个方法的监测,可以使用@ComputeTime注解 - -```java - @ComputeTime - public void test() { - - } -``` #### 可视化展示 @@ -130,16 +67,5 @@ public class RunTimeHandler implements ComputeTimeHandlerInterface { 1.本项目使用java8开发,其他版本未曾试验,如有什么bug还请告知! -2.v1.5及以下版本默认使用了freemarker模板(其余版本可选用thymeleaf),需要自行引入 - -``` - - org.springframework.boot - spring-boot-starter-freemarker - xxxx - -``` - -3.项目使用@Aspect注解,未引入 aop相关包的自行引入,如aspectj或者spring-boot-starter-aop diff --git a/docs/getstart.md b/docs/getstart.md index 41c3428..3030a55 100644 --- a/docs/getstart.md +++ b/docs/getstart.md @@ -39,6 +39,12 @@ ## 访问 +> 注意: +> 1.引入了上面的依赖和配置以后,确认项目中是否有aop相关的包,koTime使用了@Aspect注解,未引入的自行引入,如aspectj或者spring-boot-starter-aop +> 2.做完前面的步骤,koTime的集成已经完毕,无需进行其他配置 + + + * 启动项目访问 `/koTime` 路径即可 diff --git a/docs/index.html b/docs/index.html index 1a9109b..43f1ed7 100644 --- a/docs/index.html +++ b/docs/index.html @@ -18,7 +18,7 @@ coverpage: true, loadSidebar: true, onlyCover: false, - subMaxLevel: 2 + subMaxLevel: 3 } diff --git a/docs/questions.md b/docs/questions.md index 8cdeff0..2fc7421 100644 --- a/docs/questions.md +++ b/docs/questions.md @@ -4,10 +4,19 @@ koTime使用了@Aspect注解,未引入 aop相关包的自行引入,如aspect ## 前端展示模板冲突 -koTime提供freemark和thymeleaf两种模板,根据自身项目的模板进行选择 +* 前后端分离的项目 + +koTime提供freemark和thymeleaf两种模板,可根据自己的爱好自由选择,如果喜欢其他的,koTime暂不支持你的喜欢 + +* 前后端不分离的项目 如果项目中使用了除了freemarker和thymeleaf之外的模板,那么koTime暂时不支持 +如果发生资源文件和配置的冲突,可取消`spring.profiles.active=koTime`这一步配置 +然后将koTime中对于freemarker和thymeleaf的配置与自身的进行合并 + + + ## 是否支持前后端分离项目 支持!目前来看,对前后端分离的项目比较友好,不分离的项目可能存在资源的文件影响