madao_service: A Java repository from GuoGuang

急速预览---直达

如果喜欢记得给个star哦🌟

更多内容请关注公众号：码道人生

本仓库基于spring、spring-boot、spring-cloud等全家桶模块搭建

一、技术选型

核心框架：SpringBoot、SpringCloud全家桶、Python提供电影服务
安全框架：Spring Security
分布式任务调度：Elastic-job
持久层框架：Jpa
数据库连接池：Druid
数据库/存储：Mysql8.0+、Redis
消息队列：RabbitMQ
日志管理：Logback
三方服务：邮件服务、阿里云短信服务、阿里云OSS对象存储
运维/集成/部署：Jenkins、Docker...

二、前台项目请移步

三、其他开源仓库

项目	地址
IDEA插件（IDEA市场搜索 Generate Crud 安装）	根据JPA实体类生成后端代码，简单快捷 👋
pinyinUtils	https://github.com/GuoGuang/pinyinUtils
后台管理框架	https://github.com/GuoGuang/madao_admin_manage
数据爬虫集合	https://github.com/GuoGuang/python-spider
前台博客	https://github.com/GuoGuang/madao
如何写好单元测试	https://github.com/GuoGuang/spring_junit_mockito_example

四、平台目录结构说明

├─madao-common-parent----------------------------父项目，公共依赖
│  │
│  │─madao-authentication-server----------------认证服务
│  │
│  ├─madao-common--------------------------------微服务公共包
│  │
│  ├─madao-service-config-------------------------微服务配置中心+微服务注册中心
│  │
│  ├─madao-service-api---------------------------微服务API工程
│  │
│  ├─madao-service-article-----------------------文章服务
│  │
│  ├─madao-service-base--------------------------基础服务
│  │
│  ├─madao-service-search------------------------搜索服务
│  │
│  ├─madao-service-user--------------------------RBAC用户服务
│  │
│  ├─madao-web-gateway---------------------------微服务网关中心

前置环境

IDE：IntelliJ IDEA
JDK：17+
工具：Maven

五、快速开始

本项目需要你有一定得开发经验，对SpringCloud有基础的认识，此项目仅提供学习使用。

开源不易，如果此项目对您有帮助，麻烦点个star给作者一点动力，不胜感激。:sparkles:

1. 导入服务

点击 "import module" 将服务一一导入，如果你嫌一个个导入麻烦，可以在madao-common-parent的pom.xml文件中最底下把标签放开，但是真正微服务开发一般一个团队或者一个人负责一个服务，没有一个人同时开发多个服务情况，毕竟是个人博客项目，导入方式可以自己定。

// install
mvn -B -DskipTests install -f madao-common-parent -Dmaven.test.skip=true  
或者 
idea里 maven选项选中madao-common-parent install 需要在Maven Projects界面里中选中"跳过测试"

2. 初始化数据库

导入系统根路径下madao.sql文件到数据库中

3. 初始化中间件

一个成熟的项目必然会依赖众多中间件，本项目也不例外，这里假设你会使用docker,如果你还没有接触到docker,那么可以参考我的另一篇文章Docker入门

使用docker启动mysql、redis
```
// mysql
docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root -d mysql --lower_case_table_names=1

// redis
docker run --name myredis -d -p 6379:6379 -v /data/redis/redis.conf:/etc/redis/redis.conf -v /data/redis/data:/data redis  redis-server /etc/redis/redis.conf --requirepass "root" --appendonly yes

// rebbitmq
docker run -d --name rabbit-server -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin -p 5672:5672 -p 15672:15672 rabbitmq:3-management

```

4. 配置注册中心远程仓库

github fork此仓库配置中心

将里面的配置文件更改为你的地址
阿里云oss地址没有的话需要注释掉
将密码部分（{cipher}）改为你的真实密码（{cipher}是指用的加密数据）

5. 配置注册中心远程地址

在madao-server-config服务中找到bootstrap.yml文件，配置如下

spring:
  profiles:
    active: ${ACTIVE_PROFILE:dev}
  cloud:
    config:
      server:
        encrypt:
          enabled: true # 启用config加密功能
        git:
          uri: 第2步配置的注册中心远程仓库地址
          searchPaths: ${spring.profiles.active}
          default-label: master
          username: 你的github账号
          password: '你的github密码'

      enabled: true    # 开启消息跟踪

# 非对称加密，将下面的配置注释。如果上面配置的"你的github密码"地方是明文，则注释掉下面配置
# encrypt:
#   key-store:
#     location: classpath:xxx
#     alias: xxx
#     password: xxx
#     secret: xxx

6. 生成store文件

生成store文件并将其放到madao-server-config服务下的resources目录下。

# 生成keystore，或者直接用根目录下的madao.keystore文件
keytool -genkeypair -alias madaoo.com -keyalg RSA -dname "CN=Web Server,OU=China,O=www.youwebsite.im,L=ShangHai,S=ShangHai,C=China" -keypass madaoo.com -keystore madao.keystore -storepass madaoo.com
# 生成crt，后面获取公钥
keytool -export -alias madaoo.com -file test.crt -keystore madao.keystore
# 获取公钥，以文本方式打开rsa_public_key.pem，然后在配置中心配置其内容
openssl x509 -inform der -in test.crt -pubkey -noout > rsa_public_key.pem

# 远端配置中心示例：
com:
  madao:
    # 秘钥token，例：-----BEGIN PUBLIC KEY-----xxxx-----END PUBLIC KEY----- 取其中的xxxx
    secretKey: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvbwpEqZcet2KRTppVazzOU55+w6o1pf/JSiQEYYpXw/wCRZCXTf2wqnoLjb50+21ZEIhAFkE9wvW1FjNpFO1zYcy0HcKvJQb8qhQhGUHmP4w6Qb9bRJXhGt4IoKApXVUN+A4+xz8xC+Jw6/zn46pNQv2e47HATm/P+0LDDqxU7MPhPvddr9ihKeeVCG+/8W2X2a4N/NHoQo0Q1AyGWQcVWnl4yYgKpmedk3eGLpuaHZKJxse5bb9K5mEk5vuRsEhTkhtLVH2HT3ZCDycJQPdXjv+iO88O5Nbj/Tc2wehxnD3GFBKPaOZWDwIcNyIOTXRa4OvVFtEe4Qb3wNNhIYfiQIDAQAB

7. 启动

第一步首先启动madao-service-config服务，这个是注册中心+配置中心，然后再启动其他的服务。

Swagger

本地访问地址默认账号：admin 密码：password

SpringSecurity流程

大致了解一下SpringSecurity的流程，方便对整个项目的了解

常见问题

1、关于内存问题

SpringCloud是比较吃内存的，如果你不指定内存大小，8G内存一般启3、4个就满了，所以这里需要配置下每个服务内存大小

打开Environment config,如果你不指定在哪打开，参考https://www.jetbrains.com/help/idea/2019.3/run-debug-configuration-junit.html?utm_campaign=IU&utm_content=2019.3&utm_medium=link&utm_source=product#configTab 的VM options

类似 config、gateway、eureka、 Oauth2Authentication、服务配置为 -Xmx128m -Xms128m -Xmn50m

其他的-Xmx236m -Xms236m -Xmn150m

以上配置请不要再生产使用，仅作为本地开发调试，为解决内存不足问题的，当然如果你的内存够大，可以忽略以上配置

2、javax.annotation.processing.FilerException: Attempt to recreate a file for xxx

maven install之前先maven clean

启动微服务

架构图

服务监控平台

启动 madao-service-monitor 服务访问地址

更新日志

[20211128]：实现分布式Socket弹幕功能
[20211111]：基于loadbalancer重写负载均衡器，实现前端指定后端实例访问的功能。
[20210505]：将资源缓存化，加快访问速度。
[20210412]：移除不必要得依赖，项目结构重构。
[20210204]：Spring-Cloud-Gateway 集成 Swagger,支持认证后访问，由网关统一管理。

GuoGuang/madao_service