本节讲述了HTTP代理服务的创建过程,以及HTTP代理服务的参数配置。通过本节你将了解到以下内容:
- 如何创建HTTP代理服务;
- 如何配置HTTP代理服务的参数,以及各参数的含义;
- 如何建立代理服务与业务服务(或中介服务)的关系;
# 创建步骤
在资源管理器中,右键点击业务Module的代理服务项,在弹出的菜单中选择"创建->HTTP代理服务",如下图所示:
- 类别:用于HTTP代理服务的业务化分类,便于对代理服务的管理、查找。通过上图中的"选择类别"项,可以使用已经存在的类别,也可以填写新的类别。填写新的类别时,需要输入类别名称。
- 文件名称:存储HTTP代理服务配置信息的文件名称。该文件名称要求本module中唯一,不推荐长文件名。
- 显示名称:HTTP代理服务的显示名称。显示名称可以为中文,推荐具有业务含义的显示名,便于管理、查找。
弹出"创建HTTP代理服务"窗口,如下图所示,填写类别、文件名等信息后,并点击"完成"按钮,生成HTTP代理服务。
- 类别:用于HTTP代理服务的业务化分类,便于对代理服务的管理、查找。通过上图中的"选择类别"项,可以使用已经存在的类别,也可以填写新的类别。填写新的类别时,需要输入类别名称。
- 文件名称:存储HTTP代理服务配置信息的文件名称。该文件名称要求本module中唯一,不推荐长文件名。
- 显示名称:HTTP代理服务的显示名称。显示名称可以为中文,推荐具有业务含义的显示名,便于管理、查找。
"创建HTTP代理服务"窗口中,各输入项的填写规则如下:
属性名称 | 填写规则 |
---|---|
选择工程 | 选择当前的工程 |
选择Module | 选择当前的业务Module |
选择类别 | 只能是数字、字母、下划线(_) |
文件名 | 只能是数字、字母、下划线(_) |
显示名称 | 只能是数字、字母、中文、点(.)、下划线(_)、中横线(-) |
HTTP代理服务生成后,在资源管理中如下所示:
新生成的HTTP代理服务缺少其它必要信息,如访问URL、关联的业务服务(或代理服务),并在上图中显示为存在编译错误。
HTTP代理服务生成后,编辑界面如下:
- ID:HTTP代理服务的唯一ID。系统自动生成ID,不可修改。
- 显示名称:HTTP代理服务的显示名称。显示名称可以为中文,推荐具有业务含义的显示名,便于管理、查找。
- Transport:HTTP代理服务关联的Transport,即HTTP代理服务所处理请求的来源。系统运行中,Transport完成请求的接入,然后交予HTTP代理服务处理。ESB工程创建时,在公共Module中自动生成缺省的HTTP Transport,HTTP代理服务选择缺省的HTTP Transport即可。
- URI:HTTP代理服务所接收的请求URL,不包括IP、Port等信息。系统运行时,HTTP Transport中的IP、Port与该URL组合,组成实际的请求URL。
- 关联服务类型:HTTP代理服务必须关联中介服务或业务服务,关联服务类型用于选择关联的是哪种服务。
- 服务名称:HTTP代理服务所关联服务的ID,通过"选择"按钮选择关联的服务后,关联服务的ID显示在该域。
为提升HTTP代理服务运行时的效率,HTTP代理服务支持线程池配置。HTTP代理服务的线程池配置为响应线程池配置,即该线程池用于处理返回消息。HTTP代理服务可以使用全局的线程池,也可以使用单独的线程池。
线程池配置信息参考:线程池配置信息
HTTP代理服务编辑器中,各输入项填写规则如下:
属性名称 | 填写规则 |
---|---|
显示名称 | 只能是数字、字母、中文、点(.)、下划线(_)、中横线(-) |
Transport | 选择所在工程的公共Module中的Transport |
URI | 不能为空 |
关联服务类型 | 可以选"业务服务"或"中介服务" |
服务名称 | 选择所在Module中的HTTP业务服务或中介服务 |
点击"关联服务类型"的下拉框,选择HTTP代理服务关联的服务类型,这里选择业务服务。
点击"服务名称"项的"选择"按钮,弹出HTTP业务服务选择窗口,如下所示:
选择相应HTTP业务服务后,点击"确定"按钮,完成HTTP代理服务与HTTP业务服务的关联。
- 完成HTTP代理服务的各项配置后,点击工具栏中的保存 图标保存HTTP代理服务配置。