cdac.medinfo.sdk.dcm30_04.services.scu.commons

Class ClientSideAssociationAgent

java.lang.Object

cdac.medinfo.sdk.dcm30_04.services.scu.commons.ClientSideAssociationAgent

All Implemented Interfaces:

IAssociatePDUReceiver, java.util.EventListener

public class ClientSideAssociationAgent
extends java.lang.Object
implements IAssociatePDUReceiver

This class provides communication between DataNotificationReceiver and PDUHandler. It implements receiving and sending process of Association PDU's or commands between DataNotificationReceiver and PDUHandler. It also generates AgreedAssociation and implements required validation.

Constructor Summary

Constructors

Constructor and Description
ClientSideAssociationAgent(PDUWriter pduWriter, PDUReader pduReader) Instantiates a new association agent.

Method Summary

Methods

Modifier and Type	Method and Description
void	addAssociationStatusListener(IAssociationStatusListener objIAssociationStatusListener) Adds the associate status listener.
void	addDataNotificationListener(IDataNotificationReceiver objIDataNotificationReceiver) Sets the DataNotificationListener.
void	associatePDUReceive(AssociateEvent objAssociateEvent) This method is invoked when a Association PDU arrives from PDUHandler.
AgreedAssociation	getAgreedAssociation() Retrieves the AgreedAssociation.
boolean	getAssociationStatus() Retrieves the status of association.
DefaultAssociation	getDefaultAssociation() Retrieves the Default Association settings.
IDIMSEAssociation	getDimseAssociation() Retrieves the currently processing DimseAssociation.
PDUReader	getPDUReader() Retrieves PDU Reader.
PDUWriter	getPDUWriter() Retrieves the PDU Writer.
void	onException(DicomException ex, EnumErrorCode ErrorCode) Gets automatically invoked when exception occur while processing data received
boolean	sendAssociationMessage(IDIMSEAssociation objIDimseAssociation) This method generates Association PDU according to the arrived Association command and redirect it to PDUHandler.
void	setAgreedAssociation(AgreedAssociation objAgreedAssociation) Sets the AgreedAssociation
void	setAssociationStatus(boolean status) Sets the current status of the on going association.
void	setDefaultAssociation(DefaultAssociation objDefaultAssociation) Sets the Default settings of Association.
void	setDimseAssociation(IDIMSEAssociation objIDimseAssociation) Sets the currently processing DimseAssociation.
void	setPDUReader(PDUReader objPDUReader) Sets the PDU Reader.
void	setPDUWriter(PDUWriter pduWriter) Sets the PDU Writer.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientSideAssociationAgent

public ClientSideAssociationAgent(PDUWriter pduWriter,
                          PDUReader pduReader)

Instantiates a new association agent.

Parameters:

pduWriter - instance of PDU Writer.

pduReader - instance of PDU reader

Method Detail

setDefaultAssociation

public void setDefaultAssociation(DefaultAssociation objDefaultAssociation)

Sets the Default settings of Association.

Parameters:

objDefaultAssociation - instance of Default Association.

getDefaultAssociation

public DefaultAssociation getDefaultAssociation()

Retrieves the Default Association settings.

Returns:

DefaultAssociation - instance of Default Association.

getDimseAssociation

public IDIMSEAssociation getDimseAssociation()

Retrieves the currently processing DimseAssociation.

Returns:

IDIMSEAssociation - instance of Dimse Association.

getPDUWriter

public PDUWriter getPDUWriter()

Retrieves the PDU Writer.

Returns:

PDUWriter object of PDU Writer.

setPDUWriter

public void setPDUWriter(PDUWriter pduWriter)

Sets the PDU Writer.

Parameters:

pduWriter - object of PDU Writer.

setDimseAssociation

public void setDimseAssociation(IDIMSEAssociation objIDimseAssociation)

Sets the currently processing DimseAssociation.

Parameters:

objIDimseAssociation - instance of DIMSE Association.

addAssociationStatusListener

public void addAssociationStatusListener(IAssociationStatusListener objIAssociationStatusListener)

Adds the associate status listener. This method is used to get updated regarding the status of the Association. Implementor of the IAssociationStatusListener interface will implement the setAssociationStatus method to receive the update.

Parameters:

objIAssociationStatusListener - instance of Association Status Listener.

associatePDUReceive

public void associatePDUReceive(AssociateEvent objAssociateEvent)
                         throws java.io.IOException

This method is invoked when a Association PDU arrives from PDUHandler. It generates Association Command from the PDU arrived and notifies the DataNotificationReceiver.

Specified by:

associatePDUReceive in interface IAssociatePDUReceiver

Parameters:

objAssociateEvent - instance of AssociateEvent.

Throws:

java.io.IOException - Signals that an I/O exception has occurred.

sendAssociationMessage

public boolean sendAssociationMessage(IDIMSEAssociation objIDimseAssociation)

This method generates Association PDU according to the arrived Association command and redirect it to PDUHandler.

Parameters:

objIDimseAssociation - instance of DIMSE Association.

Returns:

boolean - shows status as success or failure.

Throws:

java.io.IOException - Signals that an I/O exception has occurred.

addDataNotificationListener

public void addDataNotificationListener(IDataNotificationReceiver objIDataNotificationReceiver)

Sets the DataNotificationListener.

Parameters:

objIDataNotificationReceiver - object of Data Notification Receiver.

setAssociationStatus

public void setAssociationStatus(boolean status)

Sets the current status of the on going association.

Parameters:

status - boolean variable representing association status true - if association is alive false - if association does not exits.

getAssociationStatus

public boolean getAssociationStatus()

Retrieves the status of association.

Returns:

boolean - boolean variable representing association status true - if association is alive false - if association does not exits.

getAgreedAssociation

public AgreedAssociation getAgreedAssociation()

Retrieves the AgreedAssociation.

Returns:

AgreedAssociation - instance of AgreedAssociation

getPDUReader

public PDUReader getPDUReader()

Retrieves PDU Reader.

Returns:

PDUReader - instance of PDU Reader.

setPDUReader

public void setPDUReader(PDUReader objPDUReader)

Sets the PDU Reader.

Parameters:

objPDUReader - object of PDU Reader.

setAgreedAssociation

public void setAgreedAssociation(AgreedAssociation objAgreedAssociation)

Sets the AgreedAssociation

Parameters:

objAgreedAssociation - object of Agreed Association.

onException

public void onException(DicomException ex,
               EnumErrorCode ErrorCode)

Description copied from interface: IAssociatePDUReceiver

Gets automatically invoked when exception occur while processing data received

Specified by:

onException in interface IAssociatePDUReceiver

Parameters:

ex -

ErrorCode - - the reason of the DicomException