WebSocket++  0.8.0-dev
C++ websocket client/server library
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Pages
client_endpoint.hpp
1 /*
2  * Copyright (c) 2014, Peter Thorson. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  * * Redistributions of source code must retain the above copyright
7  * notice, this list of conditions and the following disclaimer.
8  * * Redistributions in binary form must reproduce the above copyright
9  * notice, this list of conditions and the following disclaimer in the
10  * documentation and/or other materials provided with the distribution.
11  * * Neither the name of the WebSocket++ Project nor the
12  * names of its contributors may be used to endorse or promote products
13  * derived from this software without specific prior written permission.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY
19  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
22  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
24  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  */
27 
28 #ifndef WEBSOCKETPP_CLIENT_ENDPOINT_HPP
29 #define WEBSOCKETPP_CLIENT_ENDPOINT_HPP
30 
31 #include <websocketpp/endpoint.hpp>
32 #include <websocketpp/uri.hpp>
33 
34 #include <websocketpp/logger/levels.hpp>
35 
36 #include <websocketpp/common/system_error.hpp>
37 
38 #include <string>
39 
40 namespace websocketpp {
41 
42 /// Client endpoint role based on the given config
43 /**
44  *
45  */
46 template <typename config>
47 class client : public endpoint<connection<config>,config> {
48 public:
49  /// Type of this endpoint
50  typedef client<config> type;
51 
52  /// Type of the endpoint concurrency component
54  /// Type of the endpoint transport component
56 
57  /// Type of the connections this server will create
59  /// Type of a shared pointer to the connections this server will create
60  typedef typename connection_type::ptr connection_ptr;
61 
62  /// Type of the connection transport component
64  /// Type of a shared pointer to the connection transport component
66 
67  /// Type of the endpoint component of this server
69 
70  friend class connection<config>;
71 
72  explicit client() : endpoint_type(false)
73  {
74  endpoint_type::m_alog->write(log::alevel::devel, "client constructor");
75  }
76 
77  /// Get a new connection
78  /**
79  * Creates and returns a pointer to a new connection to the given URI
80  * suitable for passing to connect(connection_ptr). This method allows
81  * applying connection specific settings before performing the opening
82  * handshake.
83  *
84  * @param [in] location URI to open the connection to as a uri_ptr
85  * @param [out] ec An status code indicating failure reasons, if any
86  *
87  * @return A connection_ptr to the new connection
88  */
92  return connection_ptr();
93  }
94 
96 
97  if (!con) {
99  return con;
100  }
101 
102  con->set_uri(location);
103 
104  ec = lib::error_code();
105  return con;
106  }
107 
108  /// Get a new connection (string version)
109  /**
110  * Creates and returns a pointer to a new connection to the given URI
111  * suitable for passing to connect(connection_ptr). This overload allows
112  * default construction of the uri_ptr from a standard string.
113  *
114  * @param [in] u URI to open the connection to as a string
115  * @param [out] ec An status code indicating failure reasons, if any
116  *
117  * @return A connection_ptr to the new connection
118  */
121 
122  if (!location->get_valid()) {
124  return connection_ptr();
125  }
126 
127  return get_connection(location, ec);
128  }
129 
130  /// Begin the connection process for the given connection
131  /**
132  * Initiates the opening connection handshake for connection con. Exact
133  * behavior depends on the underlying transport policy.
134  *
135  * @param con The connection to connect
136  *
137  * @return The pointer to the connection originally passed in.
138  */
140  // Ask transport to perform a connection
143  con->get_uri(),
144  lib::bind(
146  this,
147  con,
149  )
150  );
151 
152  return con;
153  }
154 private:
155  // handle_connect
157  if (ec) {
158  con->terminate(ec);
159 
161  "handle_connect error: "+ec.message());
162  } else {
164  "Successful connection");
165 
166  con->start();
167  }
168  }
169 };
170 
171 } // namespace websocketpp
172 
173 #endif //WEBSOCKETPP_CLIENT_ENDPOINT_HPP
Client endpoint role based on the given config.
void handle_accept(connection_ptr con, lib::error_code const &ec)
Handler callback for start_accept.