com.actional.soapstation.plugin.inproc

Interface ISqlDatabase

public interface ISqlDatabase

Instances of this interface allow a plugin to tap into the container's SQL connection pool and thus makes better reuse of database resources.

Method Summary

Modifier and Type	Method and Description
ISqlConnection	acquireConnection() This method retrieves a connection that can be used by the plug-in to do SQL queries.
boolean	query(ISqlTx tx) Executes an SQL transaction

Method Detail

acquireConnection

ISqlConnection acquireConnection()
                          throws java.lang.Exception

This method retrieves a connection that can be used by the plug-in to do SQL queries.
When the plug-in is finished with the connection, it must call ISqlConnection.release().

Returns:

The Writer onto which to render the plug-in UI

Throws:

java.lang.Exception

query

boolean query(ISqlTx tx)
       throws java.lang.Exception

Executes an SQL transaction

Parameters:

tx - The ISqlTx to be executed

Returns:

True if the query completed successfully. False if the database was down and the query silently failed. Normal failures will throw an exception.

Throws:

java.lang.Exception