/* * Copyright (c) 2014, Peter Thorson. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the WebSocket++ Project nor the * names of its contributors may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL PETER THORSON BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ #ifndef WEBSOCKETPP_CLIENT_ENDPOINT_HPP #define WEBSOCKETPP_CLIENT_ENDPOINT_HPP #include #include #include #include #include namespace websocketpp { /// Client endpoint role based on the given config /** * */ template class client : public endpoint,config> { public: /// Type of this endpoint typedef client type; /// Type of the endpoint concurrency component typedef typename config::concurrency_type concurrency_type; /// Type of the endpoint transport component typedef typename config::transport_type transport_type; /// Type of the connections this server will create typedef connection connection_type; /// Type of a shared pointer to the connections this server will create typedef typename connection_type::ptr connection_ptr; /// Type of the connection transport component typedef typename transport_type::transport_con_type transport_con_type; /// Type of a shared pointer to the connection transport component typedef typename transport_con_type::ptr transport_con_ptr; /// Type of the endpoint component of this server typedef endpoint endpoint_type; friend class connection; explicit client() : endpoint_type(false) { endpoint_type::m_alog.write(log::alevel::devel, "client constructor"); } /// Get a new connection /** * Creates and returns a pointer to a new connection to the given URI * suitable for passing to connect(connection_ptr). This method allows * applying connection specific settings before performing the opening * handshake. * * @param [in] location URI to open the connection to as a uri_ptr * @param [out] ec An status code indicating failure reasons, if any * * @return A connection_ptr to the new connection */ connection_ptr get_connection(uri_ptr location, lib::error_code & ec) { if (location->get_secure() && !transport_type::is_secure()) { ec = error::make_error_code(error::endpoint_not_secure); return connection_ptr(); } connection_ptr con = endpoint_type::create_connection(); if (!con) { ec = error::make_error_code(error::con_creation_failed); return con; } con->set_uri(location); ec = lib::error_code(); return con; } /// Get a new connection (string version) /** * Creates and returns a pointer to a new connection to the given URI * suitable for passing to connect(connection_ptr). This overload allows * default construction of the uri_ptr from a standard string. * * @param [in] u URI to open the connection to as a string * @param [out] ec An status code indicating failure reasons, if any * * @return A connection_ptr to the new connection */ connection_ptr get_connection(std::string const & u, lib::error_code & ec) { uri_ptr location = lib::make_shared(u); if (!location->get_valid()) { ec = error::make_error_code(error::invalid_uri); return connection_ptr(); } return get_connection(location, ec); } /// Begin the connection process for the given connection /** * Initiates the opening connection handshake for connection con. Exact * behavior depends on the underlying transport policy. * * @param con The connection to connect * * @return The pointer to the connection originally passed in. */ connection_ptr connect(connection_ptr con) { // Ask transport to perform a connection transport_type::async_connect( lib::static_pointer_cast(con), con->get_uri(), lib::bind( &type::handle_connect, this, con, lib::placeholders::_1 ) ); return con; } private: // handle_connect void handle_connect(connection_ptr con, lib::error_code const & ec) { if (ec) { con->terminate(ec); endpoint_type::m_elog.write(log::elevel::rerror, "handle_connect error: "+ec.message()); } else { endpoint_type::m_alog.write(log::alevel::connect, "Successful connection"); con->start(); } } }; } // namespace websocketpp #endif //WEBSOCKETPP_CLIENT_ENDPOINT_HPP