Package org.eclipse.ecf.provider.dnssd

Class DnsSdDiscoveryContainerAdapter

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

  • Field Details

    • resolver

      protected org.xbill.DNS.Resolver resolver

    • targetID

      protected DnsSdServiceTypeID targetID

  • Constructor Details

  • Method Details

    • getServiceInfo

      public IServiceInfo getServiceInfo(IServiceID aServiceId)
      Description copied from interface: IDiscoveryLocator
      Synchronously retrieve info about the service
      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()
      Description copied from interface: IDiscoveryLocator
      Synchronously get service info about all known services of given service type
      Returns:
      IServiceTypeID[] the resulting array of service type IDs. Will not be null. May be of length 0.

    • getServices

      public IServiceInfo[] getServices()
      Description copied from interface: IDiscoveryLocator
      Synchronously get service info about all known services
      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
      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.

    • registerService

      public void registerService(IServiceInfo serviceInfo)
      Description copied from interface: IDiscoveryAdvertiser
      Register the given service. This publishes the service defined by the serviceInfo to the underlying publishing mechanism
      Parameters:
      serviceInfo - IServiceInfo of the service to be published. Must not be null.

    • unregisterService

      public void unregisterService(IServiceInfo serviceInfo)
      Description copied from interface: IDiscoveryAdvertiser
      Unregister a previously registered service defined by serviceInfo.
      Parameters:
      serviceInfo - IServiceInfo defining the service to unregister. Must not be null.

    • connect

      public abstract void connect(ID targetID, 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.
      Parameters:
      targetID - 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.

    • getConnectedID

      public ID getConnectedID()
      Description copied from interface: IContainer
      Get the target ID that this container instance has connected to. Returns null if not connected.
      Returns:
      ID of the target we are connected to. Returns null if container not connected.

    • disconnect

      public void disconnect()
      Description copied from interface: IContainer
      Disconnect. This operation will disconnect the local container instance from any previously joined target or group. Subsequent calls to getConnectedID() will return null.

    • getBrowsingOrRegistrationDomains

      protected Collection getBrowsingOrRegistrationDomains(IServiceTypeID aServiceTypeId, String[] rrs)

    • getRecords

      protected org.xbill.DNS.Record[] getRecords(DnsSdServiceTypeID serviceTypeId)

    • getSRVRecords

      protected SortedSet getSRVRecords(org.xbill.DNS.Lookup[] queries)

    • getSRVRecords

      protected SortedSet getSRVRecords(org.xbill.DNS.Lookup[] queries, Comparator aComparator)

    • getSRVRecord

      protected SortedSet getSRVRecord(org.xbill.DNS.Lookup query, Comparator aComparator)

    • setSearchPath

      public void setSearchPath(String[] searchPaths)
      Parameters:
      searchPaths - The default search path used for discovery

    • getSearchPath

      public String[] getSearchPath()
      Returns:
      The default search path used by this discovery provider

    • setResolver

      public void setResolver(String aResolver)
      Parameters:
      aResolver - The resolver to use
      Throws:
      DnsSdDiscoveryException - if hostname cannot be resolved

    • setTsigKey

      public void setTsigKey(String tsigKeyName, String tsigKey)
      Parameters:
      tsigKeyName - A key name/user name for dns dynamic update
      tsigKey - A string representation of the shared key