x_action_cable

Description:

x action cable

ActionCable in Dart #
(This is a fork from https://pub.dev/packages/action_cable)
ActionCable is the default realtime websocket framework and protocol in Rails.
This is a dart port of the client and protocol implementation which is available in web, dartVM and flutter.
The difference between this libs and others, is some patterns we are using here. Exemple the way that your server response need to match what we are expecting, and improving the code based on last features from dart (I know we still have some code to be improved) See more bellow.
Usage #
Connecting to a cable 🙌 #
final cable = ActionCable.connect(
'ws://127.0.0.1:3000/cable',
headers: {
'Authorization': 'jwt-token',
},
onConnected: (){
print('connected');
},
onConnectionLost: () {
print('connection lost');
},
onCannotConnect: () {
print('cannot connect');
});
copied to clipboard
Subscribing to channel 🎉 #
void receiveMessage(Map payload) => print(payload);
final actionCallback = ActionCallback(name: 'receive_message', callback: receiveMessage);

ActionChannel channel = cable.subscribe(
'Chat', // either 'Chat' and 'ChatChannel' is fine
channelParams: { 'room': 'private' },
onSubscribed: (){}, // `confirm_subscription` received
onDisconnected: (){}, // `disconnect` received
callbacks: [actionCallback] // Callback list to able the server to call any method that you registered in your aplicaticon
);
copied to clipboard
When your server send the key 'receive_message' in their payload, the lib will be able to identify and call the callback correctly.
See the example bellow explaining what the server need to send:
ActionCable.server.broadcast("notifications_#{current_user}", {method: "receive_message", data: { anyData: [1, 2, 3] } })
copied to clipboard
Above we have on the second parameter the key method, that's all the lib need to see what callback call on client side.
Also with this ActionChannel you will be able to perform action from the channel object, see more bellow.
Unsubscribing from a channel 🎃 #
First lets see how we can unsubscribe from a channel.
Remember the ActionChannel that you created? You will use the same object to unsubribe itself.
channel.unsubscribe();
copied to clipboard
Just it, don't need nothing more. Lets see how perform an action client calling the server
Perform an action on your ActionCable server 🎇 #
Again, remember the object that you created above? The channel? We will use itself to perform an action.
channel.performAction(
action: 'send_message',
actionParams: { 'message': 'Hello private peeps! 😜' }
);
copied to clipboard
Here we have some other parameters.
action: will be the name of your server side method that you are trying to call
actionParams: will be the parameters that you pass to the server
Bellow we have a method example in ruby on rails
def send_message(data)
puts("message: #{data}")
end
copied to clipboard
Disconnect from the ActionCable server #
And now, for the disconnect you will need to use the main object (ActionCable) to disconect the websocket.
cable.disconnect();
copied to clipboard
ActionCable protocol #
Anycable has a great doc on that topic.
Contributors ✨ #
This project follows the all-contributors specification. Contributions of any kind welcome!