关于此任务
z/OS Connect 提供了一个实现,它要求请求和响应消息格式为 JSON。此功能支持将请求转换为字节阵列,本地语言 COBOL、PL/I 或 C 结构可以映射字节阵列。通过使用 z/OS Connect 所提供的实用程序将目标程序或者副本的语言结构(包括 in 和 out 参数的描述)用来生成绑定文件以及 JSON 请求和响应模式文件。当请求到达和返回响应时,z/OS Connect 使用此实用程序所生成的绑定文件来完成将数据从 JSON 格式转换为本机数据格式以及从本机数据格式转换为 JSON 格式。您可以使用 z/OS Connect 提供的 REST API 调用来检索请求和响应消息的 JSON 模式。
z/OS Connect 提供了 zosConnectService 配置元素,使管理员能够配置一组适用于特定服务的属性。dataXformRef 是这些属性中的一个属性,它指向要用于特定服务的数据变换配置。此任务描述如何请求使用 z/OS Connect 提供的数据变换器。
- 更新 server.xml 配置中您想要对其启用 z/OS Connect 提供的数据变换的每项服务的 zosConnectService 元素。
<!-- z/OS Connect service definition -->
<zosConnectService id="zcs1"
serviceName="recordOpsCreate"
serviceRef="wolaOpsCreateService"
dataXformRef="xformJSON2btye"/>
- 创建相关联的 zosConnectDataXform 元素。
<!-- z/OS Connect data transformation provider -->
<zosConnectDataXform id="xformJSON2Byte"
bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd"
requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>
有关与 zosConnectDataXform 元素相关联的可配置属性定义的更多信息,请参阅 z/OS Connect 功能部件的文档。
- 可选:配置适用于所有服务的数据变换器。 将 zosConnectManager 元素的 globaDataXformRef 设置为所配置的数据变换器的标识,以供全局使用。如果定义了全局数据变换器和服务数据变换器,并且请求使用所配置的数据变换器来接受服务,那么 z/OS Connect 将使用特地为该服务配置的数据变换器。
<zosConnectManager id="zosConnectGlobals" globalDataXformRef="globalDataXform"/>
<!-- z/OS Connect data transformation provider -->
<zosConnectDataXform id="globalDataXform"
bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd"
requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>
- 可选:配置 pollingRate 和 updateTrigger 之类的设置以对监视操作进行微调。 缺省情况下,将监视与数据转换定义相关联的目录以查找新文件和文件更新。有关这些配置属性的更多信息,请参阅
zosConnect-1.0 和 zosConnect
1.2 下的 zosConnectDataXform 元素部分。
<zosConnectDataXform id="ibmDataXform2"
bindFileLoc="/zosConnect/banking/bind/" bindFileSuffix=".bnd"
requestSchemaLoc="/zosConnect/banking/reqSchema" requestSchemaSuffix=".json"
responseSchemaLoc="/zosConnect/banking/respSchema" responseSchemaSuffix=".json" pollingRate="500ms">
</zosConnectDataXform>
在此示例中,将按每 500 毫秒一次的频率轮询 /zosConnect/banking/bind,/zosConnect/banking/reqSchema 和
/zosConnect/banking/respSchema 目录以查找文件更新。如果未配置 pollingRate 和 updateTrigger
配置属性,那么将分别使用缺省值 polled 和 2 seconds。如果不需要监视文件,那么可通过将 updateTrigger 属性设置为
disabled 来禁用文件监视。如果想要触发某些文件的手动刷新,请将 updateTrigger 属性设置为
mbean 并使用文件通知 MBean(即 com.ibm.ws.kernel.filemonitor.FileNotificationMBean)来触发更新;例如:
String[] MBEAN_METHOD_SIGNATURE = new String[] {Collection.class.getName(),Collection.class.getName(),Collection.class.getName() };
JMXConnector jmxConnector = ...;
MBeanServerConnection mbsc = jmxConnector.getMBeanServerConnection();
ObjectName fileMonitorMBeanName = new ObjectName("WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean");
List<String> paths = new ArrayList<String>();
paths.add("/zosConnect/banking/bind/customer.bnd");
paths.add("/zosConnect/banking/reqSchema/customer_request.json");
paths.add("/zosConnect/banking/respSchema/customer_response.json");
Object[] params = new Object[] { null, paths, null };
mbsc.invoke(fileMonitorMBeanName, "notifyFileChanges", params, MBEAN_METHOD_SIGNATURE);
此示例使用 restConnector-1.0 功能部件触发 customer.bnd、customer_request.json 和
customer_response.json 文件的更新。有关如何创建安全 JMX 连接的更多信息,请参阅配置与 Liberty 的安全 JMX 连接上的文档。