信创环境金蝶Apusic应用服务器(AAS)使用

概要

随着国产化技术普及，越累越多的政府相关项目要求使用信创国产化应用中间件

例如：

Apusic应用服务器。

本人使用springboot项目与linux服务器对AAS-V10进行操作

金蝶Apusic应用服务器使用步骤

修改项目打包方式

Apusic应用服务器功能对标tomcat，需要项目打包成war包方式。

由于本人使用的项目架构为springboot，其中内置tomcat并自动打包为jar包，所以要修改其打包方式

1.修改pom.xml打包方式<packaging>jar</packaging>改为<packaging>war</packaging>

<packaging>war</packaging>

2.排除springboot自带tomcat依赖

<!-- web -->
        <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>

3.添加servlet依赖

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

4.修改启动类，继承SpringBootServletInitializer

5.启动类重写SpringBootServletInitializer中的configure方法，SocialPersuasionApplication.class为自己项目启动类名称

@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
    // 注意这里要指向原先用main方法执行的Application启动类
    return builder.sources(SocialPersuasionApplication.class);

6.修改原打包方式将本地jar包打进jar包方式修改为本地jar包打进war包(如果有本地jar包的情况)

<!-- maven plugin -->

<!--            <plugin>-->
<!--                <groupId>org.springframework.boot</groupId>-->
<!--                <artifactId>spring-boot-maven-plugin</artifactId>-->
<!--                &lt;!&ndash;解决本地jar包打不进jar的问题&ndash;&gt;-->
<!--                <configuration>-->
<!--                    <includeSystemScope>true</includeSystemScope>-->
<!--                </configuration>-->
<!--            </plugin>-->

<!--            <plugin>-->
<!--                <groupId>org.apache.maven.plugins</groupId>-->
<!--                <artifactId>maven-compiler-plugin</artifactId>-->
<!--                <version>3.8.1</version>-->
<!--                <configuration>-->
<!--                    <source>17</source>-->
<!--                    <target>17</target>-->
<!--                    <encoding>UTF-8</encoding>-->
<!--                    <compilerArguments>-->
<!--                        <extdirs>${project.basedir}/lib</extdirs>-->
<!--                    </compilerArguments>-->
<!--                </configuration>-->
<!--            </plugin>-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <configuration>
                    <warName>${project.artifactId}</warName>
                    <webResources>
                        <resource>
                            <directory>lib/</directory>
                            <targetPath>WEB-INF/lib</targetPath>
                            <includes>
                                <include>**/*.jar</include>
                            </includes>
                        </resource>
                    </webResources>
                </configuration>
            </plugin>

7.resources目录添加apusic-web.xml文件

7.apusic-web.xml文件添加内容

<aas-web-app>
  <class-loader delegate="false">
   <property name="ignoreParentsFiles" value="true"></property>
   <property name="ignoreResources" value="META-INF/services/javax.validation.spi.ValidationProvider"></property>
   <property name="ignoreClassPrefix" value="org.hibernate.validator"></property>
 </class-loader>
</aas-web-app>

服务器安装及配置

提示：自行安装jdk运行环境，有些版本jdk与中间件不适配，本人使用AAS-V10中间件不适配服务器上jdk17.0.8，重新安装了jdk17.0.2

1. 上传AAS-V10.zip应用服务器压缩包到指定目录，unzip AAS_V10.zip命令解压安装，解压后出现ApusicAS目录

2. 执行echo '127.0.0.1 ' hostname >> /etc/hosts命令，解决aas默认域启动超时问题，cat /etc/hosts查看检查

3上传厂家提供license.xml替换/ApusicAS/aas目录下的license.xml

4.进入/ApusicAS/aas/bin执行目录，执行./asadmin start-domain命令，第一次执行需设置三个管理员密码

提示启动默认域成功（默认端口号为6848，需更改/ApusicAS/aas/domains/mydomain/config/domain.xml，6848为管控端口号，6887为https端口，6888为http端口）

提示以下信息为启动默认域成功（可使用asadmin list-domains命令查询，asadmin stop-domain关闭）

5.上传项目war包，进入/ApusicAS/aas/bin可执行目录，执行asadmin deploy dir/war-name(war包名称,dir为目录)命令，部署服务（asadmin list-applications查看运行服务，asadmin undeploy war-name(不含.war后缀)取消部署）

测试

通过访问项目地址访问接口

小结

目前信创环境中间件使用还不够广泛、网上资料也比较少，遇到问题可以多询问售后，金蝶Apusic应用服务器可能会不支持高版本jdk环境，需要上传一个domain.xml文件，可以联系相关售后技术获取

未来国产化信创环境是大势所趋，支持一波国产（虽然不好用）。