# gulimall_2 **Repository Path**: liu-xing-a/gulimall_2 ## Basic Information - **Project Name**: gulimall_2 - **Description**: gulimall是一个由商业级项目升级优化而来的微服务架构，采用Spring Boot 2.1 、Spring Cloud 2021 等核心技术构建，完全遵循阿里巴巴编码规范。提供基于Vue前端框架用于快速搭建企业级商城微服务平台。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 5 - **Created**: 2024-05-15 - **Last Updated**: 2024-05-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 谷粒商城简介 ### 前言 gulimall` 项目致力于打造一个完整的电商系统，采用现阶段流行技术来实现，采用前后端分离继续编写。 ### 项目API接口文档 - 文档地址：[https://easydoc.xyz/s/78237135/ZUqEdvA4/hKJTcbfd]() ### 项目介绍 gulimall（谷粒商城） 项目是一套电商项目，包括前台商城系统以及后台管理系统，基于 SpringCloud + SpringCloudAlibaba + MyBatis-Plus实现，采用 Docker 容器化部署。前台商城系统包括：用户登录、注册、商品搜索、商品详情、购物车、下订单流程、秒杀活动等模块。后台管理系统包括：系统管理、商品系统、优惠营销、库存系统、订单系统、用户系统、内容管理等七大模块。 分布式项目谷粒商城，前后端分离，前端基于Vue+ElementUI，后端基于SpringBoot+MybatisPlus+Mysql+Redis+ElasticSearch，具备商城所有功能（注册（社交登录）、登录、上架、检索、购物车、订单、支付、秒杀），项目框架由renrenfast开源项目搭建。项目中使用到SpringCache，SpringSession，Rabbitmq，SpringGateway+Nginx，Openfeign，alibaba-nacos做分布式注册中心和配置中心，alibaba-seata做分布式事务控制，redisson做布式锁。 ### 项目演示 #### **前台部分功能演示效果** ![UUvLAU.png](https://images.gitee.com/uploads/images/2020/0714/193421_2e595b5f_4914148.png) ![UUv7n0.png](https://images.gitee.com/uploads/images/2020/0714/193422_0ed39103_4914148.png) #### 后端登录界面 ![UUvXh4.png](https://images.gitee.com/uploads/images/2020/0714/193422_cd40fc31_4914148.png) #### 主页面 ![UUv51s.png](https://images.gitee.com/uploads/images/2020/0714/193422_d1a789d5_4914148.png) #### 后台部分功能 [![UUvoXq.th.png](https://images.gitee.com/uploads/images/2020/0714/193422_9758a0a6_4914148.png)](https://imgchr.com/i/UUvoXq)[![UUvONF.th.png](https://images.gitee.com/uploads/images/2020/0714/193423_ed014fcc_4914148.png)](https://imgchr.com/i/UUvONF)[![UUvHBV.th.png](https://images.gitee.com/uploads/images/2020/0714/193423_0996ef2d_4914148.png)](https://imgchr.com/i/UUvHBV)[![UUvIcn.th.png](https://images.gitee.com/uploads/images/2020/0714/193424_bb60e0f4_4914148.png)](https://imgchr.com/i/UUvIcn) ### 组织结构 ``` gulimall ├── gulimall-common -- 工具类及通用代码 ├── renren-generator -- 人人开源项目的代码生成器 ├── gulimall-auth-server -- 认证中心（社交登录、OAuth2.0、单点登录） ├── gulimall-cart -- 购物车服务 ├── gulimall-coupon -- 优惠卷服务 ├── gulimall-gateway -- 统一配置网关 ├── gulimall-order -- 订单服务 ├── gulimall-product -- 商品服务 ├── gulimall-search -- 检索服务 ├── gulimall-seckill -- 秒杀服务 ├── gulimall-third-party -- 第三方服务 ├── gulimall-ware -- 仓储服务 └── gulimall-member -- 会员服务 ``` ### 技术选型 **后端技术** | 技术 | 说明 | 官网 | | :----------------: | :----------------------: | :---------------------------------------------: | | SpringBoot | 容器+MVC框架 | https://spring.io/projects/spring-boot | | SpringCloud | 微服务架构 | https://spring.io/projects/spring-cloud | | SpringCloudAlibaba | 一系列组件 | https://spring.io/projects/spring-cloud-alibaba | | MyBatis-Plus | ORM框架 | https://mp.baomidou.com | | renren-generator | 人人开源项目的代码生成器 | https://gitee.com/renrenio/renren-generator | | Elasticsearch | 搜索引擎 | https://github.com/elastic/elasticsearch | | RabbitMQ | 消息队列 | https://www.rabbitmq.com | | Springsession | 分布式缓存 | https://projects.spring.io/spring-session | | Redisson | 分布式锁 | https://github.com/redisson/redisson | | Docker | 应用容器引擎 | https://www.docker.com | | OSS | 对象云存储 | https://github.com/aliyun/aliyun-oss-java-sdk | **前端技术** | 技术 | 说明 | 官网 | | :-------: | :--------: | :-----------------------: | | Vue | 前端框架 | https://vuejs.org | | Element | 前端UI框架 | https://element.eleme.io | | thymeleaf | 模板引擎 | https://www.thymeleaf.org | | node.js | 服务端的js | https://nodejs.org/en | ### 架构图 **系统架构图** [![UUvRAS.png](https://images.gitee.com/uploads/images/2020/0714/193425_4a1056c4_4914148.png)](https://imgchr.com/i/UUvRAS) **业务架构图** ![UUvb7T.png](https://images.gitee.com/uploads/images/2020/0714/193425_9bb153d1_4914148.png) ### 环境搭建 #### 开发工具 | 工具 | 说明 | 官网 | | :-----------: | :-----------------: | :---------------------------------------------: | | IDEA | 开发Java程序 | https://www.jetbrains.com/idea/download | | RedisDesktop | redis客户端连接工具 | https://redisdesktop.com/download | | SwitchHosts | 本地host管理 | https://oldj.github.io/SwitchHosts | | X-shell | Linux远程连接工具 | http://www.netsarang.com/download/software.html | | Navicat | 数据库连接工具 | http://www.formysql.com/xiazai.html | | PowerDesigner | 数据库设计工具 | http://powerdesigner.de | | Postman | API接口调试工具 | https://www.postman.com | | Jmeter | 性能压测工具 | https://jmeter.apache.org | | Typora | Markdown编辑器 | https://typora.io | #### 开发环境 | 工具 | 版本号 | 下载 | | :-----------: | :----: | :----------------------------------------------------------: | | JDK | 1.8 | https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html | | Mysql | 5.7 | https://www.mysql.com | | Redis | Redis | https://redis.io/download | | Elasticsearch | 7.6.2 | https://www.elastic.co/downloads | | Kibana | 7.6.2 | https://www.elastic.co/cn/kibana | | RabbitMQ | 3.8.5 | http://www.rabbitmq.com/download.html | | Nginx | 1.1.6 | http://nginx.org/en/download.html | 注意：以上的除了jdk都是采用docker方式进行安装，详细安装步骤可参考百度!!! #### 搭建步骤 > Windows环境部署 - 修改本机的host文件，映射域名端口 ``` 192.168.77.130 gulimall.com 192.168.77.130 search.gulimall.com 192.168.77.130 item.gulimall.com 192.168.77.130 auth.gulimall.com 192.168.77.130 cart.gulimall.com 192.168.77.130 order.gulimall.com 192.168.77.130 member.gulimall.com 192.168.77.130 seckill.gulimall.com 以上端口换成自己Linux的ip地址 ``` - 修改Linux中Nginx的配置文件 ``` 1、在nginx.conf中添加负载均衡的配置 upstream gulimall { server 192.168.43.182:88; } 2、在gulimall.conf中添加如下配置 server { listen 80; server_name gulimall.com *.gulimall.com hjl.mynatapp.cc; #charset koi8-r; #access_log /var/log/nginx/log/host.access.log main; #配置静态资源的动态分离 location /static/ { root /usr/share/nginx/html; } #支付异步回调的一个配置 location /payed/ { proxy_set_header Host order.gulimall.com; #不让请求头丢失 proxy_pass http://gulimall; } location / { #root /usr/share/nginx/html; #index index.html index.htm; proxy_set_header Host $host; #不让请求头丢失 proxy_pass http://gulimall; } ``` - 克隆前端项目 `renren-fast-vue` 以 `npm run dev` 方式去运行 - 克隆整个后端项目 `gulimall` ，并导入 IDEA 中完成编译 ### 如果你喜欢，要是觉得对你有帮助的话，请点个赞是对我最大的支持！ ## Docker ### Docker安装RabbitMQ ```shell docker run --name rabbitmq -p 5672:5672 -p 15672:15672 -d rabbitmq:3.8-management ``` ### Docker安装Mysql ```shell # 编写my.cnf配置文件 vim /root/docker/mysql/conf/my.cnf [mysql] # 设置mysql客户端默认字符集 default-character-set=utf8mb4 [client] # 设置mysql客户端连接服务端时默认使用的端口 port=3306 default-character-set=utf8mb4 [mysqld] # 设置3306端口 port=3306 # 允许最大连接数 max_connections=200 # 允许连接失败的次数。 max_connect_errors=10 # 服务端使用的字符集默认为utf8mb4 character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci skip-name-resolve # 运行容器 docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root \ -v /root/docker/mysql/conf:/etc/mysql/conf.d \ -v /root/docker/mysql/data:/var/lib/mysql \ -v /root/docker/mysql/log:/var/log/mysql \ -d mysql:8.0 ``` ### Docker安装Redis ```shell script docker pull redis:5.0.9 mkdir /root/docker/redis vim /root/docker/redis/redis.conf port 6379 requirepass xxxx appendonly yes docker run -p 6379:6379 --name redis \ -v /root/docker/redis/data:/data \ -v /root/docker/redis/redis.conf:/etc/redis/redis.conf \ -d redis:5.0.9 redis-server /etc/redis/redis.conf ``` ### Docker安装Nginx ```shell script mkdir /root/docker/nginx mkdir /root/docker/nginx/conf # 由于我们现在没有配置文件，也不知道配置什么。可以先启动一个nginx，讲他的配置文件拷贝出来 # 再作为映射，启动真正的nginx docker pull nginx:1.17.4 docker run --name some-nginx -d nginx:1.17.4 docker container cp some-nginx:/etc/nginx /root/docker/nginx/conf # 然后就可以删除这个容器了 docker docker rm -f some-nginx # 启动nginx docker run --name nginx -p 80:80 \ -v /root/docker/nginx/conf:/etc/nginx \ -v /root/docker/nginx/html:/usr/share/nginx/html \ -d nginx:1.17.4 ``` ### Docker安装ElasticSearch ```shell script docker pull elasticsearch:7.8.0 # 做映射之前赋予文件夹相应权限， chmod -R 775 /root/docker/elasticsearch/data chmod -R 775 /root/docker/elasticsearch/logs docker run -p 9200:9200 -p 9300:9300 --name es7.8 \ -e "discovery.type=single-node" \ -e ES_JAVA_OPTS="-Xms128m -Xmx512m" \ -v /root/docker/elasticsearch/plugins:/usr/share/elasticsearch/plugins \ -v /root/docker/elasticsearch/data:/usr/share/elasticsearch/data \ -v /root/docker/elasticsearch/logs:/usr/share/elasticsearch/logs \ -d elasticsearch:7.8.0 ``` ### Docker安装Kibana ```sehll # 拉取镜像 # kibana版本必须和elasticsearch版本保持一致 docker pull kibana:7.8.0 # 启动容器 # YOUR_ELASTICSEARCH_CONTAINER_NAME_OR_ID 正在运行的ES容器ID或name docker run --link YOUR_ELASTICSEARCH_CONTAINER_NAME_OR_ID:elasticsearch -p 5601:5601 {docker-repo}:{version} docker run --link es7.8:elasticsearch -p 5601:5601 --name kibana -d kibana:7.8.0 ``` ### DockerElasticSearch安装IK分词器 ```sehll # Ik分词器版本要和ES和Kibana版本保持一致 # 进入容器 docker exec -it es7.8 /bin/bash #此命令需要在容器中运行 elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.8.0/elasticsearch-analysis-ik-7.8.0.zip # 退出容器，重启容器 exit docker restart es7.8 ``` ## spring-cloud-alibaba的使用 ### 引入依赖，全套组件版本统一管理 ```xml 2.2.2.RELEASE org.springframework.cloud spring-cloud-dependencies ${spring-cloud.version} pom import ``` ### nacos作为注册中心 1. 本地启动nacos客户端，windows双击startup.bat 若启动失败，则在当前目录下打开cmd，执行startup.bat -m standalone 2. 引入nacos作为注册中心的依赖 ```xml com.alibaba.cloud spring-cloud-starter-alibaba-nacos-discovery ``` 3. 在配置文件中配置注册中心地址以及服务名和端口 ```properties # 服务端口 server.port=8070 # 服务名 spring.application.name=service-provider # 注册中心地址 spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848 ``` 4. 启用服务注册发现配置 @EnableDiscoveryClient ```java @SpringBootApplication @EnableDiscoveryClient public class NacosProviderApplication { public static void main(String[] args) { SpringApplication.run(NacosProviderApplication.class, args); } } ``` ### nacos作为配置中心 1. 本地启动nacos客户端，windows双击startup.bat 若启动失败，则在当前目录下打开cmd，执行startup.bat -m standalone 2. 引入nacos作为配置中心的依赖 ```xml com.alibaba.cloud spring-cloud-starter-alibaba-nacos-config ``` 3. 在配置文件bootstrap.properties中配置注册中心地址以及服务名 ```properties # 服务名,配置服务名是因为服务名是默认读取的dataId的一部分 spring.application.name=service-provider # 配置中心地址 spring.cloud.nacos.config.server-addr=127.0.0.1:8848 ``` 当配置了nacos配置中心，服务启动时会去nacos配置中心加载默认命名空间(public)下默认命名的配置集，dataId的组成形式是 ${prefix}-${spring.profiles.active}.${file-extension} - dataId：一组配置的集合的唯一表示 - prefix：默认值为配置文件中配置的服务名，也可以使用spring.cloud.nacos.config.prefix来自定义 - spring.profiles.active指当前激活的环境，如dev,prod等，如果当前服务不存在多个环境，则dataI d将变为 ${prefix}.${file-extension} - file-extension：配置中心中配置项的配置格式(默认是properties,因此只要内容格式是properties就可以不加后缀)，可在配置文件中通过spring.cloud.nacos.config.file-extension指定，当前只支持yaml和properties 4. 获取配合中心中配置项的值可使用@Value注解，若希望读取的值随着配置中心中的改变而实时更新（不用重启项目），使用@RefreshScope自动刷新 - 若某个配置项既在application.yaml有配置，也在配置中心进行了配置，优先读取配置中心中的值 5. 关于配置中心的几个名字概念 - 命名空间：用来做配置隔离，区分每个dataId所属哪个命名空间，比如可以让每个服务所创建的所有dataId属于自己的命名空间 - 配置中心中新建的dataId默认所属的命名空间都是PUBLIC，服务启动时默认去读取的dataId是服务名.properties，若自己修改了其所属命名空间，则无法读取到配置项的内容 可以在配置文件bootstrap.properties中指定要读取哪个配置空间 - 每个配置空间下所创建的配置集dataId，可以设置其所属组，默认组是DEFAULT_PUBLIC，可以通过这个组来进行生产、测试等多个环境下的多个配置，然后在配置文件中指定读取的是哪个组即可 6. 读取多个配置文件 我们可以将服务的全部配置分成多个配置文件(数据连接相关，mybatis相关，redis相关，其他)，为每部分的配置文件也都可以设置所属组，然后在配置文件中通过spring.cloud.nacos.config.extension-configs:来指定加在属于指定组的多个配置文件 7. 通常情况下，每个模块(微服务)会去创建自己专属的命名空间(如服务名)，然后在命名空间内创建多个dataId进行相应部分的配置管理，并可以为其指定所属组来进行不同环境下的不同配置。 ```java @RestController @RequestMapping("/config") @RefreshScope public class ConfigController { @Value("${useLocalCache:false}") private boolean useLocalCache; @RequestMapping("/get") public boolean get() { return useLocalCache; } } ``` ## JSR303 - 1)、导入 javax.validation、hibernate-validator依赖，尤其是第二个，在springboot应用中使用校验，必须导入 - 2)、给Bean的字段添加校验注解:javax.validation.constraints，并定义自己的message提示 - @NotNull: CharSequence, Collection, Map 和 Array 对象不能是 null, 但可以是空集（size = 0）。 - @NotEmpty: CharSequence, Collection, Map 和 Array 对象不能是 null 并且相关对象的 size 大于 0。 - @NotBlank: String 不是 null 且 至少包含一个字符 - 3)、开启校验功能 使用@Valid - 效果：校验错误以后会有默认的响应； - 4)、给校验的bean后紧跟一个BindingResult，就可以获取到校验的结果 - 5)、分组校验（多场景的复杂校验） - @NotBlank(message = "品牌名必须提交",groups = {AddGroup.class,UpdateGroup.class}) - @Validated({AddGroup.class}),给校验注解标注什么情况需要进行校验 - 默认没有指定分组的字段校验使用注解@Valid，在分组校验情况下，只会在@Validated({AddGroup.class})生效； - 6)、自定义校验 - 1、编写一个自定义的校验注解 - 2、编写一个自定义的校验器 ConstraintValidator - 3、关联自定义的校验器和自定义的校验注解 - @Constraint(validatedBy = { ListValueConstraintValidator.class【可以指定多个不同的校验器，适配不同类型的校验】 }) - 统一的异常处理 - @ControllerAdvice - 编写异常处理类，使用@ControllerAdvice。 - 使用@ExceptionHandler标注方法可以处理的异常。 ## 分布式锁Redisson的使用 https://redis.io/topics/distlock https://github.com/redisson/redisson Redisson是一个在Redis的基础上实现的Java驻内存数据网格（In-Memory Data Grid）。它不仅提供了一系列的分布式的Java常用对象，还提供了许多分布式服务。 其中包括(BitSet, Set, Multimap, SortedSet, Map, List, Queue, BlockingQueue, Deque, BlockingDeque, Semaphore, Lock, AtomicLong, CountDownLatch, Publish / Subscribe, Bloom filter, Remote service, Spring cache, Executor service, Live Object service, Scheduler service) Redisson提供了使用Redis的最简单和最便捷的方法。Redisson的宗旨是促进使用者对Redis的关注分离（Separation of Concern），从而让使用者能够将精力更集中地放在处理业务逻辑上。 1. 导入erdisson依赖，可去maven仓库 2. 编写配置类，创建 RedissonClient对象 3. @autowired注入RedissonClient对象 4. 获取锁 参数就是锁的名字 // 获取分布式可重入锁，最基本的锁 RLock lock = redissonClient.getLock("锁名"); // 获取读写锁 redissonClient.getReadWriteLock("anyRWLock"); // 信号量 redissonClient.getSemaphore("semaphore"); Rlock实现了juc下的lock，完全可以像使用本地锁一样使用它 5. 以可重入锁为例 如果直接执行 lock.lock(); Redisson内部提供了一个监控锁的看门狗，它的作用是在Redisson实例被关闭前，(定时任务)不断的延长锁的有效期。 默认情况下，看门狗的检查锁的超时时间是30秒钟，也可以通过修改Config.lockWatchdogTimeout来另行指定 也就是说，先加锁，然后执行业务，锁的默认有效期是30s，业务进行期间，会通过定时任务不断将锁的有效期续至30s。直到业务代码结束 所以即便不手动释放锁。最终也会自动释放 默认是任务调度的周期是 看门狗时间 / 3 = 10s 也可以使用 lock.lock(10, TimeUnit.SECONDS);手动指定时间 此时，不会有定时任务自动延期，超过这个时间后锁便自动解开了 需要注意的是，如果代码块中有手动解锁，但是业务执行完成之前锁的有效期到了， 此时执行unlock会报错：当前线程无法解锁 因为现在redis中的锁是另一个线程加上的，而他的删锁逻辑是lua脚本执行 先获取键值，判断是否是自己加的锁。如果是。则释放，lua脚本保证这是一个原子操作 所以，手动设置时间必须保证这个时间内业务能够执行完成 ## SpringCache的使用 https://docs.spring.io/spring-framework/docs/current/spring-framework-reference/integration.html#cache 1. 导入依赖。 ```xml org.springframework.boot spring-boot-starter-cache ``` 2. CacheAutoconfiguration类导入了多种类型的缓存自动配置 ```java static class CacheConfigurationImportSelector implements ImportSelector { @Override public String[] selectImports(AnnotationMetadata importingClassMetadata) { CacheType[] types = CacheType.values(); String[] imports = new String[types.length]; for (int i = 0; i < types.length; i++) { imports[i] = CacheConfigurations.getConfigurationClass(types[i]); } return imports; } } // 缓存类型 public enum CacheType { GENERIC, JCACHE, EHCACHE, HAZELCAST, INFINISPAN, COUCHBASE, REDIS, CAFFEINE, SIMPLE, NONE;} // 各种类型缓存对应的自动配置类 mappings.put(CacheType.GENERIC, GenericCacheConfiguration.class); mappings.put(CacheType.EHCACHE, EhCacheCacheConfiguration.class); mappings.put(CacheType.HAZELCAST, HazelcastCacheConfiguration.class); mappings.put(CacheType.INFINISPAN, InfinispanCacheConfiguration.class); mappings.put(CacheType.JCACHE, JCacheCacheConfiguration.class); mappings.put(CacheType.COUCHBASE, CouchbaseCacheConfiguration.class); mappings.put(CacheType.REDIS, RedisCacheConfiguration.class); mappings.put(CacheType.CAFFEINE, CaffeineCacheConfiguration.class); mappings.put(CacheType.SIMPLE, SimpleCacheConfiguration.class); mappings.put(CacheType.NONE, NoOpCacheConfiguration.class); MAPPINGS = Collections.unmodifiableMap(mappings); ``` 3. 每种类型的缓存自动配置类中，创建了CacheManager，根据默认配置或用户自定义配置初始化了一系列Cache 以RedisCacheConfiguration为例 ```java // 创建cacheManager。初始化cache @Bean RedisCacheManager cacheManager(){} // 用于决定初始化cache用什么配置，如果用户自定义了RedisCacheConfiguration。就用用户的配置 // 否则就自己创建一个配置 private determineConfiguration(){ CacheProperties cacheProperties, ObjectProvider redisCacheConfiguration, ClassLoader classLoader) { return redisCacheConfiguration.getIfAvailable(() -> createConfiguration(cacheProperties, classLoader)); } // 自己创建一个RedisCacheConfiguration private createConfiguration( CacheProperties cacheProperties, ClassLoader classLoader) { Redis redisProperties = cacheProperties.getRedis(); // 这里就是默认策略的设置 org.springframework.data.redis.cache.RedisCacheConfiguration config = org.springframework.data.redis.cache.RedisCacheConfiguration .defaultCacheConfig(); // 值的序列化采用Jdk序列化 config = config.serializeValuesWith( SerializationPair.fromSerializer(new JdkSerializationRedisSerializer(classLoader))); // 读取配置文件中用户指定的缓存有效期 if (redisProperties.getTimeToLive() != null) { config = config.entryTtl(redisProperties.getTimeToLive()); } // 读取配置文件中用户指定的缓存键的前缀 if (redisProperties.getKeyPrefix() != null) { config = config.prefixCacheNameWith(redisProperties.getKeyPrefix()); } // 读取配置文件中用户指定的缓存是否要缓存空值，缓存控制能够解决缓存雪崩(疯狂访问一个缓存和数据库中都没有的id，导致崩溃) if (!redisProperties.isCacheNullValues()) { config = config.disableCachingNullValues(); } // 读取配置文件中用户指定的缓存是否使用指定的键前缀 if (!redisProperties.isUseKeyPrefix()) { config = config.disableKeyPrefix(); } return config; } ``` 4. 使用缓存 首先在applicaition.yml中指定我们使用的是哪个类型的缓存， 并在配置类上使用@EnableCaching启用缓存 接下来只需要使用注解标注方法就行 ```yml spring.cache.type=redis ``` ```java @EnableCaching public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } @Cacheable: Triggers cache population: 触发将值存入缓存的操作 @CacheEvict: Triggers cache eviction. 触发将值从缓存移除的操作 @CachePut: Updates the cache without interfering with the method execution：触发更新缓存的操作 @Caching: Regroups multiple cache operations to be applied on a method：组合以上多种操作 @CacheConfig: Shares some common cache-related settings at class-level：在类级别上共享相同的缓存配置 ``` ### @Cacheable ```java /** * @Cacheable 代表当前方法的结果需要放入缓存 * 并且，每次访问这个方法时，会先去缓存中判断数据是否存在，若存在则直接返回缓存中数据，不会执行方法 * 但是我们需要指定，要将结果放入哪个缓存中，每个cacheManager管理多个cache. * 我们需要指定cache的名字(相当于对缓存进行分区管理，建议按照业务进行划分) * 使用cacheNames或value属性都可以。可以同时放入多个分区 * * 存入缓存中的键名：product-category::SimpleKey [] * cacheName::默认生成的键名 [方法参数列表] * 这个simplekey[]就是自己生成的键名 * 我们可以使用注解的key属性，指定键名，它接收一个Spel表达式 * 比如 #root.methodName 就是获取方法名 * 详细用法：https://docs.spring.io/spring-framework/docs/current/spring-framework-reference/integration.html#cache-spel-context * 指定key后，得到的键名是：product-category::getLevel1Category * * 默认生成的值是采用jdk序列化，并且过期时间是-1， * 如果我们想要改变默认配置， * 一些最基本的配置可以在配置文件中设置： * # 是否缓存空值 * spring.cache.redis.cache-null-values=true * # 键的前缀 * spring.cache.redis.key-prefix=CACHE_ * # 是否使用这个前缀 * spring.cache.redis.use-key-prefix=true * # 缓存的有效期 * spring.cache.redis.time-to-live=3600000 * 比较高级的配置，比如设置序列化策略采用json形式，就得自己编写RedisCacheConfiguration sync 属性：默认为false。 如果设为true。则会为处理过程加上synchronized本地锁。也就是说在一个微服务里面，能够保证线程间互斥访问这个方法 * * @return */ @RequestMapping("/product/category/level1") @Cacheable(cacheNames = {"product-category"}, key = "#root.methodName") public List getLevel1Category() { System.out.println("查询数据库"); List level1Categories = categoryService.getLevel1Categories(); return level1Categories; } /** * 自己编写RedisCacheConfiguration */ @EnableConfigurationProperties(CacheProperties.class) @Configuration public class RedisCacheConfig { /** * 没有无参构造方法。不能直接 new RedisCacheConfiguration(); * 使用RedisCacheConfiguration.defaultCacheConfig();默认配置，再修改 * * 用户的自定义配置都在 application.yml中其中spring.cache部分。 * 它和CacheProperties.class进行了绑定， * @ConfigurationProperties(prefix = "spring.cache") * public class CacheProperties {} * 但是这个类它没有被作为一个bean放入容器中。 * 我们需要手动导入 * @EnableConfigurationProperties(CacheProperties.class) * 这样容器中就会创建出一个 cacheProperties对象。我们可以使用方法参数直接接收 * @return */ @Bean public RedisCacheConfiguration redisCacheConfiguration(CacheProperties cacheProperties) { RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig(); // 设置键的序列化策略 config = config.serializeKeysWith(RedisSerializationContext.SerializationPair.fromSerializer(RedisSerializer.string())); // 设置值的序列化策略 config = config.serializeValuesWith(RedisSerializationContext.SerializationPair.fromSerializer(RedisSerializer.json())); // 加载配置文件中用户自定义配置 // 拿出redis部分 CacheProperties.Redis redisProperties = cacheProperties.getRedis(); if (redisProperties.getTimeToLive() != null) { config = config.entryTtl(redisProperties.getTimeToLive()); } if (redisProperties.getKeyPrefix() != null) { config = config.prefixCacheNameWith(redisProperties.getKeyPrefix()); } if (!redisProperties.isCacheNullValues()) { config = config.disableCachingNullValues(); } if (!redisProperties.isUseKeyPrefix()) { config = config.disableKeyPrefix(); } return config; } } /** * @CacheEvict: 触发删除缓存操作 * cacheNames: 指定要删除的是哪个缓存分区的缓存 * key: 要删除的是这个分区中的那个缓存 * allEntries: 是否删除这个分区中的所有缓存。默认false * 所以。如果只指定cacheNames.不指定key。不会进行任何删除。 * 如果设置allEntries = true。那么不用指定key。全部删除 * * key。一次只能指定一个key。那如果要删除多个，但不想全部删除，就需要使用 @Caching * @Caching( * evict = { * @CacheEvict(cacheNames = {ProductConstant.CacheName.PRODUCT_CATEGORY}, * key = "'level1Category'"), * @CacheEvict(cacheNames = {ProductConstant.CacheName.PRODUCT_CATEGORY}, * key = "'level2Category'") * }, * cacheable = {} * ) */ /** * @CachePut * 最简单的保证缓存和数据库一致性的方式就是，每次执行更新操作。就将缓存删除。下次查询方法自然会将最新数据存入缓存 * * 如果我们的更新方法没有返回值，也就是更新完就结束，那么我们使用@CacheEvit删除缓存 * 如果我们的更新方法有返回值，也就是更新成功后将最新数据返回，那么我们使用@CachePut将最新数据更新到缓存 * @return */ ``` ### Rabbitmq消息可靠投递 https://codeonce.cc/archives/rabbitmq-confirm ### Feign远程调用请求头丢失 https://codeonce.cc/archives/feign-lost-cookie ### Xloggc实践 https://blog.csdn.net/alinyua/article/details/108106706 ### Metaspace Below are the options to see the classes that are loaded in the Metaspace: 1. -verbose:class 2. -Xlog:class+load 3. jcmd GC.class_histogram 4. Programmatic approach 5. Heap Dump analysis Let’s discuss each option in detail in this post. -Xmx100m -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xloggc:gc-product-%t.log ### GIT约定规范 # 提交：主要 type feat: 增加新功能 fix: 修复bug # 提交：特殊 type docs: 只改动了文档相关的内容 style: 不影响代码含义的改动，例如去掉空格、改变缩进、增删分号 build: 构造工具的或者外部依赖的改动，例如webpack，npm refactor: 代码重构时使用 revert: 执行git revert打印的message # 提交：暂不使用type test: 添加测试或者修改现有测试 perf: 提高性能的改动 ci: 与CI（持续集成服务）有关的改动 chore: 不修改src或者test的其余修改，例如构建过程或辅助工具的变动 # 注释：类注释配置 /** * @description: * @author: ${USER} * @date: ${DATE} */