Interface ClientService


  • public interface ClientService
    ClientService allows you to query connected Clients and attach/detach ClientListeners to listen to connection events.

    All the methods are thread-safe.

    See Also:
    Client, ClientListener
    • Method Detail

      • getConnectedClients

        @Nonnull
        java.util.Collection<Client> getConnectedClients()
        Returns all connected clients to this member.
        Returns:
        all connected clients to this member
      • addClientListener

        @Nonnull
        java.util.UUID addClientListener​(@Nonnull
                                         ClientListener clientListener)
        Adds a ClientListener. When a ClientListener is added more than once, it will receive duplicate events.
        Parameters:
        clientListener - the ClientListener to add
        Returns:
        registration ID which can be used to remove the listener using the removeClientListener(UUID) method
        Throws:
        java.lang.NullPointerException - if clientListener is null
      • removeClientListener

        boolean removeClientListener​(@Nonnull
                                     java.util.UUID registrationId)
        Removes a ClientListener. Can safely be called with a non existing ID, or when the ClientListener already is removed.
        Parameters:
        registrationId - ID of the ClientListener registration
        Returns:
        true if registration is removed, false otherwise
        Throws:
        java.lang.NullPointerException - if registration ID is null