本框架的初始理念

本框架为启路springCloud服务模板工程,三大项目类型之一,只有接口,没有页面.

内网工程,没有安全.

本项目为微服务的模板工程,在没有平台的情况下,只是对springCloud进行了集成,配置常见的参数,支持多版本的兼容.

使用feign的过程中,对常见的坑进行简单处理.主要解决问题:

• 可运行的程序框架+示例
• 服务暴露
• 服务声明
• 服务调用
• 验证
• 异常处理
• 日志追踪号传递
• 多版本兼容
• 简单监控,(外挂prometheus+grafana)
• 配置文件载入
• 附带简单运维
• springboot2.3版本以后,支持优雅停机(请使用run.sh启停服务),2.2以前版本,请使用actuator/shutdown停机,脚本不支持
• 支持Hicari/Druid数据源

从业十多年以来,虽然一直都在积累,内容相对比较多,但是始终处于一个比较混乱的状态.启路框架作为我从业十多年的经验的积累,做一个完整的技术输出.现阶段服务器的应用主要分为如下几类:

• 后台管理框架

• 纯接口框架

本地maven构建

settings文件的设置

请设置本地settings文件进行如下设置

• 设置mirror为阿里云的开放仓库

<mirror>
  <id>alimaven</id>
  <mirrorOf>central</mirrorOf>
  <name>aliyun maven</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
</mirror>

推荐Eclipse javaEE版 或者 IDEA

本文中的截图都是使用eclipse,请自行对照

一般不需要安装啥插件,有一些插件对于我们平常的编码有很大的用处,这边做点推荐

• regex-util 主要在编写正则表达式非常好用
• eclemma 主要在写完代码以后,编写单元测试脚本,看看覆盖率

字符集设置

这个应该是一个习惯,只要是打开IDE,首先想到的第一件事情,就是设置IDE的字符集

还要设置具体文件的字符集

设置工作空间

maven是现在主流公司都在使用的一个项目组织工具.也有一些替代的工具,比如gradle,但是目前还没形成趋势,能否大规模使用有待验证.

使用maven具备如下好处

• jar包管理,使用maven搭建的环境,比使用ant或者自己管理的jar包,会出现更少的jar包冲突
• 打包控制,除了能方便的打包以外,还能打doc包,source包和可执行包
• 集成CI工具,使用maven的最重要的好处就能可以和各种CI工具集成,是敏捷开发中不可缺少的工具
• 查看源码,改变了查看源码的方式

虽然各种IDE里面已经集成了嵌入式的maven,我这边还是推荐使用外部的Maven工具进行处理,内部嵌入式的maven,会受到当前IDE的JRE的影响,有时候本地编译成功不代表在服务器上能成功. 而本地成功,能代表服务器上进行编译也一定能成功.

这边墙裂推荐看文档的同学,搭建自己的maven私服.

1. 在企业里面,每家企业都自己搭建maven私服.
2. maven的settings内部,本身的mirrors,虽然可以配置多个mirror,但是每次编译都只有一个mirror生效,而搭建私服可以直接从多个源下载,不受影响.

搭建私服

搭建过程,请自行百度,这边不做介绍.

nexus的设置

• 创建一个类型为proxy的仓库,地址指向阿里云的公开仓库,https://maven.aliyun.com/nexus/content/groups/public/

• 创建一个类型为proxy的仓库,地址指向9istock的公开仓库,http://nexus.9istock.com/repository/maven-public/

• 在本地public仓库中,开放新创建的阿里云仓库和9istock的仓库

• 如果需要上传本地jar包,请在创建一个类型为host的仓库, 常见的nexus都已经创建好了release和snapshot的repostiry,仔细观察2份repository的配置,安全性是不一样的.