rippled
HTTPStream.h
1 //------------------------------------------------------------------------------
2 /*
3  This file is part of rippled: https://github.com/ripple/rippled
4  Copyright (c) 2020 Ripple Labs Inc.
5 
6  Permission to use, copy, modify, and/or distribute this software for any
7  purpose with or without fee is hereby granted, provided that the above
8  copyright notice and this permission notice appear in all copies.
9 
10  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13  ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 */
18 //==============================================================================
19 
20 #ifndef RIPPLE_NET_HTTPSTREAM_H_INCLUDED
21 #define RIPPLE_NET_HTTPSTREAM_H_INCLUDED
22 
23 #include <ripple/core/Config.h>
24 #include <ripple/net/HTTPClientSSLContext.h>
25 
26 #include <boost/asio/spawn.hpp>
27 #include <boost/asio/strand.hpp>
28 #include <boost/beast/core.hpp>
29 #include <boost/beast/http.hpp>
30 
31 namespace ripple {
32 
34 {
35 public:
36  using request = boost::beast::http::request<boost::beast::http::empty_body>;
37  using parser = boost::beast::http::basic_parser<false>;
38 
39  virtual ~HTTPStream() = default;
40 
41  template <class T>
44  Config const& config,
45  boost::asio::io_service::strand& strand,
47  {
48  return std::make_unique<T>(config, strand, j);
49  }
50 
51  [[nodiscard]] virtual boost::asio::ip::tcp::socket&
52  getStream() = 0;
53 
54  [[nodiscard]] virtual bool
55  connect(
56  std::string& errorOut,
57  std::string const host,
58  std::string const port,
59  boost::asio::yield_context& yield) = 0;
60 
61  virtual void
62  asyncWrite(
63  request& req,
64  boost::asio::yield_context& yield,
65  boost::system::error_code& ec) = 0;
66 
67  virtual void
68  asyncRead(
69  boost::beast::flat_buffer& buf,
70  parser& p,
71  bool readSome,
72  boost::asio::yield_context& yield,
73  boost::system::error_code& ec) = 0;
74 };
75 
76 class SSLStream : public HTTPStream
77 {
78 public:
79  SSLStream(
80  Config const& config,
81  boost::asio::io_service::strand& strand,
82  beast::Journal j);
83 
84  virtual ~SSLStream() = default;
85 
86  boost::asio::ip::tcp::socket&
87  getStream() override;
88 
89  bool
90  connect(
91  std::string& errorOut,
92  std::string const host,
93  std::string const port,
94  boost::asio::yield_context& yield) override;
95 
96  void
97  asyncWrite(
98  request& req,
99  boost::asio::yield_context& yield,
100  boost::system::error_code& ec) override;
101 
102  void
103  asyncRead(
104  boost::beast::flat_buffer& buf,
105  parser& p,
106  bool readSome,
107  boost::asio::yield_context& yield,
108  boost::system::error_code& ec) override;
109 
110 private:
112  boost::optional<boost::asio::ssl::stream<boost::asio::ip::tcp::socket>>
114  boost::asio::io_service::strand& strand_;
115 };
116 
117 class RawStream : public HTTPStream
118 {
119 public:
120  RawStream(
121  Config const& config,
122  boost::asio::io_service::strand& strand,
123  beast::Journal j);
124 
125  virtual ~RawStream() = default;
126 
127  boost::asio::ip::tcp::socket&
128  getStream() override;
129 
130  bool
131  connect(
132  std::string& errorOut,
133  std::string const host,
134  std::string const port,
135  boost::asio::yield_context& yield) override;
136 
137  void
138  asyncWrite(
139  request& req,
140  boost::asio::yield_context& yield,
141  boost::system::error_code& ec) override;
142 
143  void
144  asyncRead(
145  boost::beast::flat_buffer& buf,
146  parser& p,
147  bool readSome,
148  boost::asio::yield_context& yield,
149  boost::system::error_code& ec) override;
150 
151 private:
152  boost::optional<boost::asio::ip::tcp::socket> stream_;
153  boost::asio::io_service::strand& strand_;
154 };
155 
156 } // namespace ripple
157 
158 #endif // RIPPLE_NET_HTTPSTREAM_H
std::string
STL class.
ripple::HTTPStream::makeUnique
static std::unique_ptr< HTTPStream > makeUnique(Config const &config, boost::asio::io_service::strand &strand, beast::Journal j)
Definition: HTTPStream.h:43
ripple::HTTPStream
Definition: HTTPStream.h:33
ripple::RawStream::asyncWrite
void asyncWrite(request &req, boost::asio::yield_context &yield, boost::system::error_code &ec) override
Definition: HTTPStream.cpp:169
ripple::SSLStream::~SSLStream
virtual ~SSLStream()=default
ripple::SSLStream::getStream
boost::asio::ip::tcp::socket & getStream() override
Definition: HTTPStream.cpp:34
ripple::RawStream::RawStream
RawStream(Config const &config, boost::asio::io_service::strand &strand, beast::Journal j)
Definition: HTTPStream.cpp:114
ripple::SSLStream::stream_
boost::optional< boost::asio::ssl::stream< boost::asio::ip::tcp::socket > > stream_
Definition: HTTPStream.h:113
ripple::HTTPStream::parser
boost::beast::http::basic_parser< false > parser
Definition: HTTPStream.h:37
ripple::HTTPStream::getStream
virtual boost::asio::ip::tcp::socket & getStream()=0
ripple::RawStream
Definition: HTTPStream.h:117
ripple::RawStream::getStream
boost::asio::ip::tcp::socket & getStream() override
Definition: HTTPStream.cpp:123
ripple::HTTPStream::~HTTPStream
virtual ~HTTPStream()=default
ripple::RawStream::asyncRead
void asyncRead(boost::beast::flat_buffer &buf, parser &p, bool readSome, boost::asio::yield_context &yield, boost::system::error_code &ec) override
Definition: HTTPStream.cpp:178
ripple::HTTPStream::connect
virtual bool connect(std::string &errorOut, std::string const host, std::string const port, boost::asio::yield_context &yield)=0
ripple::SSLStream::asyncWrite
void asyncWrite(request &req, boost::asio::yield_context &yield, boost::system::error_code &ec) override
Definition: HTTPStream.cpp:92
ripple::Config
Definition: Config.h:67
ripple::RawStream::connect
bool connect(std::string &errorOut, std::string const host, std::string const port, boost::asio::yield_context &yield) override
Definition: HTTPStream.cpp:130
ripple::SSLStream::asyncRead
void asyncRead(boost::beast::flat_buffer &buf, parser &p, bool readSome, boost::asio::yield_context &yield, boost::system::error_code &ec) override
Definition: HTTPStream.cpp:101
ripple::RawStream::strand_
boost::asio::io_service::strand & strand_
Definition: HTTPStream.h:153
beast::Journal
A generic endpoint for log messages.
Definition: Journal.h:58
ripple::SSLStream
Definition: HTTPStream.h:76
ripple::HTTPStream::asyncWrite
virtual void asyncWrite(request &req, boost::asio::yield_context &yield, boost::system::error_code &ec)=0
ripple::RawStream::stream_
boost::optional< boost::asio::ip::tcp::socket > stream_
Definition: HTTPStream.h:152
ripple::SSLStream::strand_
boost::asio::io_service::strand & strand_
Definition: HTTPStream.h:114
ripple::HTTPClientSSLContext
Definition: HTTPClientSSLContext.h:34
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: RCLCensorshipDetector.h:29
ripple::SSLStream::SSLStream
SSLStream(Config const &config, boost::asio::io_service::strand &strand, beast::Journal j)
Definition: HTTPStream.cpp:24
ripple::RawStream::~RawStream
virtual ~RawStream()=default
ripple::SSLStream::ssl_ctx_
HTTPClientSSLContext ssl_ctx_
Definition: HTTPStream.h:111
ripple::SSLStream::connect
bool connect(std::string &errorOut, std::string const host, std::string const port, boost::asio::yield_context &yield) override
Definition: HTTPStream.cpp:41
ripple::HTTPStream::asyncRead
virtual void asyncRead(boost::beast::flat_buffer &buf, parser &p, bool readSome, boost::asio::yield_context &yield, boost::system::error_code &ec)=0
std::unique_ptr
STL class.
ripple::HTTPStream::request
boost::beast::http::request< boost::beast::http::empty_body > request
Definition: HTTPStream.h:36