Back Previous Next

Syntax:

   create {client} name {name} type {type} [notify once]
   create {service} name {name} type {type}

Keyword handler:

   net.eclecity.linguist.network.keyword.NetworkKCreate.class

Runtime handler(s):

   net.eclecity.linguist.network.handler.NetworkHCreate.class

Function:

Create a new peer-to-peer client or service. Peer-to-peer networking operates by putting clients in touch with services and exchanging information between them. When a new service is added, all clients of the same type (i.e. having the same type string) are notified - see on notify - and they can then choose to set up a conversation with one or more services of that type. Similarly, when a client is added it will be informed of all relevant pre-existing services. Such notifications will occur every time a new service comes online unless the notify once flag is used; this ensures only a single notification is ever received by that client.

The system can support any number of different client and service types; a typical program is likely to maintain several conversations at once. Conversations are held using message objects.

Example(s):

   create AdminClient name "Admin Client" type "Admin" notify once
   create ClockClient name "Clock 1" type "Clock"
   create ClockService name "Master Clock" type "Clock"