org.xnio

Class Xnio

java.lang.Object

org.xnio.Xnio

public abstract class Xnio
extends java.lang.Object

The XNIO provider class.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Xnio(java.lang.String name) Construct an XNIO provider instance.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	allowBlocking(boolean newSetting) Allow (or disallow) blocking I/O on the current thread.
static void	checkBlockingAllowed() Perform a check for whether blocking is allowed on the current thread.
XnioWorker	createWorker(OptionMap optionMap) Construct a new XNIO worker.
XnioWorker	createWorker(java.lang.ThreadGroup threadGroup, OptionMap optionMap) Construct a new XNIO worker.
abstract XnioWorker	createWorker(java.lang.ThreadGroup threadGroup, OptionMap optionMap, java.lang.Runnable terminationTask) Construct a new XNIO worker.
static Xnio	getInstance() Get an XNIO provider instance from XNIO's class loader.
static Xnio	getInstance(java.lang.ClassLoader classLoader) Get an XNIO provider instance.
static Xnio	getInstance(java.lang.String provider) Get a specific XNIO provider instance from XNIO's class loader.
static Xnio	getInstance(java.lang.String provider, java.lang.ClassLoader classLoader) Get a specific XNIO provider instance.
java.lang.String	getName() Get the name of this XNIO provider.
protected java.lang.String	getProperty(java.lang.String name) Get an XNIO property.
protected java.lang.String	getProperty(java.lang.String name, java.lang.String defaultValue) Get an XNIO property.
XnioSsl	getSslProvider(javax.net.ssl.KeyManager[] keyManagers, javax.net.ssl.TrustManager[] trustManagers, OptionMap optionMap) Get an SSL provider for this XNIO provider.
XnioSsl	getSslProvider(OptionMap optionMap) Get an SSL provider for this XNIO provider.
static boolean	isBlockingAllowed() Determine whether blocking I/O is allowed from the current thread.
java.nio.channels.FileChannel	openFile(java.io.File file, FileAccess access) Open a file on the filesystem.
java.nio.channels.FileChannel	openFile(java.io.File file, OptionMap options) Open a file on the filesystem.
java.nio.channels.FileChannel	openFile(java.lang.String fileName, FileAccess access) Open a file on the filesystem.
java.nio.channels.FileChannel	openFile(java.lang.String fileName, OptionMap options) Open a file on the filesystem.
java.lang.String	toString() Get a string representation of this XNIO provider.

Methods inherited from class java.lang.Object

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

Constructor Detail

Xnio

protected Xnio(java.lang.String name)

Construct an XNIO provider instance. Used by implementors only. To get an XNIO instance, use one of the getInstance() methods.

Parameters:

name - the provider name

Method Detail

allowBlocking

public static boolean allowBlocking(boolean newSetting)
                             throws java.lang.SecurityException

Allow (or disallow) blocking I/O on the current thread. Requires the changeThreadBlockingSetting RuntimePermission.

Parameters:

newSetting - true to allow blocking I/O, false to disallow it

Returns:

the previous setting

Throws:

java.lang.SecurityException - if a security manager is present and disallows changing the changeThreadBlockingSetting RuntimePermission

isBlockingAllowed

public static boolean isBlockingAllowed()

Determine whether blocking I/O is allowed from the current thread.

Returns:

true if blocking I/O is allowed, false otherwise

checkBlockingAllowed

public static void checkBlockingAllowed()
                                 throws java.lang.IllegalStateException

Perform a check for whether blocking is allowed on the current thread.

Throws:

java.lang.IllegalStateException - if blocking is not allowed on the current thread

getInstance

public static Xnio getInstance(java.lang.ClassLoader classLoader)

Get an XNIO provider instance. If multiple providers are available, use the first one encountered.

Parameters:

classLoader - the class loader to search in

Returns:

the XNIO provider instance

Since:

3.0

getInstance

public static Xnio getInstance()

Get an XNIO provider instance from XNIO's class loader. If multiple providers are available, use the first one encountered.

Returns:

the XNIO provider instance

Since:

3.0

getInstance

public static Xnio getInstance(java.lang.String provider,
               java.lang.ClassLoader classLoader)

Get a specific XNIO provider instance.

Parameters:

provider - the provider name, or null for the first available

classLoader - the class loader to search in

Returns:

the XNIO provider instance

Since:

3.0

getInstance

public static Xnio getInstance(java.lang.String provider)

Get a specific XNIO provider instance from XNIO's class loader.

Parameters:

provider - the provider name, or null for the first available

Returns:

the XNIO provider instance

Since:

3.0

getSslProvider

public XnioSsl getSslProvider(OptionMap optionMap)
                       throws java.security.GeneralSecurityException

Get an SSL provider for this XNIO provider.

Parameters:

optionMap - the option map to use for configuring SSL

Returns:

the SSL provider

Throws:

java.security.GeneralSecurityException - if an exception occurred configuring the SSL provider

getSslProvider

public XnioSsl getSslProvider(javax.net.ssl.KeyManager[] keyManagers,
                     javax.net.ssl.TrustManager[] trustManagers,
                     OptionMap optionMap)
                       throws java.security.GeneralSecurityException

Get an SSL provider for this XNIO provider.

Parameters:

optionMap - the option map to use for configuring SSL

keyManagers - the key managers to use, or null to configure from the option map

trustManagers - the trust managers to use, or null to configure from the option map

Returns:

the SSL provider

Throws:

java.security.GeneralSecurityException - if an exception occurred configuring the SSL provider

openFile

public java.nio.channels.FileChannel openFile(java.io.File file,
                                     OptionMap options)
                                       throws java.io.IOException

Open a file on the filesystem.

Parameters:

file - the file to open

options - the file-open options

Returns:

the file channel

Throws:

java.io.IOException - if an I/O error occurs

openFile

public java.nio.channels.FileChannel openFile(java.lang.String fileName,
                                     OptionMap options)
                                       throws java.io.IOException

Open a file on the filesystem.

Parameters:

fileName - the file name of the file to open

options - the file-open options

Returns:

the file channel

Throws:

java.io.IOException - if an I/O error occurs

openFile

public java.nio.channels.FileChannel openFile(java.io.File file,
                                     FileAccess access)
                                       throws java.io.IOException

Open a file on the filesystem.

Parameters:

file - the file to open

access - the file access level to use

Returns:

the file channel

Throws:

java.io.IOException - if an I/O error occurs

openFile

public java.nio.channels.FileChannel openFile(java.lang.String fileName,
                                     FileAccess access)
                                       throws java.io.IOException

Open a file on the filesystem.

Parameters:

fileName - the file name of the file to open

access - the file access level to use

Returns:

the file channel

Throws:

java.io.IOException - if an I/O error occurs

createWorker

public XnioWorker createWorker(OptionMap optionMap)
                        throws java.io.IOException,
                               java.lang.IllegalArgumentException

Construct a new XNIO worker.

Parameters:

optionMap - the options to use to configure the worker

Returns:

the new worker

Throws:

java.io.IOException - if the worker failed to be opened

java.lang.IllegalArgumentException - if an option value is invalid for this worker

createWorker

public XnioWorker createWorker(java.lang.ThreadGroup threadGroup,
                      OptionMap optionMap)
                        throws java.io.IOException,
                               java.lang.IllegalArgumentException

Construct a new XNIO worker.

Parameters:

threadGroup - the thread group for worker threads

optionMap - the options to use to configure the worker

Returns:

the new worker

Throws:

java.io.IOException - if the worker failed to be opened

java.lang.IllegalArgumentException - if an option value is invalid for this worker

createWorker

public abstract XnioWorker createWorker(java.lang.ThreadGroup threadGroup,
                      OptionMap optionMap,
                      java.lang.Runnable terminationTask)
                                 throws java.io.IOException,
                                        java.lang.IllegalArgumentException

Construct a new XNIO worker.

Parameters:

threadGroup - the thread group for worker threads

optionMap - the options to use to configure the worker

terminationTask - the task to run after the worker has shut down

Returns:

the new worker

Throws:

java.io.IOException - if the worker failed to be opened

java.lang.IllegalArgumentException - if an option value is invalid for this worker

getName

public final java.lang.String getName()

Get the name of this XNIO provider.

Returns:

the name

toString

public final java.lang.String toString()

Get a string representation of this XNIO provider.

Overrides:

toString in class java.lang.Object

Returns:

the string representation

getProperty

protected java.lang.String getProperty(java.lang.String name)

Get an XNIO property. The property name must start with "xnio.".

Parameters:

name - the property name

Returns:

the property value, or null if it wasn't found

Since:

1.2

getProperty

protected java.lang.String getProperty(java.lang.String name,
                           java.lang.String defaultValue)

Get an XNIO property. The property name must start with "xnio.".

Parameters:

name - the property name

defaultValue - the default value

Returns:

the property value, or defaultValue if it wasn't found

Since:

1.2