Skip navigation links

com.oracle.cep.cartridge
Interface ExternalConnection

public interface ExternalConnection

Connection to an external data-source. A connection supports a fixed set of capabilities, such as the equals function, the less-than function, the AND comparative function, etc. By default, a connection supports the equals function for all native CQL types (e.g. char, int). To specify a different set of capabilities, an ExternalConnection must implement the interface CapabilityProvider.

See Also:

ExternalDataSource, CapabilityProvider

Method Summary

void	close() Releases all the resources acquired by Connection without any wait.
ExternalPreparedStatement	prepareStatement(java.lang.String relationName, java.util.List relationAttrs, ExternalPredicate predicate) Creates a ExternalPreparedStatement object for sending statements to external data-sources.
boolean	supportsPredicate(ExternalPredicate predicate) Return true if the connection supports the predicate.

Method Detail

prepareStatement

public ExternalPreparedStatement prepareStatement(java.lang.String relationName,
                                                  java.util.List relationAttrs,
                                                  ExternalPredicate predicate)
                                           throws java.lang.Exception

Creates a ExternalPreparedStatement object for sending statements to external data-sources. ExternalPreparedStatement must be prepared to support predicate.

Parameters:

relationName - name of the relation (table)

relationAttrs - attributes (columns) of the relation (table)

pred - predicate clause, or null if statement should return all tuples.

Returns:

a new prepared statement that supports predicate

supportsPredicate

public boolean supportsPredicate(ExternalPredicate predicate)
                          throws java.lang.Exception

Return true if the connection supports the predicate. The infrastructure invokes this method prior to executing a prepared statement.

Parameters:

predicate -

Returns:

Throws:

java.lang.Exception -

close

public void close()
           throws java.lang.Exception

Releases all the resources acquired by Connection without any wait.