blackboard.persist.gradebook
Interface LineitemDbPersister

All Superinterfaces:

Persister

public interface LineitemDbPersister
extends Persister

The LineitemDbPersister interface provides a standard set of methods used to store Lineitem objects into the Blackboard database schema.

Note: Persisting a Lineitem requires the caller to have a PersistPermission with the name "OutcomeDefinition", with actions for create, modify, or delete, as appropriate. For system extensions, this is declared with a line in the manifest such as <permission type="persist" name="OutcomeDefinition" actions="create,modify,delete"/>

Since:

Bb 5.5

Version:

$Revision: #1 $ $Date: 2005/06/27 $

Field Summary

static java.lang.String

TYPE Type used to obtain an instance of the class configured to provide the implementation for this interface.

Method Summary

void	deleteById(Id id) Deletes the Lineitem with the given Id from the database using a connection obtained through this object's database context.
void	deleteById(Id id, java.sql.Connection con) Deletes the Lineitem with the given Id from the database using the supplied connection.
void	persist(BbList lineitems) Stores the given LineitemList into the database Lineitem by Lineitem using a connection obtained through this object's database context.
void	persist(BbList lineitems, java.sql.Connection con) Stores the given LineitemList into the database Lineitem by Lineitem using the provided connection.
void	persist(Lineitem lineitem) Stores the given Lineitem into the database using a connection obtained through this object's database context.
void	persist(Lineitem lineitem, java.sql.Connection con) Stores the given Lineitem into the database using the provided connection.

Methods inherited from interface blackboard.persist.Persister

getAppVersion, init

Field Detail

TYPE

static final java.lang.String TYPE

Type used to obtain an instance of the class configured to provide the implementation for this interface. Used when making a call to BbPersistenceManager.getPersister(String)

See Also:

Constant Field Values

Method Detail

persist

void persist(Lineitem lineitem)
             throws ValidationException,
                    PersistenceException

Stores the given Lineitem into the database using a connection obtained through this object's database context.

Parameters:

lineitem - The Lineitem to be persisted

Throws:

ValidationException - If the Lineitem fails validation tests

PersistenceException - If a general persistence level exception occurs

persist

void persist(Lineitem lineitem,
             java.sql.Connection con)
             throws ValidationException,
                    PersistenceException

Stores the given Lineitem into the database using the provided connection.

Parameters:

lineitem - The Lineitem to be persisted

con - A connection supplied by the caller's database context

Throws:

ValidationException - If the Lineitem fails validation tests

PersistenceException - If a general persistence level exception occurs

persist

void persist(BbList lineitems)
             throws ValidationException,
                    PersistenceException

Stores the given LineitemList into the database Lineitem by Lineitem using a connection obtained through this object's database context.

Parameters:

lineitems - The LineitemList to be persisted

Throws:

ValidationException - If any Lineitem fails validation tests

PersistenceException - If a general persistence level exception occurs

persist

void persist(BbList lineitems,
             java.sql.Connection con)
             throws ValidationException,
                    PersistenceException

Stores the given LineitemList into the database Lineitem by Lineitem using the provided connection.

Parameters:

lineitems - The LineitemList to be persisted

con - A connection supplied by the caller's database context

Throws:

ValidationException - If any Lineitem fails validation tests

PersistenceException - If a general persistence level exception occurs

deleteById

void deleteById(Id id)
                throws KeyNotFoundException,
                       PersistenceException

Deletes the Lineitem with the given Id from the database using a connection obtained through this object's database context. Dependent scores will also be deleted.

Parameters:

id - The Id of the Lineitem to be deleted

Throws:

KeyNotFoundException - If there is no Lineitem in the database with the given Id

PersistenceException - If a general persistence level exception occurs

deleteById

void deleteById(Id id,
                java.sql.Connection con)
                throws KeyNotFoundException,
                       PersistenceException

Deletes the Lineitem with the given Id from the database using the supplied connection. Dependent scores will also be deleted.

Parameters:

id - The Id of the Lineitem to be deleted

con - A connection supplied by the caller's database context

Throws:

KeyNotFoundException - If there is no Lineitem in the database with the given Id

PersistenceException - If a general persistence level exception occurs