# chinese-springboot

**Repository Path**: yzd_org/chinese-springboot

## Basic Information

- **Project Name**: chinese-springboot
- **Description**: 🔥🔥🔥国产化适配金蝶容器(AAS)
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 12
- **Forks**: 7
- **Created**: 2021-03-12
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 国产化适配经验总结

本文通过实际的实践经验，总结出了服务端 `SpringBoot` 国产化适配的注意事项

---

## 项目概述

这是一个基于 Spring Boot 的 Web 应用程序，已针对国产化环境进行了适配，包括金蝶 AAS、东方通 TongWeb 等应用服务器。项目包含用户管理功能，支持用户信息的保存和查询。

### 项目结构

```
src
├── main
│   ├── java/com/cn/mical/springboot
│   │   ├── controller
│   │   │   ├── HelloController.java     # 简单的 Hello World 控制器
│   │   │   └── UserController.java      # 用户管理控制器
│   │   ├── pojo
│   │   │   └── User.java                # 用户实体类
│   │   ├── repository
│   │   │   └── UserRepository.java      # 用户数据仓库（内存存储）
│   │   └── SpringbootApplication.java   # 主应用类
│   └── resources
│       └── application.properties       # 应用配置文件
└── test
    └── java/com/cn/mical/springboot
        └── SpringbootApplicationTests.java
```

### 核心功能模块

1. **HelloController**: 提供基础的 "/" 路径访问，返回 "Hello Word"
2. **UserController**: 提供用户管理功能
   - POST /person/save: 保存用户信息
   - GET /person/get/{id}: 根据ID获取用户信息
   - GET /person/getUserInfo: 根据ID获取用户信息
3. **User**: 用户实体类，包含 id 和 userName 字段
4. **UserRepository**: 内存存储的用户数据仓库，使用 ConcurrentHashMap 存储数据，AtomicInteger 生成ID
5. **SpringbootApplication**: 主应用类，继承 SpringBootServletInitializer 以支持部署到外部容器

---

## 国产化适配清单

+ 金蝶AAS V9.0
+ 东方通tongweb 7
+ 达梦DM8 V8.1.1.126
+ 统信 uos 2

## 金蝶AAS适配

### 常见配置和问题

+ jvm

> 编辑 `%domian_home%/bin/startapusic`，搜索`MEMORY_JVMOPTS`
> MEMORY_JVMOPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"

+ 请求

AAS默认是将 `DELETE,PUT,TRACE,OPTIONS` 这四个请求方式禁用了.

>编辑 `%domian_home%/config/vm.options`,搜索`apusic.http.disabledMethods`,进行注释
> apusic.http.disabledMethods=DELETE,PUT,TRACE,OPTIONS

+ 端口

> 编辑 `%domian_home%/config/apusic.conf`，搜索`Port`
> ATTRIBUTE NAME="Port" VALUE="6888"

+ 管理

[![rhxOmV.jpg](https://z3.ax1x.com/2020/12/26/rhxOmV.jpg)](https://imgchr.com/i/rhxOmV)

+ 后台启动和停止

在`./startapusic`其后面加入"&"即可,停止通过杀进程的方式

### 项目适配

+ 排除内嵌tomcat

```xml
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 移除嵌入式tomcat插件 -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>
```

+ 打成war

```xml
<packaging>war</packaging>
```

+ 修改启动类，并重写初始化方法

```java
public class WebApplication extends SpringBootServletInitializer {  
    修改启动类，继承 SpringBootServletInitializer 并重写 configure 方法
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        System.out.println("======WebApplication====start==========");
        return builder.sources(new Class[]{WebApplication.class});
    }
}
```

+ 注入websoket

```java
@Configuration
public class WebSocketConfig {

    @Bean
    public ServerEndpointExporter serverEndpointExporter() {
        return new ServerEndpointExporter();
    }
}
```

+ 添加serverlet依赖

```xml
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.0.1</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <scope>provided</scope>
        </dependency>
```
  
+ 配置文件解析器

```java
    /**
     * 金蝶文件无法上传时使用,<注意：非国产化注入,文件无法上传>
     * @return MultipartResolver
     */
    @Bean(name = "multipartResolver")
    @Profile({"uos", "dm"})
    public MultipartResolver multipartResolver() {
        CommonsMultipartResolver resolver = new CommonsMultipartResolver();
        resolver.setDefaultEncoding("UTF-8");
        // resolveLazily属性启用是为了推迟文件解析，以在在UploadAction中捕获文件大小异常
        resolver.setResolveLazily(true);
        resolver.setMaxInMemorySize(40960);
        // 上传文件大小 100M 100*1024*1024
        resolver.setMaxUploadSize(100 * 1024 * 1024);
        return resolver;
    }
```

<font color='red'>注意:项目未使用redis但引入redis依赖时,AAS启动将报错</color>

## 东方通tongweb

### 常见配置和问题

+ jvm

[![r49OgJ.jpg](https://z3.ax1x.com/2020/12/26/r49OgJ.jpg)](https://imgchr.com/i/r49OgJ)

+ 端口

[![r4CwPU.jpg](https://z3.ax1x.com/2020/12/26/r4CwPU.jpg)](https://imgchr.com/i/r4CwPU)

+ 部署和部署

[![r49c4S.jpg](https://z3.ax1x.com/2020/12/26/r49c4S.jpg)](https://imgchr.com/i/r49c4S)

+ 修改通道编码为utf-8

[![sEf20P.png](https://z3.ax1x.com/2021/01/06/sEf20P.png)](https://imgchr.com/i/sEf20P)

或

位置：`TongWeb7.0\conf\tongweb.xml`,搜索以下关键字将`GBK`修改为`utf-8`

```xml
 uri-encoding="GBK"
 parameter-encoding="GBK"
 response-encoding="GBK"
```

### 项目适配

+ 打成war

```xml
<packaging>war</packaging>
```

+ 修改启动类，并重写初始化方法

```java
public class WebApplication extends SpringBootServletInitializer {  
    修改启动类，继承 SpringBootServletInitializer 并重写 configure 方法
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        System.out.println("======WebApplication====start==========");
        return builder.sources(new Class[]{WebApplication.class});
    }
}
```

+ 添加serverlet依赖

```xml
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.0.1</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <scope>provided</scope>
        </dependency>
```

## 统信uos2

+ nginx中文文件无法下载

方式一：将文件名修改为英文
方式二：通过文件流方式下载
方式三：修改Nginx支持中文文件名

1. 确定服务器安装了UTF-8字符集
在命令行里输入env|grep LANG
如果显示en_US.UTF-8则说明已安装

2. 在nginx的配置文件中添加charset utf-8; 并使其生效

```java
　server {
　　listen 80;
　　server_name localhost;
　　charset utf-8;
　　……
```

3. 重新以UTF-8方式上传文件，以Xftp举例
点击属性->选项->勾选使用UTF-8编码

## 达梦

[![r4Pny9.jpg](https://z3.ax1x.com/2020/12/26/r4Pny9.jpg)](https://imgchr.com/i/r4Pny9)

### 迁移

[![r4Plo6.jpg](https://z3.ax1x.com/2020/12/26/r4Plo6.jpg)](https://imgchr.com/i/r4Plo6)

+ FAQ

乱码解决：指定URL
`jdbc:mysql://localhost:3306/meeting?characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowMultiQueries=true`

### Mybatis的代码处理

[![r4iBu9.jpg](https://z3.ax1x.com/2020/12/26/r4iBu9.jpg)](https://imgchr.com/i/r4iBu9)

### SQL适配

1. 模式名+表名 (注意大写模式名)

```sql
  <select id="selectAll" resultMap="BaseResultMap">
        select
        meet_info.id,
        meet_info.gmt_create,
        meet_info.gmt_modified,
        meet_info.name,
        meet_info.expect_start_time,
        meet_info.expect_end_time,
        meet_info.room_id,
        meet_info.type_id,
        meet_info.summary,
        meet_info.status,
        is_enabled,
        meet_info.is_deleted,
        meet_room.room_name AS meet_room,
        meet_room.room_location as roomLocation,
        meet_type.type_name as meet_type,
        creator_id
        from "MEETING".meet_info
        inner join "MEETING".meet_room on meet_info.room_id = meet_room.id
        inner join "MEETING".meet_type on meet_info.type_id = meet_type.id
        where meet_info.is_deleted=0
        order by meet_info.expect_start_time desc
    </select>
```

2. 达梦如果设置了某个列为主键自增，那么 `insert` 语句就不能指定主键值

正例：

```sql
    <insert id="insert" parameterType="com.bourne.meet.meeting.domain.MeetBallot" useGeneratedKeys="true"
            keyProperty="id" keyColumn="id">

    insert into "MEETING".meet_ballot (gmt_create, gmt_modified,
      meet_id, issue_id, start_time, 
      interval_time, end_time, ballot_status, 
      is_anonymous, corp_id)
    values (  #{gmtCreate,jdbcType=TIMESTAMP}, #{gmtModified,jdbcType=TIMESTAMP},
      #{meetId,jdbcType=BIGINT}, #{issueId,jdbcType=BIGINT}, #{startTime,jdbcType=TIMESTAMP}, 
      #{intervalTime,jdbcType=INTEGER}, #{endTime,jdbcType=TIMESTAMP}, #{ballotStatus,jdbcType=CHAR}, 
      #{isAnonymous,jdbcType=BIT}, #{corpId,jdbcType=VARCHAR})
  </insert>
```

反例：

```sql
  <insert id="insert" parameterType="com.bourne.meet.meeting.domain.MeetBallot" useGeneratedKeys="true" keyProperty="id" keyColumn="id">
    insert into meet_ballot (id, gmt_create, gmt_modified, 
      meet_id, issue_id, start_time, 
      interval_time, end_time, ballot_status, 
      is_anonymous, corp_id)
    values (#{id,jdbcType=BIGINT}, #{gmtCreate,jdbcType=TIMESTAMP}, #{gmtModified,jdbcType=TIMESTAMP}, 
      #{meetId,jdbcType=BIGINT}, #{issueId,jdbcType=BIGINT}, #{startTime,jdbcType=TIMESTAMP}, 
      #{intervalTime,jdbcType=INTEGER}, #{endTime,jdbcType=TIMESTAMP}, #{ballotStatus,jdbcType=CHAR}, 
      #{isAnonymous,jdbcType=BIT}, #{corpId,jdbcType=VARCHAR})
  </insert>
  ```

3. 数据库连接务必设置IP（这样能避免防火墙和达梦数据库的隔离策略导致的很多问题）

4. 达梦不支持函数: `LAST_INSERT_ID()`

5. 达梦日期时间函数适配

 `DATE_SUB(NOW(), INTERVAL 1 MONTH) --> NOW() - INTERVAL '1' MONTH`

6. 不能使用关键字和保留字作为列名

7. 批量插入不能返回受影响记录数


## 📞联系方式

如有任何问题或建议，请联系项目维护者。

- 个人网站：https://yzd1206.blog.csdn.net
- QQ：121665820


## 🛠️ 推荐工具

如果您正在使用 Hutool 工具库，强烈推荐搭配 `hutool-plus` 使用，这是一个基于 Hutool 的增强工具包，秉承"只做增强不做改变"的设计理念，

为简化开发、提高效率而生。完全兼容 Hutool 原有 API，提供了更多开箱即用的功能模块，特别是在 Spring 生态集成方面做了大量优化工作，让您能够更专注于业务逻辑实现。

<p align="center">
	<img src="https://raw.gitcode.com/yzd1206/hutool-plus/raw/master/docs%2Fimages%2Fplus-logo.png" width="45%">

</p>
<p align="center">
	<strong>🍬Hutool最佳搭档，只做增强不做改变，为简化开发、提高效率而生</strong>
</p>

### 📚简介

`hutool-plus`是基于[Hutool](https://hutool.cn/)的增强工具包，秉承"Hutool最佳搭档，只做增强不做改变"的设计理念，致力于进一步简化Java开发，提升开发效率。

`hutool-plus`在Hutool的基础上进行了功能增强和扩展，保留了Hutool原有的所有优秀特性，同时增加了更多实用的功能模块，特别是在Spring生态集成方面做了大量工作。

GitCode源码仓库地址：[https://gitcode.com/yzd1206/hutool-plus](https://gitcode.com/yzd1206/hutool-plus)

Gitee源码仓库地址：[https://gitee.com/yzd_org/hutool-plus](https://gitee.com/yzd_org/hutool-plus)

Maven仓库地址(网页1)：[https://repo1.maven.org/maven2/io/github/yzd1206](https://repo1.maven.org/maven2/io/github/yzd1206)

Maven仓库地址(网页2)：[https://mvnrepository.com/artifact/io.github.yzd1206](https://mvnrepository.com/artifact/io.github.yzd1206)


## ⭐Star Hutool

[![Stargazers over time](https://starchart.cc/chinabugotech/hutool.svg)](https://starchart.cc/chinabugotech/hutool)