dcmnet/include/dcmtk/dcmnet/dfindscu.h

/*
 *
 *  Copyright (C) 1994-2010, OFFIS e.V.
 *  All rights reserved.  See COPYRIGHT file for details.
 *
 *  This software and supporting documentation were developed by
 *
 *    OFFIS e.V.
 *    R&D Division Health
 *    Escherweg 2
 *    D-26121 Oldenburg, Germany
 *
 *
 *  Module:  dcmnet
 *
 *  Author:  Marco Eichelberg / Andrew Hewett
 *
 *  Purpose: Classes for Query/Retrieve Service Class User (C-FIND operation)
 *
 *  Last Update:      $Author: joergr $
 *  Update Date:      $Date: 2010-10-14 13:17:22 $
 *  CVS/RCS Revision: $Revision: 1.5 $
 *  Status:           $State: Exp $
 *
 *  CVS/RCS Log at end of file
 *
 */

#ifndef DFINDSCU_H
#define DFINDSCU_H

#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
#include "dcmtk/ofstd/ofcond.h"    /* for class OFCondition */
#include "dcmtk/dcmdata/dcxfer.h"  /* for E_TransferSyntax */
#include "dcmtk/dcmnet/dimse.h"    /* for T_DIMSE_BlockingMode */

// forward declarations of classes and structs
class DcmDataset;
class DcmTransportLayer;
class OFConsoleApplication;
struct T_ASC_Association;
struct T_ASC_Parameters;
struct T_DIMSE_C_FindRQ;
struct T_DIMSE_C_FindRSP;

class DcmFindSCUCallback 
{ 
public: 

  DcmFindSCUCallback();
  
  virtual ~DcmFindSCUCallback() {}

  virtual void callback(
        T_DIMSE_C_FindRQ *request,
        int responseCount,
        T_DIMSE_C_FindRSP *rsp,
        DcmDataset *responseIdentifiers) = 0;

  void setAssociation(T_ASC_Association *assoc);

  void setPresentationContextID(T_ASC_PresentationContextID presId);

protected: /* the two member variables are protected and can be accessed from derived classes */
    
   T_ASC_Association *assoc_;

   T_ASC_PresentationContextID presId_;
};


class DcmFindSCUDefaultCallback: public DcmFindSCUCallback
{
public:
  DcmFindSCUDefaultCallback(
    OFBool extractResponsesToFile,
    int cancelAfterNResponses);
  
  virtual ~DcmFindSCUDefaultCallback() {}

  virtual void callback(
        T_DIMSE_C_FindRQ *request,
        int responseCount,
        T_DIMSE_C_FindRSP *rsp,
        DcmDataset *responseIdentifiers);

private:

   OFBool extractResponsesToFile_;

   int cancelAfterNResponses_;
};


class DcmFindSCU
{
public:

  DcmFindSCU();

  virtual ~DcmFindSCU();

  OFCondition initializeNetwork(int acse_timeout);

  OFCondition setTransportLayer(DcmTransportLayer *tLayer);

  OFCondition dropNetwork();

  OFCondition performQuery(
    const char *peer,
    unsigned int port,
    const char *ourTitle,
    const char *peerTitle,
    const char *abstractSyntax,
    E_TransferSyntax preferredTransferSyntax,
    T_DIMSE_BlockingMode blockMode,
    int dimse_timeout,
    Uint32 maxReceivePDULength,
    OFBool secureConnection,
    OFBool abortAssociation,
    unsigned int repeatCount,
    OFBool extractResponsesToFile,
    int cancelAfterNResponses,
    OFList<OFString> *overrideKeys,
    DcmFindSCUCallback *callback = NULL,
    OFList<OFString> *fileNameList = NULL);    

  static OFBool writeToFile(const char* ofname, DcmDataset *dataset);

private:

  OFCondition addPresentationContext(
    T_ASC_Parameters *params, 
    const char *abstractSyntax,
    E_TransferSyntax preferredTransferSyntax);

  OFCondition findSCU(
    T_ASC_Association * assoc, 
    const char *fname, 
    int repeatCount,  
    const char *abstractSyntax,
    T_DIMSE_BlockingMode blockMode, 
    int dimse_timeout, 
    OFBool extractResponsesToFile,
    int cancelAfterNResponses,
    OFList<OFString> *overrideKeys,
    DcmFindSCUCallback *callback = NULL) const;

private:
    
  T_ASC_Network *net_;

};

#endif

/*
 * CVS Log
 * $Log: dfindscu.h,v $
 * Revision 1.5  2010-10-14 13:17:22  joergr
 * Updated copyright header. Added reference to COPYRIGHT file.
 *
 * Revision 1.4  2009-11-18 11:53:58  uli
 * Switched to logging mechanism provided by the "new" oflog module.
 *
 * Revision 1.3  2009-07-10 13:21:04  onken
 * Moved override key functionality to DcmPathProcessor.
 *
 * Revision 1.2  2009-07-08 16:14:25  onken
 * Added support for specifying tag paths as override keys.
 *
 * Revision 1.1  2007-02-19 13:13:28  meichel
 * Refactored findscu code into class DcmFindSCU, which is now part of the dcmnet
 *   library, and a short command line tool that only evaluates command line
 *   parameters and then makes use of this class. This facilitates re-use of the
 *   findscu code in other applications.
 *
 *
 */

---

Generated on 6 Jan 2011 for OFFIS DCMTK Version 3.6.0 by Doxygen 1.5.1