Listening to events

Table of content

EventEmitter methods
Catch-all listeners
- For incoming packets
- For outgoing packets

There are several ways to handle events that are transmitted between the server and the client.

EventEmitter methods

socket.on(eventName, listener)

Adds the listener function to the end of the listeners array for the event named eventName.

socket.on("details", new Emitter.Listener() {
    @Override
    public void call(Object... args) {
        // ...
    }
});

socket.once(eventName, listener)

Adds a one-time listener function for the event named eventName.

socket.once("details", new Emitter.Listener() {
    @Override
    public void call(Object... args) {
        // ...
    }
});

socket.off(eventName, listener)

Removes the specified listener from the listener array for the event named eventName.

Emitter.Listener listener = new Emitter.Listener() {
    @Override
    public void call(Object... args) {
        calls.add("two");
    }
};

socket.on("details", listener);

// and then later...
socket.off("details", listener);

socket.off(eventName)

Removes all listeners for the specific eventName.

socket.off("details");

socket.off()

Removes all listeners (for any event).

socket.off();

Catch-all listeners

For incoming packets

socket.onAnyIncoming(new Emitter.Listener() {
    @Override
    public void call(Object... args) {
        // ...
    }
});

For outgoing packets

socket.onAnyOutgoing(new Emitter.Listener() {
    @Override
    public void call(Object... args) {
        // ...
    }
});