com.sapportals.connector.connection
Interface INative

public interface INative

The interface INative provides a set of handles to various interfaces that an EIS can expose directly to the connector client application. Reasons to use native API access are:

1. Getting a better performance when using the native API directly
2. Using legacy code that is written using the native API
3. Using a function that the generic interface does not expose

The INative interface serves as a wrapper to the interface exposed by the EIS, allowing the consumer code to directly access the resource without using the Connector Framework interface. The connector still performs the connection, and then hands to the consumer the native connection interface. The native connection interface is an entry point interface and can be used to create every other native interface. However, in the scenario that other native interfaces are not available through connection factory or connection interfaces, the connector must also provide those inaccessible interfaces. The native module exposes a list of all available native interfaces by name; the consumer can obtain reference to a native interface by providing the interfaces name.

Version:

1.0

Method Summary

java.lang.Object	getNative(java.lang.String interfaceName) Returns the handle to the requested interface of the EIS.
boolean	supports(java.lang.String interfaceName) Returns whether this native interface supports the given interface name.

Method Detail

supports

public boolean supports(java.lang.String interfaceName)
                 throws ConnectorException

Returns whether this native interface supports the given interface name.

Parameters:

interfaceName - A name of an interface of the EIS to retrieve the handle for.

Returns:

boolean Whether this native interface supports the given interface name.

getNative

public java.lang.Object getNative(java.lang.String interfaceName)
                           throws InterfaceNotSupportedException,
                                  ConnectorException

Returns the handle to the requested interface of the EIS. Don't call any of the close() methods of the native object. After using the native handler, use IConnection.close() in order to enable the connector J2EE service reuse this physical connection

Parameters:

interfaceName - A name of an interface of the EIS to retrieve the handle for.

Returns:

object The handle to the EIS interface.

Throws:

InterfaceNotSupportedException -