JmmDNS.java

Go to the documentation of this file.

package javax.jmdns;

import java.io.Closeable;
import java.io.IOException;
import java.net.InetAddress;
import java.util.Map;
import java.util.concurrent.atomic.AtomicReference;

import javax.jmdns.impl.JmmDNSImpl;

public interface JmmDNS extends Closeable {

    public static final class Factory {
        private static volatile JmmDNS _instance;

        public static interface ClassDelegate {

            public JmmDNS newJmmDNS();

        }

        private static final AtomicReference<ClassDelegate> _databaseClassDelegate = new AtomicReference<ClassDelegate>();

        private Factory() {
            super();
        }

        public static void setClassDelegate(ClassDelegate delegate) {
            _databaseClassDelegate.set(delegate);
        }

        public static ClassDelegate classDelegate() {
            return _databaseClassDelegate.get();
        }

        protected static JmmDNS newJmmDNS() {
            JmmDNS dns = null;
            ClassDelegate delegate = _databaseClassDelegate.get();
            if (delegate != null) {
                dns = delegate.newJmmDNS();
            }
            return (dns != null ? dns : new JmmDNSImpl());
        }

        public static JmmDNS getInstance() {
                // DJS don't ever want to retrieve an instance still floating around after
                // it's been closed, so forcing a new one (black magic, only should ever call 
                // this once)
            if ( (_instance == null) || ( _instance.isClosed() ) ) {
                synchronized (Factory.class) {
                    _instance = JmmDNS.Factory.newJmmDNS();
                }
            }
            return _instance;
        }
    }

    public abstract boolean isClosed();
    
    public abstract String[] getNames();

    public abstract String[] getHostNames();

    public abstract InetAddress[] getInetAddresses() throws IOException;

    @Deprecated
    public abstract InetAddress[] getInterfaces() throws IOException;

    public abstract ServiceInfo[] getServiceInfos(String type, String name);

    public abstract ServiceInfo[] getServiceInfos(String type, String name, long timeout);

    public abstract ServiceInfo[] getServiceInfos(String type, String name, boolean persistent);

    public abstract ServiceInfo[] getServiceInfos(String type, String name, boolean persistent, long timeout);

    public abstract void requestServiceInfo(String type, String name);

    public abstract void requestServiceInfo(String type, String name, boolean persistent);

    public abstract void requestServiceInfo(String type, String name, long timeout);

    public abstract void requestServiceInfo(String type, String name, boolean persistent, long timeout);

    public abstract void addServiceTypeListener(ServiceTypeListener listener) throws IOException;

    public abstract void removeServiceTypeListener(ServiceTypeListener listener);

    public abstract void addServiceListener(String type, ServiceListener listener);

    public abstract void removeServiceListener(String type, ServiceListener listener);

    public abstract void registerService(ServiceInfo info) throws IOException;

    public abstract void unregisterService(ServiceInfo info);

    public abstract void unregisterAllServices();

    public abstract void registerServiceType(String type);

    public abstract ServiceInfo[] list(String type);

    public abstract ServiceInfo[] list(String type, long timeout);

    public abstract Map<String, ServiceInfo[]> listBySubtype(String type);

    public abstract Map<String, ServiceInfo[]> listBySubtype(String type, long timeout);

    public abstract void addNetworkTopologyListener(NetworkTopologyListener listener);

    public abstract void removeNetworkTopologyListener(NetworkTopologyListener listener);

    public abstract NetworkTopologyListener[] networkListeners();

}