1 karl  1.22 //%2006////////////////////////////////////////////////////////////////////////

  2 mike  1.2  //

  3 karl  1.19 // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
  4            // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
  5            // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;

  6 karl  1.17 // IBM Corp.; EMC Corporation, The Open Group.

  7 karl  1.19 // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
  8            // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

  9 karl  1.21 // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 10            // EMC Corporation; VERITAS Software Corporation; The Open Group.

 11 karl  1.22 // Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
 12            // EMC Corporation; Symantec Corporation; The Open Group.

 13 mike  1.2  //
 14            // Permission is hereby granted, free of charge, to any person obtaining a copy

 15 kumpf 1.11 // of this software and associated documentation files (the "Software"), to
 16            // deal in the Software without restriction, including without limitation the
 17            // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or

 18 mike  1.2  // sell copies of the Software, and to permit persons to whom the Software is
 19            // furnished to do so, subject to the following conditions:
 20            // 

 21 kumpf 1.11 // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN

 22 mike  1.2  // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
 23            // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT

 24 kumpf 1.11 // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
 25            // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 26            // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

 27 mike  1.2  // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 28            // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 29            //
 30            //==============================================================================
 31            //
 32            //%/////////////////////////////////////////////////////////////////////////////
 33            
 34            #ifndef Pegasus_HTTPConnector_h
 35            #define Pegasus_HTTPConnector_h
 36            
 37            #include <Pegasus/Common/Config.h>

 38 kumpf 1.23 #include <Pegasus/Common/MessageQueue.h>

 39 mike  1.2  #include <Pegasus/Common/Monitor.h>
 40            #include <Pegasus/Common/String.h>
 41            #include <Pegasus/Common/TLS.h>

 42 kumpf 1.13 #include <Pegasus/Common/Linkage.h>

 43 mike  1.2  
 44            PEGASUS_NAMESPACE_BEGIN
 45            
 46            struct HTTPConnectorRep;

 47 dj.gorey 1.18 

 48 mike     1.2  class HTTPConnection;
 49               
 50               /** This class is used by clients to establish a connection with a
 51                   server. For each established connection, a HTTPConnection object
 52                   is created.
 53               */

 54 kumpf    1.23 class PEGASUS_COMMON_LINKAGE HTTPConnector : public MessageQueue

 55 mike     1.2  {

 56 kumpf    1.24 public:
 57               
 58                   typedef MessageQueue Base;
 59               
 60                   /** Constructor.
 61                       @param monitor pointer to monitor object which this class uses to
 62                       solicit SocketMessages on the server port (socket).
 63                       @param outputMessageQueue ouptut message queue for connections
 64                       created by this connector.
 65                   */
 66                   HTTPConnector(Monitor* monitor);
 67               
 68                   HTTPConnector(Monitor* monitor, SSLContext * sslcontext);
 69               
 70                   /** Destructor. */
 71                   ~HTTPConnector();
 72               
 73                   /** This method is called whenever a SocketMessage is enqueued
 74                       on the input queue of the HTTPConnector object.
 75                   */
 76               
 77 kumpf    1.24     virtual void handleEnqueue(Message *);
 78                   virtual void handleEnqueue();
 79               
 80                   /** Establishes a new connection and creates an HTTPConnection object
 81                       to represent it.
 82               
 83                       @param host indicates host to connect to
 84                       @param portNumber indicates port number to use
 85                       @param outputMessageQueue output message queue for the HTTPConnection
 86                       that will be created.
 87                       @exception InvalidLocatorException
 88                       @exception CannotCreateSocketException
 89                       @exception CannotConnectException
 90                   */
 91                   inline HTTPConnection* connect(
 92                       const String& host,
 93                       const Uint32 portNumber,
 94                       MessageQueue* outputMessageQueue)
 95                   {
 96                       return connect(host, portNumber, NULL, outputMessageQueue);
 97                   }
 98 kumpf    1.24 
 99                   /** Establishes a new connection and creates an HTTPConnection object
100                       to represent it.
101               
102                       @param host indicates host to connect to
103                       @param portNumber indicates port number to use
104                       @param sslContext Specifies the SSL context to use for this connection
105                       @param outputMessageQueue output message queue for the HTTPConnection
106                       that will be created.
107                       @exception InvalidLocatorException
108                       @exception CannotCreateSocketException
109                       @exception CannotConnectException
110                   */
111                   HTTPConnection* connect(
112                       const String& host,
113                       const Uint32 portNumber,
114                       SSLContext * sslContext,
115                       MessageQueue* outputMessageQueue);
116               
117                   /** Destroys all the connections created by this connector. */
118                   void destroyConnections();
119 kumpf    1.24 
120                   /** Close the specified connection. */
121                   void disconnect(HTTPConnection* connection);
122               
123               private:
124               
125                   /** Delete the specified connection. */
126                   void _deleteConnection(HTTPConnection* httpConnection);
127               
128                   Monitor* _monitor;
129                   HTTPConnectorRep* _rep;
130               
131                   SSLContext* _sslcontext;
132                   int _entry_index;

133 dj.gorey 1.18 };
134               

135 mike     1.2  PEGASUS_NAMESPACE_END
136               
137               #endif /* Pegasus_HTTPConnector_h */