com.sap.mdm.extension.session
Class ConnectionManagerEx

java.lang.Object
  extended bycom.sap.mdm.extension.session.ConnectionManagerEx

public class ConnectionManagerEx
extends Object

This class is responsible for supplying users with connection to MDM server It enables creation of MdmSessionContext and correspondent MDM session from the information stored in MdmDestinationProperties class.

See Also:
SessionManager

Method Summary
static RepositorySessionContext connectWithRepositorySession(MdmDestinationProperties destination, String password, String applicationName, int unicodeNormalizationType, String contextIdentifier)
          Create instance of RepositorySessionContext from the specified parameters.
static RepositorySessionContext connectWithRepositorySession(String destinationName, String applicationName, int unicodeNormalizationType, String contextIdentifier)
          Create instance of RepositorySessionContext from the specified parameters.
static ServerSessionContext connectWithServerSession(MdmDestinationProperties destination, String serverPassword, String applicationName, String contextIdentifier)
          Create instance of ServerSessionContext from the specified parameters.
static ServerSessionContext connectWithServerSession(String destinationName, String applicationName, String contextIdentifier)
          Create instance of ServerSessionContext from the specified parameters.
static UserSessionContext connectWithUserSession(MdmDestinationProperties destination, String password, String applicationName, String regionName, Locale regionLocale, int unicodeNormalizationType, boolean useBlobCache, String contextIdentifier)
          Create instance of UserSessionContext from the data stored in MDM destination The authenticated user session for this session context is created as well and stored in cache of SessionManager All parameters excepting the 'destination' and 'password' are optional.
static UserSessionContext connectWithUserSession(String destinationName, String applicationName, String regionName, Locale regionLocale, int unicodeNormalizationType, boolean useBlobCache, String contextIdentifier)
          Create instance of UserSessionContext from the data stored in MDM destination according to the destination name The authenticated user session for this session context is created as well and stored in cache of SessionManager All parameters excepting the 'destinationName' and 'applicationName' are optional.
static NetWeaverMdmDestinationProperties getMdmDestinationProperties(String destinationName)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

connectWithServerSession

public static ServerSessionContext connectWithServerSession(MdmDestinationProperties destination,
                                                            String serverPassword,
                                                            String applicationName,
                                                            String contextIdentifier)
                                                     throws ConnectionException
Create instance of ServerSessionContext from the specified parameters. The authenticated server session for this session context is created as well and stored in cache of SessionManager. All parameters excepting the 'destination' are optional. Specify 'null' value for optional parameters if you want the default value will be used.

Parameters:
destination - the properties of MDM server destination
serverPassword - the server password that should be specified only if authenticationType equals to AUTHENTICATION_TYPE_BASIC
applicationName - the application name
contextIdentifier - context identifier (optional), null if not defined
Returns:
the instance of ServerSessionContext
Throws:
ConnectionException - if any connectivity problem occurs

connectWithRepositorySession

public static RepositorySessionContext connectWithRepositorySession(MdmDestinationProperties destination,
                                                                    String password,
                                                                    String applicationName,
                                                                    int unicodeNormalizationType,
                                                                    String contextIdentifier)
                                                             throws ConnectionException
Create instance of RepositorySessionContext from the specified parameters. The authenticated repository session for this session context is created as well and stored in cache of SessionManager. All parameters excepting the 'destination' and 'password' are optional. The 'password' should be specified if authentication type defined in 'destination' is BASIC authentication. Specify 'null' or -1 value for optional parameters if you want the default value will be used.

Parameters:
destination - the properties of MDM server destination
password - the password of the repository user that should be specified only if authenticationType equals to AUTHENTICATION_TYPE_BASIC
applicationName - the application name
unicodeNormalizationType - the type of unicode normalization
contextIdentifier - context identifier (optional), null if not defined
Returns:
the instance of RepositorySessionContext
Throws:
ConnectionException - if any connectivity problem occurs

getMdmDestinationProperties

public static NetWeaverMdmDestinationProperties getMdmDestinationProperties(String destinationName)
                                                                     throws ConnectionException
Throws:
ConnectionException

connectWithUserSession

public static UserSessionContext connectWithUserSession(MdmDestinationProperties destination,
                                                        String password,
                                                        String applicationName,
                                                        String regionName,
                                                        Locale regionLocale,
                                                        int unicodeNormalizationType,
                                                        boolean useBlobCache,
                                                        String contextIdentifier)
                                                 throws ConnectionException
Create instance of UserSessionContext from the data stored in MDM destination The authenticated user session for this session context is created as well and stored in cache of SessionManager All parameters excepting the 'destination' and 'password' are optional. The 'password' should be specified if authentication type defined in 'destination' is BASIC authentication. Specify 'null' or -1 value for optional parameters if you want the default value will be used.

Parameters:
destination - the properties of MDM server destination
password - the password of the repository user that should be specified only if authenticationType equals to AUTHENTICATION_TYPE_BASIC
applicationName - the application name
regionName - the region name
regionLocale - the region locale
unicodeNormalizationType - the type of unicode normalization
useBlobCache - specifies whether BlocCache should be initialized
contextIdentifier - context identifier (optional), null if not defined
Returns:
the instance of UserSessionContext
Throws:
ConnectionException - if any connectivity problem occurs

connectWithServerSession

public static ServerSessionContext connectWithServerSession(String destinationName,
                                                            String applicationName,
                                                            String contextIdentifier)
                                                     throws ConnectionException
Create instance of ServerSessionContext from the specified parameters. The authenticated server session for this session context is created as well and stored in cache of SessionManager. All parameters excepting the 'destinationName' and 'applicationName' are optional. Specify 'null' value for optional parameters if you want the default value will be used.

Parameters:
destinationName - the destination name
applicationName - the application name
contextIdentifier - context identifier (optional), null if not defined
Returns:
the instance of ServerSessionContext
Throws:
ConnectionException - if any connectivity problem occurs

connectWithRepositorySession

public static RepositorySessionContext connectWithRepositorySession(String destinationName,
                                                                    String applicationName,
                                                                    int unicodeNormalizationType,
                                                                    String contextIdentifier)
                                                             throws ConnectionException
Create instance of RepositorySessionContext from the specified parameters. The authenticated repository session for this session context is created as well and stored in cache of SessionManager. All parameters excepting the 'destinationName' and 'applicaitonName' are optional. Specify 'null' or -1 value for optional parameters if you want the default value will be used.

Parameters:
destinationName - the destination name
applicationName - the application name
unicodeNormalizationType - the type of unicode normalization
contextIdentifier - context identifier (optional), null if not defined
Returns:
the instance of RepositorySessionContext
Throws:
ConnectionException - if any connectivity problem occurs

connectWithUserSession

public static UserSessionContext connectWithUserSession(String destinationName,
                                                        String applicationName,
                                                        String regionName,
                                                        Locale regionLocale,
                                                        int unicodeNormalizationType,
                                                        boolean useBlobCache,
                                                        String contextIdentifier)
                                                 throws ConnectionException
Create instance of UserSessionContext from the data stored in MDM destination according to the destination name The authenticated user session for this session context is created as well and stored in cache of SessionManager All parameters excepting the 'destinationName' and 'applicationName' are optional. Specify 'null' or -1 value for optional parameters if you want the default value will be used.

Parameters:
destinationName - the destination name
applicationName - the application name
regionName - the region name
regionLocale - the region locale
unicodeNormalizationType - the type of unicode normalization
useBlobCache - specifies whether BlocCache should be initialized
contextIdentifier - context identifier (optional), null if not defined
Returns:
the instance of UserSessionContext
Throws:
ConnectionException - if any connectivity problem occurs


Copyright 2004-2007 by SAP AG. All Rights Reserved.

SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies (SAP Group) for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.