version 1.1.2.3, 2001/08/20 02:37:39
|
version 1.24.18.1, 2008/01/02 21:00:39
|
|
|
//%///////////////////////////////////////////////////////////////////////////// |
//%2006//////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001 BMC Software, Hewlett-Packard Company, IBM, |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// The Open Group, Tivoli Systems |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
|
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation, The Open Group. |
|
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy | // Permission is hereby granted, free of charge, to any person obtaining a copy |
// of this software and associated documentation files (the "Software"), to | // of this software and associated documentation files (the "Software"), to |
|
|
// | // |
//============================================================================== | //============================================================================== |
// | // |
// Author: Mike Brasher (mbrasher@bmc.com) |
|
// |
|
// Modified By: |
|
// |
|
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
#ifndef Pegasus_HTTPConnector_h | #ifndef Pegasus_HTTPConnector_h |
|
|
#include <Pegasus/Common/MessageQueue.h> | #include <Pegasus/Common/MessageQueue.h> |
#include <Pegasus/Common/Monitor.h> | #include <Pegasus/Common/Monitor.h> |
#include <Pegasus/Common/String.h> | #include <Pegasus/Common/String.h> |
|
#include <Pegasus/Common/TLS.h> |
|
#include <Pegasus/Common/Linkage.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
struct HTTPConnectorRep; | struct HTTPConnectorRep; |
|
|
class HTTPConnection; | class HTTPConnection; |
| |
/** This class is used by clients to establish a connection with a | /** This class is used by clients to establish a connection with a |
|
|
{ | { |
public: | public: |
| |
|
typedef MessageQueue Base; |
|
|
/** Constructor. | /** Constructor. |
@param monitor pointer to monitor object which this class uses to | @param monitor pointer to monitor object which this class uses to |
solicit SocketMessages on the server port (socket). | solicit SocketMessages on the server port (socket). |
|
|
*/ | */ |
HTTPConnector(Monitor* monitor); | HTTPConnector(Monitor* monitor); |
| |
|
HTTPConnector(Monitor* monitor, SSLContext * sslcontext); |
|
|
/** Destructor. */ | /** Destructor. */ |
~HTTPConnector(); | ~HTTPConnector(); |
| |
/** This method is called whenever a SocketMessage is enqueued | /** This method is called whenever a SocketMessage is enqueued |
on the input queue of the HTTPConnector object. | on the input queue of the HTTPConnector object. |
*/ | */ |
virtual void handleEnqueue(); |
|
| |
virtual const char* getQueueName() const; |
virtual void handleEnqueue(Message *); |
|
virtual void handleEnqueue(); |
| |
/** Establishes a new connection and creates an HTTPConnection object | /** Establishes a new connection and creates an HTTPConnection object |
to represent it. | to represent it. |
| |
@param locator indicates which server to connect to (of the form |
@param host indicates host to connect to |
host:port). |
@param portNumber indicates port number to use |
|
@param sslContext Specifies the SSL context to use for this connection |
|
@param timeoutMilliseconds Specifies the connection timeout. |
|
If a socket is non-blocking and a connection is in progress after |
|
the initial attempt, the connection will be attempted until the |
|
specified timeout is reached. If the specified timeout is zero, |
|
the connection will not be re-attempted. The timeout is not |
|
applicable for a blocking socket. |
@param outputMessageQueue output message queue for the HTTPConnection | @param outputMessageQueue output message queue for the HTTPConnection |
that will be created. | that will be created. |
@exception InvalidLocator |
@exception InvalidLocatorException |
@exception CannotCreateSocket |
@exception CannotCreateSocketException |
@exception CannotConnect |
@exception CannotConnectException |
@exception UnexpectedFailure |
|
*/ | */ |
HTTPConnection* connect( | HTTPConnection* connect( |
const String& locator, |
const String& host, |
|
const Uint32 portNumber, |
|
SSLContext * sslContext, |
|
Uint32 timeoutMilliseconds, |
MessageQueue* outputMessageQueue); | MessageQueue* outputMessageQueue); |
| |
/** Destroys all the connections created by this connector. */ | /** Destroys all the connections created by this connector. */ |
void destroyConnections(); | void destroyConnections(); |
| |
|
/** Close the specified connection. */ |
|
void disconnect(HTTPConnection* connection); |
|
|
private: | private: |
| |
|
/** Delete the specified connection. */ |
|
void _deleteConnection(HTTPConnection* httpConnection); |
|
|
Monitor* _monitor; | Monitor* _monitor; |
HTTPConnectorRep* _rep; | HTTPConnectorRep* _rep; |
|
|
|
SSLContext* _sslcontext; |
|
int _entry_index; |
}; | }; |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |