cdac.medinfo.sdk.dcm30_04.services.print.scu

Class PrintSCU

java.lang.Object

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

cdac.medinfo.sdk.dcm30_04.services.print.scu.PrintSCU

All Implemented Interfaces:

IMessageListener

public class PrintSCU
extends SCU

Print SCU works as a SCU for Print Management Service Class. Print Management Service class includes meta SOP classes and some optional SOP Class. The Meta SOP Class and the Optional SOP Class Supported by PrintSCU is Basic GrayScale Print Management Meta SOP Class - This Meta SOP class support following SOP classes 1) Basic Film Session SOP Class :- This class supports following Services N-Create,N-Set,N-Delete,N-Action services. 2) Basic Film Box SOP Class :- This class supports following Services N-Create,N-Set,N-Delete,N-Action services. 3) Basic GrayScale Image Box SOP Class :- This class supports following Services N-Set services. 4) Printer SOP Class :- This class supports following Services N-Get and N-Event Report services. Basic Color Print Management Meta SOP Class This Meta SOP class support following SOP classes 1)Basic Film Session SOP Class :- This class supports following Services N-Create,N-Set,N-Delete,N-Action services. 2)Basic Film Box SOP Class :- This class supports following Services N-Create,N-Set,N-Delete,N-Action services. 3)Basic Color Image Box SOP Class :- This class supports following Services N-Set services. 4)Printer SOP Class :- This class supports following Services N-Get and N-Event Report services. Pull Print Meta SOP Class This Meta SOP class support following SOP classes 1)Pull Print Request SOP Class :- This class supports following Services N-Create , N-Action and N-Delete services. 2)Printer SOP Class :- This class supports following Services N-Get and N-Event Report services. Following are the option SOP Class supported by Print Management Service Class with Basic Print Management SOP 1)Basic Annotation Box SOP Class :- This class supports following Services N-Set services. 2)Print Job SOP Class :- This class supports following Services N-Get and N-Event Report services. 3)Basic print Image Overlay Box SOP Class. 4)Presentation LUT Sop Class :- This class supports following Services N-Create and N-Delete services. 5)Printer Configuration Retrieval SOP Class. Following are the option SOP Class supported by Print Management Service Class with Pull Stored Print Management SOP 1) Print Job SOP Class :- This class supports following Services N-Get and N-Event Report services. 2) Presentation LUT Sop Class :- This class supports following Services N-Create and N-Delete services. 3)Printer Configuration Retrieval SOP Class. Print_SCU is responsible to send the requests of supported N-Services and maintains the received response.

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
void	send(AssociateRQ objAssociateRQ, EnumCommandField objEnumCommandField, EnumSOPClassUIDs enumSOPClassUIDs, java.lang.String strSOPInstanceUID, IDataSet objIDataSet, ISingleCollection<ITag> objITagCollection) Sends the available datasets to the SCP.
void	send(java.lang.String strcallingAETitle, java.lang.String strCalledAETitle, EnumMetaSOPClassUID enumMetaSOPClassUID, EnumSOPClassUIDs[] enumOptionalPrintSOPClassUIDs, EnumCommandField objEnumCommandField, EnumSOPClassUIDs enumSOPClassUIDs, java.lang.String strSOPInstanceUID, IDataSet objIDataSet, ISingleCollection<ITag> objITagCollection) This method creates associaition request according to the DataSet collection provided by the user and the Default association.
boolean	sendMessage(DicomMessage objDicomMessage) This method sends the Request for Print Service Mangement Service.
boolean	validateNActionRQ(EnumSOPClassUIDs enumSOPClassUIDs, IDataSet objIDataSet, NActionRQ objNActionRQ) This function validates the N-Action Data Set of the SOP Class UID specified.
boolean	validateNCreateRQ(EnumSOPClassUIDs enumSOPClassUIDs, IDataSet objIDataSet) This function validates the N-Create Data Set of the SOP Class UID specified.
boolean	validateNGetRQ(EnumSOPClassUIDs enumSOPClassUIDs, IDataSet objIDataSet) This function validates the N-Get Data Set of the SOP Class UID specified.
boolean	validateNSetRQ(EnumSOPClassUIDs enumSOPClassUIDs, IDataSet objIDataSet) This function validates the N-Set Data Set of the SOP Class UID specified.

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

PrintSCU

public PrintSCU(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 opeation fails.

PrintSCU

public PrintSCU(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 opeation fails.

PrintSCU

public PrintSCU(SCUSession objSCUSession)

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

Parameters:

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

Method Detail

send

public void send(java.lang.String strcallingAETitle,
        java.lang.String strCalledAETitle,
        EnumMetaSOPClassUID enumMetaSOPClassUID,
        EnumSOPClassUIDs[] enumOptionalPrintSOPClassUIDs,
        EnumCommandField objEnumCommandField,
        EnumSOPClassUIDs enumSOPClassUIDs,
        java.lang.String strSOPInstanceUID,
        IDataSet objIDataSet,
        ISingleCollection<ITag> objITagCollection)
          throws java.io.IOException

This method creates associaition 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

enumMetaSOPClassUID - Meta Sop Class UID for which association for print mangement service is to be loaded.

enumOptionalPrintSOPClassUIDs - Option SOP Class UID s for which association is to be established with the Meta SOP Class provided.

objEnumCommandField - Enum Represents Element Command Field i.e. the type of service.

enumSOPClassUIDs - Affected SOP Class UID in the Command Set.

strSOPInstanceUID - Affected SOP Instance UID in the command Set.

objIDataSet - instance of dataset which is to be sent.

objITagCollection - list of requested attributes

Throws:

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

send

public void send(AssociateRQ objAssociateRQ,
        EnumCommandField objEnumCommandField,
        EnumSOPClassUIDs enumSOPClassUIDs,
        java.lang.String strSOPInstanceUID,
        IDataSet objIDataSet,
        ISingleCollection<ITag> objITagCollection)
          throws java.io.IOException

Sends the available datasets to the SCP. While sending the datsets, 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 datasets. 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 Print SCU.

Parameters:

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

objEnumCommandField - Enum Represents Element Command Field i.e. the type of service.

enumSOPClassUIDs - Affected SOP Class UID in the Command Set.

strSOPInstanceUID - Affected SOP Instance UID in the command Set.

objIDataSet - instance of dataset which is to be sent.

objITagCollection - list of requested attributes

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 Print Service Mangement Service. If the Service is supported by Print management service and is supported in association then it is send to the Service Provider and this function returns true. If the message cannot be sent to the Serive Provide (SCP) then this function returns false. Logging is done if logging is enables in SDK.

Specified by:

sendMessage in interface IMessageListener

Specified by:

sendMessage in class SCU

Parameters:

objDicomMessage - instance of Dicom Message containing Request for Print Management Service..

Returns:

true, if send message

Throws:

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

validateNCreateRQ

public boolean validateNCreateRQ(EnumSOPClassUIDs enumSOPClassUIDs,
                        IDataSet objIDataSet)
                          throws InvalidDataSetException

This function validates the N-Create Data Set of the SOP Class UID specified.

Parameters:

enumSOPClassUIDs - SOP class UID for which DataSet needs to be validated for N-Create RQ.

objIDataSet - instance of dataset which is to be validated.

Returns:

boolean - true if the dataset is validated successfully. Else return false.

Throws:

InvalidDataSetException - Signals if dataset validation fails.

validateNSetRQ

public boolean validateNSetRQ(EnumSOPClassUIDs enumSOPClassUIDs,
                     IDataSet objIDataSet)
                       throws InvalidDataSetException

This function validates the N-Set Data Set of the SOP Class UID specified.

Parameters:

enumSOPClassUIDs - SOP class UID for which DataSet needs to be validated for N-Set RQ.

objIDataSet - instance of dataset which is to be validated.

Returns:

boolean - true if the dataset is validated successfully. Else return false.

Throws:

InvalidDataSetException - Signals if dataset validation fails.

validateNActionRQ

public boolean validateNActionRQ(EnumSOPClassUIDs enumSOPClassUIDs,
                        IDataSet objIDataSet,
                        NActionRQ objNActionRQ)
                          throws InvalidDataSetException

This function validates the N-Action Data Set of the SOP Class UID specified.

Parameters:

enumSOPClassUIDs - SOP class UID for which DataSet needs to be validated for N-Action RQ.

objIDataSet - instance of dataset which is to be validated.

Returns:

boolean - true if the dataset is validated successfully. Else return false.

Throws:

InvalidDataSetException - Signals if dataset validation fails.

validateNGetRQ

public boolean validateNGetRQ(EnumSOPClassUIDs enumSOPClassUIDs,
                     IDataSet objIDataSet)
                       throws InvalidDataSetException

This function validates the N-Get Data Set of the SOP Class UID specified.

Parameters:

enumSOPClassUIDs - SOP class UID for which DataSet needs to be validated for N-Get RQ.

objIDataSet - instance of dataset which is to be validated.

Returns:

boolean - true if the dataset is validated successfully. Else return false.

Throws:

InvalidDataSetException - Signals if dataset validation fails.