The AppConn Class Library

The file apptrieve.jar contains the class libraries for the Java connector. The AppConn Java methods are documented in a set of Javadoc HTML files installed with the SDK. To view these files, you need a supported browser. View the methods reference in a new browser window.

The AppConn Java interface is implemented through the following classes:

com.wrq.apptrieve.appconn.AppConnSession

This class contains methods that manage model- and terminal-level tasks like connecting and disconnecting from the Host Integrator Server, navigating to and fetching entities and attributes, performing operations, and managing host application model variables. It also contains methods that perform table-level tasks, such as executing SQL statements and performing procedures.

com.wrq.apptrieve.appconn.AppConnRecord

This contains methods that access the data fields returned by access methods in the AppConnSession class.

com.wrq.apptrieve.appconn.AppConnRecordSet

This class contains methods that access data records returned by the fetch methods in the AppConnSession class. It always contains a collection of either AppConnRecord or AppConnModelRecord objects.

com.wrq.apptrieve.agent.AppConnException

These libraries contain methods that help you manage exceptions, errors and security.


Importing the AppConn Java Classes

To use the AppConn interfaces, add the following statement into your classes:

   import com.wrq.apptrieve.appconn.*; 
   import com.wrq.apptrieve.agent.*; 
   import org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider;
   import org.bouncycastle.jsse.provider.BouncyCastleJsseProvider;
   import java.security.Security;

Adding the Bouncy Castle security provider

security.addProvider(new BouncyCastleFipsProvider());
security.addProvider(new BouncyCastleJsseProvider());

VHI uses Bouncy Castle as the default SSL engine for HTTPS connections. To facilitate this the Bouncy Castle provider must be the default provider and the default SSL provider. Instead of importing the Bouncy Castle security statements, you can add the the Bouncy Castle security provider by modifying your java.security file in the JRE you are using to run the Java application:

Edit your <jre>/lib/security/java.security file and add the Bouncy Castle providers to the top of the list. Remember to re-number the elements below the Bouncy Castle providers.

 

Related Topics
Bullet Requirements
Bullet Accessing Host Data Using Host Integrator Connector APIs
Bullet Tables Overview