107 lines
2.8 KiB
C
107 lines
2.8 KiB
C
|
/*
|
||
|
|
*
|
||
|
|
* Copyright (C) 1998-2011, 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
|
||
|
|
*
|
||
|
|
* Purpose:
|
||
|
|
* classes: DcmTransportLayer
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef DCMLAYER_H
|
||
|
|
#define DCMLAYER_H
|
||
|
|
|
||
|
|
#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
|
||
|
|
#include "dcmtk/ofstd/oftypes.h"
|
||
|
|
#include "dcmtk/ofstd/ofstring.h"
|
||
|
|
|
||
|
|
#define INCLUDE_UNISTD
|
||
|
|
#include "dcmtk/ofstd/ofstdinc.h"
|
||
|
|
|
||
|
|
#include "dcmtk/dcmnet/dndefine.h"
|
||
|
|
|
||
|
|
/** this enum represents the result of a transport layer operation
|
||
|
|
* which may be a transparent TCP/IP or a secure TLS operation.
|
||
|
|
*/
|
||
|
|
enum DcmTransportLayerStatus
|
||
|
|
{
|
||
|
|
/** successful operation
|
||
|
|
*/
|
||
|
|
TCS_ok,
|
||
|
|
|
||
|
|
/** operation cannot be performed because transport connection
|
||
|
|
* object was not allocated.
|
||
|
|
*/
|
||
|
|
TCS_noConnection,
|
||
|
|
|
||
|
|
/** operation failed due to an error within the TLS protocol layer
|
||
|
|
*/
|
||
|
|
TCS_tlsError,
|
||
|
|
|
||
|
|
/** operation failed because an illegal parameter was passed
|
||
|
|
*/
|
||
|
|
TCS_illegalCall,
|
||
|
|
|
||
|
|
/** unspecified error
|
||
|
|
*/
|
||
|
|
TCS_unspecifiedError
|
||
|
|
};
|
||
|
|
|
||
|
|
class DcmTransportConnection;
|
||
|
|
|
||
|
|
/** factory class which creates transport layer connections.
|
||
|
|
* Base class only supports transparent TCP connections, subclasses
|
||
|
|
* may also support secure transport layer connections.
|
||
|
|
*/
|
||
|
|
|
||
|
|
class DCMTK_DCMNET_EXPORT DcmTransportLayer
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
|
||
|
|
/** constructor.
|
||
|
|
* #param networkRole network role to be used by the application, influences
|
||
|
|
* the choice of the secure transport layer code.
|
||
|
|
*/
|
||
|
|
DcmTransportLayer(int /* networkRole */ ) { /* empty */ }
|
||
|
|
|
||
|
|
/// destructor
|
||
|
|
virtual ~DcmTransportLayer();
|
||
|
|
|
||
|
|
/** factory method that returns a new transport connection for the
|
||
|
|
* given socket. Depending on the second parameter, either a transparent
|
||
|
|
* or a secure connection is established. If the object cannot be created
|
||
|
|
* (e. g. because no secure layer is available), returns NULL.
|
||
|
|
* @param openSocket TCP/IP socket to be used for the transport connection.
|
||
|
|
* the connection must already be establised on socket level. If a non-null
|
||
|
|
* pointer is returned, the new connection object takes over control of the socket.
|
||
|
|
* @param useSecureLayer if true, a secure layer is used. If false, a
|
||
|
|
* transparent layer is used.
|
||
|
|
* @return pointer to new connection object if successful, NULL otherwise.
|
||
|
|
*/
|
||
|
|
virtual DcmTransportConnection *createConnection(int openSocket, OFBool useSecureLayer);
|
||
|
|
|
||
|
|
private:
|
||
|
|
|
||
|
|
/// private undefined copy constructor
|
||
|
|
DcmTransportLayer(const DcmTransportLayer&);
|
||
|
|
|
||
|
|
/// private undefined assignment operator
|
||
|
|
DcmTransportLayer& operator=(const DcmTransportLayer&);
|
||
|
|
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#endif
|