Net::Async::Tangence::Server - serve Tangence clients using IO::Async
Net::Async::Tangence::Server
Tangence
IO::Async
This subclass of IO::Async::Listener accepts Tangence client connections.
The following named parameters may be passed to new or configure:
new
configure
The Tangence::Registry for the server's objects.
The following methods are provided but intended to be overridden if the implementing class wishes to provide different behaviour from the default.
$rootobj = $server->conn_rootobj( $conn, $identity )
Invoked when a GETROOT message is received from the client, this method should return a Tangence::Object as root object for the connection.
GETROOT
The default implementation will return the object with ID 1; i.e. the first object created in the registry.
$allow = $server->conn_permits_registry( $conn )
Invoked when a GETREGISTRY message is received from the client on the given connection object. This method should return a boolean to indicate whether the client is allowed to access the object registry.
GETREGISTRY
The default implementation always permits this, but an overridden method may decide to disallow it in some situations. When disabled, a client will not be able to gain access to any serverside objects other than the root object, and (recursively) any other objects returned by methods, events or properties on objects already known. This can be used as a security mechanism.
Paul Evans <leonerd@leonerd.org.uk>
To install Net::Async::Tangence, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Async::Tangence
CPAN shell
perl -MCPAN -e shell install Net::Async::Tangence
For more information on module installation, please visit the detailed CPAN module installation guide.