version 1.1, 2001/08/17 03:06:23
|
version 1.2, 2001/12/13 14:53:59
|
|
|
|
//%///////////////////////////////////////////////////////////////////////////// |
|
// |
|
// Copyright (c) 2000, 2001 BMC Software, Hewlett-Packard Company, IBM, |
|
// The Open Group, Tivoli Systems |
|
// |
|
// Permission is hereby granted, free of charge, to any person obtaining a copy |
|
// of this software and associated documentation files (the "Software"), to |
|
// deal in the Software without restriction, including without limitation the |
|
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
|
// sell copies of the Software, and to permit persons to whom the Software is |
|
// furnished to do so, subject to the following conditions: |
|
// |
|
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
|
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
|
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
|
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
|
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
|
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
|
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
// |
|
//============================================================================== |
|
// |
|
// Author: Mike Brasher (mbrasher@bmc.com) |
|
// |
|
// Modified By: |
|
// |
|
//%///////////////////////////////////////////////////////////////////////////// |
|
|
|
#ifndef Pegasus_HTTPConnector_h |
|
#define Pegasus_HTTPConnector_h |
|
|
|
#include <Pegasus/Common/Config.h> |
|
#include <Pegasus/Common/MessageQueue.h> |
|
#include <Pegasus/Common/Monitor.h> |
|
#include <Pegasus/Common/String.h> |
|
#include <Pegasus/Common/TLS.h> |
|
|
|
PEGASUS_NAMESPACE_BEGIN |
|
|
|
struct HTTPConnectorRep; |
|
class HTTPConnection; |
|
|
|
/** This class is used by clients to establish a connection with a |
|
server. For each established connection, a HTTPConnection object |
|
is created. |
|
*/ |
|
class PEGASUS_COMMON_LINKAGE HTTPConnector : public MessageQueue |
|
{ |
|
public: |
|
|
|
/** Constructor. |
|
@param monitor pointer to monitor object which this class uses to |
|
solicit SocketMessages on the server port (socket). |
|
@param outputMessageQueue ouptut message queue for connections |
|
created by this connector. |
|
*/ |
|
HTTPConnector(Monitor* monitor); |
|
|
|
HTTPConnector(Monitor* monitor, SSLContext * sslcontext); |
|
|
|
/** Destructor. */ |
|
~HTTPConnector(); |
|
|
|
/** This method is called whenever a SocketMessage is enqueued |
|
on the input queue of the HTTPConnector object. |
|
*/ |
|
virtual void handleEnqueue(); |
|
|
|
virtual const char* getQueueName() const; |
|
|
|
/** Establishes a new connection and creates an HTTPConnection object |
|
to represent it. |
|
|
|
@param locator indicates which server to connect to (of the form |
|
host:port). |
|
@param outputMessageQueue output message queue for the HTTPConnection |
|
that will be created. |
|
@exception InvalidLocator |
|
@exception CannotCreateSocket |
|
@exception CannotConnect |
|
@exception UnexpectedFailure |
|
*/ |
|
HTTPConnection* connect( |
|
const String& locator, |
|
MessageQueue* outputMessageQueue); |
|
|
|
/** Destroys all the connections created by this connector. */ |
|
void destroyConnections(); |
|
|
|
private: |
|
|
|
Monitor* _monitor; |
|
HTTPConnectorRep* _rep; |
|
|
|
SSLContext * _sslcontext; |
|
}; |
|
|
|
PEGASUS_NAMESPACE_END |
|
|
|
#endif /* Pegasus_HTTPConnector_h */ |