org.jboss.narayana.blacktie.jatmibroker.xatmi

Interface Connection

All Known Implementing Classes:

ConnectionImpl

public interface Connection

This is the connection to remote BlackTie services. It must be created using the ConnectionFactory.

See Also:

ConnectionFactory.getConnection()

Field Summary

Fields

Modifier and Type	Field and Description
static int	TPCONV
static int	TPEBADDESC
static int	TPEBLOCK
static int	TPEEVENT
static int	TPEINVAL
static int	TPEITYPE
static int	TPELIMIT
static int	TPEMATCH
static int	TPENOENT
static int	TPEOS
static int	TPEOTYPE
static int	TPEPROTO
static int	TPESVCERR
static int	TPESVCFAIL
static int	TPESYSTEM
static int	TPETIME
static int	TPETRAN
static long	TPEV_DISCONIMM
static long	TPEV_SENDONLY
static long	TPEV_SVCERR
static long	TPEV_SVCFAIL
static long	TPEV_SVCSUCC
static short	TPFAIL
static int	TPGETANY
static int	TPGOTSIG
static int	TPNOBLOCK
static int	TPNOCHANGE
static int	TPNOREPLY
static int	TPNOTIME
static int	TPNOTRAN
static int	TPRECVONLY
static int	TPSENDONLY
static int	TPSIGRSTRT
static short	TPSUCCESS
static int	TPTRAN
static int	XATMI_SERVICE_NAME_LENGTH

Method Summary

Modifier and Type	Method and Description
void	close() Close any resources associated with this connection
int	tpacall(String svc, Buffer toSend, int flags) Asynchronous call
Buffer	tpalloc(String type, String subtype) Allocate a new buffer
Response	tpcall(String svc, Buffer buffer, int flags) Synchronous call.
int	tpcancel(int cd) Cancel the outstanding asynchronous call.
Session	tpconnect(String svc, Buffer toSend, int flags) Handle the initiation of a conversation with the server.
Response	tpgetrply(int cd, int flags) Get the reply for an asynchronous call.

Field Detail

TPNOBLOCK

static final int TPNOBLOCK

See Also:

Constant Field Values

TPSIGRSTRT

static final int TPSIGRSTRT

See Also:

Constant Field Values

TPNOREPLY

static final int TPNOREPLY

See Also:

Constant Field Values

TPNOTRAN

static final int TPNOTRAN

See Also:

Constant Field Values

TPTRAN

static final int TPTRAN

See Also:

Constant Field Values

TPNOTIME

static final int TPNOTIME

See Also:

Constant Field Values

TPGETANY

static final int TPGETANY

See Also:

Constant Field Values

TPNOCHANGE

static final int TPNOCHANGE

See Also:

Constant Field Values

TPCONV

static final int TPCONV

See Also:

Constant Field Values

TPSENDONLY

static final int TPSENDONLY

See Also:

Constant Field Values

TPRECVONLY

static final int TPRECVONLY

See Also:

Constant Field Values

TPEBADDESC

static final int TPEBADDESC

See Also:

Constant Field Values

TPEBLOCK

static final int TPEBLOCK

See Also:

Constant Field Values

TPEINVAL

static final int TPEINVAL

See Also:

Constant Field Values

TPELIMIT

static final int TPELIMIT

See Also:

Constant Field Values

TPENOENT

static final int TPENOENT

See Also:

Constant Field Values

TPEOS

static final int TPEOS

See Also:

Constant Field Values

TPEPROTO

static final int TPEPROTO

See Also:

Constant Field Values

TPESVCERR

static final int TPESVCERR

See Also:

Constant Field Values

TPESVCFAIL

static final int TPESVCFAIL

See Also:

Constant Field Values

TPESYSTEM

static final int TPESYSTEM

See Also:

Constant Field Values

TPETIME

static final int TPETIME

See Also:

Constant Field Values

TPETRAN

static final int TPETRAN

See Also:

Constant Field Values

TPGOTSIG

static final int TPGOTSIG

See Also:

Constant Field Values

TPEITYPE

static final int TPEITYPE

See Also:

Constant Field Values

TPEOTYPE

static final int TPEOTYPE

See Also:

Constant Field Values

TPEEVENT

static final int TPEEVENT

See Also:

Constant Field Values

TPEMATCH

static final int TPEMATCH

See Also:

Constant Field Values

TPFAIL

static final short TPFAIL

See Also:

Constant Field Values

TPSUCCESS

static final short TPSUCCESS

See Also:

Constant Field Values

TPEV_DISCONIMM

static final long TPEV_DISCONIMM

See Also:

Constant Field Values

TPEV_SVCERR

static final long TPEV_SVCERR

See Also:

Constant Field Values

TPEV_SVCFAIL

static final long TPEV_SVCFAIL

See Also:

Constant Field Values

TPEV_SVCSUCC

static final long TPEV_SVCSUCC

See Also:

Constant Field Values

TPEV_SENDONLY

static final long TPEV_SENDONLY

See Also:

Constant Field Values

XATMI_SERVICE_NAME_LENGTH

static final int XATMI_SERVICE_NAME_LENGTH

See Also:

Constant Field Values

Method Detail

tpalloc

Buffer tpalloc(String type,
               String subtype)
        throws ConnectionException,
               org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException

Allocate a new buffer

Parameters:

type - The type of the buffer

subtype - The subtype of the buffer

Returns:

The new buffer

Throws:

ConnectionException - If the buffer was unknown or invalid.

org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException

tpcall

Response tpcall(String svc,
                Buffer buffer,
                int flags)
         throws ConnectionException,
                org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException

Synchronous call.

Parameters:

svc - The name of the service to call

buffer - The inbound data

flags - The flags to use

Returns:

The returned buffer

Throws:

ConnectionException - If the service cannot be contacted.

org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException

tpacall

int tpacall(String svc,
            Buffer toSend,
            int flags)
     throws ConnectionException

Asynchronous call

Parameters:

svc - The name of the service to call

toSend - The inbound data

flags - The flags to use

Returns:

The connection descriptor

Throws:

ConnectionException - If the service cannot be contacted.

tpcancel

int tpcancel(int cd)
      throws ConnectionException

Cancel the outstanding asynchronous call.

Parameters:

cd - The connection descriptor

Throws:

ConnectionException - If the client cannot be cleaned up.

tpgetrply

Response tpgetrply(int cd,
                   int flags)
            throws ConnectionException,
                   org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException

Get the reply for an asynchronous call.

Parameters:

cd - The connection descriptor to use

flags - The flags to use

Returns:

The response from the server

Throws:

ConnectionException - If the service cannot be contacted.

org.jboss.narayana.blacktie.jatmibroker.core.conf.ConfigurationException

tpconnect

Session tpconnect(String svc,
                  Buffer toSend,
                  int flags)
           throws ConnectionException

Handle the initiation of a conversation with the server.

Parameters:

svc - The name of the service

toSend - The outbound buffer

flags - The flags to use

Returns:

The connection descriptor

Throws:

ConnectionException - If the service cannot be contacted.

close

void close()
    throws ConnectionException

Close any resources associated with this connection

Throws:

ConnectionException - If an open session cannot be cancelled or disconnected.