#pragma once

#ifndef THIS_SESSION_H_HTS95N7G
#define THIS_SESSION_H_HTS95N7G

#include <atomic>
#include "rpc/config.h"

namespace rpc {

namespace detail {
class server_session;
}

//! \brief Encapsulates information about the server session/connection
//! this handler is running in. This is the interface through which bound
//! functions may interact with the session.
//! \note Accessing the this_session() object is thread safe, but incurs some
//! syncrhonization cost in the form of atomic flags. (usually not a concern)
class this_session_t {
public:
    //! \brief Gracefully exits the session (i.e. ongoing writes and reads are
    //! completed; queued writes and reads are not).
    //! \note Use this function if you need to close the connection from a
    //! handler.
    void post_exit();

    //! \brief Returns an ID that uniquely identifies a session. 
    //! \note This is not an ID for the client. If the client disconnects
    //! and reconnects, this ID may change. That being said, you can
    //! use this ID to store client-specific information *for the duration
    //! of the session.
    session_id_t id() const;

    friend class rpc::detail::server_session;

private:
    void clear();
    void set_id(session_id_t value);

    std::atomic_bool exit_{false};
    session_id_t id_{0};
};

//! \brief A thread-local object that can be used to control the currently
//! active server session.
//! \note Accessing this object outside of handlers while a server is
//! running is potentially unsafe.
this_session_t &this_session();

} /* rpc */

#endif /* end of include guard: THIS_SESSION_H_HTS95N7G */
