Package org.eclipse.ecf.provider.dnssd

Class DnsSdDiscoveryLocator

java.lang.Object
org.eclipse.ecf.core.AbstractContainer
org.eclipse.ecf.discovery.AbstractDiscoveryContainerAdapter
org.eclipse.ecf.provider.dnssd.DnsSdDiscoveryContainerAdapter
org.eclipse.ecf.provider.dnssd.DnsSdDiscoveryLocator
All Implemented Interfaces:
org.eclipse.core.runtime.IAdaptable, IContainer, IIdentifiable, IDiscoveryAdvertiser, IDiscoveryLocator
public class DnsSdDiscoveryLocator extends DnsSdDiscoveryContainerAdapter

  • Constructor Details

    • DnsSdDiscoveryLocator

      public DnsSdDiscoveryLocator()

  • Method Details

    • getServiceInfo

      public IServiceInfo getServiceInfo(IServiceID aServiceId)
      Description copied from interface: IDiscoveryLocator
      Synchronously retrieve info about the service
      Specified by:
      getServiceInfo in interface IDiscoveryLocator
      Overrides:
      getServiceInfo in class DnsSdDiscoveryContainerAdapter
      Parameters:
      aServiceId - IServiceID of the service to get info about. Must not be null.
      Returns:
      IServiceInfo the service info retrieved. null if no information retrievable.

    • getServiceTypes

      public IServiceTypeID[] getServiceTypes()
      This always returns the service type found for our local domain Use org.eclipse.ecf.provider.dnssrv.DnsSrvDisocoveryLocator.getServices(IServiceTypeID) with a wildcard query instead.
      Specified by:
      getServiceTypes in interface IDiscoveryLocator
      Overrides:
      getServiceTypes in class DnsSdDiscoveryContainerAdapter
      Returns:
      IServiceTypeID[] the resulting array of service type IDs. Will not be null. May be of length 0.
      See Also:

    • getServices

      public IServiceInfo[] getServices()
      Description copied from interface: IDiscoveryLocator
      Synchronously get service info about all known services
      Specified by:
      getServices in interface IDiscoveryLocator
      Overrides:
      getServices in class DnsSdDiscoveryContainerAdapter
      Returns:
      IServiceInfo[] the resulting array of service info instances. Will not be null. May be of length 0.

    • getServices

      public IServiceInfo[] getServices(IServiceTypeID aServiceTypeId)
      Description copied from interface: IDiscoveryLocator
      Synchronously get service info about all known services of given service type
      Specified by:
      getServices in interface IDiscoveryLocator
      Overrides:
      getServices in class DnsSdDiscoveryContainerAdapter
      Parameters:
      aServiceTypeId - IServiceTypeID defining the type of service we are interested in getting service info about. Must not be null
      Returns:
      IServiceInfo[] the resulting array of service info instances. Will not be null. May be of length 0.

    • connect

      public void connect(ID aTargetID, IConnectContext connectContext) throws ContainerConnectException
      Description copied from interface: IContainer
      Connect to a target remote process or process group. The target identified by the first parameter (targetID) is connected the implementation class. If authentication information is required, the required information is given via via the second parameter (connectContext). Callers note that depending upon the provider implementation this method may block. It is suggested that callers use a separate thread to call this method. This method provides an implementation independent way for container implementations to connect, authenticate, and communicate with a remote service or group of services. Providers are responsible for implementing this operation in a way appropriate to the given remote service (or group) via expected protocol.
      Specified by:
      connect in interface IContainer
      Specified by:
      connect in class DnsSdDiscoveryContainerAdapter
      Parameters:
      aTargetID - the ID of the remote server or group to connect to. See IContainer.getConnectNamespace() for a explanation of the constraints upon this parameter.
      connectContext - any required context to allow this container to authenticate. May be null if underlying provider does not have any authentication requirements for connection.
      Throws:
      ContainerConnectException - thrown if communication cannot be established with remote service. Causes can include network connection failure, authentication failure, server error, or if container is already connected.

    • getContainerName

      public String getContainerName()
      Specified by:
      getContainerName in class AbstractDiscoveryContainerAdapter
      Returns:
      The name of this discovery container