NAME

Net::WAMP::Role::Dealer - Dealer role for Net::WAMP

SYNOPSIS

package MyRouter;

use parent qw( Net::WAMP::Role::Dealer );

#For security, this defaults to rejecting everything!
sub deny_CALL {
    my ($self, $CALL_msg) = @_;

    my $session_obj = $self->get_session();

    #success
    return;

    #fail, generic (Error = wamp.error.not_authorized)
    return 1;

    #fail, custom Auxiliary (Error = wamp.error.not_authorized)
    return { foo => 1 };

    #fail, generic Auxiliary, custom Error
    return 1, 'myapp.error.go_away';

    #fail, custom Auxiliary and Error
    return { foo => 1 }, 'myapp.error.go_away';
}

#This follows the same pattern as deny_CALL().
#It also defaults to rejecting everything.
sub deny_REGISTER { ... }

DESCRIPTION

This is an EXPERIMENTAL WAMP Dealer implementation. If you use it, please send feedback!

AUTHORIZATION

To have a useful Dealer you’ll need to create a deny_CALL method, since the default is to deny all CALL requests. If that Broker is to allow REGISTER requests, you’ll also need a deny_REGISTER() method. The format of these is described above.

METHODS

Dealer only exposes a few public methods:

$registr_id = OBJ->register( SESSION_OBJ, METADATA_HR, PROCEDURE )

This function registers a session to supply the given procedure, independently of actual WAMP messaging. This is useful, e.g., if you want to “auto-register” a procedure to a given session.

The return is the same number that is sent in a REGISTERED message’s Registration. No REGISTERED message is sent, however.

OBJ->unregister( SESSION_OBJ, REGISTRATION_ID )

Undoes a registration, without sending an UNREGISTERED message.