InteractionSpec (Java EE 5)

CCI 规范为 InteractionSpec 定义一组标准属性。如果某个标准属性未应用于其底层 EIS，则 InteractionSpec 实现不需要支持该属性。

InteractionSpec 实现类必须为其支持的每个属性提供获取方法和设置方法。获取方法和设置方法约定应该基于 Java Bean 设计模式。

标准属性如下所示：

• FunctionName：EIS 函数的名称
• InteractionVerb：EIS 实例的交互模式：SYNC_SEND、SYNC_SEND_RECEIVE、SYNC_RECEIVE
• ExecutionTimeout：Interaction 等待 EIS 执行指定函数的毫秒数

使用以下标准属性为 Interaction 实例提供有关 ResultSet 要求的提示：

• FetchSize
• FetchDirection
• MaxFieldSize
• ResultSetType
• ResultSetConcurrency

除了在 InteractionSpec 接口中描述的属性之外，CCI 实现还可以提供其他属性。注意，其他属性的格式和类型特定于 EIS 并且超出了 CCI 规范范围。

需要将 InteractionSpec 接口作为 JavaBean 以支持各种工具。应该通过获取方法和设置方法模式定义 InteractionSpec 实现类上的属性。InteractionSpec 接口的实现类需要实现 java.io.Serializable 接口。

An InteractionSpec holds properties for driving an Interaction with an EIS instance. An InteractionSpec is used by an Interaction to execute the specified function on an underlying EIS.

The CCI specification defines a set of standard properties for an InteractionSpec. An InteractionSpec implementation is not required to support a standard property if that property does not apply to its underlying EIS.

The InteractionSpec implementation class must provide getter and setter methods for each of its supported properties. The getter and setter methods convention should be based on the Java Beans design pattern.

The standard properties are as follows:

• FunctionName: name of an EIS function
• InteractionVerb: mode of interaction with an EIS instance: SYNC_SEND, SYNC_SEND_RECEIVE, SYNC_RECEIVE
• ExecutionTimeout: the number of milliseconds an Interaction will wait for an EIS to execute the specified function

The following standard properties are used to give hints to an Interaction instance about the ResultSet requirements:

• FetchSize
• FetchDirection
• MaxFieldSize
• ResultSetType
• ResultSetConcurrency

A CCI implementation can provide additional properties beyond that described in the InteractionSpec interface. Note that the format and type of the additional properties is specific to an EIS and is outside the scope of the CCI specification.

It is required that the InteractionSpec interface be implemented as a JavaBean for the toolability support. The properties on the InteractionSpec implementation class should be defined through the getter and setter methods pattern. An implementation class for InteractionSpec interface is required to implement the java.io.Serializable interface.

Since:

0.8

Version:

0.8

Author:

Rahul Sharma

See Also:

Interaction

英文文档：

SYNC_SEND

static final int SYNC_SEND

Interaction Verb type: The execution of an Interaction does only a send to the target EIS instance. The input record is sent to the EIS instance without any synchronous response in terms of an output Record or ResultSet.

See Also:

Constant Field Values

英文文档：

SYNC_SEND_RECEIVE

static final int SYNC_SEND_RECEIVE

Interaction Verb type: The execution of an Interaction sends a request to the EIS instance and receives response synchronously. The input record is sent to the EIS instance with the output received either as Record or CCIResultSet.

See Also:

Constant Field Values

英文文档：

SYNC_RECEIVE

static final int SYNC_RECEIVE

The execution of an Interaction results in a synchronous receive of an output Record. An example is: a session bean gets a method invocation and it uses this SEND_RECEIVE form of interaction to retrieve messages that have been delivered to a message queue.

See Also:

Constant Field Values

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.