com.pixelmed.network

Class Association

java.lang.Object

com.pixelmed.network.Association

public abstract class Association
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected int	associationNumber
protected java.lang.String	calledAETitle
protected java.lang.String	callingAETitle
protected java.io.InputStream	in
protected java.lang.String	localHostName
protected int	maximumLengthReceived
protected java.io.OutputStream	out
protected java.util.LinkedList	presentationContexts
protected java.lang.String	remoteHostName
protected java.util.LinkedList	scuSCPRoleSelections
protected java.net.Socket	socket

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Association()

Method Summary

Modifier and Type	Method and Description
void	abort() Send an A-ABORT-RQ.
int	getAssociationNumber()
AssociationOutputStream	getAssociationOutputStream(byte presentationContextID) A factory method to build an AssociationOutputStream for this Association, on which to send data which is fragmented as appropriate into PDUs.
abstract java.lang.String	getCalledAEHostName()
abstract int	getCalledAEPort()
java.lang.String	getCalledAETitle()
abstract java.lang.String	getCallingAEHostName()
abstract int	getCallingAEPort()
java.lang.String	getCallingAETitle()
java.lang.String	getEndpointDescription()
protected java.lang.String	getLocalHostName()
protected int	getLocalPort()
protected java.lang.String	getRemoteHostName()
protected int	getRemotePort()
protected static byte[]	getRestOfPDU(java.io.InputStream in, byte[] startBuffer, int pduLength)
byte	getSuitablePresentationContextID(java.lang.String abstractSyntaxUID) Find a Presentation Context for the a particular SOP Class UID, using any available Transfer Syntax but preferring compressed then, Explicit VR Little Endian, then any Explicit VR, over Implicit VR.
byte	getSuitablePresentationContextID(java.lang.String abstractSyntaxUID, java.lang.String transferSyntaxUID) Find a Presentation Context for a particular combination of SOP Class UID and Transfer Syntax.
java.lang.String	getTransferSyntaxForPresentationContextID(byte identifier) Get the Transfer Syntax UID of the Presentation Context specified by the Presentation Context ID.
protected static void	readInsistently(java.io.InputStream in, byte[] b, int offset, int length, java.lang.String what)
void	release() Send an A-RELEASE-RQ.
void	send(byte presentationContextID, byte[] command, byte[] data) Send a command and/or data in a single PDU, each PDV with the last fragment flag set.
void	setReceivedDataHandler(ReceivedDataHandler h) Register a ReceivedDataHandler to handle each PDU as it is received.
protected void	setSocketOptions(java.net.Socket socket, int ourMaximumLengthReceived, int socketReceiveBufferSize, int socketSendBufferSize) Set the socket options for either initiator or acceptor.
java.lang.String	toString()
void	waitForCommandPDataPDUs() Continue to transfer data (remain in State 6) until the last fragment of a command has been received.
void	waitForDataPDataPDUs() Continue to transfer data (remain in State 6) until the last fragment of data has been received.
void	waitForOnePDataPDU() Continue to transfer data (remain in State 6) until one PDU has been received.
void	waitForPDataPDUs(int count, boolean stopAfterLastFragmentOfCommand, boolean stopAfterLastFragmentOfData, boolean stopAfterHandlerReportsDone) Continue to transfer data (remain in State 6) until the specified number of PDUs have been received or the specified conditions are satisfied.
void	waitForPDataPDUsUntilHandlerReportsDone() Continue to transfer data (remain in State 6) until the data handler reports that it is done.

Methods inherited from class java.lang.Object

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

Field Detail

associationNumber

protected int associationNumber

calledAETitle

protected java.lang.String calledAETitle

callingAETitle

protected java.lang.String callingAETitle

in

protected java.io.InputStream in

localHostName

protected java.lang.String localHostName

maximumLengthReceived

protected int maximumLengthReceived

out

protected java.io.OutputStream out

presentationContexts

protected java.util.LinkedList presentationContexts

remoteHostName

protected java.lang.String remoteHostName

scuSCPRoleSelections

protected java.util.LinkedList scuSCPRoleSelections

socket

protected java.net.Socket socket

Constructor Detail

Association

protected Association()

Method Detail

abort

public void abort()
           throws DicomNetworkException

Send an A-ABORT-RQ. This is an unconfirmed service, so a normal return is expected.

Throws:

DicomNetworkException

getAssociationNumber

public int getAssociationNumber()

getAssociationOutputStream

public AssociationOutputStream getAssociationOutputStream(byte presentationContextID)
                                                   throws DicomNetworkException

A factory method to build an AssociationOutputStream for this Association, on which to send data which is fragmented as appropriate into PDUs.

Parameters:

presentationContextID - included in the header of each PDU

Throws:

DicomNetworkException

getCalledAEHostName

public abstract java.lang.String getCalledAEHostName()

getCalledAEPort

public abstract int getCalledAEPort()

getCalledAETitle

public java.lang.String getCalledAETitle()

getCallingAEHostName

public abstract java.lang.String getCallingAEHostName()

getCallingAEPort

public abstract int getCallingAEPort()

getCallingAETitle

public java.lang.String getCallingAETitle()

getEndpointDescription

public java.lang.String getEndpointDescription()

getLocalHostName

protected java.lang.String getLocalHostName()

getLocalPort

protected int getLocalPort()

getRemoteHostName

protected java.lang.String getRemoteHostName()

getRemotePort

protected int getRemotePort()

getRestOfPDU

protected static byte[] getRestOfPDU(java.io.InputStream in,
                                     byte[] startBuffer,
                                     int pduLength)
                              throws DicomNetworkException,
                                     java.io.IOException

Parameters:

in -

startBuffer -

pduLength -

Throws:

java.io.IOException

DicomNetworkException

getSuitablePresentationContextID

public byte getSuitablePresentationContextID(java.lang.String abstractSyntaxUID)
                                      throws DicomNetworkException

Find a Presentation Context for the a particular SOP Class UID, using any available Transfer Syntax but preferring compressed then, Explicit VR Little Endian, then any Explicit VR, over Implicit VR.

Parameters:

abstractSyntaxUID - the SOP Class UID for which to find a suitable Presentation Context

Returns:

the Presentation Context ID of a suitable Presentation Context

Throws:

DicomNetworkException - thrown if no suitable Presentation Context

getSuitablePresentationContextID

public byte getSuitablePresentationContextID(java.lang.String abstractSyntaxUID,
                                             java.lang.String transferSyntaxUID)
                                      throws DicomNetworkException

Find a Presentation Context for a particular combination of SOP Class UID and Transfer Syntax.

Parameters:

abstractSyntaxUID - the SOP Class UID for which to find a suitable Presentation Context

transferSyntaxUID - the Transfer Syntax UID for which to find a suitable Presentation Context

Returns:

the Presentation Context ID of a suitable Presentation Context

Throws:

DicomNetworkException - thrown if no suitable Presentation Context

getTransferSyntaxForPresentationContextID

public java.lang.String getTransferSyntaxForPresentationContextID(byte identifier)
                                                           throws DicomNetworkException

Get the Transfer Syntax UID of the Presentation Context specified by the Presentation Context ID.

Parameters:

identifier - the Presentation Context ID

Returns:

the only or first Transfer Syntax UID

Throws:

DicomNetworkException - thrown if no such Presentation Context or no Transfer Syntax for that Presentation Context (e.g. it was rejected)

readInsistently

protected static void readInsistently(java.io.InputStream in,
                                      byte[] b,
                                      int offset,
                                      int length,
                                      java.lang.String what)
                               throws DicomNetworkException,
                                      java.io.IOException

Parameters:

in -

b -

offset -

length -

what -

Throws:

java.io.IOException

DicomNetworkException

release

public void release()
             throws DicomNetworkException

Send an A-RELEASE-RQ. This is a confirmed service, so a normal return is the A-RELEASE confirmation primitive.

Throws:

DicomNetworkException

send

public void send(byte presentationContextID,
                 byte[] command,
                 byte[] data)
          throws DicomNetworkException

Send a command and/or data in a single PDU, each PDV with the last fragment flag set.

Parameters:

presentationContextID - included in the header of each PDU

command - the command PDV payload, or null if none

data - the data PDV payload, or null if none

Throws:

DicomNetworkException

setReceivedDataHandler

public void setReceivedDataHandler(ReceivedDataHandler h)
                            throws DicomNetworkException

Register a ReceivedDataHandler to handle each PDU as it is received.

Parameters:

h - an implementation of the abstract class ReceivedDataHandler

Throws:

DicomNetworkException

setSocketOptions

protected void setSocketOptions(java.net.Socket socket,
                                int ourMaximumLengthReceived,
                                int socketReceiveBufferSize,
                                int socketSendBufferSize)
                         throws java.io.IOException

Set the socket options for either initiator or acceptor.

Must be called before using the socket or the options won't set.

Parameters:

socket - the socket whose options to set

ourMaximumLengthReceived - the maximum PDU length that we will offer to receive

socketReceiveBufferSize - the TCP socket receive buffer size to set (if possible), 0 means leave at the default

socketSendBufferSize - the TCP socket send buffer size to set (if possible), 0 means leave at the default

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

waitForCommandPDataPDUs

public void waitForCommandPDataPDUs()
                             throws DicomNetworkException,
                                    AReleaseException

Continue to transfer data (remain in State 6) until the last fragment of a command has been received. The registered receivedDataHandler is sent a PDataIndication.

Throws:

DicomNetworkException - A-ABORT or A-P-ABORT indication

AReleaseException - A-RELEASE indication; transport connection is closed

waitForDataPDataPDUs

public void waitForDataPDataPDUs()
                          throws DicomNetworkException,
                                 AReleaseException

Continue to transfer data (remain in State 6) until the last fragment of data has been received. The registered receivedDataHandler is sent a PDataIndication.

Throws:

DicomNetworkException - A-ABORT or A-P-ABORT indication

AReleaseException - A-RELEASE indication; transport connection is closed

waitForOnePDataPDU

public void waitForOnePDataPDU()
                        throws DicomNetworkException,
                               AReleaseException

Continue to transfer data (remain in State 6) until one PDU has been received. The registered receivedDataHandler is sent a PDataIndication.

Throws:

DicomNetworkException - A-ABORT or A-P-ABORT indication

AReleaseException - A-RELEASE indication; transport connection is closed

waitForPDataPDUs

public void waitForPDataPDUs(int count,
                             boolean stopAfterLastFragmentOfCommand,
                             boolean stopAfterLastFragmentOfData,
                             boolean stopAfterHandlerReportsDone)
                      throws DicomNetworkException,
                             AReleaseException

Continue to transfer data (remain in State 6) until the specified number of PDUs have been received or the specified conditions are satisfied. The registered receivedDataHandler is sent a PDataIndication.

Parameters:

count - the number of PDUs to be transferred, or -1 if no limit (stop only when conditions satisfied)

stopAfterLastFragmentOfCommand - stop after the last fragment of a command has been received

stopAfterLastFragmentOfData - stop after the last fragment of data has been received

stopAfterHandlerReportsDone - stop after data handler reports that it is done

Throws:

DicomNetworkException - A-ABORT or A-P-ABORT indication

AReleaseException - A-RELEASE indication; transport connection is closed

waitForPDataPDUsUntilHandlerReportsDone

public void waitForPDataPDUsUntilHandlerReportsDone()
                                             throws DicomNetworkException,
                                                    AReleaseException

Continue to transfer data (remain in State 6) until the data handler reports that it is done. The registered receivedDataHandler is sent a PDataIndication.

Throws:

DicomNetworkException - A-ABORT or A-P-ABORT indication

AReleaseException - A-RELEASE indication; transport connection is closed