Class ServiceURL

java.lang.Object
org.sblim.slp.ServiceURL
All Implemented Interfaces:
Serializable

public class ServiceURL extends Object implements Serializable
The ServiceURL object models the advertised SLP service URL. It can be either a service: URL or a regular URL. These objects are returned from service lookup requests, and describe the registered services. This class should be a subclass of java.net.URL but can't since that class is final.
See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    The default URL lifetime (3 hours) in seconds.
    static final int
    The maximum URL lifetime (about 18 hours) in seconds.
    static final int
    Indicates that the URL has a zero lifetime.
    static final int
    Indicates that the API implementation should continuously re-register the URL until the application exits.
    static final int
    Indicates that no port information is required or was returned for this URL.
  • Constructor Summary

    Constructors
    Constructor
    Description
    ServiceURL(String pServiceURL, int pLifetime)
    Construct a service URL object having the specified lifetime.
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
     
    Returns the host identifier.
    int
    Returns the service advertisement lifetime.
    int
    Returns the port number, if any.
    Returns the service type object representing the service type name of the URL.
    Get the network layer transport identifier.
    Returns the URL path description, if any.
    int
     
    void
    Set the service type name to the object.
     

    Methods inherited from class Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait
  • Field Details

    • NO_PORT

      public static final int NO_PORT
      Indicates that no port information is required or was returned for this URL.
      See Also:
    • LIFETIME_NONE

      public static final int LIFETIME_NONE
      Indicates that the URL has a zero lifetime. This value is never returned from the API, but can be used to create a ServiceURL object to deregister, delete attributes, or find attributes.
      See Also:
    • LIFETIME_DEFAULT

      public static final int LIFETIME_DEFAULT
      The default URL lifetime (3 hours) in seconds.
      See Also:
    • LIFETIME_MAXIMUM

      public static final int LIFETIME_MAXIMUM
      The maximum URL lifetime (about 18 hours) in seconds.
      See Also:
    • LIFETIME_PERMANENT

      public static final int LIFETIME_PERMANENT
      Indicates that the API implementation should continuously re-register the URL until the application exits.
      See Also:
  • Constructor Details

    • ServiceURL

      public ServiceURL(String pServiceURL, int pLifetime)
      Construct a service URL object having the specified lifetime.
      Parameters:
      pServiceURL - The URL as a string. Must be either a service: URL or a valid generic URL according to RFC 2396 [2].
      pLifetime - The service advertisement lifetime in seconds. This value may be either between LIFETIME_NONE and LIFETIME_MAXIMUM or LIFETIME_PERMANENT.
  • Method Details

    • getServiceType

      public ServiceType getServiceType()
      Returns the service type object representing the service type name of the URL.
      Returns:
      The service type
    • setServiceType

      public void setServiceType(ServiceType pServicetype)
      Set the service type name to the object. Ignored if the URL is a service: URL.
      Parameters:
      pServicetype - The service type object.
    • getTransport

      public String getTransport()
      Get the network layer transport identifier. If the transport is IP, an empty string, "", is returned.
      Returns:
      The NLT identifier
    • getHost

      public String getHost()
      Returns the host identifier. For IP, this will be the machine name or IP address.
      Returns:
      The host
    • getPort

      public int getPort()
      Returns the port number, if any. For non-IP transports, always returns NO_PORT.
      Returns:
      The port
    • getURLPath

      public String getURLPath()
      Returns the URL path description, if any.
      Returns:
      The URL path
    • getLifetime

      public int getLifetime()
      Returns the service advertisement lifetime. This will be a positive int between LIFETIME_NONE and LIFETIME_MAXIMUM.
      Returns:
      The lifetime
    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object
    • toString

      public String toString()
      Overrides:
      toString in class Object
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object