#include <api_server.h>

Inheritance diagram for KICAD_API_SERVER:

Public Member Functions
	KICAD_API_SERVER (bool aAutoStart=true)

	~KICAD_API_SERVER ()

void	Start ()

void	Stop ()

bool	Running () const

void	RegisterHandler (API_HANDLER *aHandler)
	Adds a new request handler to the server.

void	DeregisterHandler (API_HANDLER *aHandler)

void	SetReadyToReply (bool aReady=true)

void	SetSocketPath (const wxString &aSocketPath)

std::string	SocketPath () const

const std::string &	Token () const

Private Member Functions
void	onApiRequest (std::string *aRequest)
	Callback that executes on the server thread and generates an event that will be handled by the wxWidgets event loop to process an incoming request.

void	handleApiEvent (wxCommandEvent &aEvent)
	Event handler that receives the event on the main thread sent by onApiRequest.

void	handleApiRequestString (std::string &aRequestString)

void	log (const std::string &aOutput)

Private Attributes
std::unique_ptr< KINNG_REQUEST_SERVER >	m_server

std::set< API_HANDLER * >	m_handlers

std::string	m_token

bool	m_readyToReply

wxString	m_socketPathOverride

wxFileName	m_logFilePath

Static Private Attributes
static wxString	s_logFileName = "api.log"

Detailed Description

Definition at line 41 of file api_server.h.

Constructor & Destructor Documentation

◆ KICAD_API_SERVER()

KICAD_API_SERVER::KICAD_API_SERVER ( bool aAutoStart = true )

Definition at line 53 of file api_server.cpp.

References m_readyToReply, m_token, Pgm(), and Start().

◆ ~KICAD_API_SERVER()

KICAD_API_SERVER::~KICAD_API_SERVER ( )

Definition at line 71 of file api_server.cpp.

References Stop().

Member Function Documentation

◆ DeregisterHandler()

void KICAD_API_SERVER::DeregisterHandler ( API_HANDLER * aHandler )

Definition at line 192 of file api_server.cpp.

References m_handlers.

◆ handleApiEvent()

void KICAD_API_SERVER::handleApiEvent ( wxCommandEvent & aEvent )

private

Event handler that receives the event on the main thread sent by onApiRequest.

Parameters

aEvent will contain a pointer to an incoming API request string in the client data

Definition at line 226 of file api_server.cpp.

References handleApiRequestString().

Referenced by Start(), and Stop().

◆ handleApiRequestString()

void KICAD_API_SERVER::handleApiRequestString ( std::string & aRequestString )

private

Definition at line 233 of file api_server.cpp.

References ADVANCED_CFG::GetCfg(), log(), m_handlers, m_server, m_token, and result.

Referenced by handleApiEvent().

◆ log()

void KICAD_API_SERVER::log ( const std::string & aOutput )

private

Definition at line 314 of file api_server.cpp.

References m_logFilePath, and TO_UTF8.

Referenced by handleApiRequestString(), onApiRequest(), and Start().

◆ onApiRequest()

void KICAD_API_SERVER::onApiRequest ( std::string * aRequest )

private

Callback that executes on the server thread and generates an event that will be handled by the wxWidgets event loop to process an incoming request.

Temporarily takes ownership of the request pointer so that it can be passed through the event system.

Parameters

aRequest is a pointer to a string containing bytes that came in over the wire

Definition at line 204 of file api_server.cpp.

References log(), m_readyToReply, and m_server.

Referenced by Start().

◆ RegisterHandler()

void KICAD_API_SERVER::RegisterHandler ( API_HANDLER * aHandler )

Adds a new request handler to the server.

Each handler maintains its own list of API messages that it knows how to handle, and the server will pass every incoming message to all handlers in succession until one of them handles it.

The caller is responsible for the lifetime of the handler and must call DeregisterHandler before the pointer is freed.

Parameters

aHandler is a pointer (non-owned) to API_HANDLER

Definition at line 185 of file api_server.cpp.

References m_handlers.

◆ Running()

bool KICAD_API_SERVER::Running ( ) const

Definition at line 179 of file api_server.cpp.

References m_server.

Referenced by Start(), and Stop().

◆ SetReadyToReply()

void KICAD_API_SERVER::SetReadyToReply ( bool aReady = true )

inline

Definition at line 68 of file api_server.h.

References m_readyToReply.

◆ SetSocketPath()

void KICAD_API_SERVER::SetSocketPath ( const wxString & aSocketPath )

inline

Definition at line 70 of file api_server.h.

References m_socketPathOverride.

◆ SocketPath()

std::string KICAD_API_SERVER::SocketPath ( ) const

Definition at line 198 of file api_server.cpp.

References m_server.

Referenced by Start().

◆ Start()

void KICAD_API_SERVER::Start ( )

Definition at line 77 of file api_server.cpp.

References PATHS::EnsurePathExists(), ADVANCED_CFG::GetCfg(), PATHS::GetLogsPath(), handleApiEvent(), log(), m_logFilePath, m_server, m_socketPathOverride, onApiRequest(), Running(), s_logFileName, SocketPath(), and traceApi.

Referenced by KICAD_API_SERVER().

◆ Stop()

void KICAD_API_SERVER::Stop ( )

Definition at line 166 of file api_server.cpp.

References handleApiEvent(), m_server, Running(), and traceApi.

Referenced by ~KICAD_API_SERVER().

◆ Token()

const std::string & KICAD_API_SERVER::Token ( ) const

inline

Definition at line 77 of file api_server.h.

References m_token.

Member Data Documentation

◆ m_handlers

std::set<API_HANDLER*> KICAD_API_SERVER::m_handlers

private

Definition at line 102 of file api_server.h.

Referenced by DeregisterHandler(), handleApiRequestString(), and RegisterHandler().

◆ m_logFilePath

wxFileName KICAD_API_SERVER::m_logFilePath

private

Definition at line 112 of file api_server.h.

Referenced by log(), and Start().

◆ m_readyToReply

bool KICAD_API_SERVER::m_readyToReply

private

Definition at line 106 of file api_server.h.

Referenced by KICAD_API_SERVER(), onApiRequest(), and SetReadyToReply().

◆ m_server

std::unique_ptr<KINNG_REQUEST_SERVER> KICAD_API_SERVER::m_server

private

Definition at line 100 of file api_server.h.

Referenced by handleApiRequestString(), onApiRequest(), Running(), SocketPath(), Start(), and Stop().

◆ m_socketPathOverride

wxString KICAD_API_SERVER::m_socketPathOverride

private

Definition at line 108 of file api_server.h.

Referenced by SetSocketPath(), and Start().

◆ m_token

std::string KICAD_API_SERVER::m_token

private

Definition at line 104 of file api_server.h.

Referenced by handleApiRequestString(), KICAD_API_SERVER(), and Token().

◆ s_logFileName

wxString KICAD_API_SERVER::s_logFileName = "api.log"

staticprivate

Definition at line 110 of file api_server.h.

Referenced by Start().

The documentation for this class was generated from the following files:

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ KICAD_API_SERVER()

◆ ~KICAD_API_SERVER()

Member Function Documentation

◆ DeregisterHandler()

◆ handleApiEvent()

◆ handleApiRequestString()

◆ log()

◆ onApiRequest()

◆ RegisterHandler()

◆ Running()

◆ SetReadyToReply()

◆ SetSocketPath()

◆ SocketPath()

◆ Start()

◆ Stop()

◆ Token()

Member Data Documentation

◆ m_handlers

◆ m_logFilePath

◆ m_readyToReply

◆ m_server

◆ m_socketPathOverride

◆ m_token

◆ s_logFileName