javax.jmdns

接口 JmmDNS

所有超级接口:

java.lang.AutoCloseable, java.io.Closeable

所有已知实现类:

JmmDNSImpl

public interface JmmDNS
extends java.io.Closeable

Java Multihomed Multicast DNS

Uses an underlying JmDNS instance for each InetAddress found on this computer.
This class will monitor network topology changes, and will create or destroy JmDNS instances as required. It is your responsibility to maintain services registration (hint: use a NetworkTopologyListener).
Most of this class methods have no notion of transaction: if an Exception is raised in the middle of execution, you may be in an incoherent state.

Note: This API is experimental and may change in the future please let us know what work and what does not work in your application.

作者:

Cédrik Lime, Pierre Frisch

嵌套类概要

嵌套类

限定符和类型	接口和说明
static class	JmmDNS.Factory JmmDNS.Factory enable the creation of new instance of JmmDNS.

方法概要

限定符和类型	方法和说明
void	addNetworkTopologyListener(NetworkTopologyListener listener) Listen to network changes.
void	addServiceListener(java.lang.String type, ServiceListener listener) Listen for services of a given type.
void	addServiceTypeListener(ServiceTypeListener listener) Listen for service types.
JmDNS[]	getDNS() Return a list of all the registered JmDNS instances
java.lang.String[]	getHostNames() Return the list HostName associated with this JmmDNS instance.
java.net.InetAddress[]	getInetAddresses() Return the list of addresses of the interface to which this instance of JmmDNS is bound.
java.net.InetAddress[]	getInterfaces() 已过时。 do not use this implementation yields unpredictable results use getInetAddresses()
java.lang.String[]	getNames() Return the names of the JmDNS instances.
ServiceInfo[]	getServiceInfos(java.lang.String type, java.lang.String name) Get service information.
ServiceInfo[]	getServiceInfos(java.lang.String type, java.lang.String name, boolean persistent) Get service information.
ServiceInfo[]	getServiceInfos(java.lang.String type, java.lang.String name, boolean persistent, long timeout) Get service information.
ServiceInfo[]	getServiceInfos(java.lang.String type, java.lang.String name, long timeout) Get service information.
ServiceInfo[]	list(java.lang.String type) Returns a list of service infos of the specified type.
ServiceInfo[]	list(java.lang.String type, long timeout) Returns a list of service infos of the specified type.
java.util.Map<java.lang.String,ServiceInfo[]>	listBySubtype(java.lang.String type) Returns a list of service infos of the specified type sorted by subtype.
java.util.Map<java.lang.String,ServiceInfo[]>	listBySubtype(java.lang.String type, long timeout) Returns a list of service infos of the specified type sorted by subtype.
NetworkTopologyListener[]	networkListeners() Returns list of network change listeners
void	registerService(ServiceInfo info) Register a service.
void	registerServiceType(java.lang.String type) Register a service type.
void	removeNetworkTopologyListener(NetworkTopologyListener listener) Remove listener for network changes.
void	removeServiceListener(java.lang.String type, ServiceListener listener) Remove listener for services of a given type.
void	removeServiceTypeListener(ServiceTypeListener listener) Remove listener for service types.
void	requestServiceInfo(java.lang.String type, java.lang.String name) Request service information.
void	requestServiceInfo(java.lang.String type, java.lang.String name, boolean persistent) Request service information.
void	requestServiceInfo(java.lang.String type, java.lang.String name, boolean persistent, long timeout) Request service information.
void	requestServiceInfo(java.lang.String type, java.lang.String name, long timeout) Request service information.
void	unregisterAllServices() Unregister all services.
void	unregisterService(ServiceInfo info) Unregister a service.

从接口继承的方法 java.io.Closeable

close

方法详细资料

getNames

java.lang.String[] getNames()

Return the names of the JmDNS instances.

返回:

list of name of the JmDNS

另请参阅:

JmDNS.getName()

getHostNames

java.lang.String[] getHostNames()

Return the list HostName associated with this JmmDNS instance.

返回:

list of host names

另请参阅:

JmDNS.getHostName()

getInetAddresses

java.net.InetAddress[] getInetAddresses()
                                 throws java.io.IOException

Return the list of addresses of the interface to which this instance of JmmDNS is bound.

返回:

list of Internet Address

抛出:

java.io.IOException

另请参阅:

JmDNS.getInetAddress()

getInterfaces

@Deprecated
java.net.InetAddress[] getInterfaces()
                                           throws java.io.IOException

已过时。 do not use this implementation yields unpredictable results use getInetAddresses()

Return the list of addresses of the interface to which this instance of JmmDNS is bound.

返回:

list of Internet Address

抛出:

java.io.IOException

另请参阅:

JmDNS.getInterface()

getDNS

JmDNS[] getDNS()

Return a list of all the registered JmDNS instances

返回:

list of JmDNS instances

getServiceInfos

ServiceInfo[] getServiceInfos(java.lang.String type,
                              java.lang.String name)

Get service information. If the information is not cached, the method will block until updated information is received on all DNS.

Usage note: Do not call this method from the AWT event dispatcher thread. You will make the user interface unresponsive.

参数:

type - fully qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

返回:

list of service info. If no service info is found the list is empty.

另请参阅:

JmDNS.getServiceInfo(java.lang.String, java.lang.String)

getServiceInfos

ServiceInfo[] getServiceInfos(java.lang.String type,
                              java.lang.String name,
                              long timeout)

Get service information. If the information is not cached, the method will block until updated information is received on all DNS.

Usage note: If you call this method from the AWT event dispatcher thread, use a small timeout, or you will make the user interface unresponsive.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

timeout - timeout in milliseconds. Typical timeout should be 5s.

返回:

list of service info. If no service info is found the list is empty.

另请参阅:

JmDNS.getServiceInfo(java.lang.String, java.lang.String, long)

getServiceInfos

ServiceInfo[] getServiceInfos(java.lang.String type,
                              java.lang.String name,
                              boolean persistent)

Get service information. If the information is not cached, the method will block until updated information is received on all DNS.

Usage note: If you call this method from the AWT event dispatcher thread, use a small timeout, or you will make the user interface unresponsive.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

persistent - if true ServiceListener.resolveService will be called whenever new new information is received.

返回:

list of service info. If no service info is found the list is empty.

另请参阅:

JmDNS.getServiceInfo(java.lang.String, java.lang.String, boolean)

getServiceInfos

ServiceInfo[] getServiceInfos(java.lang.String type,
                              java.lang.String name,
                              boolean persistent,
                              long timeout)

Get service information. If the information is not cached, the method will block until updated information is received on all DNS.

Usage note: If you call this method from the AWT event dispatcher thread, use a small timeout, or you will make the user interface unresponsive.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

timeout - timeout in milliseconds. Typical timeout should be 5s.

persistent - if true ServiceListener.resolveService will be called whenever new new information is received.

返回:

list of service info. If no service info is found the list is empty.

另请参阅:

JmDNS.getServiceInfo(java.lang.String, java.lang.String, boolean, long)

requestServiceInfo

void requestServiceInfo(java.lang.String type,
                        java.lang.String name)

Request service information. The information about the service is requested and the ServiceListener.resolveService method is called as soon as it is available.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

另请参阅:

JmDNS.requestServiceInfo(java.lang.String, java.lang.String)

requestServiceInfo

void requestServiceInfo(java.lang.String type,
                        java.lang.String name,
                        boolean persistent)

Request service information. The information about the service is requested and the ServiceListener.resolveService method is called as soon as it is available.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

persistent - if true ServiceListener.resolveService will be called whenever new new information is received.

另请参阅:

JmDNS.requestServiceInfo(java.lang.String, java.lang.String, boolean)

requestServiceInfo

void requestServiceInfo(java.lang.String type,
                        java.lang.String name,
                        long timeout)

Request service information. The information about the service is requested and the ServiceListener.resolveService method is called as soon as it is available.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

timeout - timeout in milliseconds

另请参阅:

JmDNS.requestServiceInfo(java.lang.String, java.lang.String, long)

requestServiceInfo

void requestServiceInfo(java.lang.String type,
                        java.lang.String name,
                        boolean persistent,
                        long timeout)

Request service information. The information about the service is requested and the ServiceListener.resolveService method is called as soon as it is available.

参数:

type - full qualified service type, such as _http._tcp.local. .

name - unqualified service name, such as foobar .

persistent - if true ServiceListener.resolveService will be called whenever new new information is received.

timeout - timeout in milliseconds

另请参阅:

JmDNS.requestServiceInfo(java.lang.String, java.lang.String, boolean, long)

addServiceTypeListener

void addServiceTypeListener(ServiceTypeListener listener)
                     throws java.io.IOException

Listen for service types.

参数:

listener - listener for service types

抛出:

java.io.IOException

另请参阅:

JmDNS.addServiceTypeListener(javax.jmdns.ServiceTypeListener)

removeServiceTypeListener

void removeServiceTypeListener(ServiceTypeListener listener)

Remove listener for service types.

参数:

listener - listener for service types

另请参阅:

JmDNS.removeServiceTypeListener(javax.jmdns.ServiceTypeListener)

addServiceListener

void addServiceListener(java.lang.String type,
                        ServiceListener listener)

Listen for services of a given type. The type has to be a fully qualified type name such as _http._tcp.local..

参数:

type - full qualified service type, such as _http._tcp.local..

listener - listener for service updates

另请参阅:

JmDNS.addServiceListener(java.lang.String, javax.jmdns.ServiceListener)

removeServiceListener

void removeServiceListener(java.lang.String type,
                           ServiceListener listener)

Remove listener for services of a given type.

参数:

type - full qualified service type, such as _http._tcp.local..

listener - listener for service updates

另请参阅:

JmDNS.removeServiceListener(java.lang.String, javax.jmdns.ServiceListener)

registerService

void registerService(ServiceInfo info)
              throws java.io.IOException

Register a service. The service is registered for access by other jmdns clients. The name of the service may be changed to make it unique.
Note the Service info is cloned for each network interface.

参数:

info - service info to register

抛出:

java.io.IOException

另请参阅:

JmDNS.registerService(javax.jmdns.ServiceInfo)

unregisterService

void unregisterService(ServiceInfo info)

Unregister a service. The service should have been registered.

参数:

info - service info to remove

另请参阅:

JmDNS.unregisterService(javax.jmdns.ServiceInfo)

unregisterAllServices

void unregisterAllServices()

Unregister all services.

另请参阅:

JmDNS.unregisterAllServices()

registerServiceType

void registerServiceType(java.lang.String type)

Register a service type. If this service type was not already known, all service listeners will be notified of the new service type. Service types are automatically registered as they are discovered.

参数:

type - full qualified service type, such as _http._tcp.local..

另请参阅:

JmDNS.registerServiceType(java.lang.String)

list

ServiceInfo[] list(java.lang.String type)

Returns a list of service infos of the specified type.

参数:

type - Service type name, such as _http._tcp.local..

返回:

An array of service instance.

另请参阅:

JmDNS.list(java.lang.String)

list

ServiceInfo[] list(java.lang.String type,
                   long timeout)

Returns a list of service infos of the specified type.

参数:

type - Service type name, such as _http._tcp.local..

timeout - timeout in milliseconds. Typical timeout should be 6s.

返回:

An array of service instance.

另请参阅:

JmDNS.list(java.lang.String, long)

listBySubtype

java.util.Map<java.lang.String,ServiceInfo[]> listBySubtype(java.lang.String type)

Returns a list of service infos of the specified type sorted by subtype. Any service that do not register a subtype is listed in the empty subtype section.

参数:

type - Service type name, such as _http._tcp.local..

返回:

A dictionary of service info by subtypes.

另请参阅:

JmDNS.listBySubtype(java.lang.String)

listBySubtype

java.util.Map<java.lang.String,ServiceInfo[]> listBySubtype(java.lang.String type,
                                                            long timeout)

Returns a list of service infos of the specified type sorted by subtype. Any service that do not register a subtype is listed in the empty subtype section.

参数:

type - Service type name, such as _http._tcp.local..

timeout - timeout in milliseconds. Typical timeout should be 6s.

返回:

A dictionary of service info by subtypes.

另请参阅:

JmDNS.listBySubtype(java.lang.String, long)

addNetworkTopologyListener

void addNetworkTopologyListener(NetworkTopologyListener listener)

Listen to network changes.

参数:

listener - listener for network changes

removeNetworkTopologyListener

void removeNetworkTopologyListener(NetworkTopologyListener listener)

Remove listener for network changes.

参数:

listener - listener for network changes

networkListeners

NetworkTopologyListener[] networkListeners()

Returns list of network change listeners

返回:

list of network change listeners