Foundation Class Library (Java):

IDataConnSet is deprecated and is provided for backward compatibility only. New applications should use the JDBC API to provide similar functionality.

The IDataConnSet interface represents a collection of data connections and associated query names. It is used in conjunction with loading a query file.

Use IDataConnSet when loading a hierarchical query from a file. The AppLogic first establishes a data connection with each database on which any queries will be run. Next, the AppLogic calls createDataConnSet( ) in the AppLogic class (deprecated) to create an empty IDataConnSet object, then populates this object with query name / data connection pairs.

In this way, the AppLogic can use parameterized queries and select and assign data connections dynamically at runtime. Finally, the AppLogic calls loadHierQuery( ) in the AppLogic class (deprecated) to create the hierarchical query object.

IDataConnSet is part of the Data Access Engine (DAE) service.

To create an instance of the IDataConnSet interface, use createDataConnSet( ) in the AppLogic class (deprecated), as shown in the following example:.

IDataConnSet connSet;

connSet = createDataConnSet();

Package
com.kivasoft

Methods


addConn( )	Associates a query name with a data connection object and adds it to the IDataConnSet object.

addConn( )
Associates a query name with a data connection object and adds it to the IDataConnSet object.

Syntax

public int addConn(
	String pQueryName,
	IDataConn pConn)

pQueryName. Name of a query in the query file.

pConn. Name of the data connection object representing an active connection with the data source on which the query will be run.

Rules

Every named query in the qulery file must have a corresponding named query in the IDataConnSet object.

The AppLogic must first create the data connection object using createDataConn( ) in the AppLogic class (deprecated).

Duplicate query names are not permitted.

Return Value
GXE.SUCCESS if the method succeeds.

Example

IDataConnSet connSet;

connSet = createDataConnSet();

// Specify query / db connection pairs

connSet.addconn("employee", conn_empDB);

connSet.addconn("sales", conn_salesDB);

IHierQuery hqry;

// Load the GXQ file with the db connection set

hqry = loadHierQuery("employeeReport.gxq",connSet, 0, null);

// Run the report

evalTemplate("employeeReport.html", hqry);