From 1894b8abafcdb7915a0e68d026e2d86b06aae770 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=8B=94=E5=9C=9F=E8=B1=86=E7=9A=84=E7=A8=8B=E5=BA=8F?= =?UTF-8?q?=E5=91=98?= Date: Wed, 11 Oct 2023 15:20:47 +0800 Subject: [PATCH] spring --- .../MySQL-limit\344\274\230\345\214\226.md" | 23 ++ docs/database/mysql/README.md | 4 +- .../\347\272\277\347\250\213\346\261\240.md" | 48 +++- docs/spring/spring/README.md | 2 + .../spring/Spring\344\272\213\344\273\266.md" | 42 ++++ ...1\235\242\347\274\226\347\250\213(AOP).md" | 207 +++++++++++++++++- .../spring/image/spring-framework-aop-6.png | Bin 0 -> 20557 bytes docs/tools/idea/README.md | 4 + 8 files changed, 325 insertions(+), 5 deletions(-) create mode 100644 "docs/database/mysql/MySQL-limit\344\274\230\345\214\226.md" create mode 100644 "docs/spring/spring/Spring\344\272\213\344\273\266.md" create mode 100644 docs/spring/spring/image/spring-framework-aop-6.png diff --git "a/docs/database/mysql/MySQL-limit\344\274\230\345\214\226.md" "b/docs/database/mysql/MySQL-limit\344\274\230\345\214\226.md" new file mode 100644 index 0000000..67fb0cb --- /dev/null +++ "b/docs/database/mysql/MySQL-limit\344\274\230\345\214\226.md" @@ -0,0 +1,23 @@ +# MySQL limit优化 + +Limit 是一种常用的分页查询语句,它可以指定返回记录行的偏移量和最大数目。例如,下面的语句表示从 demo表中查询 val 等于4的记录,并返回第300001到第300005条记录: + +```sql +select * from demo where val=4 limit 300000,5; +``` + +## MySQL 的索引结构 + +MySQL 支持多种类型的索引,其中最常用的是 B+ 树索引。B+ 树索引是一种平衡多路查找树,它有以下特点: + +- 树中的每个节点最多包含 m 个子节点,m 被称为 B+ 树的阶。 +- 树中的每个节点最少包含 m/2(向上取整)个子节点,除了根节点和叶子节点。 +- 树中的所有叶子节点都位于同一层,并且通过指针相连。 +- 树中的所有非叶子节点只存储键值(索引列)和指向子节点的指针。 +- 树中的所有叶子节点存储键值(索引列)和指向数据记录(聚簇索引)或者数据记录地址(非聚簇索引)的指针。 + + + + + +> https://juejin.cn/post/7278951711553486911 \ No newline at end of file diff --git a/docs/database/mysql/README.md b/docs/database/mysql/README.md index ba41bd9..9a6d521 100644 --- a/docs/database/mysql/README.md +++ b/docs/database/mysql/README.md @@ -8,7 +8,9 @@ [MySQL二进制日志(Binary Log)](MySQL-BinaryLog.md) -## 待分类 +## 小技巧 + +[MySQL-limit优化](./MySQL-limit优化.md) [MySQL-count用法分析](./MySQL-count用法分析.md) diff --git "a/docs/java/base/\347\272\277\347\250\213\346\261\240.md" "b/docs/java/base/\347\272\277\347\250\213\346\261\240.md" index e791a64..f4da174 100644 --- "a/docs/java/base/\347\272\277\347\250\213\346\261\240.md" +++ "b/docs/java/base/\347\272\277\347\250\213\346\261\240.md" @@ -43,8 +43,6 @@ public static ScheduledExecutorService newScheduledThreadPool(int corePoolSize) > > 说明:使用线程池的好处是减少在创建和销毁线程上所花的时间以及系统资源的开销,解决资源不足的问题。如果不使用线程池,有可能造成系统创建大量同类线程而导致消耗完内存或者“过度切换”的问题。 > -> -> > 【强制】线程池不允许使用 Executors 去创建,而是通过 ThreadPoolExecutor 的方式,这样的处理方式让写的同学更加明确线程池的运行规则,规避资源耗尽的风险。 > > 说明:Executors 返回的线程池对象的弊端如下: @@ -77,7 +75,20 @@ public static void main(String[] args){ } ``` +## 线程数和CPU + +**一个CPU核心,单位时间内只能执行一个线程的指令**,理论上个线程只需要不停的执行指令,就可以跑满一个核心的利用率。 + +现代CPU基本都是多核心的,例如6核心12线程(超线程),可以简单的认为它就是12核心CPU。那么我这个CPU就可以同时做12件事,互不打扰。 + +如果要执行的线程大于核心数,那么就需要通过操作系统的调度了。操作系统给每个线程分配CPU时间片资源,然后不停的切换,从而实现“并行”执行的效果。 + +总结: +1. 一个极端的线程(不停执行“计算”型操作时),就可以把单个核心的利用率跑满,多核心CPU最多只能同时执行等于核心数的“极端”线程数 +2. 如果每个线程都这么“极端”,且同时执行的线程数超过核心数,会导致不必要的切换,造成负载过高,只会让执行更慢 +3. I/O 等暂停类操作时,CPU处于空闲状态,操作系统调度CPU执行其他线程,可以提高CPU利用率,同时执行更多的线程 +4. I/O 事件的频率频率越高,或者等待/暂停时间越长,CPU的空闲时间也就更长,利用率越低,操作系统可以调度CPU执行更多的线程。 ## 线程池参数配置 @@ -85,6 +96,11 @@ public static void main(String[] args){ cpu密集型任务阻塞系数为0,IO密集型一般在0.8-0.9之间。 +常规配置: + +- CPU 密集型的程序: 核心数 + 1 +- I/O 密集型的程序 :核心数 * 2 + ### CPU密集型 CPU密集型任务是指该任务需要进行大量的运算,需要消耗CPU的大量算力,需要CPU的频繁计算,很少情况出现阻塞,所以CPU在处理该类型任务时会处于高速运转。 @@ -116,6 +132,32 @@ IO密集型是指该类型任务在执行时会产生大量的IO(包含磁盘IO 目前实现的思路大多数都是基于美团的关于动态线程池监控的文章。 +## CPU核心数 + +Java 获取CPU核心数: +```java +Runtime.getRuntime().availableProcessors()//获取逻辑核心数,如6核心12线程,那么返回的是12 +``` -> https://juejin.cn/post/7038473601086914597 \ No newline at end of file +Linux 获取CPU核心数: + +```shell +# 总核数 = 物理CPU个数 X 每颗物理CPU的核数 +# 总逻辑CPU数 = 物理CPU个数 X 每颗物理CPU的核数 X 超线程数 + +# 查看物理CPU个数 +cat /proc/cpuinfo| grep "physical id"| sort| uniq| wc -l + +# 查看每个物理CPU中core的个数(即核数) +cat /proc/cpuinfo| grep "cpu cores"| uniq + +# 查看逻辑CPU的个数 +cat /proc/cpuinfo| grep "processor"| wc -l +``` + + + +> https://juejin.cn/post/7038473601086914597 +> +> https://juejin.cn/post/7280429214608146490 \ No newline at end of file diff --git a/docs/spring/spring/README.md b/docs/spring/spring/README.md index 6f0e565..0b5cd3d 100644 --- a/docs/spring/spring/README.md +++ b/docs/spring/spring/README.md @@ -2,6 +2,8 @@ [SpringModulith简介](./SpringModulith简介.md) +[Spring事件](./Spring事件.md) + [Spring事件和事务的关系](./Spring事件和事务的关系.md) [BeanUtils使用注意事项](./BeanUtils.md) diff --git "a/docs/spring/spring/Spring\344\272\213\344\273\266.md" "b/docs/spring/spring/Spring\344\272\213\344\273\266.md" new file mode 100644 index 0000000..db89127 --- /dev/null +++ "b/docs/spring/spring/Spring\344\272\213\344\273\266.md" @@ -0,0 +1,42 @@ +# Spring事件 + + + +## @EventListener + +监听器只需要 在方法上声明为 EventListener注解,Spring就会自动找到对应的监听器。Spring会根据方法入参的事件类型和发布的事件类型自动匹配。 + +服务关闭期间: + +1. **事件发布成功**:发布事件的过程是同步的,因此在事件发布成功之前,应用程序不会继续执行。因此,如果事件发布成功,则意味着事件已被传递到所有的事件监听器。 +2. **监听器无法完成处理**:如果在事件监听器处理事件期间关闭了应用程序,监听器可能无法完成其正常的事件处理逻辑。这可能会导致未完成的操作、资源泄漏或不一致的状态,具体取决于监听器中的操作和应用程序的设计。 + +解决办法: + +1. 优雅停机:并不能完全消除在关闭期间可能发生的问题。如果某些操作耗时很长,或者事件监听器中的操作不受控制,仍然可能在关闭期间引发问题。 +2. 责任链模式了,for循环订阅的策略类。 + +```java +public interface EventSubscriber { + void subscribe(Event event, EventSubscriber nextSubscriber); + void handleEvent(Event event); +} + +public class ConcreteEventSubscriber implements EventSubscriber { + private EventSubscriber nextSubscriber; + + @Override + public void subscribe(Event event, EventSubscriber nextSubscriber) { + this.nextSubscriber = nextSubscriber; + } + + @Override + public void handleEvent(Event event) { + // 处理事件 + if (nextSubscriber != null) { + nextSubscriber.handleEvent(event); + } + } +} +``` + diff --git "a/docs/spring/spring/Spring\346\240\270\345\277\203\344\271\213\351\235\242\345\220\221\345\210\207\351\235\242\347\274\226\347\250\213(AOP).md" "b/docs/spring/spring/Spring\346\240\270\345\277\203\344\271\213\351\235\242\345\220\221\345\210\207\351\235\242\347\274\226\347\250\213(AOP).md" index be626ef..fdb0f26 100644 --- "a/docs/spring/spring/Spring\346\240\270\345\277\203\344\271\213\351\235\242\345\220\221\345\210\207\351\235\242\347\274\226\347\250\213(AOP).md" +++ "b/docs/spring/spring/Spring\346\240\270\345\277\203\344\271\213\351\235\242\345\220\221\345\210\207\351\235\242\347\274\226\347\250\213(AOP).md" @@ -1,3 +1,208 @@ # Spring核心之面向切面编程(AOP) -AOP为Aspect Oriented Programming的缩写,意为:面向切面编程 \ No newline at end of file +文章代码:[spring-learn/spring-aop at main · lizhifuabc/spring-learn (github.com)](https://github.com/lizhifuabc/spring-learn/tree/main/spring-aop) + +AOP为Aspect Oriented Programming的缩写,意为:面向切面编程 + +Spring 框架通过定义切面, 通过拦截切点实现了不同业务模块的解耦,这个就叫**面向切面编程** + +## 基础概念 + +- **前置通知(Before advice)**:在某连接点之前执行的通知,但这个通知不能阻止连接点之前的执行流程(除非它抛出一个异常)。 +- **后置通知(After returning advice)**:在某连接点正常完成后执行的通知:例如,一个方法没有抛出任何异常,正常返回。 +- **异常通知(After throwing advice)**:在方法抛出异常退出时执行的通知。 +- **最终通知(After (finally) advice)**:当某连接点退出的时候执行的通知(不论是正常返回还是异常退出)。 +- **环绕通知(Around Advice)**:包围一个连接点的通知,如方法调用。这是最强大的一种通知类型。环绕通知可以在方法调用前后完成自定义的行为。它也会选择是否继续执行连接点或直接返回它自己的返回值或抛出异常来结束执行。 + +## Spring AOP和AspectJ + +AspectJ是一个java实现的AOP框架,它能够对java代码进行AOP编译(一般在编译期进行),让java代码具有AspectJ的AOP功能(当然需要特殊的编译器)。 + +**动态织入**和**静态织入**: + +动态织入的方式是在运行时动态将要增强的代码织入到目标类中,这样往往是通过动态代理技术完成的,如Java JDK的动态代理(Proxy,底层通过反射实现)或者CGLIB的动态代理(底层通过继承实现),Spring AOP采用的就是基于运行时增强的代理技术。 + +ApectJ采用的就是静态织入的方式。ApectJ主要采用的是编译期织入,在这个期间使用AspectJ的acj编译器(类似javac)把aspect类编译成class字节码后,在java目标类编译时织入,即先编译aspect类再编译目标类。 + +![img](image/spring-framework-aop-6.png) + +| Spring AOP | AspectJ | +| ------------------------------------------------ | ------------------------------------------------------------ | +| 纯 Java 中实现 | 使用 Java 编程语言的扩展实现 | +| 不需要单独的编译过程 | 除非设置 LTW,否则需要 AspectJ 编译器 (ajc) | +| 只能使用运行时织入 | 运行时织入不可用。支持编译时、编译后和加载时织入 | +| 功能不强-仅支持方法级编织 | 更强大 - 可以编织字段、方法、构造函数、静态初始值设定项、最终类/方法等......。 | +| 只能在由 Spring 容器管理的 bean 上实现 | 可以在所有域对象上实现 | +| 仅支持方法执行切入点 | 支持所有切入点 | +| 代理是由目标对象创建的, 并且切面应用在这些代理上 | 在执行应用程序之前 (在运行时) 前, 各方面直接在代码中进行织入 | +| 比 AspectJ 慢多了 | 更好的性能 | +| 易于学习和应用 | 相对于 Spring AOP 来说更复杂 | + +## Spring AOP + +常用配置 + +```java +// 任意公共方法的执行: +execution(public * *(..)) + +// 任何一个名字以“set”开始的方法的执行: +execution(* set*(..)) + +// AccountService接口定义的任意方法的执行: +execution(* com.xyz.service.AccountService.*(..)) + +// 在service包中定义的任意方法的执行: +execution(* com.xyz.service.*.*(..)) + +// 在service包或其子包中定义的任意方法的执行: +execution(* com.xyz.service..*.*(..)) + +// 在service包中的任意连接点(在Spring AOP中只是方法执行): +within(com.xyz.service.*) + +// 在service包或其子包中的任意连接点(在Spring AOP中只是方法执行): +within(com.xyz.service..*) + +// 实现了AccountService接口的代理对象的任意连接点 (在Spring AOP中只是方法执行): +this(com.xyz.service.AccountService)// 'this'在绑定表单中更加常用 + +// 实现AccountService接口的目标对象的任意连接点 (在Spring AOP中只是方法执行): +target(com.xyz.service.AccountService) // 'target'在绑定表单中更加常用 + +// 任何一个只接受一个参数,并且运行时所传入的参数是Serializable 接口的连接点(在Spring AOP中只是方法执行) +args(java.io.Serializable) // 'args'在绑定表单中更加常用; 请注意在例子中给出的切入点不同于 execution(* *(java.io.Serializable)): args版本只有在动态运行时候传入参数是Serializable时才匹配,而execution版本在方法签名中声明只有一个 Serializable类型的参数时候匹配。 + +// 目标对象中有一个 @Transactional 注解的任意连接点 (在Spring AOP中只是方法执行) +@target(org.springframework.transaction.annotation.Transactional)// '@target'在绑定表单中更加常用 + +// 任何一个目标对象声明的类型有一个 @Transactional 注解的连接点 (在Spring AOP中只是方法执行): +@within(org.springframework.transaction.annotation.Transactional) // '@within'在绑定表单中更加常用 + +// 任何一个执行的方法有一个 @Transactional 注解的连接点 (在Spring AOP中只是方法执行) +@annotation(org.springframework.transaction.annotation.Transactional) // '@annotation'在绑定表单中更加常用 + +// 任何一个只接受一个参数,并且运行时所传入的参数类型具有@Classified 注解的连接点(在Spring AOP中只是方法执行) +@args(com.xyz.security.Classified) // '@args'在绑定表单中更加常用 + +// 任何一个在名为'tradeService'的Spring bean之上的连接点 (在Spring AOP中只是方法执行) +bean(tradeService) + +// 任何一个在名字匹配通配符表达式'*Service'的Spring bean之上的连接点 (在Spring AOP中只是方法执行) +bean(*Service) +``` + +Spring 支持如下三个逻辑运算符来组合切入点表达式: + +```java +&&:要求连接点同时匹配两个切入点表达式 +||:要求连接点匹配任意个切入点表达式 +!::要求连接点不匹配指定的切入点表达式 +``` + +Spring AOP采用的就是基于运行时增强的代理技术: + +1. 接口使用JDK代理 + +2. 非接口使用Cglib代理 + +Spring 使用了@AspectJ框架为AOP的实现提供了一套注解: + +| 注解名称 | 解释 | +| --------------- | ------------------------------------------------------------ | +| @Aspect | 用来定义一个切面。 | +| @pointcut | 用于定义切入点表达式。在使用时还需要定义一个包含名字和任意参数的方法签名来表示切入点名称,这个方法签名就是一个返回值为void,且方法体为空的普通方法。 | +| @Before | 用于定义前置通知,相当于BeforeAdvice。在使用时,通常需要指定一个value属性值,该属性值用于指定一个切入点表达式(可以是已有的切入点,也可以直接定义切入点表达式)。 | +| @AfterReturning | 用于定义后置通知,相当于AfterReturningAdvice。在使用时可以指定pointcut / value和returning属性,其中pointcut / value这两个属性的作用一样,都用于指定切入点表达式。 | +| @Around | 用于定义环绕通知,相当于MethodInterceptor。在使用时需要指定一个value属性,该属性用于指定该通知被植入的切入点。 | +| @After-Throwing | 用于定义异常通知来处理程序中未处理的异常,相当于ThrowAdvice。在使用时可指定pointcut / value和throwing属性。其中pointcut/value用于指定切入点表达式,而throwing属性值用于指定-一个形参名来表示Advice方法中可定义与此同名的形参,该形参可用于访问目标方法抛出的异常。 | +| @After | 用于定义最终final 通知,不管是否异常,该通知都会执行。使用时需要指定一个value属性,该属性用于指定该通知被植入的切入点。 | +| @DeclareParents | 用于定义引介通知,相当于IntroductionInterceptor (不要求掌握)。 | + +## 示例 + +```java +package com.spring.aop.aspect; + +import lombok.extern.slf4j.Slf4j; +import org.aspectj.lang.annotation.*; +import org.aspectj.lang.ProceedingJoinPoint; +import org.springframework.context.annotation.EnableAspectJAutoProxy; +import org.springframework.stereotype.Component; + +/** + * LogAspect: 日志切面 + * + * @author lizhifu + * @since 2023/9/17 + */ +@EnableAspectJAutoProxy +@Component +@Aspect +@Slf4j +public class LogAspect { + /** + * 切入点. + */ + @Pointcut("execution(* com.spring.aop.service.*.*(..))") + private void pointCutMethod() { + } + + + /** + * 环绕通知. + * + * @param pjp pjp + * @return obj + * @throws Throwable exception + */ + @Around("pointCutMethod()") + public Object doAround(ProceedingJoinPoint pjp) throws Throwable { + log.info("---------------------环绕通知: 开始---------------------"); + Object o = pjp.proceed(); + log.info("---------------------环绕通知: 结束---------------------"); + return o; + } + + /** + * 前置通知. + */ + @Before("pointCutMethod()") + public void doBefore() { + log.info("前置通知"); + } + + + /** + * 后置通知. + * + * @param result return val + */ + @AfterReturning(pointcut = "pointCutMethod()", returning = "result") + public void doAfterReturning(String result) { + log.info("后置通知, 返回值: {}", result); + } + + /** + * 异常通知. + * + * @param e exception + */ + @AfterThrowing(pointcut = "pointCutMethod()", throwing = "e") + public void doAfterThrowing(Exception e) { + log.error("异常通知, 异常: {}", e.getMessage()); + } + + /** + * 最终通知. + */ + @After("pointCutMethod()") + public void doAfter() { + log.info("最终通知"); + } +} +``` + + + +> https://pdai.tech/md/spring/spring-x-framework-aop.html \ No newline at end of file diff --git a/docs/spring/spring/image/spring-framework-aop-6.png b/docs/spring/spring/image/spring-framework-aop-6.png new file mode 100644 index 0000000000000000000000000000000000000000..da123d34c5e37762c3cfea256f750e2251f280a8 GIT binary patch literal 20557 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