Class ASCIIChannel

java.lang.Object

java.util.Observable

org.jpos.iso.BaseChannel

org.jpos.iso.channel.ASCIIChannel

All Implemented Interfaces:

Cloneable, Configurable, ExceptionHandlerAware, BaseChannelMBean, ClientChannel, FactoryChannel, FilteredChannel, ISOChannel, ISOSource, ServerChannel, ISOMsgMetrics.Source, LogSource

public class ASCIIChannel
extends BaseChannel

ISOChannel implementation suitable for OASIS Ltd © hosts
Message length header: n ASCII digits, configurable by setLengthDigits() (default: 4) or the 'length-digits' Configuration property.

See Also:

• ISOMsg
• ISOException
• ISOChannel

Field Summary

Fields

Modifier and Type	Field	Description
protected int	lengthDigits	Number of digits for the message length header

Fields inherited from class BaseChannel

cnt, header, incomingFilters, logger, originalRealm, outgoingFilters, overrideHeader, packager, realm, serverIn, serverInLock, serverOut, serverOutLock, serverSocket, socketFactory, usable

Fields inherited from interface ISOChannel

CONNECT, RX, SIZEOF_CNT, TX

Constructor Summary

Constructors

Constructor	Description
ASCIIChannel()	Public constructor (used by Class.forName("...").newInstance())
ASCIIChannel(String host, int port, ISOPackager p)	Construct client ISOChannel
ASCIIChannel(ISOPackager p)	Construct server ISOChannel
ASCIIChannel(ISOPackager p, ServerSocket serverSocket)	constructs a server ISOChannel associated with a Server Socket

Method Summary

Modifier and Type	Method	Description
int	getLengthDigits()
protected int	getMessageLength()
protected void	sendMessageLength(int len)
void	setConfiguration(Configuration cfg)	Calls super.setConfiguration() and then reads the 'length-digits' property, defaulting to 4
void	setLengthDigits(int len)

Methods inherited from class BaseChannel

accept, addFilter, addFilter, addIncomingFilter, addOutgoingFilter, applyIncomingFilters, applyIncomingFilters, applyOutgoingFilters, applyTimeout, clone, closeSocket, connect, connect, createISOMsg, createMsg, disconnect, getBytes, getChannel, getConfiguration, getCounters, getDynamicHeader, getDynamicPackager, getDynamicPackager, getDynamicPackager, getExceptionHandlers, getHeader, getHeaderLength, getHeaderLength, getHeaderLength, getHost, getIncomingFilters, getISOMsgMetrics, getLogger, getMaxPacketLength, getMessage, getMessageTrailer, getMessageTrailler, getName, getOriginalRealm, getOutgoingFilters, getPackager, getPort, getRealm, getServerSocket, getSocket, getSocketFactory, getSoLingerSeconds, getTimeout, incrementMsgInCounter, incrementMsgOutCounter, isConnected, isExpectKeepAlive, isOverrideHeader, isRejected, isSoLingerOn, newSocket, newSocket, pack, postConnectHook, readHeader, receive, reconnect, removeFilter, removeFilter, removeIncomingFilter, removeOutgoingFilter, resetCounters, send, send, sendKeepAlive, sendMessage, sendMessageHeader, sendMessageTrailer, sendMessageTrailler, sendMessageTrailler, setHeader, setHeader, setHost, setHost, setIncomingFilters, setISOMsgMetrics, setLocalAddress, setLogger, setMaxPacketLength, setName, setOutgoingFilters, setOverrideHeader, setPackager, setPort, setServerSocket, setSocketFactory, setSoLinger, setTimeout, setUsable, shouldIgnore, streamReceive, unpack

Methods inherited from class Observable

addObserver, clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers, notifyObservers, setChanged

Methods inherited from class Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface ExceptionHandlerAware

addHandler, addHandler, handle, removeHandler, removeHandler, removeHandlers

Field Details

lengthDigits

protected int lengthDigits

Number of digits for the message length header

Constructor Details

ASCIIChannel

public ASCIIChannel()

Public constructor (used by Class.forName("...").newInstance())

ASCIIChannel

public ASCIIChannel(String host,
 int port,
 ISOPackager p)

Construct client ISOChannel

Parameters:

host - server TCP Address

port - server port number

p - an ISOPackager

See Also:

• ISOPackager

ASCIIChannel

public ASCIIChannel(ISOPackager p)
             throws IOException

Construct server ISOChannel

Parameters:

p - an ISOPackager

Throws:

IOException

See Also:

• ISOPackager

ASCIIChannel

public ASCIIChannel(ISOPackager p,
 ServerSocket serverSocket)
             throws IOException

constructs a server ISOChannel associated with a Server Socket

Parameters:

p - an ISOPackager

serverSocket - where to accept a connection

Throws:

IOException

See Also:

• ISOPackager

Method Details

setLengthDigits

public void setLengthDigits(int len)

getLengthDigits

public int getLengthDigits()

sendMessageLength

protected void sendMessageLength(int len)
                          throws IOException

Overrides:

sendMessageLength in class BaseChannel

Parameters:

len - the packed Message len

Throws:

IOException

getMessageLength

protected int getMessageLength()
                        throws IOException,
ISOException

Overrides:

getMessageLength in class BaseChannel

Returns:

the Message len

Throws:

IOException

ISOException

setConfiguration

public void setConfiguration(Configuration cfg)
                      throws ConfigurationException

Calls super.setConfiguration() and then reads the 'length-digits' property, defaulting to 4

Specified by:

setConfiguration in interface Configurable

Overrides:

setConfiguration in class BaseChannel

Parameters:

cfg - Configuration

Throws:

ConfigurationException