org.openfjord.business.workflow
Interface SurveyManager

All Known Subinterfaces:

SurveyManagerRemote

All Known Implementing Classes:

SurveyManagerBean, SurveyManagerDelegate

public interface SurveyManager

Title: open Flexible Java Online Research Designer

Description: Business Interface

Copyright: Copyright (c) 2003 Ingo Düppe

Company: University of Muenster

Version:

1.0

Author:

Ingo Düppe

Method Summary

Survey	createSurvey(Survey survey) Creates a new survey.
void	deleteSurvey(java.lang.String surveyId) Deletes the specified survey object
void	deleteSurvey(Survey survey) Deletes the specified survey object
Survey	getSurvey(java.lang.String surveyId) Look up for a special survey defined by its id.
java.util.Collection	getSurveys() Gives back a collection of survey objects belonging to the researcher
Survey	updateSurvey(Survey survey) Updates a survey specified by his given primary key.

Method Detail

getSurveys

public java.util.Collection getSurveys()
                                throws java.rmi.RemoteException

Gives back a collection of survey objects belonging to the researcher

Returns:

Collection containing survey objects with no related sub elements.

Throws:

java.rmi.RemoteException

getSurvey

public Survey getSurvey(java.lang.String surveyId)
                 throws SurveyManagerException,
                        java.rmi.RemoteException

Look up for a special survey defined by its id.

Parameters:

surveyId - - primary key of the survey

Returns:

survey object with sub objects

Throws:

SurveyManagerException - - no survey with this given id

java.rmi.RemoteException - - something gone wrong

createSurvey

public Survey createSurvey(Survey survey)
                    throws java.rmi.RemoteException

Creates a new survey.

Parameters:

survey - - optional parameter defining an template structure for the new template

Returns:

the new survey object, containing sub objects and his primary key

Throws:

java.rmi.RemoteException - - somthing gone wrong

updateSurvey

public Survey updateSurvey(Survey survey)
                    throws SurveyManagerException,
                           java.rmi.RemoteException

Updates a survey specified by his given primary key. The function will trace the whole tree of sub objects. Existing serverside objects will be updated and new ones will be created. No objects will be deleted.

Parameters:

survey - containing the new data for survey.

Returns:

the updated survey object

Throws:

SurveyManagerException - - specified survey not found or could not update the survey

java.rmi.RemoteException - - somthing gone wrong

deleteSurvey

public void deleteSurvey(Survey survey)
                  throws SurveyManagerException,
                         java.rmi.RemoteException

Deletes the specified survey object

Parameters:

survey - the survey to be deleted

Throws:

SurveyManagerException - could not find or delete the survey

java.rmi.RemoteException - something gone wrong

deleteSurvey

public void deleteSurvey(java.lang.String surveyId)
                  throws SurveyManagerException,
                         java.rmi.RemoteException

Deletes the specified survey object

Parameters:

surveyId - primary key of the survey

Throws:

SurveyManagerException - could not find or delete the survey

java.rmi.RemoteException - something gone wrong