blackboard.persist.gradebook
Interface ScoreDbPersister

All Superinterfaces:

Persister

public interface ScoreDbPersister
extends Persister

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

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 Score identified by the given Id value using a connection from the associated persistence manager's database container.
void	deleteById(Id id, java.sql.Connection con) Deletes the Score identified by the given Id value using the supplied connection.
void	persist(BbList scores) Inserts or updates the supplied ScoreList, Score by Score, using a connection from the associated persistence manager's database container.
void	persist(BbList scores, java.sql.Connection con) Inserts or updates the supplied ScoreList, Score by Score, using the supplied connection.
void	persist(Score score) Inserts or updates the supplied Score using a connection from the associated persistence manager's database container.
void	persist(Score score, java.sql.Connection con) Inserts or updates the supplied Score using the supplied 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(Score score)
             throws ValidationException,
                    PersistenceException

Inserts or updates the supplied Score using a connection from the associated persistence manager's database container. If the object's Id is set and is associated with the same container, then an update is done, otherwise a new object is inserted.

Parameters:

score - the Score to be persisted

Throws:

ValidationException - if the object is not in a consistent state to be persisted.

PersistenceException - if some other exception happens while persisting the object.

persist

void persist(Score score,
             java.sql.Connection con)
             throws ValidationException,
                    PersistenceException

Inserts or updates the supplied Score using the supplied connection. The connection must be to the same database as is used by the associated persistence manager. If the object's Id is set and is associated with this persistence manager's same container, then an update is done, otherwise a new object is inserted.

Parameters:

score - the Score to be persisted

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

Throws:

ValidationException - if the object is not in a consistent state to be persisted.

PersistenceException - if some other exception happens while persisting the object.

persist

void persist(BbList scores)
             throws ValidationException,
                    PersistenceException

Inserts or updates the supplied ScoreList, Score by Score, using a connection from the associated persistence manager's database container. If an object's Id is set and is associated with the same container, then an update is done, otherwise a new object is inserted.

Parameters:

scores - the ScoreList to be persisted

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

Throws:

ValidationException - if any of the objects is not in a consistent state to be persisted.

PersistenceException - if some other exception happens while persisting the objects.

persist

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

Inserts or updates the supplied ScoreList, Score by Score, using the supplied connection. The connection must be to the same database as is used by the associated persistence manager. If an object's Id is set and is associated with the same container, then an update is done, otherwise a new object is inserted.

Parameters:

scores - the ScoreList to be persisted

Throws:

ValidationException - if any of the objects is not in a consistent state to be persisted.

PersistenceException - if some other exception happens while persisting the objects.

deleteById

void deleteById(Id id)
                throws KeyNotFoundException,
                       PersistenceException

Deletes the Score identified by the given Id value using a connection from the associated persistence manager's database container.

Parameters:

id - the Id of the Score to be deleted

Throws:

KeyNotFoundException - if an object with the given Id value can not be found

PersistenceException - if some other exception happens during the delete operation

deleteById

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

Deletes the Score identified by the given Id value using the supplied connection.

Parameters:

id - the Id of the Score to be deleted

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

Throws:

KeyNotFoundException - if an object with the given Id value can not be found

PersistenceException - if some other exception happens during the delete operation