jcifs.netbios

Class NameServiceClientImpl

java.lang.Object

jcifs.netbios.NameServiceClientImpl

All Implemented Interfaces:

Runnable, NameServiceClient

public class NameServiceClientImpl
extends Object
implements Runnable, NameServiceClient

Author:

mbechler

Constructor Summary

Constructors

Constructor and Description
NameServiceClientImpl(CIFSContext tc)

Method Summary

Modifier and Type	Method and Description
UniAddress[]	getAllByName(String hostname, boolean possibleNTDomainOrWorkgroup) Lookup addresses for the given hostname.
UniAddress	getByName(String hostname) Determines the address of a host given it's host name.
UniAddress	getByName(String hostname, boolean possibleNTDomainOrWorkgroup) Lookup hostname and return it's UniAddress.
Lmhosts	getLmhosts()
NbtAddress	getLocalHost()
Name	getLocalName()
NbtAddress[]	getNbtAllByAddress(NetbiosAddress addr) Retrieve all addresses of a host by it's address.
NbtAddress[]	getNbtAllByAddress(String host) Retrieve all addresses of a host by it's address.
NbtAddress[]	getNbtAllByAddress(String host, int type, String scope) Retrieve all addresses of a host by it's address.
NbtAddress[]	getNbtAllByName(String host, int type, String scope, InetAddress svr) Retrieve all addresses of a host by it's name.
NbtAddress	getNbtByName(String host) Determines the address of a host given it's host name.
NbtAddress	getNbtByName(String host, int type, String scope) Determines the address of a host given it's host name.
NbtAddress	getNbtByName(String host, int type, String scope, InetAddress svr) Determines the address of a host given it's host name.
NbtAddress[]	getNodeStatus(NetbiosAddress addr)
Name	getUnknownName()
void	run()

Methods inherited from class java.lang.Object

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

Constructor Detail

NameServiceClientImpl

public NameServiceClientImpl(CIFSContext tc)

Parameters:

tc -

Method Detail

run

public void run()

Specified by:

run in interface Runnable

getNodeStatus

public NbtAddress[] getNodeStatus(NetbiosAddress addr)
                           throws UnknownHostException

Specified by:

getNodeStatus in interface NameServiceClient

Returns:

the node status responses

Throws:

UnknownHostException

getNbtByName

public NbtAddress getNbtByName(String host)
                        throws UnknownHostException

Description copied from interface: NameServiceClient

Determines the address of a host given it's host name. The name can be a NetBIOS name like "freto" or an IP address like "192.168.1.15". It cannot be a DNS name; the analygous UniAddress or InetAddress getByName methods can be used for that.

Specified by:

getNbtByName in interface NameServiceClient

Parameters:

host - hostname to resolve

Returns:

the resolved address

Throws:

UnknownHostException - if there is an error resolving the name

getNbtByName

public NbtAddress getNbtByName(String host,
                               int type,
                               String scope)
                        throws UnknownHostException

Description copied from interface: NameServiceClient

Determines the address of a host given it's host name. NetBIOS names also have a type. Types(aka Hex Codes) are used to distinguish the various services on a host. Here is a fairly complete list of NetBIOS hex codes. Scope is not used but is still functional in other NetBIOS products and so for completeness it has been implemented. A scope of null or "" signifies no scope.

Specified by:

getNbtByName in interface NameServiceClient

Parameters:

host - the name to resolve

type - the hex code of the name

scope - the scope of the name

Returns:

the resolved address

Throws:

UnknownHostException - if there is an error resolving the name

getNbtByName

public NbtAddress getNbtByName(String host,
                               int type,
                               String scope,
                               InetAddress svr)
                        throws UnknownHostException

Description copied from interface: NameServiceClient

Determines the address of a host given it's host name. NetBIOS names also have a type. Types(aka Hex Codes) are used to distinguish the various services on a host. Here is a fairly complete list of NetBIOS hex codes. Scope is not used but is still functional in other NetBIOS products and so for completeness it has been implemented. A scope of null or "" signifies no scope. The additional svr parameter specifies the address to query. This might be the address of a specific host, a name server, or a broadcast address.

Specified by:

getNbtByName in interface NameServiceClient

Parameters:

host - the name to resolve

type - the hex code of the name

scope - the scope of the name

svr - server to query

Returns:

the resolved address

Throws:

UnknownHostException - if there is an error resolving the name

getNbtAllByName

public NbtAddress[] getNbtAllByName(String host,
                                    int type,
                                    String scope,
                                    InetAddress svr)
                             throws UnknownHostException

Description copied from interface: NameServiceClient

Retrieve all addresses of a host by it's name.

Specified by:

getNbtAllByName in interface NameServiceClient

Parameters:

host - hostname to lookup all addresses for

type - the hexcode of the name

scope - the scope of the name

svr - server to query

Returns:

the resolved addresses

Throws:

UnknownHostException

getNbtAllByAddress

public NbtAddress[] getNbtAllByAddress(String host)
                                throws UnknownHostException

Description copied from interface: NameServiceClient

Retrieve all addresses of a host by it's address. NetBIOS hosts can have many names for a given IP address. The name and IP address make the NetBIOS address. This provides a way to retrieve the other names for a host with the same IP address.

Specified by:

getNbtAllByAddress in interface NameServiceClient

Parameters:

host - hostname to lookup all addresses for

Returns:

resolved addresses

Throws:

UnknownHostException - if there is an error resolving the name

getNbtAllByAddress

public NbtAddress[] getNbtAllByAddress(String host,
                                       int type,
                                       String scope)
                                throws UnknownHostException

Description copied from interface: NameServiceClient

Retrieve all addresses of a host by it's address. NetBIOS hosts can have many names for a given IP address. The name and IP address make the NetBIOS address. This provides a way to retrieve the other names for a host with the same IP address. See NameServiceClient.getByName(java.lang.String, boolean) for a description of type and scope.

Specified by:

getNbtAllByAddress in interface NameServiceClient

Parameters:

host - hostname to lookup all addresses for

type - the hexcode of the name

scope - the scope of the name

Returns:

resolved addresses

Throws:

UnknownHostException - if there is an error resolving the name

getNbtAllByAddress

public NbtAddress[] getNbtAllByAddress(NetbiosAddress addr)
                                throws UnknownHostException

Description copied from interface: NameServiceClient

Retrieve all addresses of a host by it's address. NetBIOS hosts can have many names for a given IP address. The name and IP address make the NetBIOS address. This provides a way to retrieve the other names for a host with the same IP address.

Specified by:

getNbtAllByAddress in interface NameServiceClient

Parameters:

addr - the address to query

Returns:

resolved addresses

Throws:

UnknownHostException - if address cannot be resolved

getByName

public UniAddress getByName(String hostname)
                     throws UnknownHostException

Description copied from interface: NameServiceClient

Determines the address of a host given it's host name. The name can be a machine name like "jcifs.samba.org", or an IP address like "192.168.1.15".

Specified by:

getByName in interface NameServiceClient

Parameters:

hostname - NetBIOS or DNS hostname to resolve

Returns:

the found address

Throws:

UnknownHostException - if there is an error resolving the name

getByName

public UniAddress getByName(String hostname,
                            boolean possibleNTDomainOrWorkgroup)
                     throws UnknownHostException

Description copied from interface: NameServiceClient

Lookup hostname and return it's UniAddress. If the possibleNTDomainOrWorkgroup parameter is true an additional name query will be performed to locate a master browser.

Specified by:

getByName in interface NameServiceClient

Returns:

the first resolved address

Throws:

UnknownHostException

getAllByName

public UniAddress[] getAllByName(String hostname,
                                 boolean possibleNTDomainOrWorkgroup)
                          throws UnknownHostException

Description copied from interface: NameServiceClient

Lookup addresses for the given hostname.

Specified by:

getAllByName in interface NameServiceClient

Returns:

found addresses

Throws:

UnknownHostException

getLocalHost

public NbtAddress getLocalHost()

Specified by:

getLocalHost in interface NameServiceClient

Returns:

local host address

See Also:

NameServiceClient.getLocalHost()

getLocalName

public Name getLocalName()

Specified by:

getLocalName in interface NameServiceClient

Returns:

the local host name

See Also:

NameServiceClient.getLocalName()

getLmhosts

public Lmhosts getLmhosts()

Returns:

lmhosts file used

getUnknownName

public Name getUnknownName()

Specified by:

getUnknownName in interface NameServiceClient

Returns:

the unknown name

See Also:

NameServiceClient.getUnknownName()