company logo

DBBaseContext :: doAfterInsert - After inserted handler

The after insert handler is called when a data instance has been inserted in a collection ( DBO_Inserted event). In contrast to create, insert only means, that an existing instance has been added to a collection without creating a new instance.

Usually, an instance is selected in the property handle after being inserted. In case of maintaining inverse references or extent hierarchies, however, the instance state is usually located, but not selected. In order to access instance data, the instance in the parent.parent property may be referred to, or the instance has to be read explicitly.

The handler can be overloaded in specialized property context class implementations.

// maintaining inverse persons reference in cars after adding a car to Person::cars

... pCar_persons :: doAfterInsert () {

  Property        persons(property()); // not selected, but located

  Property        cars(persons.parent());

  

  if ( !persons.selected() )

    persons.get();           // get located instance

  // now do what is necessary

  return(false);

}

Return value:  Execution error ( int32  )

The value is usually returned from context functions or actions in order to report the result of execution. The variable may contain following values:

  • -1: function/action not executed
  • 0: function executed normally
  • 1-9: Function executed with errors. Error codes depend on the function/action called.

Implementation details

int32 DBBaseContext  :: doAfterInsert (  )