org.safs.net

Class NetUtilities

java.lang.Object

org.safs.net.NetUtilities

public class NetUtilities
extends java.lang.Object

Utilities for network.

Author:

Lei Wang

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ARG_TEST_HOSTS "-testhosts" followed by a series of hostname separated by semi-colon, such as "-testhosts host1;host2;host3;host4"
static java.lang.String	LOCAL_HOST 'localhost'
static java.lang.String	LOCAL_HOST_IP '127.0.0.1'
static java.lang.String	LOCAL_HOST_IPV6_PREFIX_1 '::1'
static java.lang.String	LOCAL_HOST_IPV6_PREFIX_FE80 'fe80::'
static java.lang.String	PATTERN_MAC_ADDRESS "^([0-9A-F]{2}[:-]){5}([0-9A-F]{2})$" the regex pattern for a MAC address.

Constructor Summary

Constructors

Constructor and Description
NetUtilities()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	getHostIP(java.lang.String hostname) Get the host's IP address.
static java.lang.String	getLocalHostIP() Get the localhost's IP Address.
static java.lang.String	getLocalHostName()
static boolean	isHttpURLReachable(java.net.URL url, int timeout) Detect if url is reachable withing timeout.
static boolean	isLocalHost(java.lang.String host) Test if the host is local according to the host's name.
static boolean	isMacAddress(java.lang.String address)
static void	main(java.lang.String[] args) Test some implementations of this class. To test isLocalHost(String) and getHostIP(String), call as following: org.safs.net.NetUtilities -testhosts host1;host2;host3;host4
static java.lang.String	readHttpURL(java.net.URL url, java.lang.String encoding, int timeout) Read from url connection. If the HTTP response code is 200, then the content is read from standard out stream. Otherwise, the content is read from the standard error stream.

Methods inherited from class java.lang.Object

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

Field Detail

LOCAL_HOST

public static final java.lang.String LOCAL_HOST

'localhost'

See Also:

Constant Field Values

LOCAL_HOST_IP

public static final java.lang.String LOCAL_HOST_IP

'127.0.0.1'

See Also:

Constant Field Values

LOCAL_HOST_IPV6_PREFIX_1

public static final java.lang.String LOCAL_HOST_IPV6_PREFIX_1

'::1'

See Also:

Constant Field Values

LOCAL_HOST_IPV6_PREFIX_FE80

public static final java.lang.String LOCAL_HOST_IPV6_PREFIX_FE80

'fe80::'

See Also:

Constant Field Values

PATTERN_MAC_ADDRESS

public static final java.lang.String PATTERN_MAC_ADDRESS

"^([0-9A-F]{2}[:-]){5}([0-9A-F]{2})$" the regex pattern for a MAC address.

See Also:

Constant Field Values

ARG_TEST_HOSTS

public static final java.lang.String ARG_TEST_HOSTS

"-testhosts" followed by a series of hostname separated by semi-colon, such as "-testhosts host1;host2;host3;host4"

See Also:

Constant Field Values

Constructor Detail

NetUtilities

public NetUtilities()

Method Detail

isLocalHost

public static boolean isLocalHost(java.lang.String host)

Test if the host is local according to the host's name.

Parameters:

host - String, the name/ip of the host

Returns:

boolean true if the host is local.

isMacAddress

public static boolean isMacAddress(java.lang.String address)

Parameters:

address - String, the address to be tested

Returns:

boolean true if address is a MAC address

getHostIP

public static java.lang.String getHostIP(java.lang.String hostname)

Get the host's IP address.

Parameters:

hostname - String, the name of a host

Returns:

String, the host's IP address.

getLocalHostIP

public static java.lang.String getLocalHostIP()

Get the localhost's IP Address. Try Java's API to get it firstly, if it cannot be got the try command NativeWrapper.COMMAND_IPCONFIG.

getLocalHostName

public static java.lang.String getLocalHostName()

Returns:

String, the name of localhost

readHttpURL

public static java.lang.String readHttpURL(java.net.URL url,
                                           java.lang.String encoding,
                                           int timeout)

Read from url connection.
If the HTTP response code is 200, then the content is read from standard out stream.
Otherwise, the content is read from the standard error stream.

Parameters:

url - URL, the url from where to read content

encoding - String, the encoding used to read the URL, such as "utf-8"

timeout - int, the connect timeout in milliseconds

Returns:

String the content read from url connection.

isHttpURLReachable

public static boolean isHttpURLReachable(java.net.URL url,
                                         int timeout)

Detect if url is reachable withing timeout.

Parameters:

url - URL, the url from where to read content

timeout - int, the connect timeout in milliseconds

Returns:

booelan if the URL is reachable.

main

public static void main(java.lang.String[] args)

Test some implementations of this class.
To test isLocalHost(String) and getHostIP(String), call as following:
org.safs.net.NetUtilities -testhosts host1;host2;host3;host4

Parameters:

args - String[],
-testhosts followed by a series of hostname separated by semi-colon, such as "-testhosts host1;host2;host3;host4", used to test method isLocalHost(String) and getHostIP(String)
if IndependantLog.ARG_DEBUG followed by host name such as machine.domain.com, then #test_getHostIp(String[])