javax.jmdns

类 ServiceInfo

java.lang.Object

javax.jmdns.ServiceInfo

所有已实现的接口:

java.lang.Cloneable

直接已知子类:

ServiceInfoImpl

public abstract class ServiceInfo
extends java.lang.Object
implements java.lang.Cloneable

The fully qualified service name is build using up to 5 components with the following structure:

            <app>.<protocol>.<servicedomain>.<parentdomain>.

 <Instance>.<app>.<protocol>.<servicedomain>.<parentdomain>.

 <sub>._sub.<app>.<protocol>.<servicedomain>.<parentdomain>.
 

1. <servicedomain>.<parentdomain>: This is the domain scope of the service typically "local.", but this can also be something similar to "in-addr.arpa." or "ip6.arpa."
2. <protocol>: This is either "_tcp" or "_udp"
3. <app>: This define the application protocol. Typical example are "_http", "_ftp", etc.
4. <Instance>: This is the service name
5. <sub>: This is the subtype for the application protocol

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	ServiceInfo.Fields Fields for the fully qualified map.

构造器概要

构造器

构造器和说明
ServiceInfo()

方法概要

限定符和类型	方法和说明
ServiceInfo	clone()
static ServiceInfo	create(java.util.Map<ServiceInfo.Fields,java.lang.String> qualifiedNameMap, int port, int weight, int priority, boolean persistent, java.util.Map<java.lang.String,?> props) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, int weight, int priority, boolean persistent, byte[] text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, int weight, int priority, boolean persistent, java.util.Map<java.lang.String,?> props) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, int weight, int priority, boolean persistent, java.lang.String text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, int weight, int priority, byte[] text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, int weight, int priority, java.util.Map<java.lang.String,?> props) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, int weight, int priority, java.lang.String text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, int port, java.lang.String text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, int weight, int priority, boolean persistent, byte[] text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, int weight, int priority, boolean persistent, java.util.Map<java.lang.String,?> props) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, int weight, int priority, boolean persistent, java.lang.String text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, int weight, int priority, byte[] text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, int weight, int priority, java.util.Map<java.lang.String,?> props) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, int weight, int priority, java.lang.String text) Construct a service description for registering with JmDNS.
static ServiceInfo	create(java.lang.String type, java.lang.String name, java.lang.String subtype, int port, java.lang.String text) Construct a service description for registering with JmDNS.
abstract java.net.InetAddress	getAddress() 已过时。 since 3.1.8
abstract java.lang.String	getApplication() Returns the application of the service info suitable for printing.
abstract java.lang.String	getDomain() Returns the domain of the service info suitable for printing.
abstract java.lang.String	getHostAddress() 已过时。 since 3.2.3
abstract java.lang.String[]	getHostAddresses() Returns the host IP addresses string in textual presentation.
abstract java.net.Inet4Address	getInet4Address() 已过时。 since 3.2.3
abstract java.net.Inet4Address[]	getInet4Addresses() Returns a list of all IPv4 InetAddresses that can be used for this service.
abstract java.net.Inet6Address	getInet6Address() 已过时。 since 3.2.3
abstract java.net.Inet6Address[]	getInet6Addresses() Returns a list of all IPv6 InetAddresses that can be used for this service.
abstract java.net.InetAddress	getInetAddress() 已过时。 since 3.2.3
abstract java.net.InetAddress[]	getInetAddresses() Returns a list of all InetAddresses that can be used for this service.
abstract java.lang.String	getKey() The key is used to retrieve service info in hash tables.
abstract java.lang.String	getName() Unqualified service instance name, such as foobar .
abstract java.lang.String	getNiceTextString() Returns a description of the service info suitable for printing.
abstract int	getPort() Get the port for the service.
abstract int	getPriority() Get the priority of the service.
abstract byte[]	getPropertyBytes(java.lang.String name) Get a property of the service.
abstract java.util.Enumeration<java.lang.String>	getPropertyNames() Enumeration of the property names.
abstract java.lang.String	getPropertyString(java.lang.String name) Get a property of the service.
abstract java.lang.String	getProtocol() Returns the protocol of the service info suitable for printing.
abstract java.lang.String	getQualifiedName() Fully qualified service name, such as foobar.
abstract java.util.Map<ServiceInfo.Fields,java.lang.String>	getQualifiedNameMap() Returns a dictionary of the fully qualified name component of this service.
abstract java.lang.String	getServer() Get the name of the server.
abstract java.lang.String	getSubtype() Returns the sub type of the service info suitable for printing.
abstract byte[]	getTextBytes() Get the text for the service as raw bytes.
abstract java.lang.String	getTextString() 已过时。 since 3.1.7
abstract java.lang.String	getType() Fully qualified service type name, such as _http.
abstract java.lang.String	getTypeWithSubtype() Fully qualified service type name with the subtype if appropriate, such as _printer.
abstract java.lang.String	getURL() 已过时。 since 3.2.3
abstract java.lang.String	getURL(java.lang.String protocol) 已过时。 since 3.2.3
abstract java.lang.String[]	getURLs() Get the list of URL for this service.
abstract java.lang.String[]	getURLs(java.lang.String protocol) Get the list of URL for this service.
abstract int	getWeight() Get the weight of the service.
abstract boolean	hasData() Returns true if the service info is filled with data.
abstract boolean	hasSameAddresses(ServiceInfo other) Compare addresses of another ServiceInfo
abstract boolean	hasServer() Returns true if the service info has a server
abstract boolean	isPersistent() Returns true if ServiceListener.resolveService will be called whenever new new information is received.
abstract void	setText(byte[] text) Set the text for the service.
abstract void	setText(java.util.Map<java.lang.String,?> props) Set the text for the service.

从类继承的方法 java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ServiceInfo

public ServiceInfo()

方法详细资料

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 java.lang.String text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

text - string describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 java.lang.String text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

text - string describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 int weight,
                                 int priority,
                                 java.lang.String text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

text - string describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 int weight,
                                 int priority,
                                 java.lang.String text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

text - string describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 int weight,
                                 int priority,
                                 java.util.Map<java.lang.String,?> props)

Construct a service description for registering with JmDNS. The properties hashtable must map property names to either Strings or byte arrays describing the property values.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

props - properties describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 int weight,
                                 int priority,
                                 java.util.Map<java.lang.String,?> props)

Construct a service description for registering with JmDNS. The properties hashtable must map property names to either Strings or byte arrays describing the property values.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

props - properties describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 int weight,
                                 int priority,
                                 byte[] text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

text - bytes describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 int weight,
                                 int priority,
                                 byte[] text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

text - bytes describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 java.lang.String text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

text - string describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 java.lang.String text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

text - string describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 java.util.Map<java.lang.String,?> props)

Construct a service description for registering with JmDNS. The properties hashtable must map property names to either Strings or byte arrays describing the property values.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

props - properties describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 java.util.Map<java.lang.String,?> props)

Construct a service description for registering with JmDNS. The properties hashtable must map property names to either Strings or byte arrays describing the property values.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

props - properties describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 byte[] text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

text - bytes describing the service

返回:

new service info

create

public static ServiceInfo create(java.lang.String type,
                                 java.lang.String name,
                                 java.lang.String subtype,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 byte[] text)

Construct a service description for registering with JmDNS.

参数:

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

name - unqualified service instance name, such as foobar

subtype - service subtype see draft-cheshire-dnsext-dns-sd-06.txt chapter 7.1 Selective Instance Enumeration

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

text - bytes describing the service

返回:

new service info

create

public static ServiceInfo create(java.util.Map<ServiceInfo.Fields,java.lang.String> qualifiedNameMap,
                                 int port,
                                 int weight,
                                 int priority,
                                 boolean persistent,
                                 java.util.Map<java.lang.String,?> props)

Construct a service description for registering with JmDNS. The properties hashtable must map property names to either Strings or byte arrays describing the property values.

参数:

qualifiedNameMap - dictionary of values to build the fully qualified service name. Mandatory keys are Application and Instance. The Domain default is local, the Protocol default is tcp and the subtype default is none.

port - the local port on which the service runs

weight - weight of the service

priority - priority of the service

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

props - properties describing the service

返回:

new service info

hasData

public abstract boolean hasData()

Returns true if the service info is filled with data.

返回:

true if the service info has data, false otherwise.

getType

public abstract java.lang.String getType()

Fully qualified service type name, such as _http._tcp.local.

返回:

service type name

getTypeWithSubtype

public abstract java.lang.String getTypeWithSubtype()

Fully qualified service type name with the subtype if appropriate, such as _printer._sub._http._tcp.local.

返回:

service type name

getName

public abstract java.lang.String getName()

Unqualified service instance name, such as foobar .

返回:

service name

getKey

public abstract java.lang.String getKey()

The key is used to retrieve service info in hash tables.
The key is the lower case qualified name.

返回:

the key

getQualifiedName

public abstract java.lang.String getQualifiedName()

Fully qualified service name, such as foobar._http._tcp.local. .

返回:

qualified service name

getServer

public abstract java.lang.String getServer()

Get the name of the server. Note: This will be an empty string if no value has been set

返回:

server name

hasServer

public abstract boolean hasServer()

Returns true if the service info has a server

返回:

true if the service info has a server specified, false otherwise.

getHostAddress

@Deprecated
public abstract java.lang.String getHostAddress()

已过时。 since 3.2.3

Returns the host IP address string in textual presentation.
Note: This can be either an IPv4 or an IPv6 representation.

返回:

the host raw IP address in a string format.

另请参阅:

getHostAddresses()

getHostAddresses

public abstract java.lang.String[] getHostAddresses()

Returns the host IP addresses string in textual presentation.

返回:

list of host raw IP address in a string format.

getAddress

@Deprecated
public abstract java.net.InetAddress getAddress()

已过时。 since 3.1.8

Get the host address of the service.

返回:

host Internet address

另请参阅:

getInetAddresses()

getInetAddress

@Deprecated
public abstract java.net.InetAddress getInetAddress()

已过时。 since 3.2.3

Get the InetAddress of the service. This will return the IPv4 if it exist, otherwise it return the IPv6 if set.
Note: This return null if the service IP address cannot be resolved.

返回:

Internet address

另请参阅:

getInetAddresses()

getInet4Address

@Deprecated
public abstract java.net.Inet4Address getInet4Address()

已过时。 since 3.2.3

Get the IPv4 InetAddress of the service.
Note: This return null if the service IPv4 address cannot be resolved.

返回:

Internet address

另请参阅:

getInet4Addresses()

getInet6Address

@Deprecated
public abstract java.net.Inet6Address getInet6Address()

已过时。 since 3.2.3

Get the IPv6 InetAddress of the service.
Note: This return null if the service IPv6 address cannot be resolved.

返回:

Internet address

另请参阅:

getInet6Addresses()

getInetAddresses

public abstract java.net.InetAddress[] getInetAddresses()

Returns a list of all InetAddresses that can be used for this service.

In a multi-homed environment service info can be associated with more than one address.

返回:

list of InetAddress objects

getInet4Addresses

public abstract java.net.Inet4Address[] getInet4Addresses()

Returns a list of all IPv4 InetAddresses that can be used for this service.

In a multi-homed environment service info can be associated with more than one address.

返回:

list of InetAddress objects

getInet6Addresses

public abstract java.net.Inet6Address[] getInet6Addresses()

Returns a list of all IPv6 InetAddresses that can be used for this service.

In a multi-homed environment service info can be associated with more than one address.

返回:

list of InetAddress objects

getPort

public abstract int getPort()

Get the port for the service.

返回:

service port

getPriority

public abstract int getPriority()

Get the priority of the service.

返回:

service priority

getWeight

public abstract int getWeight()

Get the weight of the service.

返回:

service weight

getTextBytes

public abstract byte[] getTextBytes()

Get the text for the service as raw bytes.

返回:

raw service text

getTextString

@Deprecated
public abstract java.lang.String getTextString()

已过时。 since 3.1.7

Get the text for the service. This will interpret the text bytes as a UTF8 encoded string. Will return null if the bytes are not a valid UTF8 encoded string.
Note: Do not use. This method make the assumption that the TXT record is one string. This is false. The TXT record is a series of key value pairs.

返回:

service text

另请参阅:

getPropertyNames(), getPropertyBytes(String), getPropertyString(String)

getURL

@Deprecated
public abstract java.lang.String getURL()

已过时。 since 3.2.3

Get the URL for this service. An http URL is created by combining the address, port, and path properties.

返回:

service URL

另请参阅:

getURLs()

getURLs

public abstract java.lang.String[] getURLs()

Get the list of URL for this service. An http URL is created by combining the address, port, and path properties.

返回:

list of service URL

getURL

@Deprecated
public abstract java.lang.String getURL(java.lang.String protocol)

已过时。 since 3.2.3

Get the URL for this service. An URL is created by combining the protocol, address, port, and path properties.

参数:

protocol - requested protocol

返回:

service URL

另请参阅:

getURLs()

getURLs

public abstract java.lang.String[] getURLs(java.lang.String protocol)

Get the list of URL for this service. An URL is created by combining the protocol, address, port, and path properties.

参数:

protocol - requested protocol

返回:

list of service URL

getPropertyBytes

public abstract byte[] getPropertyBytes(java.lang.String name)

Get a property of the service. This involves decoding the text bytes into a property list. Returns null if the property is not found or the text data could not be decoded correctly.

参数:

name - property name

返回:

raw property text

getPropertyString

public abstract java.lang.String getPropertyString(java.lang.String name)

Get a property of the service. This involves decoding the text bytes into a property list. Returns null if the property is not found, the text data could not be decoded correctly, or the resulting bytes are not a valid UTF8 string.

参数:

name - property name

返回:

property text

getPropertyNames

public abstract java.util.Enumeration<java.lang.String> getPropertyNames()

Enumeration of the property names.

返回:

property name enumeration

getNiceTextString

public abstract java.lang.String getNiceTextString()

Returns a description of the service info suitable for printing.

返回:

service info description

setText

public abstract void setText(byte[] text)
                      throws java.lang.IllegalStateException

Set the text for the service. Setting the text will fore a re-announce of the service.

参数:

text - the raw byte representation of the text field.

抛出:

java.lang.IllegalStateException - if attempting to set the text for a non persistent service info.

setText

public abstract void setText(java.util.Map<java.lang.String,?> props)
                      throws java.lang.IllegalStateException

Set the text for the service. Setting the text will fore a re-announce of the service.

参数:

props - a key=value map that will be encoded into raw bytes.

抛出:

java.lang.IllegalStateException - if attempting to set the text for a non persistent service info.

isPersistent

public abstract boolean isPersistent()

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

返回:

the persistent

getDomain

public abstract java.lang.String getDomain()

Returns the domain of the service info suitable for printing.

返回:

service domain

getProtocol

public abstract java.lang.String getProtocol()

Returns the protocol of the service info suitable for printing.

返回:

service protocol

getApplication

public abstract java.lang.String getApplication()

Returns the application of the service info suitable for printing.

返回:

service application

getSubtype

public abstract java.lang.String getSubtype()

Returns the sub type of the service info suitable for printing.

返回:

service sub type

getQualifiedNameMap

public abstract java.util.Map<ServiceInfo.Fields,java.lang.String> getQualifiedNameMap()

Returns a dictionary of the fully qualified name component of this service.

返回:

dictionary of the fully qualified name components

hasSameAddresses

public abstract boolean hasSameAddresses(ServiceInfo other)

Compare addresses of another ServiceInfo

参数:

other - ServiceInfo to compare

返回:

true if addresses are the same, false if not

clone

public ServiceInfo clone()

覆盖:

clone 在类中 java.lang.Object