cdac.medinfo.sdk.dcm30_04.services.scp.commons

Class ServerSideAssociationAgent

java.lang.Object

cdac.medinfo.sdk.dcm30_04.services.scp.commons.ServerSideAssociationAgent

All Implemented Interfaces:

IAssociatePDUReceiver, java.util.EventListener

public class ServerSideAssociationAgent
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
ServerSideAssociationAgent(PDUWriter pduWriter, PDUReader pduReader) Instantiates a new Server Side 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 PDUWriter.
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.
PDUWriter	getPDUWriter() Retrieves the PDUWriter.
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 PDUWriter.
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	setPDUWriter(PDUWriter objPDUWriter) Sets the PDUWriter.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerSideAssociationAgent

public ServerSideAssociationAgent(PDUWriter pduWriter,
                          PDUReader pduReader)

Instantiates a new Server Side Association Agent.

Parameters:

pduWriter - instance of PDU Writter.

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 DimseAssociation

getPDUWriter

public PDUWriter getPDUWriter()

Retrieves the PDUWriter.

Returns:

PDUWriter - instance of PDU Writter.

setPDUWriter

public void setPDUWriter(PDUWriter objPDUWriter)

Sets the PDUWriter.

Parameters:

objPDUWriter - instance of PDU Writter.

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 - object of association status listener

associatePDUReceive

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

This method is invoked when a Association PDU arrives from PDUWriter. 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 PDUWriter.

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 Reciever.

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

setAgreedAssociation

public void setAgreedAssociation(AgreedAssociation objAgreedAssociation)

Sets the AgreedAssociation

Parameters:

objAgreedAssociation - instance of AgreedAssociation.

onException

public void onException(DicomException ex,
               EnumErrorCode ErrorCode)

Gets automatically invoked when exception occur while processing data received

Specified by:

onException in interface IAssociatePDUReceiver

Parameters:

objClientSession - - object of Client Session.

ex - - the exception object

ErrorCode - - the reason of the DicomException