diff options
Diffstat (limited to 'framework/bundles/org.eclipse.ecf.discovery/src/org/eclipse/ecf/discovery/IServiceInfo.java')
-rw-r--r-- | framework/bundles/org.eclipse.ecf.discovery/src/org/eclipse/ecf/discovery/IServiceInfo.java | 28 |
1 files changed, 17 insertions, 11 deletions
diff --git a/framework/bundles/org.eclipse.ecf.discovery/src/org/eclipse/ecf/discovery/IServiceInfo.java b/framework/bundles/org.eclipse.ecf.discovery/src/org/eclipse/ecf/discovery/IServiceInfo.java index 3083e56ed..9d2bfe2b1 100644 --- a/framework/bundles/org.eclipse.ecf.discovery/src/org/eclipse/ecf/discovery/IServiceInfo.java +++ b/framework/bundles/org.eclipse.ecf.discovery/src/org/eclipse/ecf/discovery/IServiceInfo.java @@ -17,8 +17,8 @@ import org.eclipse.ecf.discovery.identity.IServiceID; * Service information contract. Defines the information associated with a * remotely discoverable service * - * @see "http://www.dns-sd.org/ServiceTypes.html" - * @see "http://www.ietf.org/rfc/rfc2782.txt" + * see http://www.dns-sd.org/ServiceTypes.html and + * http://www.ietf.org/rfc/rfc2782.txt * */ public interface IServiceInfo extends IAdaptable { @@ -32,15 +32,18 @@ public interface IServiceInfo extends IAdaptable { /** * Get ServiceID for service. * - * @return ServiceID the serviceID for the service. Will not be <code>null</code>. + * @return ServiceID the serviceID for the service. Will not be + * <code>null</code>. */ public IServiceID getServiceID(); /** * 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. + * 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. * * @return int the priority. 0 if no priority information for service. */ @@ -49,10 +52,12 @@ public interface IServiceInfo extends IAdaptable { /** * 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. + * 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. * * @return int the weight */ @@ -72,10 +77,11 @@ public interface IServiceInfo extends IAdaptable { * Map with any/all properties associated with the service. Properties are * assumed to be name/value pairs, both of type String. * - * @return Map the properties associated with this service. Will not be <code>null</code>. + * @return Map the properties associated with this service. Will not be + * <code>null</code>. */ public IServiceProperties getServiceProperties(); - + /** * A user choose label used for pretty printing this service. * |