Package host.anzo.simon

Interface Lookup

All Known Implementing Classes:
InterfaceLookup, NameLookup
public interface Lookup

  • Method Details

    • getSslContextFactory

      SslContextFactory getSslContextFactory()

    • setSslContextFactory

      void setSslContextFactory(SslContextFactory sslContextFactory)

    • getProxyConfig

      SimonProxyConfig getProxyConfig()

    • setProxyConfig

      void setProxyConfig(SimonProxyConfig proxyConfig)

    • getClosedListeners

      List<ClosedListener> getClosedListeners(Object remoteObject)
      Returns a list of attached ClosedListeners.
      Parameters:
      remoteObject - the remote object to query for attached closed listeners
      Returns:
      a list of attached closed listeners

    • addClosedListener

      void addClosedListener(Object remoteObject, ClosedListener closedListener)
      Attaches a closed listener to the specified remote object
      Parameters:
      remoteObject - the remote object to which the listener is attached to
      closedListener - the listener to add

    • removeClosedListener

      boolean removeClosedListener(Object remoteObject, ClosedListener closedListener)
      Removes an already attached closed listener from the specified remote object
      Parameters:
      remoteObject - the remote object from which the listener has to be removed
      closedListener - the listener to remove
      Returns:
      true, if listener was removed, false if there is no listener to remove

    • getClassLoader

      ClassLoader getClassLoader()

    • setClassLoader

      void setClassLoader(ClassLoader classLoader)

    • setSourceAddress

      void setSourceAddress(InetAddress sourceAddress)
      Sets the address that is used as the source address for the lookup-request. This might be useful if client machine has more than one network interface or server requires a specific client subnet
      Parameters:
      sourceAddress -

    • getServerAddress

      InetAddress getServerAddress()

    • getServerPort

      int getServerPort()

    • lookup

      Object lookup(String lookupString) throws LookupFailedException, EstablishConnectionFailed
      Tries to lookup a remote object on the server. A successful lookup includes:
      • established socket connection to server, if not already connected
      • increased reference counter for this client-to-server connection by 1
      • return of the requested remote object
      To avoid leaks, ensure that remote objects are released after use. For releasing objects, please refer to release(Object).
      Parameters:
      lookupString -
      Returns:
      the remote object
      Throws:
      LookupFailedException
      EstablishConnectionFailed

    • release

      boolean release(Object remoteObject)
      Releases are remote object. Releasing a remote objects leads to:
      • release of related SIMON resources (threads, ...)
      • decrease reference counter for this client-to-server connection by 1
      • if reference counter reaches 0, the client-to-server connection will be disconnected and cleaned up
      Parameters:
      remoteObject -
      Returns:
      true, in case of a normal and clean release. false if remoteobject is already released
      Throws:
      IllegalArgumentException - in case of argument is not a releaseable remote object