com.archimed.dicom.scu
Class CFindSCU

java.lang.Object
  com.archimed.dicom.scu.CFindSCU

public class CFindSCU
extends java.lang.Object

CFindSCU supports the exchange of a C-FIND as an SCU and cancellation on an open association. The association must the proper presentation contexts.

Nested Class Summary

static interface

CFindSCU.ResponseHandler

Field Summary

protected JdtLogger

log

Constructor Summary

CFindSCU(AssociationIO associationIO, int presentationContextID, SOPClassUID sopClassUID)
create a new CFindSCU object on an open association.

Method Summary

void	ccancelfind() cancels the current C-FIND operation.
java.util.Collection	cfind(DicomObject identifier, int priority, CFindSCU.ResponseHandler handler) sends a C-FIND request and returns the response datasets as a Collection.
AssociationIO	getAssociationIO()

Methods inherited from class java.lang.Object

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

Field Detail

log

protected JdtLogger log

Constructor Detail

CFindSCU

public CFindSCU(AssociationIO associationIO,
                int presentationContextID,
                SOPClassUID sopClassUID)

create a new CFindSCU object on an open association.

Parameters:

associationIO - AssociationIO

Method Detail

getAssociationIO

public AssociationIO getAssociationIO()

cfind

public java.util.Collection cfind(DicomObject identifier,
                                  int priority,
                                  CFindSCU.ResponseHandler handler)
                           throws SCUException,
                                  DicomException,
                                  java.io.IOException

sends a C-FIND request and returns the response datasets as a Collection. An optional response handler can be specified that is invoked per incoming C-FIND response.

Parameters:

messageID - int the message ID

presentationContextID: - the odd integer between 1 and 255 identifying the presentation context in which to do this C-FIND exchange

sopClassUID - SOPClassUID the SOP class related to this message exchange. This is usually one of:

• SOPClass.ModalityWorklistInformationModelFINDUID
• SOPClass.PatientRootQueryRetrieveInformationModelFINDUID
• SOPClass.StudyRootQueryRetrieveInformationModelFINDUID
• SOPClass.PatientStudyOnlyQueryRetrieveInformationModelFIND

priority - int one of the Command.XXXX_PRIORITY constants

identifier - DicomObject the dataset against which matching is to be performed

handler - ResponseHandler may be null

Returns:

Collection collection of DicomObjects

Throws:

SCUException

DicomException

java.io.IOException

ccancelfind

public void ccancelfind()
                 throws SCUException,
                        DicomException,
                        java.io.IOException

cancels the current C-FIND operation. This method sends a C-CANCEL-FIND request. The cfind method will continue to read C-FIND response messages until a message is encountered with status canceled or status success

Throws:

SCUException

DicomException

java.io.IOException