Apusic部署工具用户手册

Apusic部署工具用户手册

Apusic部署工具3.0在2.0版的基础上，做了全新改版，配合Apusic应用服务器3.0的新功能，支持各种类型的应用，使用起来更加方便。

目录

1. 部署工具3.0的新特性 1.1. 统一打开应用 1.2. 提供应用移植插件机制 1.3. 部署工具与应用服务器的交互全面采用JAAS方式 1.4. 与服务器的连接标志 1.5. 部署信息的显示 1.6. 界面的改变 2. 部署工具能做什么？ 2.1. 什么是部署描述文件？ 2.1.1. 提供对程序文件的管理信息 2.1.2. 提供应用本身对外部资源的依赖的描述 2.1.3. 提供对程序本身执行特性的配置信息 2.2. 部署工具就是专门管理与部署描述文件有关的一切事务的工具 2.3. 部署工具可以管理J2EE应用，辅助J2EE程序开发 3. 部署工具的使用方式

3.1. 作为准开发工具管理J2EE应用 3.1.1. 第一步，启动Apusic应用服务器。 3.1.2. 第二步，打开部署工具。 3.1.3. 第三步，新建目录形式的EAR 3.1.4. 第四步，添加一个EJB模块 3.1.5. 第五步，添加一个EJB 3.1.6. 第六步，添加一个Web模块 3.1.7. 第七步，部署到Apusic应用服务器（AAS） 3.1.8. 第八步，访问应用 3.1.9. 第九步，修改EJB

3.1.10. 第十步，重新部署，再次访问应用 3.2. 对已有的J2EE应用进行配置修改 4. 部署工具功能详解 4.1. 界面说明 4.1.1. 菜单 4.1.2. 工具条 4.1.3. 总体界面结构 4.2. 应用管理类功能

4.2.1. 新建J2EE应用 4.2.2. 打开J2EE应用 4.2.3. 添加一个Web模块 4.2.4. 添加一个EJB模块 4.2.5. 添加一个EJB 4.2.6. 添加一个Application Client模块 4.2.7. 删除（J2EE模块，组件）

4.2.8. 打包成ear文件（.jar文件，.war文件） 4.3. 应用配置类功能 4.3.1. 对EAR的配置 4.3.2. 对Web模块的配置 4.3.3. 对EJB模块的配置 4.3.4. 对EJB的配置 4.3.5. 对Application Client模块的配置 4.3.6. 配置Mail Session 4.4. 服务器交互类功能 4.4.1. 登录到Apusic服务器 4.4.2. 查看已部署的应用 4.4.3. 部署到Apusic应用服务器

4.4.4. 以打包文件(.ear, .jar或.war文件）的形式部署到Apusic应用服务器 4.5. 部署工具本身的配置选项 5. 部署工具移植插件

5.1. 移植插件能完成的工作和不能完成的工作 5.2. 移植插件装载机制及编写方法 5.2.1. XSLT方式的移植插件 5.2.2. Java方式的移植插件 1 部署工具3.0的新特性

1.1 统一打开应用

? 文件和目录形式的应用在同一菜单打开； ? 可以单独打开EJB模块； ? 可以单独打开Web模块。

1.2 提供应用移植插件机制

? Java方式插件；

? Xslt方式插件。

部署工具3.0提供两种形式的插件机制，用户可编写自己的插件，配合部署工具完成对其他应用服务器的应用向Apusic的移植。

1.3 部署工具与应用服务器的交互全面采用JAAS方式

? 登录Apusic应用服务器；

? 获取Apusic应用服务器用户和组； ? 管理Apusic应用服务器上的应用列表； ? 部署应用到Apusic应用服务器。

1.4 与服务器的连接标志

? 登录后显示已登录标志：显示已登陆的服务器名称或地址

? 自动感知服务器关闭，显示未连接。

1.5 部署信息的显示

? 显示部署进度；

? 显示部署过程中的错误信息。

1.6 界面的改变

? 一棵详细的应用结构树

对应用中不同组件的配置只需点击树中相应节点，即可进入配置界面。

2 部署工具能做什么？

我们知道，J2EE应用(ear, war, ejb-jar)是可配置的应用，不仅由程序文件(可能为java程序，JSP文件等)组成，而且有配置文件（部署描述文件）作为必不可少的一部分，共同参与组成一个完整的应用。

2.1 什么是部署描述文件？

部署描述文件的作用有以下几点： ? 提供对程序文件的管理信息；

? 提供应用本身对外部资源的依赖的描述； ? 提供对程序本身执行特性的配置信息。

应用服务器根据配置文件来得到有关程序的信息，分配程序需要的外部资源，并根据配置信息对程序的执行施加相应的限制和影响。

2.1.1 提供对程序文件的管理信息

比如在应用级（顶级）部署描述文件application.xml中描述该应用中都包含哪些J2EE模块（EJB模块，Web模块，Application Client模块等），这些模块的URI等信息，在EJB模块级的部署描述文件ejb-jar.xml中描述该模块中包含哪些EJB，这些EJB的名字、类、接口等信息。

2.1.2 提供应用本身对外部资源的依赖的描述

比如在应用级（顶级）部署描述文件apusic-application.xml中对mail-session的定义，应用中安全角色与Apusic应用服务器中用户和组的映射，在J2EE模块级部署描述文件中对EJB引用、资源引用、环境变量等的定义等。