Package com.yahoo.messagebus.network

Interface Network

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      boolean allocServiceAddress​(RoutingNode recipient)
      Resolves the service address of the recipient referenced by the given routing node.
      void attach​(NetworkOwner owner)
      Attach the network layer to the given owner
      void freeServiceAddress​(RoutingNode recipient)
      Frees the service address from the given routing node.
      java.lang.String getConnectionSpec()
      Returns a string that represents the connection specs of this network.
      com.yahoo.jrt.slobrok.api.IMirror getMirror()
      Returns a reference to a name server mirror.
      void registerSession​(java.lang.String session)
      Register a session name with the network layer.
      void send​(Message msg, java.util.List<RoutingNode> recipients)
      Send a message to the given recipients.
      void shutdown()
      Shuts down the network.
      void sync()
      Synchronize with internal threads.
      void unregisterSession​(java.lang.String session)
      Unregister a session name with the network layer.
      boolean waitUntilReady​(double seconds)
      Waits for at most the given number of seconds for all dependencies to become ready.

    • Method Detail

      • waitUntilReady

        boolean waitUntilReady​(double seconds)
        Waits for at most the given number of seconds for all dependencies to become ready.
        Parameters:
        seconds - The timeout.
        Returns:
        True if ready.

      • attach

        void attach​(NetworkOwner owner)
        Attach the network layer to the given owner
        Parameters:
        owner - owner of the network

      • registerSession

        void registerSession​(java.lang.String session)
        Register a session name with the network layer. This will make the session visible to other nodes.
        Parameters:
        session - the session name

      • unregisterSession

        void unregisterSession​(java.lang.String session)
        Unregister a session name with the network layer. This will make the session unavailable for other nodes.
        Parameters:
        session - session name

      • allocServiceAddress

        boolean allocServiceAddress​(RoutingNode recipient)
        Resolves the service address of the recipient referenced by the given routing node. If a recipient can not be resolved, this method tags the node with an error. If this method succeeds, you need to invoke freeServiceAddress(RoutingNode) once you are done with the service address.
        Parameters:
        recipient - The node whose service address to allocate.
        Returns:
        True if a service address was allocated.

      • freeServiceAddress

        void freeServiceAddress​(RoutingNode recipient)
        Frees the service address from the given routing node. This allows the network layer to track and close connections as required.
        Parameters:
        recipient - The node whose service address to free.

      • send

        void send​(Message msg,
          java.util.List<RoutingNode> recipients)
        Send a message to the given recipients. A RoutingNode contains all the necessary context for sending.
        Parameters:
        msg - The message to send.
        recipients - A list of routing leaf nodes resolved for the message.

      • sync

        void sync()
        Synchronize with internal threads. This method will handshake with all internal threads. This has the implicit effect of waiting for all active callbacks. Note that this method should never be invoked from a callback since that would make the thread wait for itself... forever. This method is typically used to untangle during session shutdown.

      • shutdown

        void shutdown()
        Shuts down the network. This is a blocking call that waits for all scheduled tasks to complete.

      • getConnectionSpec

        java.lang.String getConnectionSpec()
        Returns a string that represents the connection specs of this network. It is in not a complete address since it know nothing of the sessions that run on it.
        Returns:
        The connection string.

      • getMirror

        com.yahoo.jrt.slobrok.api.IMirror getMirror()
        Returns a reference to a name server mirror.
        Returns:
        The mirror object.