NAME

       SQL::Translator::Schema::Trigger - SQL::Translator trigger object

SYNOPSIS

         use SQL::Translator::Schema::Trigger;
         my $trigger = SQL::Translator::Schema::Trigger->new(
           name                => 'foo',
           perform_action_when => 'before', # or after
           database_events     => [qw/update insert/], # also update, update_on, delete
           fields              => [],       # if event is "update"
           on_table            => 'foo',    # table name
           action              => '...',    # text of trigger
           schema              => $schema,  # Schema object
           scope               => 'row',    # or statement
         );

DESCRIPTION

       "SQL::Translator::Schema::Trigger" is the trigger object.

METHODS

   new
       Object constructor.

         my $schema = SQL::Translator::Schema::Trigger->new;

   perform_action_when
       Gets or sets whether the event happens "before" or "after" the "database_event".

         $trigger->perform_action_when('after');

   database_event
       Obsolete please use database_events!

   database_events
       Gets or sets the events that triggers the trigger.

         my $ok = $trigger->database_events('insert');

   fields
       Gets and set which fields to monitor for "database_event".

         $view->fields('id');
         $view->fields('id', 'name');
         $view->fields( 'id, name' );
         $view->fields( [ 'id', 'name' ] );
         $view->fields( qw[ id name ] );

         my @fields = $view->fields;

   table
       Gets or set the table on which the trigger works, as a SQL::Translator::Schema::Table
       object.
         $trigger->table($triggered_table);

   on_table
       Gets or set the table name on which the trigger works, as a string.
         $trigger->on_table('foo');

   action
       Gets or set the action of the trigger.

         $trigger->action(
             q[
               BEGIN
                 select ...;
                 update ...;
               END
             ]
         );

   is_valid
       Determine whether the trigger is valid or not.

         my $ok = $trigger->is_valid;

   name
       Get or set the trigger's name.

         my $name = $trigger->name('foo');

   order
       Get or set the trigger's order.

         my $order = $trigger->order(3);

   scope
       Get or set the trigger's scope (row or statement).

           my $scope = $trigger->scope('statement');

   schema
       Get or set the trigger's schema object.

         $trigger->schema( $schema );
         my $schema = $trigger->schema;

   compare_arrays
       Compare two arrays.

   equals
       Determines if this trigger is the same as another

         my $is_identical = $trigger1->equals( $trigger2 );

AUTHORS

       Anonymous, Ken Youens-Clark <kclark@cpan.org>.