cdac.medinfo.sdk.dcm30_04.services.hangingprotocol.scu

Class HangingProtocolSCU

java.lang.Object

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

cdac.medinfo.sdk.dcm30_04.services.hangingprotocol.scu.HangingProtocolSCU

All Implemented Interfaces:

IMessageListener

public class HangingProtocolSCU
extends SCU

HangingProtocolSCU works as a Service Class User for Hanging Protocol Storage Service Class. HangingProtocolSCU Service Class includes C-Store service as specified by DIMSE service group. HangingProtocolSCU sends the DIMSE service request for supported C-Service and handles the response.

Constructor Summary

Constructors

Constructor and Description
HangingProtocolSCU(java.net.InetSocketAddress addr) The InetAddress and port to which user connects.
HangingProtocolSCU(SCUSession objSCUSession) Instantiates a new ORMS_SCU on the SCU session provided by user.
HangingProtocolSCU(java.lang.String strIP, int port) The IP and port to which user connects.

Method Summary

Methods

Modifier and Type	Method and Description
static ISingleCollection<CStoreRQ>	getDefaultCStoreRQ(ISingleCollection<IDataSet> objIDataSetColl) This method makes CStore RQ's according to the given DataSet Collection.
void	send(AssociateRQ objAssociateRQ, EnumCommandField objEnumCommandField, java.lang.String strSOPInstanceUID, ISingleCollection<IDataSet> objDataSetCollection) Sends the available data sets to the SCP.
void	send(java.lang.String strCallingAETitle, java.lang.String strCalledAETitle, EnumCommandField objEnumCommandField, java.lang.String strSOPInstanceUID, ISingleCollection<IDataSet> objDataSetCollection) This method creates association request according to the DataSet collection provided by the user and the Default association.
boolean	sendMessage(DicomMessage objDicomMessage) This method sends the Request for Hanging Protocol.
void	sendRequestsForCFind(ISingleCollection<CFindRQ> objRQCollection) This method sends multiple CStore RQ.
void	sendRequestsForCStore(ISingleCollection<CStoreRQ> objRQCollection) This method sends multiple CStore RQ.
boolean	validateCFindRQ(IDataSet objIDataSet) Validates request for C_FIND_RQ for its Compulsory and Conditional attributes specified by DICOM.
boolean	validateCGETRQ(IDataSet objIDataSet) Validates request for C_GET_RQ for its Compulsory and Conditional attributes specified by DICOM.

Methods inherited from class cdac.medinfo.sdk.dcm30_04.services.scu.commons.SCU

getDIMSEAssociation, getDIMSEResponse, receiveMessage, setAssociationStatus, setDIMSEAssociation, setDIMSEResponse

Methods inherited from class java.lang.Object

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

Constructor Detail

HangingProtocolSCU

public HangingProtocolSCU(java.lang.String strIP,
                  int port)
                   throws java.io.IOException

The IP and port to which user connects.

Parameters:

strIP - String value of IP to which user connects.

port - Port to which user connects.

Throws:

java.io.IOException - Signals IO Exception if IO operation fails.

HangingProtocolSCU

public HangingProtocolSCU(java.net.InetSocketAddress addr)
                   throws java.io.IOException

The InetAddress and port to which user connects.

Parameters:

addr - InetAddress to which user connects.

Throws:

java.io.IOException - Signals IO Exception if IO operation fails.

HangingProtocolSCU

public HangingProtocolSCU(SCUSession objSCUSession)

Instantiates a new ORMS_SCU on the SCU session provided by user.

Parameters:

objSCUSession - the object of SCU session on which HangingProtocolSCU is to be initiated.

Method Detail

send

public void send(java.lang.String strCallingAETitle,
        java.lang.String strCalledAETitle,
        EnumCommandField objEnumCommandField,
        java.lang.String strSOPInstanceUID,
        ISingleCollection<IDataSet> objDataSetCollection)
          throws java.io.IOException

This method creates association request according to the DataSet collection provided by the user and the Default association. Then it will perform the requested operation on the data set provided by the user, release the association and close the connection.

Parameters:

strcallingAETitle - value of Calling AE Title

strCalledAETitle - value of Called AE Title

objAssociateRQ - The association request i.e. to be sent to SCP.

strSOPInstanceUID - SOP Instance UID.

objIDataSet - Object of IDataSet

Throws:

java.io.IOException - Signals IOException if IO operation fails.

send

public void send(AssociateRQ objAssociateRQ,
        EnumCommandField objEnumCommandField,
        java.lang.String strSOPInstanceUID,
        ISingleCollection<IDataSet> objDataSetCollection)
          throws java.io.IOException

Sends the available data sets to the SCP. While sending the data sets, if the connection is not made to the destination SCP, then the SCU first creates the connection. If the association is not created with the destination SCP, then the SCU first establishes the association and then sends the data sets. Note: The SCU will not close the connection, if already created connection is given to the SCU in the form of SCUSession. The SCU will neither release the association nor close the connection, if the association is already established with the destination SCP through SCUSession. User has to explicitly release the association and close the connection after completion of send process of CSTORE SCU.

Parameters:

objAssociateRQ - The association request i.e. to be sent to SCP.

strSOPInstanceUID - SOP Instance UID.

objIDataSet - Object of IDataSet

Throws:

java.io.IOException - Signals IOException if IO operation fails.

sendRequestsForCStore

public void sendRequestsForCStore(ISingleCollection<CStoreRQ> objRQCollection)
                           throws java.io.IOException

This method sends multiple CStore RQ.

Parameters:

objRQCollection - Collection of CStoreRQ i.e. to be send.

Throws:

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

sendRequestsForCFind

public void sendRequestsForCFind(ISingleCollection<CFindRQ> objRQCollection)
                          throws java.io.IOException

This method sends multiple CStore RQ.

Parameters:

objRQCollection - Collection of CStoreRQ i.e. to be send.

Throws:

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

sendMessage

public boolean sendMessage(DicomMessage objDicomMessage)
                    throws java.io.IOException

This method sends the Request for Hanging Protocol.

Specified by:

sendMessage in interface IMessageListener

Specified by:

sendMessage in class SCU

Parameters:

objDicomMessage - The Dicom Message containing Request for ORMS.

Returns:

true, if send message

Throws:

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

getDefaultCStoreRQ

public static ISingleCollection<CStoreRQ> getDefaultCStoreRQ(ISingleCollection<IDataSet> objIDataSetColl)

This method makes CStore RQ's according to the given DataSet Collection.

Parameters:

objIDataSetColl - Collection of DataSet.

Returns:

ISingleCollection Collection of CStore RQ.

validateCFindRQ

public boolean validateCFindRQ(IDataSet objIDataSet)
                        throws InvalidDataSetException

Validates request for C_FIND_RQ for its Compulsory and Conditional attributes specified by DICOM.

Parameters:

objDicomMessage - : The Request Message for validation.

Returns:

: true if validation is successful otherwise false if validation fails.

Throws:

InvalidDataSetException - : Exception is raised when the DataSet contents are not in proper order.

validateCGETRQ

public boolean validateCGETRQ(IDataSet objIDataSet)
                       throws InvalidDataSetException

Validates request for C_GET_RQ for its Compulsory and Conditional attributes specified by DICOM.

Parameters:

objDicomMessage - : The Request Message for validation.

Returns:

: true if validation is successful otherwise false if validation fails.

Throws:

InvalidDataSetException - : Exception is raised when the DataSet contents are not in proper order.