API Docs for: 0.0.2
Show:

remote.Broadcaster Class

Singleton class responsible for broadcasting messages from remote requests. Instance of this class is available in ludo.remoteBroadcaster.

The broadcaster can fire four events: start, success, failure and serverError. The example below show you how to add listeners to these events.

Methods

addResourceEvent

(
  • eventType
  • resource
  • fn
)

Listen to events from remote requests. EventType is either success, failure or serverError. resource is a name of resource specified in the request.

Parameters:

Example:

ludo.remoteBroadcaster.addEvent('failure', 'Person', function(response){ this.getBody().set('html', response.message'); }.bind(this)); The event payload is an object in this format:

{
    "code": 200,
    "message": "A message",
    "resource": "Which resource",
    "service": "Which service"
}

addResourceEvent

(
  • eventType
  • resource
  • services
  • fn
)

Listen to remote events from a specific service only.

Parameters:

Example:

ludo.remoteBroadcaster.addEvent('failure', 'Person', ['save'], function(response){ this.getBody().set('html', response.message'); }.bind(this)); The event payload is an object in this format:

{
    "code": 200,
    "message": "A message",
    "resource": "Which resource",
    "service": "Which service"
}

broadcast

(
  • request
  • service
)
private

Parameters:

  • request ludo.remote.JSON
  • service String

on

(
  • events
  • fn
)
remote.Broadcaster

Chained method for adding broadcaster events.

Parameters:

Returns:

Example:

ludo.remoteBroadcaster.withResource('Person').withService('read').on('success', function(){
    alert('Save success');
}).on('start', function(){ alert('About to save') });
 Example with array:

    ludo.remoteBroadcaster.withResource('Person').withService('read').on('success', function(){
    alert('Save success');
}).on(['start','success'], function(){ alert('Remote event') });

setDefaultMessage

(
  • message
  • eventType
  • resource
  • service
)

Specify default response messages for resource service

Parameters:

Example:

ludo.remoteBroadcaster.setDefaultMessage('You have registered successfully', 'success', 'User', 'register');

withResource

(
  • resource
)
remote.Broadcaster

Chained method for adding broadcaster events.

Parameters:

Returns:

Example:

ludo.remoteBroadcaster.withResource('Person').withService('save').on('success', function(){
    alert('Save success');
});

withResourceService

(
  • resourceAndService
)
remote.Broadcaster

Chained method for adding broadcaster events.

Parameters:

Returns:

Example:

ludo.remoteBroadcaster.withResourceService('Person/save').on('success', function(){ alert('Save success'); });

withService

(
  • service
)
remote.Broadcaster

Chained method for adding broadcaster events.

Parameters:

Returns:

Example:

ludo.remoteBroadcaster.withResource('Person').withService('read').
        withService('save').on('success', function(){
    alert('Save success');
});