金蝶Apusic应用服务器

V9.0文档

深圳市金蝶天燕中间件有限公司

2016年9月2日

I. 发行说明

1.1. 关于本发行说明
1.2. 发行说明修订历史记录

2. 应用服务器V9.0功能修订说明

2.1. 新特性概述
2.2. 新增及增强功能
2.3. 已解决问题（包含Bug修复）

II. 技术概览

4. 体系结构

4.1. Apusic服务器、Apusic域和Apusic实例
4.2. Apusic体系结构组成

5. Apusic Core内核

6.1. Web Container

6.1.1. JSP/Servlet容器
6.1.2. JSF引擎
6.1.3. Portlet容器
6.1.4. 虚拟主机
6.1.5. Http Connector
6.1.6. WebDav

6.2. EJB Container

6.3. Client Container

6.4. 容器Session管理

6.4.1. Http Session

6.4.1.1. In-memory Cache
6.4.1.2. 存储
6.4.1.3. Session Failover
6.4.1.4. Session Stick
6.4.1.5. Session Timeout

6.4.2. Stateful Session Bean

7. 基础服务

7.1. JCA Services
7.2. Naming
7.3. JTA
7.4. 死锁检测
7.5. 并发控制
7.6. JDBC
7.7. JDBC 语句缓存
7.8. 连接池
7.9. JMS
7.10. JavaMail
7.11. JMX

8. Web Services

8.1. Web Services引擎

8.1.1. JAX-WS 规范
8.1.2. 对规范的支持
8.1.3. 金蝶Apusic应用服务器的消息安全机制

9. 安全框架

9.1. JAVA授权和鉴定服务（JAAS）
9.2. Java EE 容器的授权合约（JACC）
9.3. Apusic Security Extensions
9.4. Apusic SSO
9.5. 身份鉴定
9.6. 授权
9.7. 加密
9.8. 安全数据存储

10. 管理与监控

10.1. 管理接口

10.2. 管理工具

10.2.1. Apusic管理控制台
10.2.2. Web管理控制台
10.2.3. Shell Script

11. 集群服务

11.1. Web集群

11.2. JNDI集群

11.3. EJB集群

11.4. JMS集群

11.4.1. 消息路由
11.4.2. 消息队列

12. 技术汇总

13. Apusic Platform

13.1. Apusic Studio
13.2. 金蝶Apusic消息中间件

III. 快速开始

14.1. 金蝶Apusic应用服务器的基本介绍
14.2. 相关资源
14.3. 默认路径和文件名

15. 基本功能快速入门

15.1. Apusic应用服务器管理工具

15.2. 启动服务器

15.2.1. 在Windows上启动服务器
15.2.2. 在Linux上启动服务器

15.3. 停止服务器

15.3.1. 在Windows上停止服务器
15.3.2. 在Linux上停止服务器

16. 部署应用程序

16.1. 应用打包和部署简介

16.2. 部署应用程序

16.2.1. 目录结构
16.2.2. 准备工作
16.2.3. 自动部署
16.2.4. 使用appctl工具部署
16.2.5. 通过管理控制台部署
16.2.6. 通过Apusic Studio部署

IV. 安装指南

19. 系统配置要求

20. 产品安装

20.1. 金蝶Apusic应用服务器安装

20.1.1. 获取金蝶Apusic应用服务器安装包
20.1.2. Windows下基于图形界面的安装
20.1.3. 压缩包方式的安装

20.2. NodeManager的安装

20.2.1. Unix/Linux 下安装
20.2.2. 压缩包方式的安装

20.3. Linux/Unix下安装Apusic Http Server

20.4. AAS-APM的安装配置

20.4.1. AAS-APMServer的安装

20.4.2. AAS-APMAgent的安装

20.4.2.1. Windows下的安装
20.4.2.2. Linux下的安装

20.4.3. AAS-APMAgent的配置

20.4.3.1. 监控struts2
20.4.3.2. 监控SpringMVC

20.5. ACSC（ApusicCloudServerCenter）的安装

20.5.1. ACSC介绍

20.5.2. ACSC的使用

20.5.2.1. 安装配置ACSC
20.5.2.2. 安装配置虚拟机下AAS

21. 安装后的工作

21.1. 了解金蝶Apusic应用服务器的目录结构
21.2. 运行金蝶Apusic应用服务器
21.3. 启动远程管理工具
21.4. 启动并访问信息中心
21.5. 使用FirstStep工具
21.6. 关闭服务器
21.7. 卸载服务器

22. License注册

22.1. 金蝶Apusic应用服务器V9.0开发版
22.2. 注册金蝶Apusic应用服务器V9.0正式版

V. 管理指南

23. 启动和停止服务器

23.1. 命令行启动或停止服务器

23.1.1. 使用startapusic启动脚本

23.2. 开始菜单(限于Windows)

23.3. Windows系统服务(限于Windows)

23.4. 使用firststep工具启动服务器

24. 配置Classloader

24.1. Classloader的基本概念

24.1.1. 类装载的方式
24.1.2. 一个基本的Classloader的层次结构
24.1.3. 基本的Classloader
24.1.4. 自定义Classloader
24.1.5. Caller Classloader和线程上下文Classloader
24.1.6. JVM中类的唯一性

24.2. Apusic的Classloader体系

24.2.1. JavaEE应用对Classloader的要求

24.2.2. Apusic的Classloader和它们的层次结构

24.2.3. ServletClassLoader的特性

24.2.3.1. 类的动态加载
24.2.3.2. ServletClassLoader的多层结构
24.2.3.3. Session中对象的类动态装载
24.2.3.4. 类装载的Web优先策略

24.2.4. 类装载查看服务

25. 日志服务

25.1. 理解日志服务子系统

25.1.1. 日志管理器(LogManager)
25.1.2. 日志级别
25.1.3. 日志记录器对象(Logger)
25.1.4. 日志输出(Handler)

25.2. 管理与配置

25.2.1. 编辑logging.xml文件
25.2.2. 记录客户端IP

26. 基于JMX的可植入服务配置

26.1. 理解JMX

26.2. 可植入服务命名

26.2.1. 域名(domain name)
26.2.2. 标识属性(key attribute)
26.2.3. 命名的字符串表示

26.3. 配置和管理可植入服务

27. 线程池服务配置

27.1. 默认的公共线程池配置
27.2. 多路复用线程池配置
27.3. WebServer线程池配置
27.4. 自动调优线程池配置

28. 管理多路复用

28.1. 理解多路复用

28.2. 管理与配置

28.2.1. apusic.conf文件中相关配置属性说明

28.2.2. SSL配置

28.2.2.1. TLS/SSL简介
28.2.2.2. 建立自己的认证授权机构CA
28.2.2.3. 生成服务器端证书
28.2.2.4. 颁发并发布个人证书
28.2.2.5. 配置服务器允许双向认证
28.2.2.6. 测试双向认证

29. 管理Apusic Web服务器

29.1. 管理与配置

29.2. 配置Web应用

29.2.1. 部署Web应用
29.2.2. 配置web上下文根路径

29.3. 配置虚拟主机

29.4. WebDAV配置

30. 管理Session服务

30.1. 管理与配置
30.2. 配置Session序列化
30.3. 配置Session存储
30.4. 管理Session失效时间

31. 使用Apache作为Web代理

31.1. HTTP Proxy
31.2. AJP Proxy

32. 使用Microsoft IIS作为Web代理

32.1. 理解ACP(Apusic Connector Protocol)
32.2. 安装
32.3. 管理与配置

33. 管理JDBC服务

33.1. 理解数据库连接池

33.2. 数据库连接池管理与配置

33.2.1. 编辑datasources.xml文件

33.2.1.1. datasource元素
33.2.1.2. property
33.2.1.3. remote-acl
33.2.1.4. 结果集缓存
33.2.1.5. 语句缓存
33.2.1.6. 连接失效检测

33.3. 活动连接监控

33.4. JDBC事件监控

34. 消息服务配置

34.1. 理解Apusic消息服务

34.2. 消息路由与存储

34.2.1. 配置消息存储目录

34.2.2. 配置消息路由

34.2.2.1. 理解消息路由
34.2.2.2. 配置和管理路由

34.3. 管理消息服务

34.3.1. 配置连接工厂

34.3.2. 配置消息目的地(Destination)

34.3.2.1. 配置消息队列
34.3.2.2. 配置消息主题

34.3.3. 安全相关配置

34.3.3.1. 安全角色
34.3.3.2. 消息目的地(Destination)访问许可
34.3.3.3. 范例

35. 管理事务服务

35.1. 配置事务服务

36. 管理命名服务

36.1. 配置命名服务

37. 管理应用服务器域

37.1. 应用服务器域的概念
37.2. 应用服务器域的管理

38. 应用服务器安全提供程序

38.1. 安全框架介绍

38.2. 内置安全提供程序

38.2.1. 文件存储配置
38.2.2. JDBC存储配置
38.2.3. LDAP存储配置

38.3. 自定义安全提供程序

38.3.1. 实体信息的存储与读取
38.3.2. 实现身份验证提供程序
38.3.3. 实现授权提供程序
38.3.4. 配置映射

39. 管理集群

39.1. 集群的基本概念及相关术语

39.1.1. 可扩展性（Scalability）
39.1.2. 可用性（Availability）
39.1.3. 可靠性（Reliability）
39.1.4. 失效转移（Fail-Over）
39.1.5. 负载均衡（Load Balance）
39.1.6. 会话粘滞（Session Stick）
39.1.7. 幂等性（Idempotent）

39.2. J2EE集群

39.2.1. 负载均衡
39.2.2. 失效转移

39.3. Apusic集群

39.3.1. Web集群

39.3.1.1. Apusic负载均衡

39.3.1.1.1. 负载均衡策略
39.3.1.1.2. Apusic负载均衡器的Session 复制策略
39.3.1.1.3. 失效转移
39.3.1.1.4. 配置负载均衡

39.3.1.2. Apusic Http Server负载均衡

39.3.1.3. 第三方负载均衡

39.3.1.3.1. Session复制策略
39.3.1.3.2. 配置Web集群
39.3.1.3.3. Web集群失效转移

39.3.1.4. Apusic Session复制粒度

39.3.1.5. Web集群方案

39.3.1.6. Session分布式存储

39.3.1.6.1. 为什么需要Session分布式存储
39.3.1.6.2. 应用场景及优点
39.3.1.6.3. 配置分布式存储
39.3.1.6.4. 分布式Session存储服务器安装
39.3.1.6.5. 安装中可能遇到问题及解决办法

39.3.2. JNDI集群

39.3.2.1. 本地JNDI和JNDI集群
39.3.2.2. JNDI 负载均衡和JNDI失效恢复
39.3.2.3. JNDI集群配置

39.3.3. EJB集群

39.3.3.1. EJB负载均衡和EJB高可用性
39.3.3.2. EJB集群配置
39.3.3.3. EJB集群实践

39.3.4. JMS集群

39.3.4.1. 消息路由

39.3.4.1.1. 理解Apusic消息服务
39.3.4.1.2. 配置消息路由与存储
39.3.4.1.3. 管理消息服务

39.3.4.2. 集群队列

39.3.4.2.1. 配置集群队列
39.3.4.2.2. 使用集群队列

40. 管理sip服务

40.1. SIP概述

40.2. SIP的体系结构

40.3. SIP协议结构

40.3.1. 消息体与SDP
40.3.2. SIP与Java

40.4. 配置Apusic SIP服务

41. 配置和管理工具

41.1. appctl工具

41.2. apclient工具

41.3. firststep工具

41.4. dep工具

41.5. adminmain工具

41.5.1. 选项
41.5.2. 用法
41.5.3. 关于服务的说明

41.6. JSPC工具

42. 使用Jconsole监控

42.1. 用Jconsole监控和操作Apusic应用服务器

A.1. 附录：jserv.conf
A.2. 附录：缺省的apusic.conf配置文件
A.3. 附录：缺省的datasources.xml配置文件
A.4. 附录：缺省的jms.xml配置文件
A.5. 附录：缺省的logging.xml配置文件
A.6. 附录：缺省的server.xml配置文件
A.7. 附录：缺省的auth.cfg配置文件
A.8. 附录：缺省的clientauth.cfg配置文件
A.9. 附录：缺省的acp_isapi.properties配置文件
A.10. 附录：logging.dtd

VI. 开发指南

43. Web开发手册

43.1. Apusic JSP 开发

43.1.1. JSP概述

43.1.1.1. 什么是JSP
43.1.1.2. JSP如何处理请求

43.1.2. Apusic JSP变动及其升级

43.1.2.1. 从JSP2.0到JSP2.1的主要变动

43.1.2.1.1. JSP 2.1支持统一表达语言Unified Expression Language

43.1.2.2. 从JSP1.2到JSP2.0的主要变动

43.1.2.2.1. JDK要求
43.1.2.2.2. JSP 2.0支持表达语言expression language
43.1.2.2.3. JSP 2.0中加入了JSP fragment
43.1.2.2.4. JSP 2.0中加入了SimpleTag

43.1.3. Apusic JSP开发指南

43.1.3.1. JSP页面的生命周期

43.1.3.2. 初始化和结束一个JSP页面

43.1.3.3. 创建静态内容

43.1.3.4. 创建动态内容

43.1.3.4.1. 使用内置对象
43.1.3.4.2. 对象的作用范围
43.1.3.4.3. JSP元素(Element)

43.1.3.5. 表达式语言

43.1.3.5.1. 使表达式语言失效
43.1.3.5.2. 使用表达式语言
43.1.3.5.3. 变量
43.1.3.5.4. 文字
43.1.3.5.5. 操作符
43.1.3.5.6. 保留关键字
43.1.3.5.7. 举例列表

43.1.3.6. 使用JavaBeans

43.1.3.6.1. JavaBeans 设计惯例
43.1.3.6.2. 创建和使用JavaBeans
43.1.3.6.3. 设置JavaBeans的属性
43.1.3.6.4. 得到JavaBeans 的属性

43.1.3.7. 在JSP页面中包含其他内容

43.1.3.8. 传递控制到其他Web组件

43.1.3.9. 在JSP页面中包含Applet

43.1.3.10. 使用Apusic JSP预编译

43.2. Apusic Http Servlets 开发

43.2.1. Http Servlets 概述

43.2.1.1. 什么是Servlet
43.2.1.2. 使用Servlet的目的
43.2.1.3. Servlet开发概述
43.2.1.4. Servlet与JavaEE
43.2.1.5. Servlet API参考

43.2.2. Apusic Http Servlets变动及其升级

43.2.2.1. 从Servlet2.4到Servlet2.5的主要变动

43.2.2.1.1. 依赖于J2SE5.0
43.2.2.1.2. 支持注解(Annotation)
43.2.2.1.3. 更便利的web.xml的配置

43.2.2.2. 从Servlet2.3到Servlet2.4的变动

43.2.2.2.1. Servlet 2.4版使用XML Schema作为部署描述文件定义
43.2.2.2.2. Servlet 2.4版在加入了ServletRequest监听器
43.2.2.2.3. Servlet 2.4版增强了请求分发器的过滤功能
43.2.2.2.4. Servlet 2.4版可以定义网站的字符编码方式

43.2.3. Apusic Http Servlets编程初步

43.2.3.1. Servlet生命周期
43.2.3.2. 编写一个基本HTTP Servlet的步骤
43.2.3.3. 高级特征

43.2.4. Apusic Http Servlets编程进阶

43.2.4.1. 初始化Servlet

43.2.4.2. 使用注解

43.2.4.2.1. @Resource与@Resources
43.2.4.2.2. @PostConstruct与@PreDestroy
43.2.4.2.3. @EJB
43.2.4.2.4. @WebServiceRef
43.2.4.2.5. @Persistence系列注解
43.2.4.2.6. @DeclareRoles
43.2.4.2.7. @RunAs

43.2.4.3. 编写Service方法

43.2.4.3.1. 取得客户端请求
43.2.4.3.2. 提供HTTP响应

43.2.4.4. 处理多线程情况

43.2.4.5. 维护客户端状态

43.2.4.5.1. 访问Session
43.2.4.5.2. 使属性和Session相关联
43.2.4.5.3. Session管理
43.2.4.5.4. Session跟踪

43.2.4.6. 访问Servlet环境(Servlet Context)

43.2.4.7. 使用Apusic Services

43.2.4.8. 调用其他Web资源

43.2.4.8.1. 包含其他Web资源
43.2.4.8.2. 传递控制给其他Web组件

43.2.4.9. 结束一个Servlet

43.2.5. Apusic Http Servlets高级开发

43.2.5.1. Servlet Filtering

43.2.5.1.1. 编写过滤器类
43.2.5.1.2. 定制请求和响应
43.2.5.1.3. 映射过滤器

43.2.5.2. Application Events

43.2.5.2.1. 配置事件监听类
43.2.5.2.2. 编写事件监听类
43.2.5.2.3. 事件监听类模板

43.3. JSP扩展标记

43.3.1. JSP 扩展标记介绍

43.3.2. 使用扩展标记

43.3.2.1. 声明扩展标记
43.3.2.2. 扩展标记的类型

43.3.3. 定义扩展标记

43.3.3.1. 标记库描述符
43.3.3.2. 标记处理类（Tag Handlers ）
43.3.3.3. 简单标记
43.3.3.4. 带属性的标记
43.3.3.5. 带标记体的标记
43.3.3.6. 定义脚本变量的标记
43.3.3.7. 协作标记

43.3.4. 标记处理类如何被调用

43.4. Apusic JSF

43.4.1. 什么是JavaServer Faces？

43.4.2. JSF页面的生命周期

43.4.2.1. 重建视图阶段（Restore View Phase）
43.4.2.2. 应用视图值阶段（Apply Request Values Phase）
43.4.2.3. 处理校验阶段（Process Validations Phase）
43.4.2.4. 更新模型值阶段（Update Model Values Phase）
43.4.2.5. 调用应用阶段（Invoke Application Phase）
43.4.2.6. 显示应答阶段（Render Response Phase）

43.4.3. UI组件模型

43.4.3.1. UI组件类
43.4.3.2. 组件显示模型
43.4.3.3. 转换模型
43.4.3.4. 事件和监听器模型
43.4.3.5. 校验模型

43.4.4. 导航（Navigation）模型

43.4.5. Backing Bean管理

43.4.6. 更多参考：

44. EJB开发手册

44.1. 简介

44.1.1. Enterprise JavaBean简介

44.1.1.1. 作为组件模型的EJB

44.1.1.1.1. 特征
44.1.1.1.2. 使用EJB组件模型的优势

44.1.1.2. EJB组件模型

44.1.1.2.1. 客户端类型
44.1.1.2.2. EJB组件模型的组成部分

44.1.1.3. EJB的类型

44.1.2. Session Bean

44.1.2.1. 什么是Session Bean

44.1.2.2. Session Bean的生存时间

44.1.2.3. 会话状态

44.1.2.3.1. 无状态的Session Bean
44.1.2.3.2. 有状态的Session Bean

44.1.3. Entity Bean

44.1.3.1. 什么是Entity Bean

44.1.3.1.1. Session Bean与Entity Bean
44.1.3.1.2. 容器管理持久性（Container-managed Persistence，CMP）
44.1.3.1.3. 容器管理关系（Container-managed Relationship，CMR）
44.1.3.1.4. 容器管理关系的方向

44.1.3.2. Entity Bean的特征

44.1.3.2.1. 持久性
44.1.3.2.2. 持久业务数据的对象表示
44.1.3.2.3. 表示相同的底层数据的多个Entity Bean实例
44.1.3.2.4. 可查找的Entity Bean

44.1.4. Message-driven Bean

44.1.4.1. Message-driven Bean 的产生原因
44.1.4.2. Message-driven Bean 作为一般的JMS 使用者(consumer)
44.1.4.3. Message-driven Bean 与其他Enterprise Bean

44.1.5. 使用接口定义客户访问

44.1.5.1. 远程访问
44.1.5.2. 本地访问
44.1.5.3. 本地接口与容器管理关系
44.1.5.4. 方法参数和返回值
44.1.5.5. 远程还是本地
44.1.5.6. 执行效率与组件接口类型

44.1.6. Enterprise Bean的内容

44.1.7. EJB组件模型的灵活性

44.1.8. 何时使用EJB组件

44.2. 会话Bean

44.2.1. 会话Bean

44.2.1.1. 容器与会话Bean

44.2.1.2. 会话Bean的会话状态

44.2.1.2.1. 有状态Session Bean实例的钝化与激活
44.2.1.2.2. 会话状态
44.2.1.2.3. 事务操作与状态域

44.2.2. 组件模型单元

44.2.2.1. Home接口

44.2.2.1.1. 远程Home接口
44.2.2.1.2. 本地Home接口

44.2.2.2. 业务（组件）接口

44.2.2.2.1. 远程接口
44.2.2.2.2. 本地接口

44.2.2.3. 组件类

44.2.2.3.1. 在组件类中使用注解
44.2.2.3.2. javax.ejb.SessionBean接口
44.2.2.3.3. SessionContext接口
44.2.2.3.4. 可选的SessionSynchronization接口
44.2.2.3.5. 串行化的会话Bean方法调用
44.2.2.3.6. 业务方法必须遵守的规则
44.2.2.3.7. 代码范例

44.2.3. 生存周期

44.2.3.1. 有状态Session Bean的生存周期
44.2.3.2. 无状态Session Bean的生存周期

44.3. Message-driven Bean

44.3.1. Message-driven Bean

44.3.1.1. Message-driven Bean与EJB容器、客户端、消息系统

44.3.2. 组件模型单元

44.3.2.1. 组件类

44.3.2.1.1. javax.ejb.MessageDrivenBean接口
44.3.2.1.2. javax.jms.MessageListener接口
44.3.2.1.3. javax.ejb.MessageDrivenContext接口
44.3.2.1.4. 串行化的调用
44.3.2.1.5. 消息处理的并发
44.3.2.1.6. Message-driven Bean方法的事务上下文
44.3.2.1.7. 消息接收确认（Message Acknowledgement）
44.3.2.1.8. 指定队列（Queue）或主题（Topic）
44.3.2.1.9. 异常处理
44.3.2.1.10. 遗漏的PreDestroy调用

44.3.2.2. 必须遵守的规则

44.3.2.2.1. 组件类
44.3.2.2.2. onMessage方法
44.3.2.2.3. ejbRemove方法

44.3.3. 生存周期

44.4. Entity Bean

44.4.1. 概览

44.4.1.1. 数据的对象视图
44.4.1.2. 组件结构
44.4.1.3. Primary Key

44.4.2. 客户端

44.4.2.1. JNDI
44.4.2.2. 远程客户
44.4.2.3. 本地客户

44.4.3. 容器与Entity Bean

44.4.3.1. 通过JNDI定位远程Home接口
44.4.3.2. 通过JNDI定位本地Home接口

44.4.4. 组件模型

44.4.4.1. Home接口

44.4.4.1.1. 远程Home接口
44.4.4.1.2. 本地Home接口

44.4.4.2. Primary Key

44.4.4.3. 组件接口

44.4.4.3.1. 远程接口
44.4.4.3.2. 本地接口

44.4.4.4. 组件类

44.4.5. 生存周期

44.5. Bean管理持久性的Entity Bean

44.5.1. 概述

44.5.2. Bean管理持久性的Entity Bean

44.5.2.1. 打开与释放资源
44.5.2.2. 实例的创建
44.5.2.3. 实例状态与持久存储
44.5.2.4. 实例的清除

44.5.3. 必须遵守的规则与范例

44.5.3.1. 组件类

44.5.3.1.1. ejbCreate方法
44.5.3.1.2. ejbPostCreate方法
44.5.3.1.3. ejbRemove方法
44.5.3.1.4. finder方法
44.5.3.1.5. 业务方法
44.5.3.1.6. Home方法

44.5.3.2. Home接口

44.5.3.3. 组件接口

44.5.4. 异常处理

44.5.4.1. 系统级异常
44.5.4.2. 应用级异常
44.5.4.3. 组件异常类型

44.6. 容器管理持久性的Entity Bean

44.6.1. 概述

44.6.2. 容器管理持久性的Entity Bean

44.6.2.1. CMP模型

44.6.2.2. 例子说明

44.6.2.3. 抽象持久性模式（Abstract persistence schema）

44.6.2.3.1. 容器管理持久性域（cmp-field）
44.6.2.3.2. 容器管理关系（cmr）与容器管理关系域（cmr-field）
44.6.2.3.3. 辅助值对象（dependent value object）
44.6.2.3.4. 自动建表与自动生成主键
44.6.2.3.5. 装载单元
44.6.2.3.6. 关系的赋值语义

44.6.2.4. Primary Key

44.6.2.5. 实例的清除

44.6.2.5.1. remove方法
44.6.2.5.2. 级联（cascade）移除

44.6.2.6. Finder方法

44.6.2.6.1. 单个对象的查找
44.6.2.6.2. 多个对象的查找
44.6.2.6.3. 容器自动生成查询

44.6.2.7. Select方法

44.6.2.7.1. 返回单个对象的select方法
44.6.2.7.2. 返回多个对象的select方法

44.6.2.8. 实例的生存周期与开发中的约定

44.6.2.8.1. 实例的生存周期
44.6.2.8.2. 开发中的约定

44.6.3. 必须遵守的规则

44.6.3.1. 类与接口
44.6.3.2. 组件类
44.6.3.3. 辅助类
44.6.3.4. ejbCreate方法
44.6.3.5. ejbPostCreate方法

44.7. EJB QL

44.7.1. 概述

44.7.2. 定义

44.7.2.1. 抽象持久类型与查询范围

44.7.2.2. 命名

44.7.2.3. 范例

44.7.2.4. 返回值类型

44.7.2.5. FROM子句与定位声明

44.7.2.5.1. 标识符（Identifier）
44.7.2.5.2. 标记变量(indentification variables)
44.7.2.5.3. 范围变量声明
44.7.2.5.4. 集合成员变量声明
44.7.2.5.5. 范例
44.7.2.5.6. 路径表达式
44.7.2.5.7. WHERE子句与条件表达式

44.7.2.6. SELECT子句

44.7.2.7. ORDER BY字句

44.7.2.8. NULL值

44.7.2.9. 相等语义

44.7.2.10. 查询语句的限制

44.7.3. 范例

44.7.3.1. 简单查询
44.7.3.2. 使用关系的查询
44.7.3.3. 使用输入参数的查询
44.7.3.4. 定义select方法的查询
44.7.3.5. EJB QL与SQL

44.7.4. EJB QL BNF

44.8. Java Persistence API

44.8.1. 概览

44.8.2. 实体

44.8.2.1. 什么是实体
44.8.2.2. 实体类的一些需求
44.8.2.3. 持久类的持久值域与持久属性
44.8.2.4. 持久值域
44.8.2.5. 持久属性
44.8.2.6. 实体的主键
44.8.2.7. 主键类

44.8.3. 实体的关系

44.8.3.1. 实体关系的多重性

44.8.3.2. 实体关系的方向

44.8.3.2.1. 双向关系
44.8.3.2.2. 单向关系
44.8.3.2.3. 查询与关系方向
44.8.3.2.4. 级联删除关系

44.8.3.3. 实体的继承关系

44.8.3.3.1. 抽象实体
44.8.3.3.2. 映射超类(Mapped superclass)
44.8.3.3.3. 非实体超类

44.8.3.4. 继承结构映射策略

44.8.3.4.1. 单表映射继承结构策略
44.8.3.4.2. 单表映射具体实体类策略
44.8.3.4.3. 子类连接策略

44.8.4. 管理实体

44.8.4.1. 实体管理器Entity Manager

44.8.4.1.1. 容器管理的实体管理器
44.8.4.1.2. 应用管理的实体管理器
44.8.4.1.3. 使用EntityManager查找实例

44.8.4.2. 管理实体实例的生存周期

44.8.4.2.1. 持久化实体实例
44.8.4.2.2. 清除实体实例
44.8.4.2.3. 同步实体数据到数据库

44.8.4.3. 创建查询

44.8.4.4. 查询中的命名参数

44.8.4.5. 查询中的顺序参数

44.8.5. 持久单元

44.8.5.1. persistence.xml文件

44.9. Java持久查询语言

44.9.1. 新特性

44.9.1.1. 批量更新与删除

44.9.1.2. 连接操作

44.9.1.2.1. 内连接（关系连接）
44.9.1.2.2. 左连接（LEFT JOIN）
44.9.1.2.3. 获取连接（FETCH JOIN）

44.9.1.3. GROUP BY和HAVING子句

44.9.1.4. 投影

44.9.1.5. SELECT子句中的构造表达式

44.9.1.6. 子查询

44.9.1.7. 查询中的命名参数

44.9.2. Java持久查询语言BNF

44.10. EJB的环境

44.10.1. 概述

44.10.2. 环境项（environment entry）

44.10.2.1. 访问环境项
44.10.2.2. 设置环境项

44.10.3. EJB引用

44.10.3.1. 访问EJB引用

44.10.3.2. 声明EJB引用

44.10.3.2.1. ejb-link

44.10.4. 资源管理器的连接创建器引用（resource manager connection factory reference）

44.10.4.1. 使用资源管理器的连接创建器引用
44.10.4.2. 声明连接创建器引用
44.10.4.3. 引用的映射
44.10.4.4. 访问引用
44.10.4.5. 标准的连接创建器类型

44.10.5. 资源环境引用（resource environment references）

44.10.5.1. 声明资源环境引用
44.10.5.2. 访问资源环境引用

44.10.6. javax.transaction.UserTransaction接口

44.11. EJB的事务

44.11.1. 概述

44.11.2. 客户端事务与未指明的事务上下文

44.11.3. EJB的事务划分

44.11.3.1. Bean管理事务（程序型的事务划分）

44.11.3.1.1. 使用Bean管理事务的限制
44.11.3.1.2. 事务上下文

44.11.3.2. 容器管理事务（声明型的事务划分）

44.11.3.2.1. setRollbackOnly与getRollbackOnly方法
44.11.3.2.2. 使用JMS API的考虑
44.11.3.2.3. 事务属性
44.11.3.2.4. 必须遵守的规则

44.11.4. 使用Bean管理事务与容器管理事务

44.12. EJB的安全管理

44.12.1. 安全模型

44.12.1.1. 安全角色（Security Role）与方法权限
44.12.1.2. 安全主体（Security Principal）
44.12.1.3. 安全角色与安全主体的映射

44.12.2. 使用安全模型

44.12.2.1. 声明安全角色
44.12.2.2. 定义方法许可
44.12.2.3. 定义角色映射
44.12.2.4. 调用中的身份传播
44.12.2.5. 关于安全角色引用
44.12.2.6. getCallerPrincipal
44.12.2.7. isCallerInRole
44.12.2.8. 声明代码中使用的安全角色引用

44.13. EJB Timer Service

44.13.1. 概述

44.13.2. 组件模型单元

44.13.2.1. 接口描述

44.13.2.1.1. TimerService接口
44.13.2.1.2. TimedObject接口
44.13.2.1.3. TimerHandle接口
44.13.2.1.4. Timer接口

44.13.2.2. 功能实现框架

44.13.3. 使用EJB Timer Service

44.13.3.1. 使用范围
44.13.3.2. 创建Timer
44.13.3.3. 定义Timer需要执行的内容
44.13.3.4. 取消和保存Timer
44.13.3.5. 获得Timer的信息
44.13.3.6. Timer和交易

45. Web Service开发手册

45.1. 概述

45.1.1. Web Services与SOA

45.1.2. Web服务类型

45.1.2.1. RPC方式的Web服务
45.1.2.2. 基于SOAP的Web服务
45.1.2.3. REST风格Web服务
45.1.2.4. 选择适用的Web服务类型

45.2. 在Apusic AS中开发WS

45.2.1. 通用构件

45.2.1.1. WSDL
45.2.1.2. SEI
45.2.1.3. webservices.xml

45.2.2. JAX-WS POJO

45.2.3. Stateless EJB

45.3. 开发WS客户端

45.3.1. 静态代理
45.3.2. 直接操作XML消息动态调用
45.3.3. JavaEE托管环境中的WS客户端注入

45.4. Apusic AS的SPI支持

46. 客户端开发手册

46.1. 客户端简介

46.1.1. 客户端类型

46.1.1.1. Web客户端
46.1.1.2. 应用客户端
46.1.1.3. CORBA客户端
46.1.1.4. Web Services客户端

46.2. 使用应用客户端容器

46.2.1. 应用客户端容器简介

46.2.2. 开发应用客户端

46.2.2.1. 定位Home接口
46.2.2.2. 创建EJB实例
46.2.2.3. 调用业务方法

46.2.3. 打包应用客户端

46.2.4. 运行应用客户端

46.2.5. 不使用应用客户端容器

46.2.6. 关于范例

46.3. CORBA客户端开发

46.3.1. 开发CORBA客户端

47. 金蝶Apusic应用服务器系统服务

47.1. 数据库连接池开发

47.1.1. 概述

47.1.2. 使用JDBC连接池

47.1.2.1. 服务器端JDBC应用
47.1.2.2. 客户端JDBC应用

47.1.3. 范例

47.2. 消息服务开发

47.2.1. 理解JMS

47.2.1.1. 消息中间件
47.2.1.2. JMS接口描述
47.2.1.3. JMS和其它企业级JAVA API的关系
47.2.1.4. JMS消息模型
47.2.1.5. 消息的同步异步接收
47.2.1.6. PTP模型
47.2.1.7. PUB/SUB模型

47.2.2. 使用JMS

47.2.2.1. 开发JMS Client的步骤
47.2.2.2. PTP模型应用
47.2.2.3. PUB/SUB模型应用
47.2.2.4. 权限设置

47.3. 使用JAAS用户认证

47.3.1. JAAS简介

47.3.1.1. 一个简单的例子
47.3.1.2. JAAS核心类和接口
47.3.1.3. 配置LoginModules
47.3.1.4. 编写Policy文件
47.3.1.5. 运行范例程序

47.3.2. JAAS和Apusic

47.3.3. Apusic JAAS开发

47.4. 使用Apusic事务服务

47.4.1. 事务服务简介

47.4.2. 配置Apusic事务服务

47.4.3. 分布式事务恢复

47.4.3.1. 需配置的参数
47.4.3.2. 使用方法

47.4.4. 使用事务服务

47.4.4.1. 在EJB中使用事务服务
47.4.4.2. 在客户端中使用事务服务

VII. 应用程序部署指南

48. 打包和部署Java EE应用

48.1. 打包和部署简介

48.2. 打包和部署Web模块

48.2.1. Web应用的目录结构
48.2.2. Web模块的部署描述文件
48.2.3. Web模块的两种形式
48.2.4. 部署Web模块
48.2.5. 自动部署

48.3. 打包和部署EJB模块

48.3.1. EJB-JAR文件结构
48.3.2. EJB模块的部署描述文件
48.3.3. EJB模块的两种形式
48.3.4. 部署EJB模块
48.3.5. 自动部署

48.4. 打包和部署Java EE应用

48.4.1. Java EE应用的目录结构
48.4.2. Java EE应用的部署描述文件
48.4.3. Java EE应用的两种形式
48.4.4. 部署Java EE应用
48.4.5. 自动部署

48.5. Apusic部署描述文件

48.5.1. apusic-application.xml中的元素

48.5.1.1. apusic-application元素
48.5.1.2. module元素
48.5.1.3. ejb元素
48.5.1.4. entity元素
48.5.1.5. jndi-name元素
48.5.1.6. local-jndi-name元素
48.5.1.7. cmp元素
48.5.1.8. jdbc元素
48.5.1.9. datasource-name元素
48.5.1.10. table-name元素
48.5.1.11. auto-create-table元素
48.5.1.12. auto-generate-key元素
48.5.1.13. field-mapping元素
48.5.1.14. field-name元素
48.5.1.15. column-name元素
48.5.1.16. load-unit元素
48.5.1.17. unit-name元素
48.5.1.18. cmp-field元素
48.5.1.19. cmr-field元素
48.5.1.20. finder元素
48.5.1.21. description元素
48.5.1.22. method元素
48.5.1.23. method-intf元素
48.5.1.24. method-name元素
48.5.1.25. method-params元素
48.5.1.26. method-param元素
48.5.1.27. sql-clause元素
48.5.1.28. is-modified-method-name元素
48.5.1.29. ejb-ref元素
48.5.1.30. ejb-ref-name元素
48.5.1.31. ejb-local-ref元素
48.5.1.32. resource-ref元素
48.5.1.33. res-ref-name元素
48.5.1.34. resource-env-ref元素
48.5.1.35. resource-env-ref-name元素
48.5.1.36. session元素
48.5.1.37. message-driven元素
48.5.1.38. message-driven-destination元素
48.5.1.39. connection-factory-name元素
48.5.1.40. destination-name元素
48.5.1.41. auto-create-destination元素
48.5.1.42. client-id元素
48.5.1.43. durable-subscription-name元素
48.5.1.44. relationship-mapping元素
48.5.1.45. ejb-relation-name元素
48.5.1.46. source-role元素
48.5.1.47. sink-role元素
48.5.1.48. cmp-resource元素
48.5.1.49. java元素
48.5.1.50. web元素
48.5.1.51. context-root元素
48.5.1.52. mail-session元素
48.5.1.53. property元素
48.5.1.54. security-role元素
48.5.1.55. role-name元素
48.5.1.56. principal元素
48.5.1.57. group元素

48.6. application_5_0.xsd

48.7. web-app_2_4.xsd

48.8. ejb-jar_3_0.xsd

48.9. application-client_5_0.xsd

48.10. apusic-application_5_0.dtd

VIII. 管理控制台使用指南

49. 进入Apusic管理监控台

49.1. 进入到登录页面
49.2. 登录到管理监控首页

50. 应用管理

50.1. 部署J2EE应用
50.2. 管理J2EE应用
50.3. 监控J2EE应用
50.4. 类库管理
50.5. AAR管理

51. 数据源管理

51.1. 新增数据源
51.2. 配置和测试数据源
51.3. 停止和启动数据源

52. JNDI树

52.1. 查看JNDI树

53. 日志监控

53.1. 日志监控
53.2. 下载日志

54. 服务面板配置

54.1. HTTP服务配置
54.2. 系统服务配置
54.3. 高级服务配置
54.4. 线程池服务

55. JMS消息服务配置

55.1. 管理JMS消息服务
55.2. 配置JMS服务

56. 系统配置

56.1. 系统参数配置
56.2. 日志配置
56.3. 用户组
56.4. 安全域参数配置
56.5. 生命周期监听
56.6. 系统备份
56.7. JNDI资源

57.1. javaEE组件监控
57.2. 数据源监控
57.3. 应用会话监控
57.4. JTA事务监控
57.5. HTTP链接监控
57.6. JVM内存监控
57.7. 线程监控
57.8. 线程DUMP
57.9. 类加载监控

IX. Apusic Http Server使用指南

58. Apusic Http Server启动和停止

59. 使用Apusic Http Server作为web代理

60. 使用Apusic Http Server作为负载均衡前置机

60.1. 配置Apusic Http Server

60.2. 配置Apusic应用服务器

60.2.1. 配置高可用性
60.2.2. 配置Session粘滞

X. Node Manager使用指南

62. NodeManager启动与停止

63. NodeManager目录结构

63.1. 目录结构

64. 主要的配置说明

64.1. Node Manager系统服务的配置文件
64.2. 日志输出配置文件
64.3. NodeManger插件配置文件

XI. 动态集群管理

65.1. 前言

65.1.1. 系统网络拓扑图
65.1.2. 系统架构图

66. 节点管理器

66.1. NodeManager启动与停止
66.2. NodeManager目录结构及配置文件详细说明

67. 管理控制中心

67.1. 概述

67.2. 安装与配置

67.2.1. 部署“管理控制中心”应用包

67.2.2. “管理控制中心”个性化配置

67.2.2.1. 部署机器为多网卡，设置指定与NodeManger交互的端口
67.2.2.2. 数据库配置
67.2.2.3. 数据库创建脚本

67.3. 动态集群管理监控台

67.3.1. 进入到登录页面

67.3.2. 登录到动态集群管理监控首页

67.3.3. 进入动态集群管理

67.3.4. 资源池

67.3.4.1. 资源管理

67.3.4.1.1. 新增资源
67.3.4.1.2. 配置资源
67.3.4.1.3. 删除资源
67.3.4.1.4. 实例管理

67.3.4.2. 资源统计

67.3.5. 运行环境

67.3.5.1. 策略管理

67.3.5.1.1. 新增策略
67.3.5.1.2. 配置策略
67.3.5.1.3. 删除策略

67.3.5.2. 数据源管理

67.3.5.2.1. 新增数据源
67.3.5.2.2. 配置数据源
67.3.5.2.3. 测试数据源
67.3.5.2.4. 数据源同步
67.3.5.2.5. 卸载数据源

67.3.5.3. 集群管理

67.3.5.3.1. 集群列表
67.3.5.3.2. 新建集群
67.3.5.3.3. 集群修改
67.3.5.3.4. 配置策略
67.3.5.3.5. 查看应用
67.3.5.3.6. 集群操作日志
67.3.5.3.7. 删除集群
67.3.5.3.8. 集群监控

67.3.6. 应用管理

67.3.6.1. 部署应用

67.3.6.2. 应用列表

67.3.6.3. 应用操作

67.3.6.4. 应用监控

67.3.6.4.1. 应用访问

67.3.7. 定时任务管理

67.3.7.1. 新增任务

67.3.7.1.1. 添加一次性任务
67.3.7.1.2. 添加周期性任务

67.3.7.2. 删除任务

67.3.7.3. 查看详细

67.3.7.4. 查看执行日志

67.3.8. 补丁管理

67.3.8.1. 新增
67.3.8.2. 升级
67.3.8.3. 查看
67.3.8.4. 删除

67.3.9. 系统管理

67.3.9.1. 系统日志

67.3.9.1.1. 系统日志查询
67.3.9.1.2. 标记已读
67.3.9.1.3. 标记未读

67.3.9.2. 策略调度

67.3.10. 证书管理

67.3.10.1. 基本概念

67.3.10.2. 使用自签名证书配置AAS SSL

67.3.10.2.1. 单向认证
67.3.10.2.2. 双向认证

67.3.10.3. 使用CA签发证书配置 AAS SSL

67.3.10.3.1. 单向认证
67.3.10.3.2. 双向认证

XII. 常用参数说明及常见问题解决

68. Apusic应用服务器常用参数说明

68.1. VM.options配置
68.2. web.xml全局配置参数
68.3. JVM参数

69. Apusic应用服务器常见问题及解决

69.1. 解决安全软件检测后出现的问题

69.2. 如何使用AAS进行应用预编译

69.3. 编码问题

69.3.1. 基础知识
69.3.2. 常见编码问题解析
69.3.3. Apusic的解决方案

69.4. 多个应用共享session

69.5. Spring的nativeJdbcExtractor问题

69.6. 管理应用运行在独立端口配置的问题

69.7. AIX系统下ORBSingleton问题

69.8. 应用服务器启动慢的问题

69.9. 配置使用openJPA

69.10. GemFile与Apusic集成

69.10.1. 安装配置GemFile
69.10.2. 配置apusic应用服务器
69.10.3. 启动apusic应用服务器

		下一页
		部分 I. 发行说明

金蝶中间件有限公司版权所有
地址：深圳市高新技术产业园南区科技南十二路2号金蝶软件园
邮编：518057
Email: support@apusic.com
电话：4008-830-830
传真：0755-86072300
技术支持热线：0755-86072008, 86072009