|
Oracle Fusion Middleware Java API Reference for Oracle WebLogic Server 12c (12.2.1) Part Number E55141-01 P4 Change 1723563 on 2015/10/09 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Conversation
This interface represents a conversation between a client and server over an open conection. The process that opens a connection and starts a conversation is the originator of the conversation. The process with control of the connection is the initiator; the process without control is called the subordinate. The connection remains active until an event occurs to terminate it. This interface is modeled on the conversational interface of the Tuxedo product.
Method Summary | |
---|---|
abstract void |
tpdiscon() Executes a disorderly disconnect by immediately tearing down the connection and generating a TPEV_DISCONIMM event on the other end of the connection. |
abstract Reply |
tprecv(int flags) Receives data sent across an open connection from a Tuxedo application. |
abstract void |
tpsend(TypedBuffer data, int flags) Sends data across an open connection from an initiator to a subordinate Tuxedo application. |
Method Detail |
---|
void tpsend(TypedBuffer data, int flags) throws TPException
data
- Pointer to the data buffer; null specifies no data sent.flags
- The following is a list of valid flags:
data
, tperrno
is set to TPEEVENT and revent
is set to TPEV_SENDONLY.TPException
- Returns a TPException exception indicating the error condition. tperrno
is set to one of the following values:
svc
is null or flags are invalid.Reply tprecv(int flags) throws TPException, TPReplyException
flags
- The following is a list of valid flags:
tprecv
does not wait for a reply to arrive. If a reply is available, tprecv
gets the reply and returns. If this flag is not specified and a reply is not available, tprecv
waits for one of the following to occur: a reply, a transaction timeout, or a blocking timeout.tprecv
waits indefinitely for a reply. tprecv
is immune from blocking timeouts but is subject to transaction timeouts.tpsend
. A successful termination of a conversation is determined with a catch of a TPReplyException where the revent
is set to TPEV_SVCSUCC.TPException
- Returns TPException indicating the error condition. tperrno
is set to one of the following values:
TPReplyException
- Returns a TPReplyException indicating an event condition. tperrno
is set to TPEEVENT and revent
is one of the following:
tpdiscon
; completed the service; committed or aborted the transaction with the connection still open. This event is also returned to the initiator or subordinate when a connection is broken due to a communications error. For example: a server, machine or network failure. This event signifies an abortive disconnect and indicates that data in transit may be lost. If two programs were participating in the same transaction, the transaction is marked abort-only and the conversation object is no longer valid.tpreturn
or tpreturn
was called with open connections to other subordinates. The connection is disconnected in an orderly manner and this conversation object is no longer valid. Application defined data or return codes are not available. If part of the recipient's transaction, the transaction is marked abort-only.tpreturn
called with TPFAIL or TPEXIT. The connection is disconnected in an orderly manner and this conversation object is no longer valid. If part of the recipient's transaction, the transaction is marked abort-only.tpreturn
called with TPSUCCESS. The connection is disconnected in an orderly manner and this conversation object is no longer valid. If the recipient initiated a transaction, it can commit the transaction or abort the transaction causing work done by the server in the same transaction to commit or abort.void tpdiscon() throws TPException
tpdiscon
is called by the initiator of the conversation. Any data that has not yet reached its destination may be lost. If the conversation is part of a transaction, the transaction must be rolled back.
Whenever possible allow: Tuxedo conversational services to end a conversation with a tpreturn
; WebLogic Server conversational services to end a conversation with call to return
. Letting the service tear down the connection ensures an orderly disconnect.
TPException
- Returns a TPException indicating an error condition. tperrno
is set to one of the following values:
|
Copyright 1996, 2015, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Oracle Fusion Middleware Java API Reference for Oracle WebLogic Server 12c (12.2.1) Part Number E55141-01 P4 Change 1723563 on 2015/10/09 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |