com.iplanet.jato.model
Interface InsertingModel

All Superinterfaces:
ExecutingModel, Model
All Known Subinterfaces:
InsertQueryModel

public interface InsertingModel
extends ExecutingModel

Executing model that supports addition of new data. This interface defines a generic operation that can be mapped to a model-specific operation by implementing models. If a model does not support this operation, it generally should not implement this interface.

Version:
JATO/1.2.2 $Id: InsertingModel.java,v 1.8 2002/03/16 03:26:31 todd Exp $

Method Summary
 java.lang.Object insert(ModelExecutionContext context)
          Applies any cached changes to the backing data store, if any.
 
Methods inherited from interface com.iplanet.jato.model.ExecutingModel
execute
 
Methods inherited from interface com.iplanet.jato.model.Model
getName, getValue, getValues, setName, setValue, setValues
 

Method Detail

insert

public java.lang.Object insert(ModelExecutionContext context)
                        throws ModelControlException
Applies any cached changes to the backing data store, if any. Note that there is no requirement for a model to cache changes, and indeed, it can elect to make changes to the backing store immediately. However this method enables this flexibility, if required. For example, this method might be useful for caching EJB updates rather than pushing them to the EJB immediately.
Parameters:
context - The execution context that specifies detail information pertinent to the execution of this model control
Returns:
An opaque implementation-dependent object encapsulating information related to the execution of this method
Throws:
ModelControlException - Thrown if an error occurs executing the model