mirror of
https://github.com/XRPLF/rippled.git
synced 2025-11-19 10:35:50 +00:00
1506e65558
This updates Boost to 1.88, which is needed because Clio wants to move to 1.88 as that fixes several ASAN false positives around coroutine usage. In order for Clio to move to newer boost, libXRPL needs to move too. Hence the changes in this PR. A lot has changed between 1.83 and 1.88 so there are lots of changes in the diff, especially in regards to Boost.Asio and coroutines in particular.
136 lines
4.2 KiB
C++
136 lines
4.2 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2012, 2013 Ripple Labs Inc.
|
|
|
|
Permission to use, copy, modify, and/or distribute this software for any
|
|
purpose with or without fee is hereby granted, provided that the above
|
|
copyright notice and this permission notice appear in all copies.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#ifndef RIPPLE_SERVER_SESSION_H_INCLUDED
|
|
#define RIPPLE_SERVER_SESSION_H_INCLUDED
|
|
|
|
#include <xrpl/beast/net/IPEndpoint.h>
|
|
#include <xrpl/beast/utility/Journal.h>
|
|
#include <xrpl/server/WSSession.h>
|
|
#include <xrpl/server/Writer.h>
|
|
|
|
#include <boost/beast/http/message.hpp>
|
|
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <ostream>
|
|
#include <vector>
|
|
|
|
namespace ripple {
|
|
|
|
/** Persistent state information for a connection session.
|
|
These values are preserved between calls for efficiency.
|
|
Some fields are input parameters, some are output parameters,
|
|
and all only become defined during specific callbacks.
|
|
*/
|
|
class Session
|
|
{
|
|
public:
|
|
Session() = default;
|
|
Session(Session const&) = delete;
|
|
Session&
|
|
operator=(Session const&) = delete;
|
|
virtual ~Session() = default;
|
|
|
|
/** A user-definable pointer.
|
|
The initial value is always zero.
|
|
Changes to the value are persisted between calls.
|
|
*/
|
|
void* tag = nullptr;
|
|
|
|
/** Returns the Journal to use for logging. */
|
|
virtual beast::Journal
|
|
journal() = 0;
|
|
|
|
/** Returns the Port settings for this connection. */
|
|
virtual Port const&
|
|
port() = 0;
|
|
|
|
/** Returns the remote address of the connection. */
|
|
virtual beast::IP::Endpoint
|
|
remoteAddress() = 0;
|
|
|
|
/** Returns the current HTTP request. */
|
|
virtual http_request_type&
|
|
request() = 0;
|
|
|
|
/** Send a copy of data asynchronously. */
|
|
/** @{ */
|
|
void
|
|
write(std::string const& s)
|
|
{
|
|
if (!s.empty())
|
|
write(&s[0], std::distance(s.begin(), s.end()));
|
|
}
|
|
|
|
template <typename BufferSequence>
|
|
void
|
|
write(BufferSequence const& buffers)
|
|
{
|
|
for (typename BufferSequence::const_iterator iter(buffers.begin());
|
|
iter != buffers.end();
|
|
++iter)
|
|
{
|
|
typename BufferSequence::value_type const& buffer(*iter);
|
|
write(buffer.data(), boost::asio::buffer_size(buffer));
|
|
}
|
|
}
|
|
|
|
virtual void
|
|
write(void const* buffer, std::size_t bytes) = 0;
|
|
|
|
virtual void
|
|
write(std::shared_ptr<Writer> const& writer, bool keep_alive) = 0;
|
|
|
|
/** @} */
|
|
|
|
/** Detach the session.
|
|
This holds the session open so that the response can be sent
|
|
asynchronously. Calls to io_context::run made by the server
|
|
will not return until all detached sessions are closed.
|
|
*/
|
|
virtual std::shared_ptr<Session>
|
|
detach() = 0;
|
|
|
|
/** Indicate that the response is complete.
|
|
The handler should call this when it has completed writing
|
|
the response. If Keep-Alive is indicated on the connection,
|
|
this will trigger a read for the next request; else, the
|
|
connection will be closed when all remaining data has been sent.
|
|
*/
|
|
virtual void
|
|
complete() = 0;
|
|
|
|
/** Close the session.
|
|
This will be performed asynchronously. The session will be
|
|
closed gracefully after all pending writes have completed.
|
|
@param graceful `true` to wait until all data has finished sending.
|
|
*/
|
|
virtual void
|
|
close(bool graceful) = 0;
|
|
|
|
/** Convert the connection to WebSocket. */
|
|
virtual std::shared_ptr<WSSession>
|
|
websocketUpgrade() = 0;
|
|
};
|
|
|
|
} // namespace ripple
|
|
|
|
#endif
|