eric7/Documentation/Source/eric7.EricNetwork.EricJsonServer.html

<!DOCTYPE html>
<html><head>
<title>eric7.EricNetwork.EricJsonServer</title>
<meta charset="UTF-8">
<style>
body {
    background: #EDECE6;
    margin: 0em 1em 10em 1em;
    color: black;
}

h1 { color: white; background: #85774A; }
h2 { color: white; background: #85774A; }
h3 { color: white; background: #9D936E; }
h4 { color: white; background: #9D936E; }
    
a { color: #BA6D36; }

</style>
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.EricNetwork.EricJsonServer</h1>

<p>
Module implementing the JSON based server base class.
</p>
<h3>Global Attributes</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>

<table>

<tr>
<td><a href="#EricJsonServer">EricJsonServer</a></td>
<td>Class implementing a JSON based server base class.</td>
</tr>
</table>
<h3>Functions</h3>

<table>
<tr><td>None</td></tr>
</table>
<hr />
<hr />
<a NAME="EricJsonServer" ID="EricJsonServer"></a>
<h2>EricJsonServer</h2>

<p>
    Class implementing a JSON based server base class.
</p>
<h3>Derived from</h3>
QTcpServer
<h3>Class Attributes</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Class Methods</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>

<table>

<tr>
<td><a href="#EricJsonServer.__init__">EricJsonServer</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#EricJsonServer.__handleDisconnect">__handleDisconnect</a></td>
<td>Private slot handling a disconnect of the client.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.__receiveJson">__receiveJson</a></td>
<td>Private slot handling received data from the client.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.connectionNames">connectionNames</a></td>
<td>Public method to get the list of active connection names.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.handleCall">handleCall</a></td>
<td>Public method to handle a method call from the client.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.handleNewConnection">handleNewConnection</a></td>
<td>Public slot for new incoming connections from a client.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.sendJson">sendJson</a></td>
<td>Public method to send a single command to a client.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.startClient">startClient</a></td>
<td>Public method to start a client process.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.stopAllClients">stopAllClients</a></td>
<td>Public method to stop all clients.</td>
</tr>
<tr>
<td><a href="#EricJsonServer.stopClient">stopClient</a></td>
<td>Public method to stop a client process.</td>
</tr>
</table>
<h3>Static Methods</h3>

<table>
<tr><td>None</td></tr>
</table>

<a NAME="EricJsonServer.__init__" ID="EricJsonServer.__init__"></a>
<h4>EricJsonServer (Constructor)</h4>
<b>EricJsonServer</b>(<i>name="", multiplex=False, parent=None</i>)

<p>
        Constructor
</p>
<dl>

<dt><i>name</i> (str)</dt>
<dd>
name of the server (used for output only)
</dd>
<dt><i>multiplex</i> (bool)</dt>
<dd>
flag indicating a multiplexing server
</dd>
<dt><i>parent</i> (QObject)</dt>
<dd>
parent object
</dd>
</dl>
<a NAME="EricJsonServer.__handleDisconnect" ID="EricJsonServer.__handleDisconnect"></a>
<h4>EricJsonServer.__handleDisconnect</h4>
<b>__handleDisconnect</b>(<i>idString</i>)

<p>
        Private slot handling a disconnect of the client.
</p>
<dl>

<dt><i>idString</i> (str)</dt>
<dd>
id of the connection been disconnected
</dd>
</dl>
<a NAME="EricJsonServer.__receiveJson" ID="EricJsonServer.__receiveJson"></a>
<h4>EricJsonServer.__receiveJson</h4>
<b>__receiveJson</b>(<i>idString</i>)

<p>
        Private slot handling received data from the client.
</p>
<dl>

<dt><i>idString</i> (str)</dt>
<dd>
id of the connection been disconnected
</dd>
</dl>
<a NAME="EricJsonServer.connectionNames" ID="EricJsonServer.connectionNames"></a>
<h4>EricJsonServer.connectionNames</h4>
<b>connectionNames</b>(<i></i>)

<p>
        Public method to get the list of active connection names.
</p>
<p>
        If this is not a multiplexing server, an empty list is returned.
</p>
<dl>
<dt>Return:</dt>
<dd>
list of active connection names
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
list of str
</dd>
</dl>
<a NAME="EricJsonServer.handleCall" ID="EricJsonServer.handleCall"></a>
<h4>EricJsonServer.handleCall</h4>
<b>handleCall</b>(<i>method, params</i>)

<p>
        Public method to handle a method call from the client.
</p>
<p>
        Note: This is an empty implementation that must be overridden in
        derived classes.
</p>
<dl>

<dt><i>method</i> (str)</dt>
<dd>
requested method name
</dd>
<dt><i>params</i> (dict)</dt>
<dd>
dictionary with method specific parameters
</dd>
</dl>
<a NAME="EricJsonServer.handleNewConnection" ID="EricJsonServer.handleNewConnection"></a>
<h4>EricJsonServer.handleNewConnection</h4>
<b>handleNewConnection</b>(<i></i>)

<p>
        Public slot for new incoming connections from a client.
</p>
<a NAME="EricJsonServer.sendJson" ID="EricJsonServer.sendJson"></a>
<h4>EricJsonServer.sendJson</h4>
<b>sendJson</b>(<i>command, params, flush=False, idString=""</i>)

<p>
        Public method to send a single command to a client.
</p>
<dl>

<dt><i>command</i> (str)</dt>
<dd>
command name to be sent
</dd>
<dt><i>params</i> (dict)</dt>
<dd>
dictionary of named parameters for the command
</dd>
<dt><i>flush</i> (bool)</dt>
<dd>
flag indicating to flush the data to the socket
</dd>
<dt><i>idString</i> (str)</dt>
<dd>
id of the connection to send data to
</dd>
</dl>
<a NAME="EricJsonServer.startClient" ID="EricJsonServer.startClient"></a>
<h4>EricJsonServer.startClient</h4>
<b>startClient</b>(<i>interpreter, clientScript, clientArgs, idString="", environment=None</i>)

<p>
        Public method to start a client process.
</p>
<dl>

<dt><i>interpreter</i> (str)</dt>
<dd>
interpreter to be used for the client
</dd>
<dt><i>clientScript</i> (str)</dt>
<dd>
path to the client script
</dd>
<dt><i>clientArgs</i></dt>
<dd>
list of arguments for the client
</dd>
<dt><i>idString</i> (str)</dt>
<dd>
id of the client to be started
</dd>
<dt><i>environment</i> (dict)</dt>
<dd>
dictionary of environment settings to pass
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating a successful client start and the exit code
            in case of an issue
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
bool, int
</dd>
</dl>
<a NAME="EricJsonServer.stopAllClients" ID="EricJsonServer.stopAllClients"></a>
<h4>EricJsonServer.stopAllClients</h4>
<b>stopAllClients</b>(<i></i>)

<p>
        Public method to stop all clients.
</p>
<a NAME="EricJsonServer.stopClient" ID="EricJsonServer.stopClient"></a>
<h4>EricJsonServer.stopClient</h4>
<b>stopClient</b>(<i>idString=""</i>)

<p>
        Public method to stop a client process.
</p>
<dl>

<dt><i>idString</i> (str)</dt>
<dd>
id of the client to be stopped
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>