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引用、资源引用、环境变量等的定义等。
2.1.3 提供对程序本身执行特性的配置信息
比如对Web模块中Web资源的访问约束,会话超时时间的设置,EJB中方法的事务和安全的设置等。
2.2 部署工具就是专门管理与部署描述文件有关的一切事务的工具
部署描述文件涉及的方面和内容很多很杂,都是用XML文件格式书写的,如果都用手工来写不但经常不容易记得清DTD,而且随着应用规模的扩大,数量巨大,内容繁杂的XML常令人搞得不胜繁琐。
Apusic部署工具就是专门帮助开发人员产生、操纵部署描述文件的。因此使用部署工具完全可以免去手写XML格式的部署描述文件之苦。
2.3 部署工具可以管理J2EE应用,辅助J2EE程序开发
Apusic部署工具2.0适当运用,可以扮演准开发工具的角色,可以帮助开发人员有效地管理J2EE程序。
3 部署工具的使用方式
? 作为准开发工具管理J2EE应用; ? 简单的对已有的J2EE应用进行配置修改。
3.1 作为准开发工具管理J2EE应用
之所以称为准开发工具,是因为Apusic部署工具现不具备对java源程序的文本编辑功能,因此不能提供开发J2EE应用的完整的IDE环境。但可以在Apusic部署工具的配合下,对J2EE应用进行有效管理。即由第三方的编辑和编译工具负责程序代码的编写和编译,Apusic部署工具负责J2EE应用的管理及部署描述文件的生成和修改。