SQLite
Class Vm

java.lang.Object
  extended bySQLite.Vm

public class Vm
extends Object

Class to represent compiled SQLite VM.


Field Summary
protected  int error_code
          Internal last error code for compile()/step() methods.
private  long handle
          Internal handle for the compiled SQLite VM.
 
Constructor Summary
Vm()
           
 
Method Summary
 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.


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


Contact: Christian Werner