org.sakaiproject.service.gradebook.shared
Interface GradebookFrameworkService

All Known Implementing Classes:
GradebookFrameworkServiceImpl

public interface GradebookFrameworkService

This service is meant to be used by the framework which manages the Gradebook application. The service provides various administrative functions which aren't handled by the application itself, including creating and removing gradebooks, and managing system-wide grading schemes. Because these aren't operations taken by the application, responsibility for security is left completely up to the client. THERE ARE NO AUTHORIZATION CHECKS. In other words, DO NOT provide open web service access to this service's methods!


Method Summary
 void addGradebook(String uid, String name)
          Creates a new gradebook with the given UID and name
 void deleteGradebook(String uid)
          Deletes the gradebook with the given UID, along with all its associated data.
 boolean isGradebookDefined(String gradebookUid)
          Checks to see whether a gradebook with the given uid exists.
 void setAvailableGradingScales(Collection gradingScaleDefinitions)
           
 void setDefaultGradingScale(String uid)
           
 

Method Detail

addGradebook

void addGradebook(String uid,
                  String name)
Creates a new gradebook with the given UID and name

Parameters:
uid - The UID used to specify a gradebook and its associated data. It is the caller's responsibility to ensure that this is unique within gradebook storage.
name - The name of the gradebook, to be used for logging and other conveniences by the application. This should be the name of the site or the course. It is only used for convenience, and does not need to be unique.

deleteGradebook

void deleteGradebook(String uid)
                     throws GradebookNotFoundException
Deletes the gradebook with the given UID, along with all its associated data.

Throws:
GradebookNotFoundException

isGradebookDefined

boolean isGradebookDefined(String gradebookUid)
Checks to see whether a gradebook with the given uid exists.

Parameters:
gradebookUid - The gradebook UID to check
Returns:
Whether the gradebook exists

setAvailableGradingScales

void setAvailableGradingScales(Collection gradingScaleDefinitions)
Parameters:
gradingScaleDefinitions - A collection of GradingScaleDefinition beans.

setDefaultGradingScale

void setDefaultGradingScale(String uid)
Parameters:
uid - The UID of the grading scale to use as the default for new gradebooks.


Copyright © 2011 Sakai Project. All Rights Reserved.