SQLite

Class Vm

java.lang.Object

SQLite.Vm

public class Vm
extends Object

Class to represent compiled SQLite VM.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	error_code Internal last error code for compile()/step() methods.
private long	handle Internal handle for the compiled SQLite VM.

Constructor Summary

Constructors

Constructor and Description
Vm()

Method Summary

Modifier and Type	Method and Description
boolean	compile() Compile the next SQL statement for the SQLite VM instance.
protected void	finalize() Destructor for object.
private static void	internal_init() Internal native initializer.
boolean	step(Callback cb) Perform one step on compiled SQLite VM.
void	stop() Abort the compiled SQLite VM.

Methods inherited from class java.lang.Object

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

Field Detail

error_code

protected int error_code

Internal last error code for compile()/step() methods.

handle

private long handle

Internal handle for the compiled SQLite VM.

Constructor Detail

Vm

public Vm()

Method Detail

compile

public boolean compile()
                throws Exception

Compile the next SQL statement for the SQLite VM instance.

Returns:

true when SQL statement has been compiled, false on end of statement sequence.

Throws:

Exception - indicating SQLite error

finalize

protected void finalize()

Destructor for object.

Overrides:

finalize in class Object

internal_init

private static void internal_init()

Internal native initializer.

step

public boolean step(Callback cb)
             throws Exception

Perform one step on compiled SQLite VM. The result row is passed to the given callback interface.

Example:

   ...
   try {
     Vm vm = db.compile("select * from x; select * from y;");
     while (vm.step(cb)) {
       ...
     }
     while (vm.compile()) {
       while (vm.step(cb)) {
         ...
       }
     }
   } catch (SQLite.Exception e) {
   }
 

Parameters:

cb - the object implementing the callback methods.

Returns:

true as long as more row data can be retrieved, false, otherwise.

Throws:

Exception - indicating SQLite error

stop

public void stop()
          throws Exception

Abort the compiled SQLite VM.

Throws:

Exception - indicating SQLite error