com.metamatrix.soap.sqlquerywebservice.service
Class SqlQueryWebService

java.lang.Object
  com.metamatrix.soap.sqlquerywebservice.service.SqlQueryWebService

public class SqlQueryWebService
extends java.lang.Object

This class is designed to support the querying of the MetaMatrix Server via a SOAP web service node. This class is also designed in such a way as to produce a resulting web service interface that is complaint with the WS-I profile.

Nested Class Summary

static interface

SqlQueryWebService.CredentialProvider Contextually aware credential provider.

Field Summary

static java.lang.String

APP_NAME

Constructor Summary

SqlQueryWebService()

Method Summary

protected Results	buildResults(Statement stmt, java.sql.ResultSet rs, ConnectionlessRequest request, boolean includeMetadata) This method is used to construct a results object for a given context.
Results	executeBlocking(ConnectionlessRequest connectionlessRequest) This method is used as a shortcut when no Connection state is required on the server side.
void	setConnectionSource(ConnectionSource connectionSource)
void	setCredentialProvider(SqlQueryWebService.CredentialProvider credentialProvider)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

APP_NAME

public static final java.lang.String APP_NAME

See Also:

Constant Field Values

Constructor Detail

SqlQueryWebService

public SqlQueryWebService()

Method Detail

executeBlocking

public Results executeBlocking(ConnectionlessRequest connectionlessRequest)
                        throws SqlQueryWebServiceFault

This method is used as a shortcut when no Connection state is required on the server side. It will simply make a connection using the information supplied in the passed in object, and execute the query as defined also in the passed in object. This method saves server round trips, but sacrifices the performance of keeping a Connection open on the server side when multiple queries are to be executed. The returned Data contains all of the results retrieved from the server as a result of executing the query defined in the ConnectionlessRequest object. This method also sacrifices the �batching� functionality that is available when using the execute, getResults asynchronous method combination. The first x number of rows from the results will be returned in the return message as specified in the ConnectionlessRequest object. ResultsMetadata will also be returned in the result set by default.

Returns:

Results

Throws:

SqlQueryWebServiceFault

buildResults

protected Results buildResults(Statement stmt,
                               java.sql.ResultSet rs,
                               ConnectionlessRequest request,
                               boolean includeMetadata)
                        throws java.sql.SQLException

This method is used to construct a results object for a given context. This is used for synchronous query execution to get all results.

Returns:

Results

Throws:

java.sql.SQLException

setConnectionSource

public void setConnectionSource(ConnectionSource connectionSource)

setCredentialProvider

public void setCredentialProvider(SqlQueryWebService.CredentialProvider credentialProvider)