IBM DB2 Information Integrator
Java API Reference
for Developing Wrappers

com.ibm.db2.wrapper
Class FencedServer

java.lang.Object
  extended bycom.ibm.db2.wrapper.SqlqgBaseClass
      extended bycom.ibm.db2.wrapper.Server
          extended bycom.ibm.db2.wrapper.FencedServer
Direct Known Subclasses:
FencedGenericServer

public class FencedServer
extends Server

The FencedServer class is a subclass of the Server class and is the abstract base class for all server functionality that operates in the fenced (untrusted) process space. This class is responsible for creating remote connections and nicknames.

Usage:
Do not use this class directly. Instantiating or subclassing the FencedServer class directly results in incorrect wrapper behavior. Subclass the FencedGenericServer class.

Since:
IBM DB2 Information Integrator Version 8.2

Method Summary
protected  RemoteConnection createRemoteConnection(FencedRemoteUser user, int kind, long id)
          Create a new connection for the specified user mapping and of the specified kind.
 RemoteConnection findConnection()
          Retrieve the current active connection for the data source server.
protected  int getRemoteConnectionKind()
          Retrieve the type of connection that this data source server supports as indicated by the RemoteConnection.NO_PHASE_KIND or RemoteConnection.ONE_PHASE_KIND constants.
 
Methods inherited from class com.ibm.db2.wrapper.Server
createNickname, createRemoteUser, destroy, findRemoteUser, getInfo, getName, getType, getVersion, getWrapper, initializeMyServer
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createRemoteConnection

protected RemoteConnection createRemoteConnection(FencedRemoteUser user,
                                                  int kind,
                                                  long id)
                                           throws java.lang.Exception
Create a new connection for the specified user mapping and of the specified kind. The wrapper writer implements this method.

Parameters:
user - The user mapping object that is used to authenticate the user.
kind - The connection type.
id - An integer value that represents the RemoteConnection object.
Returns:
The newly created connection instance.
Throws:
java.lang.Exception - if the RemoteConnection instance cannot be created.
Since:
IBM DB2 Information Integrator Version 8.2
See Also:
RemoteConnection

findConnection

public final RemoteConnection findConnection()
Retrieve the current active connection for the data source server.

Returns:
The active connection for this data source server or null if no active connection is found.

getRemoteConnectionKind

protected int getRemoteConnectionKind()
Retrieve the type of connection that this data source server supports as indicated by the RemoteConnection.NO_PHASE_KIND or RemoteConnection.ONE_PHASE_KIND constants. A default implementation returns the RemoteConnection.NO_PHASE_KIND constant. The subclasses can overwrite this method if necessary.

Returns:
The connection type.
Since:
IBM DB2 Information Integrator Version 8.2
See Also:
RemoteConnection

IBM DB2 Information Integrator
Java API Reference
for Developing Wrappers

(C)Copyright IBM Corp. 2002. All rights reserved.

Links on this page are made available for your convenience and may take you to non-IBM sites. IBM does not warrant any sample code provided on these sites.