PAS Micro

# 内嵌容器

本小节介绍应用如何以内嵌容器的形式使用 PAS-Micro。

原始应用类型可分为以下两类：

  • 原生 SpringBoot 应用

  • 使用旧版本嵌入式 PAS 的应用

# 基于 SpringBoot 原生应用改造

本小节介绍如何将 SpringBoot 原生应用改造为使用 PAS-Micro 为内嵌容器的应用。

以下操作以 SpringBoot 2.7.0 应用为例：

  1. 在开发环境修改应用 pom.xml，去除 SpringBoot 应用原生的嵌入式容器，添加 PAS-Micro 核心依赖。修改示例如下：

    <dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <!-- 去除原生内置容器 -->
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
            </exclusion>
        </exclusions>
    </dependency>

    <!-- 添加 PAS-Micro 核心依赖 -->
    <dependency>
        <groupId>com.primeton.epas</groupId>
        <artifactId>pas-spring-boot-2.x-starter</artifactId>
        <version>6.5.2.100</version>
    </dependency>
</dependencies>

  2. 修改应用配置文件（application.properties），若使用原生内嵌容器中的相关参数，需要将相关参数修改为 PAS-Micro 内嵌容器中的参数，具体参数请查看**“配置说明”**章节，未使用可不修改。

  3. 打包应用，使用如下命令启动应用：

    java -jar app.jar

    说明：

    • app.jar：表示应用打包后所生成的 jar。

  4. 应用启动完成后查看控制台输出信息，若出现**”PAS“**相关字样代表改造成功。

# 基于旧版本嵌入式 PAS 应用升级

本小节介绍如何将使用旧版本嵌入式 PAS 的应用升级为使用 PAS-Micro 内嵌容器的应用。

以下操作以使用嵌入式 PAS 6.5.0.2-SP2.6X 版本的应用为例：

  1. 在开发环境修改应用 pom.xml，去除旧版本的嵌入式 PAS 依赖，并添加 PAS-Micro 核心依赖，如果应用中使用了嵌入式旧版本的 Jsp 或 WebSocket 依赖，也需要同步进行修改，修改方案及完整修改示例如下：

    • Jsp：去除旧版本 Jsp 依赖，并添加新版本 Jsp 依赖。
    • WebSocket：新版本 PAS 核心已经包含 WebSocket 依赖，因此只要去除旧版本 webSocket 依赖即可。
    <!-- PAS-Micro 核心 -->
<!-- 去除旧版本的嵌入式 PAS 依赖 -->
<!--
<dependency>
	<groupId>com.primeton.appserver</groupId>
	<artifactId>pas-spring-boot-starter</artifactId>
	<version>6.5.0.2-SP2.6X</version>
</dependency>
-->

<!-- 添加 PAS-Micro 嵌入式核心依赖 -->
<dependency>
	<groupId>com.primeton.epas</groupId>
	<artifactId>pas-spring-boot-2.x-starter</artifactId>
	<version>6.5.2.100</version>
</dependency>

<!-- 若使用了 Jsp -->
<!-- 去除旧版本的 Jsp 依赖 -->
<!--
<dependency>
	<groupId>com.primeton.appserver</groupId>
	<artifactId>appserver-embed-jasper</artifactId>
	<version>6.5.0.2</version>
</dependency>
-->

<!-- 添加新版本 Jsp 依赖 -->
<dependency>
	<groupId>com.primeton.epas.embed</groupId>
	<artifactId>pas-embed-jasper</artifactId>
	<version>6.5.2.100</version>
</dependency>

<!-- 若使用了 Websocket -->
<!-- 去除旧版本的 WebSocket 依赖，无需再添加 -->
<!--
<dependency>
    <groupId>com.primeton.appserver</groupId>
    <artifactId>pas-spring-websocket-adapter</artifactId>
    <version>6.5.0.2-SP2.1X</version>
</dependency>
-->

  2. 修改应用配置文件（application.properties），若使用了旧版本 PAS 嵌入式核心中的相关参数，需要按照新版本格式进行修改，具体参数请查看**“配置说明”**章节，未使用可不修改。

  3. 打包应用，使用如下命令启动应用：

    java -jar app.jar

    说明：

    • app.jar：表示应用打包后所生成的 jar。

  4. 应用启动完成后查看控制台输出信息，若出现**”PAS“**相关字样代表改造成功。

← 内嵌控制台 →