# 01_learn_arc-java

**Repository Path**: Liuu7_ees/01_learn_arc-java

## Basic Information

- **Project Name**: 01_learn_arc-java
- **Description**: 01星球o2oa大项目--Java组件学习
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-30
- **Last Updated**: 2024-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工程简介
项目架构父模块，用于管理第三方依赖和项目模块

创建spring boot项目的时候如果比较慢可以使用：http://start.aliyun.com/ 替代原来的 https://start.spring.io

# 分层领域模型规约

领域模型本身有没固定的使用限制，但是在一套项目架构体系中需要有统一的规范。

领域对象描述：

- DO（Data Object）：此对象与数据库表结构一一对应，通过 `DAO` 层向上传输数据源对象。
- `DTO`（Data Transfer Object）：数据传输对象，Service 或 Manager 向外传输的对象。 
- BO（Business Object）：业务对象，可以由 Service 层输出的封装业务逻辑的对象。
- Query：数据查询对象，各层接收上层的查询请求。注意超过2个参数的查询封装，禁止使用Map类来传输。
- `VO`（View Object）：显示层对象，通常是 Web 向模板渲染引擎层传输的对象。

各层之间的关系如下图所示，里面包含了领域模型的传递过程。

![image-20230410170044445](imgs/layer.png)

下面是各层命名规范

- `Controller/Service/DAO` 层方法命名规约
  - 获取单个对象的方法用 `query/get/select` 做前缀。
  - 获取多个对象的方法用 `query/list/select` 做前缀。
  - 获取统计值的方法用 `count/count/count` 做前缀。
  - 插入的方法用 `add/save/insert` 做前缀。
  - 删除的方法用 `remove/remove/delete` 做前缀。
  - 修改的方法用 `modify/update/update` 做前缀。
  - `API`请求路径命名，前缀（如：功能模块名称）+ 功能名称（多个单词使用-连接），比如下面的示例：
    - `/sys/query-by-name`、`/user/add-user`、`/user/modify-password`。
- 领域模型命名规约
  - DO：`xxxDO`，`xxx` 即为数据表名。
  - DTO：`xxxDTO`，`xxx` 为业务领域相关的名称。
  - Query：`xxxQuery`，`xxx`为业务领域相关的名称。
  - VO：`xxxVO`，`xxx` 一般为网页名称。
  - `POJO` 是 `DO/DTO/BO/VO/Query` 的统称，禁止命名成 `xxxPOJO`。

# 延伸阅读

## `nacos`服务器配置参考

***注意：上传到  `Nacos`  配置中心的配置不要带中文注释，不然会出想编码问题。***

### `system.yaml`

系统配置，后续配置网关或新增服务器都在这里配置，方便在线扩展

```yaml
spring:
  cloud:
    inetutils:
      #优先网络IP选择
      preferred-networks: 
        - 192.168
        - 39.99
      #忽略一些虚拟网卡
      ignored-interfaces:
        - docker0
        - veth.*
        - VM.*
        - br-.*
```

### `data-source.yaml`

数据源配置

```yaml
#References
#https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter
#https://github.com/alibaba/druid/wiki/DruidDataSource%E9%85%8D%E7%BD%AE
#https://github.com/alibaba/druid/wiki/DruidDataSource%E9%85%8D%E7%BD%AE%E5%B1%9E%E6%80%A7%E5%88%97%E8%A1%A8
spring:
  #配置MySQL数据库
  datasource:
    url: jdbc:mysql://192.168.220.128:3306/test?useUnicode=true&useSSL=false&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      name: DruidDataSource
      initial-size: 1
      min-idle: 1
      max-active: 20
      async-init: true
      max-wait: 6000
      time-between-eviction-runs-millis: 60000
      min-evictable-idle-time-millis: 300000
      max-evictable-idle-time-millis: 900000
      validation-query: SELECT 1
      test-while-idle: true
      test-on-borrow: false
      test-on-return: false
      pool-prepared-statements: true
      max-pool-prepared-statement-per-connection-size: 20
      connection-init-sqls: SET NAMES utf8mb4 COLLATE utf8mb4_0900_ai_ci;
      filters: stat
  #配置Redis数据库
  redis:
    host: 192.168.220.128
    port: 6379
    password: 01star
  data:
    #mongodb配置
    mongodb:
      #格式: mongodb://账号:密码@主机地址:端口/数据库名称
      uri: mongodb://awei:123456@192.168.220.128:27017/firstDb
```

### `third-services.yaml` 

第三方服务配置

```yaml
#C++提供服务器
cpp:
  sample:
    url: http://localhost:8090
    name: feign-cpp-sample
#sentinel提供服务
sentinel:
    dashboard: 192.168.220.128:8718
#rocketmq配置
rocket-mq:
    name-server: 192.168.220.128:9876
#seata配置
seata:
  default: 192.168.220.128:8091
#logstash配置
logstash:
  host: 192.168.220.128
#FASTDFS配置
#References
#https://i4t.com/4758.html
#https://github.com/happyfish100/fastdfs/tree/master/docker/dockerfile_network/conf
fastdfs:
  charset: UTF-8
  connect-timeout: 5
  network-timeout: 30
  http-secret-key: FastDFS1234567890
  http-anti-steal-token: true
  connection-pool-max-idle: 20
  connection-pool-max-total: 20
  connection-pool-min-idle: 2
  nginx-servers: 192.168.220.128:8888
  tracker-servers: 192.168.220.128:22122
#Easy ES
easy-es:
  address: 192.168.220.128:9200
  username: elastic #es用户名,若无则删去此行配置
  password: WG7WVmuNMtM4GwNYkyWH #es密码,若无则删去此行配置
```

### `key-config.yaml`

秘钥配置文件

```yaml
#aliyun key
aliyun:
 sms:
  ak: dsfdsfdsdfsdfdsf
  sk: dfdsfdslkgggkhghg
spring:
  # 邮件配置
  mail:
    # 服务器地址（这里使用网易邮箱）
    host: smtp.163.com
    # 服务器端口
    port: 25
    # 邮件发送人账号
    username: xxxx@163.com
    # 邮件服务授权码
    password: xxxxxxssss
    # 邮件发信人（即真实邮箱，需要和授权邮箱一致）
    properties:
      from: xxxx@163.com
      name: xxxxx
```