Class ServiceInfo

    • Constructor Detail

      • ServiceInfo

        protected ServiceInfo()
      • ServiceInfo

        public ServiceInfo​(URI anURI,
                           String aServiceName,
                           IServiceTypeID aServiceTypeID)
        Create an IServiceInfo instance.
        Parameters:
        anURI - The (absolute) location of the service.
        aServiceName - a user chosen service name. Only ASCII characters are allowed.
        aServiceTypeID - the service type identifier.
        Since:
        3.0
      • ServiceInfo

        public ServiceInfo​(URI anURI,
                           String aServiceName,
                           IServiceTypeID aServiceTypeID,
                           IServiceProperties props)
        Create an IServiceInfo instance.
        Parameters:
        anURI - The (absolute) location of the service.
        aServiceName - a user chosen service name. Only ASCII characters are allowed.
        aServiceTypeID - the service type identifier.
        props - generic service properties.
        Since:
        3.0
      • ServiceInfo

        public ServiceInfo​(URI anURI,
                           String aServiceName,
                           IServiceTypeID aServiceTypeID,
                           int priority,
                           int weight,
                           IServiceProperties props)
        Create an IServiceInfo instance.
        Parameters:
        anURI - The (absolute) location of the service.
        aServiceName - a user chosen service name. Only ASCII characters are allowed.
        aServiceTypeID - the service type identifier.
        priority - the service priority. The priority of this target host. A client MUST attempt to contact the target host with the lowest-numbered priority it can reach; target hosts with the same priority SHOULD be tried in an order defined by the weight field.
        weight - the service weight. A server selection mechanism. The weight field specifies a relative weight for entries with the same priority. Larger weights SHOULD be given a proportionately higher probability of being selected. Domain administrators SHOULD use Weight 0 when there isn't any server selection to do. In the presence of records containing weights greater than 0, records with weight 0 should have a very small chance of being selected.
        props - generic service properties.
        Since:
        3.0
      • ServiceInfo

        public ServiceInfo​(URI anURI,
                           String aServiceName,
                           IServiceTypeID aServiceTypeID,
                           int priority,
                           int weight,
                           IServiceProperties props,
                           long ttl)
        Create an IServiceInfo instance.
        Parameters:
        anURI - The (absolute) location of the service.
        aServiceName - a user chosen service name. Only ASCII characters are allowed.
        aServiceTypeID - the service type identifier.
        priority - the service priority. The priority of this target host. A client MUST attempt to contact the target host with the lowest-numbered priority it can reach; target hosts with the same priority SHOULD be tried in an order defined by the weight field.
        weight - the service weight. A server selection mechanism. The weight field specifies a relative weight for entries with the same priority. Larger weights SHOULD be given a proportionately higher probability of being selected. Domain administrators SHOULD use Weight 0 when there isn't any server selection to do. In the presence of records containing weights greater than 0, records with weight 0 should have a very small chance of being selected.
        props - generic service properties.
        ttl - time to live
        Since:
        4.0
    • Method Detail

      • getLocation

        public URI getLocation()
        Description copied from interface: IServiceInfo
        Get URI for service
        Specified by:
        getLocation in interface IServiceInfo
        Returns:
        URI the location for the service.
      • getServiceID

        public IServiceID getServiceID()
        Description copied from interface: IServiceInfo
        Get ServiceID for service.
        Specified by:
        getServiceID in interface IServiceInfo
        Returns:
        ServiceID the serviceID for the service. Will not be null.
      • getPriority

        public int getPriority()
        Description copied from interface: IServiceInfo
        The priority for the service Priority: The priority of this target host. A client MUST attempt to contact the target host with the lowest-numbered priority it can reach; target hosts with the same priority SHOULD be tried in an order defined by the weight field.
        Specified by:
        getPriority in interface IServiceInfo
        Returns:
        int the priority. 0 if no priority information for service.
      • getWeight

        public int getWeight()
        Description copied from interface: IServiceInfo
        The weight for the service. 0 if no weight information for service. Weight: A server selection mechanism. The weight field specifies a relative weight for entries with the same priority. Larger weights SHOULD be given a proportionately higher probability of being selected. Domain administrators SHOULD use Weight 0 when there isn't any server selection to do. In the presence of records containing weights greater than 0, records with weight 0 should have a very small chance of being selected.
        Specified by:
        getWeight in interface IServiceInfo
        Returns:
        int the weight
      • getServiceProperties

        public IServiceProperties getServiceProperties()
        Description copied from interface: IServiceInfo
        Map with any/all properties associated with the service. Properties are assumed to be name/value pairs, both of type String.
        Specified by:
        getServiceProperties in interface IServiceInfo
        Returns:
        Map the properties associated with this service. Will not be null.
      • getAdapter

        public Object getAdapter​(Class adapter)
        Specified by:
        getAdapter in interface org.eclipse.core.runtime.IAdaptable