de.javastream.java.net.jmac

Class MacCache

java.lang.Object

de.javastream.java.net.jmac.MacCache

public final class MacCache
extends Object

A MAC cache request.

An example of retrieving a remote addresses MAC address:

 String ipAddress = ?;

 String macAddress = MacCache.get(ipAddress);
 if(macAddress != null)
 {
    System.out.println("Found MAC: " + macAddress);
 }
 else
 {
    System.out.println("Cannot find MAC address for the provided address.");
 }
 

Method Summary

Modifier and Type	Method and Description
static String	get(String localAddress) Return the MAC address of a currently native-cached local address.
static MacCache	getInstance()
String	getMacFromAddress(String localAddress) Return the MAC address of a currently native-cached local address.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static MacCache getInstance()

getMacFromAddress

public String getMacFromAddress(String localAddress)
                         throws UnsupportedOperatingSystemException

Return the MAC address of a currently native-cached local address.

The returned MAC address, if not null, will always return leading-zeroed for each group of two (2) hexadecimal digits with the separator always being a dash (-). For example: ff-00-ff-00-ff-00

This method is non-blocking.

Parameters:

localAddress - The address.

Returns:

The MAC address of the provided address; null, if not cached.

Throws:

UnsupportedOperatingSystemException - Thrown if the current operating system is not supported.

get

public static String get(String localAddress)

Return the MAC address of a currently native-cached local address.

The returned MAC address, if not null, will always return leading-zeroed for each group of two (2) hexadecimal digits with the separator always being a dash (-). For example: ff-00-ff-00-ff-00

This method is non-blocking.

Parameters:

localAddress - The address.

Returns:

The MAC address of the provided address; null, if not cached or system is not supported.