Package com.sap.ip.bi.sdk.exception

Provides classes and interfaces for handling exceptions thrown by the SDK layer.

See:
          Description

Exception Summary
BICapabilityNotSupportedException Thrown when a certain feature is not supported by a connector.
BIConnectionFailedException Thrown to indicate that a connection has not been successfully established.
BIConnectorException Thrown to indicate miscellaneous error situations in a connector.
BIException General-purpose exception for the BI Java SDK.
BIJmiVerifyException Exception thrown by generated JMI objects of the BI Java SDK.
BIOlapQueryException Checked exception which is thrown within the context of an OLAP query.
BIOlapQueryRuntimeException Runtime exception which is thrown within the context of an OLAP query.
BIResourceException Thrown to indicate a lower-level problem.
BIRuntimeException Represents BI Java SDK-specific runtime exceptions.
BISQLException Exception providing information on errors occurring while interacting with BI Java SDK relational connectors.
BISQLWarning Exception providing information on errors occurring while interacting with BI Java SDK relational connectors.
 

Package com.sap.ip.bi.sdk.exception Description

Provides classes and interfaces for handling exceptions thrown by the SDK layer. Exception handling in the BI Java SDK both conforms to SAP standards and supports legacy exceptions.

All exceptions thrown by the SDK interfaces implement the IBaseException interface in order to comply with SAP solution production standards. This also provides integration with SAP's Java logging and tracing framework used for instrumenting the code in case of error situations.

The SDK exceptions either directly implement the IBaseException interface, as in the case of BIResourceException, or they extend exceptions in the package com.sap.exception, as with BaseException.

Legacy exceptions, which are exceptions that are thrown by components outside the SDK, do not implement the IBaseException interface but are handled by providing wrapper exceptions. These wrappers have exactly the same semantics as the underlying legacy exception and simply add the implementation of IBaseException. For example, the legacy exception BIResourceException wraps exceptions of the type javax.resource.ResourceException.

The diagram below illustrates how the BI Java SDK exceptions relate to legacy exceptions such as javax.resource.RescourceException and the SAP Exception Framework base exceptions:

SDK Exception Framework diagramBIResourceExceptionBIExceptionBIRuntimeException

 

Exception Translation

Exceptions evoked on the BI Java SDK layer are localized into all languages supported by BW. To set the language for SDK exceptions, use the language property of your BI Java Connector in your connection specification.

For the list of languages supported by BW, see the following link in the SAP Service Marketplace:
http://service.sap.com/~form/sapnet?_SHORTKEY=01100035870000523354&

See the Connectors page for more information about the connectors and their connection properties.

Since:
3.50


Copyright © 2004-2006 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.