endpoint.hpp 5.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  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. #ifndef WEBSOCKETPP_TRANSPORT_STUB_HPP
  28. #define WEBSOCKETPP_TRANSPORT_STUB_HPP
  29. #include <websocketpp/common/memory.hpp>
  30. #include <websocketpp/logger/levels.hpp>
  31. #include <websocketpp/transport/base/endpoint.hpp>
  32. #include <websocketpp/transport/stub/connection.hpp>
  33. namespace websocketpp {
  34. namespace transport {
  35. namespace stub {
  36. template <typename config>
  37. class endpoint {
  38. public:
  39. /// Type of this endpoint transport component
  40. typedef endpoint type;
  41. /// Type of a pointer to this endpoint transport component
  42. typedef lib::shared_ptr<type> ptr;
  43. /// Type of this endpoint's concurrency policy
  44. typedef typename config::concurrency_type concurrency_type;
  45. /// Type of this endpoint's error logging policy
  46. typedef typename config::elog_type elog_type;
  47. /// Type of this endpoint's access logging policy
  48. typedef typename config::alog_type alog_type;
  49. /// Type of this endpoint transport component's associated connection
  50. /// transport component.
  51. typedef stub::connection<config> transport_con_type;
  52. /// Type of a shared pointer to this endpoint transport component's
  53. /// associated connection transport component
  54. typedef typename transport_con_type::ptr transport_con_ptr;
  55. // generate and manage our own io_service
  56. explicit endpoint()
  57. {
  58. //std::cout << "transport::iostream::endpoint constructor" << std::endl;
  59. }
  60. /// Set whether or not endpoint can create secure connections
  61. /**
  62. * TODO: docs
  63. *
  64. * Setting this value only indicates whether or not the endpoint is capable
  65. * of producing and managing secure connections. Connections produced by
  66. * this endpoint must also be individually flagged as secure if they are.
  67. *
  68. * @since 0.3.0-alpha4
  69. *
  70. * @param value Whether or not the endpoint can create secure connections.
  71. */
  72. void set_secure(bool value) {}
  73. /// Tests whether or not the underlying transport is secure
  74. /**
  75. * TODO: docs
  76. *
  77. * @return Whether or not the underlying transport is secure
  78. */
  79. bool is_secure() const {
  80. return false;
  81. }
  82. protected:
  83. /// Initialize logging
  84. /**
  85. * The loggers are located in the main endpoint class. As such, the
  86. * transport doesn't have direct access to them. This method is called
  87. * by the endpoint constructor to allow shared logging from the transport
  88. * component. These are raw pointers to member variables of the endpoint.
  89. * In particular, they cannot be used in the transport constructor as they
  90. * haven't been constructed yet, and cannot be used in the transport
  91. * destructor as they will have been destroyed by then.
  92. *
  93. * @param a A pointer to the access logger to use.
  94. * @param e A pointer to the error logger to use.
  95. */
  96. void init_logging(alog_type * a, elog_type * e) {}
  97. /// Initiate a new connection
  98. /**
  99. * @param tcon A pointer to the transport connection component of the
  100. * connection to connect.
  101. * @param u A URI pointer to the URI to connect to.
  102. * @param cb The function to call back with the results when complete.
  103. */
  104. void async_connect(transport_con_ptr tcon, uri_ptr u, connect_handler cb) {
  105. cb(make_error_code(error::not_implemented));
  106. }
  107. /// Initialize a connection
  108. /**
  109. * Init is called by an endpoint once for each newly created connection.
  110. * It's purpose is to give the transport policy the chance to perform any
  111. * transport specific initialization that couldn't be done via the default
  112. * constructor.
  113. *
  114. * @param tcon A pointer to the transport portion of the connection.
  115. * @return A status code indicating the success or failure of the operation
  116. */
  117. lib::error_code init(transport_con_ptr tcon) {
  118. return make_error_code(error::not_implemented);
  119. }
  120. private:
  121. };
  122. } // namespace stub
  123. } // namespace transport
  124. } // namespace websocketpp
  125. #endif // WEBSOCKETPP_TRANSPORT_STUB_HPP