com.sapportals.portal.ivs.cg

Interface IConnectorGatewayService

All Superinterfaces:

IConnectorGatewayService, IService

public interface IConnectorGatewayService

extends IService, IConnectorGatewayService

SAP portal service to establish connection to backends. Most of the service API reside in a J2EE library com.sap.portal.services.api.connectorgateway.IConnectorGatewayService to enable access to this service to J2EE services as well

Usage example in a Portal Component:

IConnectorGatewayService cgService =
(IConnectorGatewayService)PortalRuntime.getRuntimeResources().
getService(IConnectorGatewayService.KEY);

ConnectionProperties cp = new ConnectionProperties(request.getLocale(),
(IPrincipal) request.getUser());

// For a Connector Framework connection:
com.sapportals.connector.connection.IConnection con =
cgService.getConnection("sapSystem1", cp);

// For a JDBC connection:
java.sql.Connection conn = cgService.getDistributedConnection(new String[]
{"sapSystem1","jdbcSystem2"}, cp );

Field Summary

Fields inherited from interface com.sap.portal.services.api.connectorgateway.IConnectorGatewayService

CONNECTORS_FOLDER, CONNECTORS_SUB_FOLDER, KEY, SERVICE_JNDI_NAME

Method Summary

IConnection	getConnection(String systemAlias, IPortalComponentRequest request) Deprecated. use super interface getConnection(String,ConnectionProperties)
Connection	getDistributedConnection(String[] systemsAliases, IPortalComponentRequest request) Deprecated. use super interface getDistributedConnection(String[],ConnectionProperties)

Methods inherited from interface com.sapportals.portal.prt.service.IService

afterInit, configure, destroy, getContext, getKey, init, release

Methods inherited from interface com.sap.portal.services.api.connectorgateway.IConnectorGatewayService

getConnection, getConnectionFactories, getConnectionFactory, getConnectionSpec, getDistributedConnection

Method Detail

getConnection

public IConnection getConnection(String systemAlias,
                                 IPortalComponentRequest request)

Deprecated. use super interface getConnection(String,ConnectionProperties)

Returns a connection to a connector Supports request related and user mapping related properties

Parameters:

systemAlias -

request - IPortalComponentRequest from which user context & locale are retrieved

Returns:

Initialized handler to Connector Framework connection

getDistributedConnection

public Connection getDistributedConnection(String[] systemsAliases,
                                           IPortalComponentRequest request)
                                    throws SQLException,
                                           ClassNotFoundException,
                                           NamingException,
                                           NoLogonDataAvailableException

Deprecated. use super interface getDistributedConnection(String[],ConnectionProperties)

Returns a DQE JDBC connection to all specified distributed backends

Parameters:

systemsAliases - Array of system aliases

request - IPortalComponentRequest from which user context & locale are retrieved

Returns:

java.sql.Connection to all specified backends

Throws:

SQLException

ClassNotFoundException

NamingException

NoLogonDataAvailableException