Class VinciClient


  • public class VinciClient
    extends BaseClient
    Class for conjuring a Vinci service. Adds VNS resolution to BaseClient. Extends BaseClient with static "sendAndReceive" and "rpc" methods for convenient support of one-shot queries.
    • Method Detail

      • getLevel

        public int getLevel()
        Get the priority level of the service to which this client is connected. This method only works after the connection has been opened.
        Returns:
        -
      • getInstance

        public int getInstance()
        Get the instance number of this service. This method only works after the connection has been opened. Services should have "non zero" instance numbers only when more than one instance of the service is running on the same host. The unique instance value allows each instance to be distinguished and uniquely addressed via a fully qualified service name.
        Returns:
        -
      • getContext

        public VinciContext getContext()
        Get the context associated with this client. By default clients use the global Vinci context, though this can be overridden.
        Returns:
        -
      • setContext

        public void setContext​(VinciContext c)
        Set the VinciContext to be used by this client. Set to null if you wish the global context to be used. You should set the context BEFORE a connection is open (e.g. ater using the no-arg constructor), otherwise the global context parameters will be used to establish the connection before you have a chance to change it.
        Parameters:
        c - -
      • getQualifiedServiceName

        public String getQualifiedServiceName()
        Get the fully qualified name of this service. This method is useful when for whatever reason a connection needs to be re-established with this exact same service instance. This method only works after connection has been established.
        Returns:
        -
      • getServiceName

        public String getServiceName()
      • open

        public void open​(String service_name)
                  throws ServiceDownException,
                         VNSException
        Connects the client to the specified service as delegated by VNS. Use this open method in conjunction with the no-arg VinciClient constructor.
        Parameters:
        service_name - The name of the service to connect to.
        Throws:
        ServiceDownException - Thrown when either (1) VNS is inaccessible or (2) none of the servers registered under serviceName are accessible.
        VNSException - Thrown when VNS is accessible but reports an error, which should almost always indicate that the requested service is not registered.
        IllegalStateException - if no VNS_HOST has been specified.
      • isSocketKeepAliveEnabled

        protected boolean isSocketKeepAliveEnabled()
        Gets wheter socket keepAlive is enabled. This overrides the method in BaseClient, and makes this setting configurable through the VinciContext.
        Overrides:
        isSocketKeepAliveEnabled in class BaseClient
        Returns:
        whether socket keepAlive is enabled.
      • rpc

        public static VinciFrame rpc​(Transportable in,
                                     String service_name,
                                     int timeout)
                              throws IOException,
                                     ServiceException,
                                     ServiceDownException,
                                     VNSException
        Same as VinciClient.sendAndReceive(Transportable, service_name) except it also takes a timeout value. WARNING: This method "hides" the BaseClient rpc method with the same signature. The BaseClient method accepts (Transportable, host string, port) whereas this one accepts (Transportable, service_name, timeout). Despite the equivalent signatures, the semantics of these two methods are quite different.
        Parameters:
        in - -
        service_name - -
        timeout - -
        Returns:
        A VinciFrame representing the service result.
        Throws:
        IOException - -
        ServiceException - -
        ServiceDownException - -
        VNSException - -
      • rpc

        public static VinciFrame rpc​(Transportable in,
                                     String service_name,
                                     int timeout,
                                     int connect_timeout)
                              throws IOException,
                                     ServiceException,
                                     ServiceDownException,
                                     VNSException
        Same as VinciClient.sendAndReceive(Transportable, service_name) except it also takes socket read and socket connect timeout values. WARNING: This method "hides" the BaseClient rpc method with the same signature. The BaseClient method accepts (Transportable, host string, port) whereas this one accepts (Transportable, service_name, timeout). Despite the equivalent signatures, the semantics of these two methods are quite different.
        Parameters:
        in - -
        service_name - -
        timeout - -
        connect_timeout - -
        Returns:
        A VinciFrame representing the service result.
        Throws:
        IOException - -
        ServiceException - -
        ServiceDownException - -
        VNSException - -