126 lines
3.3 KiB
C++
126 lines
3.3 KiB
C++
#ifndef __Session_h__
|
|
#define __Session_h__
|
|
|
|
#include "TCPSocket.h"
|
|
#include "SessionFilter.h"
|
|
|
|
namespace core {
|
|
|
|
class Command;
|
|
|
|
class TCPServer;
|
|
|
|
///
|
|
/// TCPSession
|
|
///
|
|
/// TCPSession defines the nature of the interaction with the client
|
|
/// and stores persistent data for a defined session. BMASession objects
|
|
/// are not sockets but instead provide a communications control
|
|
/// mechanism. Protocol conversations are provided through extensions
|
|
/// from this object.
|
|
///
|
|
|
|
class TCPSession : public TCPSocket {
|
|
|
|
public:
|
|
TCPSession(EPoll &ePoll, TCPServer &server, std::string text = "");
|
|
~TCPSession();
|
|
|
|
Command *grab = NULL;
|
|
|
|
virtual void output(std::stringstream &data);
|
|
|
|
///
|
|
/// Use out to send data to the session socket or other session sockets.
|
|
///
|
|
|
|
std::stringstream out;
|
|
|
|
///
|
|
/// The send method is used to output the contents of the out stream
|
|
/// to the session containing the stream.
|
|
///
|
|
|
|
void send();
|
|
|
|
///
|
|
/// Use this sendToAll method to output the contents of the out stream
|
|
/// to all the connections on the server excluding the sender session.
|
|
///
|
|
|
|
void sendToAll();
|
|
|
|
///
|
|
/// Use this sendToAll method to output the contents of the out stream
|
|
/// to all the connections on the server excluding the sender session
|
|
/// and the entries identified by the passed in filter object.
|
|
///
|
|
|
|
void sendToAll(SessionFilter filter);
|
|
|
|
///
|
|
///
|
|
///
|
|
|
|
void terminate();
|
|
|
|
///
|
|
///
|
|
///
|
|
|
|
TCPServer &server;
|
|
|
|
protected:
|
|
|
|
///
|
|
///
|
|
///
|
|
|
|
virtual void onRegistered() override;
|
|
|
|
///
|
|
/// Override this method to receive data directly from the socket as data is
|
|
/// received. If you need data split by line termination characters then
|
|
/// override the onLineReceived method instead.
|
|
///
|
|
|
|
virtual void onDataReceived(char *data, int len) override;
|
|
|
|
///
|
|
/// Override the onLineReceived method to receive a string of characters that
|
|
/// represents a single line of data terminated by a LF or CRLF. If onDataReceived
|
|
/// was overriden this method will not be called unless the onDataReceived calls
|
|
/// this method explicitly using the class and member name.
|
|
///
|
|
|
|
virtual void onLineReceived(std::string line);
|
|
|
|
///
|
|
/// This method is called from within the protocol method when protocol is called
|
|
/// on the initial connection where the data is an empty string. Use this method
|
|
/// to deliver a message to the connection upon connection.
|
|
///
|
|
|
|
virtual void onConnected();
|
|
|
|
///
|
|
/// Override the protocol method to manage and control the session communications
|
|
/// in your inherited session. If you do not override this method then the Session
|
|
/// default will process the 'commands' added to the server object using the
|
|
/// processRequest method on the session input.
|
|
///
|
|
|
|
virtual void protocol(std::string data);
|
|
|
|
private:
|
|
char *lineBuffer = NULL;
|
|
int lineBufferSize = 0;
|
|
std::mutex mtx;
|
|
bool term = false;
|
|
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|