org.h2.samples

Class TriggerPassData

java.lang.Object

org.h2.samples.TriggerPassData

All Implemented Interfaces:

Trigger

public class TriggerPassData
extends java.lang.Object
implements Trigger

This sample application shows how to pass data to a trigger. Trigger data can be persisted by storing it in the database.

Field Summary

Fields inherited from interface org.h2.api.Trigger

DELETE, INSERT, SELECT, UPDATE

Constructor Summary

Constructors

Constructor and Description
TriggerPassData()

Method Summary

Modifier and Type	Method and Description
void	close() This method is called when the database is closed.
void	fire(java.sql.Connection conn, java.lang.Object[] old, java.lang.Object[] row) This method is called for each triggered action.
void	init(java.sql.Connection conn, java.lang.String schemaName, java.lang.String triggerName, java.lang.String tableName, boolean before, int type) This method is called by the database engine once when initializing the trigger.
static void	main(java.lang.String... args) This method is called when executing this sample application from the command line.
void	remove() This method is called when the trigger is dropped.
static void	setTriggerData(java.sql.Connection conn, java.lang.String trigger, java.lang.String data) Call this method to change a specific trigger.

Methods inherited from class java.lang.Object

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

Constructor Detail

TriggerPassData

public TriggerPassData()

Method Detail

main

public static void main(java.lang.String... args)
                 throws java.lang.Exception

This method is called when executing this sample application from the command line.

Parameters:

args - the command line parameters

Throws:

java.lang.Exception

init

public void init(java.sql.Connection conn,
                 java.lang.String schemaName,
                 java.lang.String triggerName,
                 java.lang.String tableName,
                 boolean before,
                 int type)
          throws java.sql.SQLException

Description copied from interface: Trigger

This method is called by the database engine once when initializing the trigger. It is called when the trigger is created, as well as when the database is opened. The type of operation is a bit field with the appropriate flags set. As an example, if the trigger is of type INSERT and UPDATE, then the parameter type is set to (INSERT | UPDATE).

Specified by:

init in interface Trigger

Parameters:

conn - a connection to the database (a system connection)

schemaName - the name of the schema

triggerName - the name of the trigger used in the CREATE TRIGGER statement

tableName - the name of the table

before - whether the fire method is called before or after the operation is performed

type - the operation type: INSERT, UPDATE, DELETE, SELECT, or a combination (this parameter is a bit field)

Throws:

java.sql.SQLException

fire

public void fire(java.sql.Connection conn,
                 java.lang.Object[] old,
                 java.lang.Object[] row)

Description copied from interface: Trigger

This method is called for each triggered action. The method is called immediately when the operation occurred (before it is committed). A transaction rollback will also rollback the operations that were done within the trigger, if the operations occurred within the same database. If the trigger changes state outside the database, a rollback trigger should be used.

The row arrays contain all columns of the table, in the same order as defined in the table.

The trigger itself may change the data in the newRow array.

Specified by:

fire in interface Trigger

Parameters:

conn - a connection to the database

old - the old row, or null if no old row is available (for INSERT)

row - the new row, or null if no new row is available (for DELETE)

close

public void close()

Description copied from interface: Trigger

This method is called when the database is closed. If the method throws an exception, it will be logged, but closing the database will continue.

Specified by:

close in interface Trigger

remove

public void remove()

Description copied from interface: Trigger

This method is called when the trigger is dropped.

Specified by:

remove in interface Trigger

setTriggerData

public static void setTriggerData(java.sql.Connection conn,
                                  java.lang.String trigger,
                                  java.lang.String data)
                           throws java.sql.SQLException

Call this method to change a specific trigger.

Parameters:

conn - the connection

trigger - the trigger name

data - the data

Throws:

java.sql.SQLException