1 mike  1.1.2.1 //%/////////////////////////////////////////////////////////////////////////////
 2               //
 3               // Copyright (c) 2000, 2001 BMC Software, Hewlett-Packard Company, IBM, 
 4               // The Open Group, Tivoli Systems
 5               //
 6               // Permission is hereby granted, free of charge, to any person obtaining a copy
 7               // of this software and associated documentation files (the "Software"), to 
 8               // deal in the Software without restriction, including without limitation the 
 9               // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 
10               // sell copies of the Software, and to permit persons to whom the Software is
11               // furnished to do so, subject to the following conditions:
12               // 
13               // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN 
14               // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
15               // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
16               // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR 
17               // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 
18               // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 
19               // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20               // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21               //
22 mike  1.1.2.1 //==============================================================================
23               //
24               // Author: Mike Brasher (mbrasher@bmc.com)
25               //
26               // Modified By:
27               //
28               //%/////////////////////////////////////////////////////////////////////////////
29               
30               #ifndef Pegasus_HTTPConnector_h
31               #define Pegasus_HTTPConnector_h
32               
33               #include <Pegasus/Common/Config.h>
34               #include <Pegasus/Common/MessageQueue.h>
35               #include <Pegasus/Common/Monitor.h>
36               #include <Pegasus/Common/String.h>
37               
38               PEGASUS_NAMESPACE_BEGIN
39               
40               struct HTTPConnectorRep;

41 mike  1.1.2.2 class HTTPConnection;

42 mike  1.1.2.1 
43               /** This class is used by clients to establish a connection with a
44                   server. For each established connection, a HTTPConnection object
45                   is created.
46               */
47               class PEGASUS_COMMON_LINKAGE HTTPConnector : public MessageQueue
48               {
49               public:
50               
51                   /** Constructor.
52               	@param monitor pointer to monitor object which this class uses to
53               	    solicit SocketMessages on the server port (socket).
54               	@param outputMessageQueue ouptut message queue for connections
55               	    created by this connector.
56                   */
57                   HTTPConnector(Monitor* monitor);
58               
59                   /** Destructor. */
60                   ~HTTPConnector();
61               
62                   /** This method is called whenever a SocketMessage is enqueued
63 mike  1.1.2.1 	on the input queue of the HTTPConnector object.
64                   */ 
65                   virtual void handleEnqueue();
66               

67 mike  1.1.2.3     virtual const char* getQueueName() const;
68               

69 mike  1.1.2.1     /** Establishes a new connection and creates an HTTPConnection object
70               	to represent it.
71               
72               	@param locator indicates which server to connect to (of the form
73               	    host:port).
74               	@param outputMessageQueue output message queue for the HTTPConnection
75               	    that will be created.
76               	@exception InvalidLocator
77               	@exception CannotCreateSocket
78               	@exception CannotConnect
79               	@exception UnexpectedFailure
80                   */

81 mike  1.1.2.2     HTTPConnection* connect(
82               	const String& locator, 
83               	MessageQueue* outputMessageQueue);

84 mike  1.1.2.1 
85                   /** Destroys all the connections created by this connector. */
86                   void destroyConnections();
87               
88               private:
89               
90                   Monitor* _monitor;
91                   HTTPConnectorRep* _rep;
92               };
93               
94               PEGASUS_NAMESPACE_END
95               
96               #endif /* Pegasus_HTTPConnector_h */