uCosminexus Service Platform, Basic Development Guide
To invoke a method of the asynchronous reception (MDB (WS-R)), specify parameters for the JMS message.
Specify properties for the JMS message. For details about the properties to be specified, see 8.5.4(4) Parameter details.
textMessage = qSession.createTextMessage(); textMessage.setStringProperty("CSCServiceName", serviceName); // Service component name textMessage.setStringProperty("CSCCorrelationID", clientID); // Client correlation ID textMessage.setStringProperty("CSCRequestFormatID", requestFormatID); // Request format ID textMessage.setStringProperty("CSCResponseFormatID", responseFormatID); // Response format ID textMessage.setStringProperty("CSCServiceOperationName", operationName); // Operation name textMessage.setStringProperty("CSCReplyToQueueName", replyToQueueName); // Queue name for response textMessage.setStringProperty("CSCMessageType", "XML"); // Message type |
The headers and properties listed below are inherited from the request side to the queue on the service component side. Therefore, set up these headers and properties as needed.
Specify a request message (user message) in the JMS message payload. For details about the payload, see 8.5.4(4) Parameter details.
textMessage.setText( userData ); |
The following figure shows parameter details.
Table 8-14 Parameter details (standard asynchronous reception (MDB (WS-R)))
Parameter name | Data type | Parameter | Property/payload | Explanation | |
---|---|---|---|---|---|
TextMessage | BytesMessage | ||||
Service name | String | StringProperty ("CSCServiceName") |
Property | This is the service name of the request destination. This parameter is required. For the service name of the request destination, specify the adapter or business process defined in the development environment. |
|
Client correlation ID | String | StringProperty ("CSCCorrelationID") |
Property | This is a correlation identifier for uniquely identifying the request message from the service requester. Specify alphanumeric characters, underscore (_), period (.), and hyphen (-) up to 255 characters. This parameter is used to map the request message from the service requester to the execution history, logs, and traces managed by the HCSC server. Therefore, specify a different ID for each request message sent to the HCSC server. By not specifying this parameter, you can omit the client correlation ID. |
|
Request format ID | String | StringProperty ("CSCRequestFormatID") |
Property | This is an ID for uniquely identifying the request message format from the service requester. Specify alphanumeric characters, underscore (_), period (.), and hyphen (-) up to 1,024 characters. Specify NULL for this parameter. If you do not specify this parameter, NULL is specified. |
|
Response format ID | String | StringProperty ("CSCResponseFormatID") |
Property | This is an ID for uniquely identifying the response message from the HCSC server. Specify alphanumeric characters, underscore (_), period (.), and hyphen (-) up to 1,024 characters. Specify NULL for this parameter. If you do not specify this parameter, NULL is specified. |
|
Operation name | String | StringProperty ("CSCServiceOperationName") |
Property | This is an operation name corresponding to the service name at the request destination.# This operation name specifies a service component defined in the development environment. Specify the operation name with NCName definition characters of XMLSchema within 255 bytes. This parameter is required when the service component at the request destination is a synchronous service (Web Services or SessionBean) or business process. When the service at the request destination is an asynchronous service, the operation name can be omitted. By not specifying this parameter, you can omit the operation name. |
|
Response queue name | String | StringProperty ("CSCReplyToQueueName") |
Property | This is the queue name that receives a response from a service component or business process when the service component at the request destination is a synchronous service (Web Services or SessionBean) or business process. By specifying this parameter when you cannot determine whether the service component at the request destination is synchronous or asynchronous, you can receive responses. For details about the response queue, see 8.5.7 Setting Up a Response Queue. By not specifying this parameter, you can omit the response queue name. If you omit this parameter, NULL is specified, and you cannot receive responses. |
|
Message type | String | StringProperty ("CSCMessageType") |
Property | Specify one of the following request message types:
When there is no request message, you can omit the message type by not specifying this parameter. |
|
User message | -- | TextMessage | N | Payload | This is the request message from the service requester.# Specify this parameter when the request message is in XML. If there is no request message, you do not need to specify this parameter. For details about request messages, see 8.5.5 Creating Request Messages. |
User message length | Long | N | LongProperty ("CSCMessageLength") |
Property | This is the request message length. Specify this parameter when the request message is binary. |
User message | -- | N | BytesMessage | Payload | This is the request message from the service requester.# Specify this parameter when the request message is binary. If there is no request message, you do not need to specify this parameter. For details about request messages, see 8.5.5 Creating Request Messages. |
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.