Package 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 Object

Utility class providing connections to MS Exchange server.

Method Summary

Modifier and Type	Method	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(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(String p_strUserGuid)	Returns a connection for an impersonate user.
static ExchangeConnectionUtil	getInstance()
static de.uplanet.jdbc.JdbcConnection	getUserConnection(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(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(String p_strUserGuid)
                                                        throws de.uplanet.lucy.server.exchange.ExchangeLoginRequiredException,
                                                               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.

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(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.