de.uplanet.lucy.server.businesslogic.exchange.util

Class ExchangeConnectionUtil

java.lang.Object

de.uplanet.lucy.server.businesslogic.exchange.util.ExchangeConnectionUtil

@Scriptable
public final class ExchangeConnectionUtil
extends java.lang.Object

Utility class providing connections to MS Exchange server.

Version:

$Revision: 104733 $

Method Summary

Modifier and Type	Method and Description
static de.uplanet.jdbc.JdbcConnection	getConnection() Returns an Exchange connection for the currently logged in Intrexx user.
static de.uplanet.jdbc.JdbcConnection	getConnectionForDataGroup(DataGroupInfo p_dataGroupInfo) Returns a connection for the current user or a connection for an impersonate user if an impersonate user is registered with the given DataGroupInfo.
static de.uplanet.jdbc.JdbcConnection	getConnectionForDataGroup(java.lang.String p_strDgGuid) Returns a connection for the current user or a connection for an impersonate user if an impersonate user is registered with a DataGroup identified by the given DataGroup GUID.
static de.uplanet.jdbc.JdbcConnection	getConnectionForWorkflowAction(ISessionProcessingContext p_context) Returns a connection for the current user or a connection for an impersonate user if an impersonate user is registered with the given ISessionProcessingContext.
static de.uplanet.jdbc.JdbcConnection	getImpersonateConnection(java.lang.String p_strUserGuid) Returns a connection for an impersonate user.
static ExchangeConnectionUtil	getInstance()
static de.uplanet.jdbc.JdbcConnection	getUserConnection(java.lang.String p_strUserGuid) Returns a connection for a static MediaGateway user.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static ExchangeConnectionUtil getInstance()

Returns:

The ExchangeConnectionUtil singleton instance.

getConnection

public static de.uplanet.jdbc.JdbcConnection getConnection()
                                                    throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException

Returns an Exchange connection for the currently logged in Intrexx user.

Returns:

The connection.

Throws:

de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException - If the connection could not be established.

getImpersonateConnection

public static de.uplanet.jdbc.JdbcConnection getImpersonateConnection(java.lang.String p_strUserGuid)
                                                               throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException

Returns a connection for an impersonate user.

Parameters:

p_strUserGuid - The GUID of the user used for impersonate actions.

Returns:

The connection.

Throws:

de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException - If the connection could not be established.

getUserConnection

public static de.uplanet.jdbc.JdbcConnection getUserConnection(java.lang.String p_strUserGuid)
                                                        throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException,
                                                               java.lang.SecurityException

Returns a connection for a static MediaGateway user. This user must have logged in before with disabled session-based authentication in order to create the user account on the MediaGateway server. Be aware that the caller is responsible for closing the connection, as a connection retrieved by this method is not bound to the ThreadContext.

Parameters:

p_strUserGuid - The GUID of the Intrexx user.

Returns:

The connection.

Throws:

de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException - If the connection could not be established.

java.lang.SecurityException - If static user connections are not permitted.

getConnectionForDataGroup

public static de.uplanet.jdbc.JdbcConnection getConnectionForDataGroup(DataGroupInfo p_dataGroupInfo)
                                                                throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException

Returns a connection for the current user or a connection for an impersonate user if an impersonate user is registered with the given DataGroupInfo.

Parameters:

p_dataGroupInfo - The DataGroupInfo instance which holds information about the impersonation user.

Returns:

The connection.

Throws:

de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException - If the connection could not be established.

getConnectionForDataGroup

public static de.uplanet.jdbc.JdbcConnection getConnectionForDataGroup(java.lang.String p_strDgGuid)
                                                                throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException

Returns a connection for the current user or a connection for an impersonate user if an impersonate user is registered with a DataGroup identified by the given DataGroup GUID.

Parameters:

p_strDgGuid - The DataGroup GUID.

Returns:

The connection.

Throws:

de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException - If the connection could not be established.

getConnectionForWorkflowAction

public static de.uplanet.jdbc.JdbcConnection getConnectionForWorkflowAction(ISessionProcessingContext p_context)
                                                                     throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException

Returns a connection for the current user or a connection for an impersonate user if an impersonate user is registered with the given ISessionProcessingContext.

Parameters:

p_context - The workflow processing context.

Returns:

The connection.

Throws:

de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException - If the connection could not be established.