Package wt.security

Class NetAccess

java.lang.Object

wt.security.Access

wt.security.NetAccess

public class NetAccess
extends wt.security.Access

Class that provides wrappers to priviledged network methods using the wt.security package. This allows applets to perform network operations that are typically restricted by the sandbox.

Supported API: true

Method Summary

Modifier and Type	Method	Description
final void	connect(URLConnection connection)	Wrapper for URLConnection.connect() method.
final byte[]	getAddress(InetAddress inetAddress)	Wrapper for InetAddress.getAddress() method Supported API: true
final String	getCanonicalHostName(InetAddress inetAddress)	Wrapper for InetAddress.getCanonicalHostName() method Supported API: true
final String	getHostAddress(InetAddress inetAddress)	Wrapper for InetAddress.getHostAddress() method Supported API: true
final String	getHostName(InetAddress inetAddress)	Wrapper for InetAddress.getHostName() method Supported API: true
final InputStream	getInputStream(URLConnection connection)	Wrapper for URLConnection.getInputStream() method.
final String	getJvmName()	Wrapper for ManagementFactory.getRuntimeMXBean().getName(), which internally invokes getLocalHost().
final InetAddress	getLocalHost()	Wrapper for InetAddress.getLocalHost() method Supported API: true
static NetAccess	getNetAccess()	Get instance of NetAccess.
static NetAccess	getNetAccess(Frame parentFrame)	Get instance of NetAccess.
final int	getResponseCode(HttpURLConnection httpUrlConnection)	Wrapper for HttpURLConnection.getResponseCode() method.

Methods inherited from class java.lang.Object

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

Method Details

getNetAccess

public static NetAccess getNetAccess(Frame parentFrame)

Get instance of NetAccess. This instance can then be used to perform network operations that are typically restricted by the sandbox.

Supported API: true

Parameters:

parentFrame - the parent frame for security dialog boxes that may be presented

getNetAccess

public static NetAccess getNetAccess()

Get instance of NetAccess. This instance can then be used to perform network operations that are typically restricted by the sandbox.

Supported API: true

connect

public final void connect(URLConnection connection)
                   throws WTSecurityException,
IOException

Wrapper for URLConnection.connect() method.

Supported API: true

Parameters:

connection - the URLConnection object to be connected

Throws:

WTSecurityException

IOException

getInputStream

public final InputStream getInputStream(URLConnection connection)
                                 throws WTSecurityException,
IOException

Wrapper for URLConnection.getInputStream() method. This can be necessary if the connection is an HttpURLConnection where getInstanceFollowRedirects() returns true and the request is redirected to a host other than that which the security manager allows (e.g. a host other than that which an applet came from).

Supported API: true

Parameters:

connection - the URLConnection to get the input stream from

Returns:

InputStream resulting from connection.getInputStream()

Throws:

WTSecurityException

IOException

getResponseCode

public final int getResponseCode(HttpURLConnection httpUrlConnection)
                          throws WTSecurityException,
IOException

Wrapper for HttpURLConnection.getResponseCode() method. This can be necessary when HttpURLConnection.getInstanceFollowRedirects() returns true and the request is redirected to a host other than that which the security manager allows (e.g. a host other than that which an applet came from).

Supported API: true

Parameters:

httpUrlConnection - the HttpURLConnection to get the response code from

Returns:

response code resulting from httpUrlConnection.getResponseCode()

Throws:

WTSecurityException

IOException

getLocalHost

public final InetAddress getLocalHost()
                               throws WTSecurityException,
UnknownHostException

Wrapper for InetAddress.getLocalHost() method

Supported API: true

Throws:

WTSecurityException

UnknownHostException

getAddress

public final byte[] getAddress(InetAddress inetAddress)
                        throws WTSecurityException

Wrapper for InetAddress.getAddress() method

Supported API: true

Parameters:

inetAddress - the InetAddress object to retrieve address for

Throws:

WTSecurityException

getHostAddress

public final String getHostAddress(InetAddress inetAddress)
                            throws WTSecurityException

Wrapper for InetAddress.getHostAddress() method

Supported API: true

Parameters:

inetAddress - the InetAddress object to retrieve address for

Throws:

WTSecurityException

getHostName

public final String getHostName(InetAddress inetAddress)
                         throws WTSecurityException

Wrapper for InetAddress.getHostName() method

Supported API: true

Parameters:

inetAddress - the InetAddress object to retrieve address for

Throws:

WTSecurityException

getCanonicalHostName

public final String getCanonicalHostName(InetAddress inetAddress)
                                  throws WTSecurityException

Wrapper for InetAddress.getCanonicalHostName() method

Supported API: true

Parameters:

inetAddress - the InetAddress object to retrieve canonical hostname for

Throws:

WTSecurityException

getJvmName

public final String getJvmName()
                        throws WTSecurityException

Wrapper for ManagementFactory.getRuntimeMXBean().getName(), which internally invokes getLocalHost().

Supported API: true

Throws:

WTSecurityException