# redcat-example-service

**Repository Path**: ywkj2014/redcat-example-service

## Basic Information

- **Project Name**: redcat-example-service
- **Description**: 红猫平台定制后端模板项目
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-23
- **Last Updated**: 2021-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# redcat-example-service

### 介绍
> 红猫平台定制后端模板项目
>> 功能简介：开发者在复杂业务场景中可以使用JAVA代码来实现业务，并自助上传部署，通过在线JS调用接口的方式完成复杂业务逻辑处理。
### 软件架构
>SpringBoot+Mybitis+Mysql
### 同步模板教程
1.  代码下载
    + 模板下载地址：[redcat-example-service](https://ywprod-file.ywsoftware.com/sdk/redcat-example-service-1.0.0.zip "https://ywprod-file.ywsoftware.com/sdk/redcat-example-service-1.0.0.zip")  
      下载并解压后需修改项目名称，替换example为定制项目的别名，此处以producttest为例
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/179120B9-C520-0008-9BA1-1DA6ACED6D98.png">
    + 修改完成后使用IDEA编辑器打开进行后续操作。  
2.  别名替换 
    +  全局替换example为定制项目的别名，此处以producttest为例。IDEA的全局替换快捷键Ctrl+Shift+R  
       <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911E4B-FFC0-0001-8722-55A5EB30D642.png">
    +  修改包名  
       <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911E5C-94B0-0001-8422-9798341A6EB4.png">
    +  修正启动类和测试启动类的名称ProductTestExtensionApplication  
       <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911E6D-D250-0002-AA79-07BBF1DBE1A1.png">
3.  租户配置
    + 全局搜索“[SET-TENANTID]”替换为需要定制的租户ID，这里举例替换为“1764CF70-9090-054F-B8AC-5C4602BF9694”  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911E76-28E0-0002-8775-662DDC702646.png">
4. 数据库配置
    + 申请账号 分为两个PRODTEST账号和PRODSYS账号
        + PRODTEST账号用于开发和测试环境运行
        + PRODSYS账号则正式用于生产运行
    + 配置覆盖
        + application.yml 中修改为正确的prodtest外网账号
        + application-prodtest.yml 修改url为内网URL 
        + application-prod配置PRODSYS账号或沟通红猫平台运维人员用环境变量覆盖进行账号安全保护。  
          <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911EB8-A0B0-0003-ADE8-CCCF553136A5.png">
5. 日志配置
    + 如需要红猫系统的日志系统 需申请并配置redcat.logger的appId appKey  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911EC4-2E40-0003-9141-391E714E16F0.png">
6. 项目运行
    + 所有名称替换和配置处理完成后，找到项目启动类 点击运行  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911ED7-C670-0004-AC1E-1B0E65E635F0.png">  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911EDC-74D0-0004-9762-E3267B5BA8AE.png">  
    + 启动正常后，访问localhost:8800/api/accounts  
      得到正常的返回JSON数据返回则正常（无用户数据则空数组[]返回），则代表定制项目模板已修改成功，可以进行开发了。  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911F05-88E0-0005-994D-0FE8CE83984E.png">
7. 项目打包
    + 打包分为两种方式一种是使用命令在项目文件夹根目录下运行CMD窗口执行 “mvn clean package”;一种使用IDEA的maven集成命令，如图  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911F10-5370-0005-8EFE-563E4B8ED68C.png">
    + 运行日志返回“BUILD SUCCESS”，则打包完成。
8. 项目发布
    + 登录开发者中心，进入应用的设计界面点击“定制发布”按钮（该按钮的开放需在应用的基础属性处申请）。  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911F17-D400-0006-BA0A-1C934D910AFF.png">
    + 进行系统选择，类型选择，选择上一步打包完成的jar文件，填写备注后点击“确认发布”  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911F1B-9EC0-0006-B73F-494EB571A863.png">
    + 上传完成后，刷新发布列表大约1分钟左右发布成功。  
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911F21-A040-0007-BE31-9D3D165910C1.png">
    + 测试接口，进入到测试系统域名下，访问 https://*.test.bobmao.cn/<font size=5>producttest-api</font>/user
如图返回则说明定制项目发布成功。   
      <img src="https://ywprod-file.ywsoftware.com/ak0000000386/16A58505-6D90-00B8-89AB-7E888323E42F/USER/202104/17911F28-5950-0007-91B5-844164814905.png">  
      *注：红猫系统是由微服务搭建完成，各服务的项目需进行路由分发，定制项目开发均需按照/api/开头的路由进行研发，运维会根据不同的应用别名（本次演示为producttest）-api转发到对应的服务。*


#### 模板下载地址
|包名|版本|创建人|发布时间|下载地址|更新说明|
| :----: |:----: |:----: |:----: |:----: |:---- |
|redcat-example-service-1.0.0|1.0.0|赵富华|2021-04-27|[redcat-example-service-1.0.0](https://ywprod-file.ywsoftware.com/sdk/redcat-example-service-1.0.0.zip "https://ywprod-file.ywsoftware.com/sdk/redcat-example-service-1.0.0.zip")|* 项目初始化|

#### SDK下载地址
|包名|版本|创建人|发布时间|下载地址|更新说明|
| :----: |:----: |:----: |:----: |:----: |:---- |
|redcat-extensions-sdk-1.0.0.jar|1.0.0|赵富华|2021-04-27|[redcat-extensions-sdk-1.0.0.jar](https://ywprod-file.ywsoftware.com/sdk/redcat-extensions-sdk-1.0.0.jar "https://ywprod-file.ywsoftware.com/sdk/redcat-extensions-sdk-1.0.0.jar")|* 新增 SessionHolder 用户会话信息  <br>* 新增 Token 拦截器<br>* 新增全局异常拦截器<br>* 新增基础应用异常类<br>* 新增 UUID 生成器 <br>* 新增Inster租户拦截器|