Servoy 2020 Documentation
Child pages
  • clientmanager
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Refresh page Apr 29, 2024 12:51

 

 

Supported Clients

SmartClient WebClient NGClient

 

 

Methods Summary
Broadcaster getBroadcaster(name, channelName, callback) Get a broadcast object giving it a (nick)name and on a specific channel, the callback is used for getting messages of other clients on that channel The function gets 2 arguments (nickName, message)
JSClientInformation getClientInformation() Returns the current client JSClientInformation object.
Array getConnectedClients() Returns an array of JSClientInformation elements describing the clients connected to the server.
Array getConnectedClients(clientInfoFilter) /* Returns an array of JSClientInformation elements describing the clients connected to the server filtered by the a client info string.
Boolean isInMaintenanceMode() Returns true if the server is in maintenance mode, false otherwise.
void sendMessageToAllClients(message) Sends a message to all connected clients.
void sendMessageToClient(clientId, message) Sends a message to a specific client, identified by its clientId.
void shutDownAllClients() Shuts down all connected clients.
void shutDownClient(clientId) Shuts down a specific client, identified by its clientId.

 

 

Methods Details

getBroadcaster(name, channelName, callback)

 
Get a broadcast object giving it a (nick)name and on a specific channel, the callback is used for getting messages of other clients on that channel
The function gets 2 arguments (nickName, message)

Parameters

String name The nickname for this user on this channel
String channelName The channel name where should be listened to (and send messages to)
Function callback The callback when for incomming messages

Returns

Broadcaster

Supported Clients

SmartClient,WebClient,NGClient

Sample

var broadcaster = plugins.clientmanager.getBroadcaster("nickname","mychatchannel",callback);
broadcaster.broadcastMessage("Hallo");
 

getClientInformation()

 
Returns the current client JSClientInformation object.

Returns

JSClientInformation

Supported Clients

SmartClient,WebClient,NGClient

Sample

 
 

getConnectedClients()

 
Returns an array of JSClientInformation elements describing the clients connected to the server.

Returns

Array

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Returns an array of JSClientInformation elements describing the clients connected to the server.
var clients = plugins.clientmanager.getConnectedClients();
application.output("There are " + clients.length + " connected clients.");
for (var i = 0; i < clients.length; i++)
	application.output("Client has clientId '" + clients[i].getClientID() + "' and has connected from host '" + clients[i].getHostAddress() + "'.");
 

getConnectedClients(clientInfoFilter)

 
/*
Returns an array of JSClientInformation elements describing the clients connected to the server filtered by the a client info string.
This way you can ask for a specific set of clients that have a specific information added to there client information.

Parameters

String clientInfoFilter The filter string

Returns

Array

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Returns an array of JSClientInformation elements describing the clients connected to the server.
var clients = plugins.clientmanager.getConnectedClients();
application.output("There are " + clients.length + " connected clients.");
for (var i = 0; i < clients.length; i++)
	application.output("Client has clientId '" + clients[i].getClientID() + "' and has connected from host '" + clients[i].getHostAddress() + "'.");
 

isInMaintenanceMode()

 
Returns true if the server is in maintenance mode, false otherwise.

Returns

Boolean

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Returns true if the server is in maintenance mode, false otherwise.
if (plugins.maintenance.isInMaintenanceMode())
	application.output("Server is in maintenance mode.");
else
	application.output("Server is not in maintenance mode.");
 

sendMessageToAllClients(message)

 
Sends a message to all connected clients.

Parameters

String message ;

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Sends a message to all connected clients.
plugins.clientmanager.sendMessageToAllClients("Hello, all clients!");
 

sendMessageToClient(clientId, message)

 
Sends a message to a specific client, identified by its clientId. The clientIds are retrieved by calling the getConnectedClients method.

Parameters

String clientId ;
String message ;

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Sends a message to a specific client, identified by its clientId. The clientIds are retrieved by calling the getConnectedClients method.
var clients = plugins.clientmanager.getConnectedClients();
for (var i=0; i<clients.length; i++)
	plugins.clientmanager.sendMessageToClient(clients[i].getClientId(), "Hello, client " + clients[i].getClientID() + "!");
 

shutDownAllClients()

 
Shuts down all connected clients. This method returns immediately, it does not wait until the client shuts down.

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Shuts down all connected clients. This method returns immediately, it does not wait until the client shuts down.
plugins.clientmanager.shutDownAllClients();
 

shutDownClient(clientId)

 
Shuts down a specific client, identified by its clientId. The clientIds are retrieved by calling the getConnectedClients method. This method returns immediately, it does not wait until the client shuts down.

Parameters

String clientId ;

Supported Clients

SmartClient,WebClient,NGClient

Sample

//Shuts down a specific client, identified by its clientId. The clientIds are retrieved by calling the getConnectedClients method. This method returns immediately, it does not wait until the client shuts down.
var clients = plugins.clientmanager.getConnectedClients();
for (var i=0; i<clients.length; i++)
	plugins.clientmanager.shutDownClient(clients[i].getClientId());
 

  • No labels