com.avaya.conferencing.api.acp.control
Class ConferencingProviders

java.lang.Object
  com.avaya.conferencing.api.acp.control.ConferencingProviders

public final class ConferencingProviders
extends java.lang.Object

Uses the Java SPI mechanism to obtain a Connection from the ConferencingProvider implementation that supports the protocol specified in the Connection URI.

Since:

5.1.0.0.29

Method Summary

static Connection	getConnection(java.lang.ClassLoader classloader, java.lang.String connectionUrl, java.lang.String username, char[] password) Returns the required connection.
static Connection	getConnection(java.lang.String connectionUrl, java.lang.String username, char[] password) Returns the required connection.
static ConnectionContext	getDefaultConnectionContext() Returns the default ConnectionContext for the context ClassLoader of the current thread.
static ConnectionContext	getDefaultConnectionContext(java.lang.ClassLoader contextClassLoader) Returns the default ConnectionContext for the specified ClassLoader.
static ConnectionContext	newConnectionContext(java.lang.ClassLoader contextClassLoader) Creates a new ConnectionContext using the supplied ClassLoader.

Methods inherited from class java.lang.Object

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

Method Detail

getConnection

public static Connection getConnection(java.lang.String connectionUrl,
                                       java.lang.String username,
                                       char[] password)
                                throws java.net.MalformedURLException,
                                       java.io.IOException

Returns the required connection. This is equivalent to a call to ConnectionContext.getConnection(String, String, char[]) on the getDefaultConnectionContext()

Parameters:

connectionUrl - The connection URI.

username - The username to connect with.

password - The password to connect with.

Returns:

The connection.

Throws:

java.net.MalformedURLException - If the URI is malformed or if the protocol is not supported.

java.io.IOException - If there was an IOException trying to establish the connection.

Since:

5.1.0.0.29

getConnection

public static Connection getConnection(java.lang.ClassLoader classloader,
                                       java.lang.String connectionUrl,
                                       java.lang.String username,
                                       char[] password)
                                throws java.net.MalformedURLException,
                                       java.io.IOException

Returns the required connection. This is equivalent to a call to ConnectionContext.getConnection(String, String, char[]) on the ConnectionContext returned by getDefaultConnectionContext(ClassLoader)

Parameters:

classloader - The classloader to search for implementations from.

connectionUrl - The connection URI.

username - The username to connect with.

password - The password to connect with.

Returns:

The connection.

Throws:

java.net.MalformedURLException - If the URI is malformed or if the protocol is not supported.

java.io.IOException - If there was an IOException trying to establish the connection.

Since:

5.1.0.0.29

getDefaultConnectionContext

public static ConnectionContext getDefaultConnectionContext()

Returns the default ConnectionContext for the context ClassLoader of the current thread. If either no ConnectionContext exists or the previous ConnectionContext was disposed by a call to ConnectionContext.dispose(), then a new ConnectionContext will be created by a call to newConnectionContext(ClassLoader).

Returns:

ConnectionContext the default ConnectionContext.

Since:

5.1.0.0.59

getDefaultConnectionContext

public static ConnectionContext getDefaultConnectionContext(java.lang.ClassLoader contextClassLoader)

Returns the default ConnectionContext for the specified ClassLoader. If either no ConnectionContext exists or the previous ConnectionContext was disposed by a call to ConnectionContext.dispose(), then a new ConnectionContext will be created by a call to newConnectionContext(ClassLoader).

Parameters:

contextClassLoader - the specified ClassLoader.

Returns:

ConnectionContext the default ConnectionContext.

Since:

5.1.0.0.59

newConnectionContext

public static ConnectionContext newConnectionContext(java.lang.ClassLoader contextClassLoader)

Creates a new ConnectionContext using the supplied ClassLoader. In most cases the getDefaultConnectionContext(ClassLoader) or getDefaultConnectionContext() method is preferred.

Parameters:

contextClassLoader - The ClassLoader to search for ConferencingProvider implementations on.

Returns:

ConnectionContext The new ConnectionContext.

Since:

5.1.0.0.59