Index: lams_tool_nb/src/java/org/lamsfoundation/lams/tool/noticeboard/service/INoticeboardService.java =================================================================== RCS file: /usr/local/cvsroot/lams_tool_nb/src/java/org/lamsfoundation/lams/tool/noticeboard/service/INoticeboardService.java,v diff -u -r1.1 -r1.2 --- lams_tool_nb/src/java/org/lamsfoundation/lams/tool/noticeboard/service/INoticeboardService.java 7 Jun 2005 05:50:05 -0000 1.1 +++ lams_tool_nb/src/java/org/lamsfoundation/lams/tool/noticeboard/service/INoticeboardService.java 16 Jun 2005 02:26:02 -0000 1.2 @@ -22,6 +22,7 @@ package org.lamsfoundation.lams.tool.noticeboard.service; import org.lamsfoundation.lams.tool.noticeboard.NoticeboardContent; +import org.lamsfoundation.lams.tool.noticeboard.NoticeboardSession; /** * Defines the contract that the tool service provider must follow @@ -31,34 +32,34 @@ public interface INoticeboardService { /** - * Return the noticeboard object according to the requested content id. + * Return the NoticeboardContent object that has id nbContentId. * - * @param nbContentid The id of the requested noticeboard object + * @param nbContentid The id of the requested NoticeboardContent object * @return NoticeboardContent object or null if not found */ public NoticeboardContent retrieveNoticeboard(Long nbContentId); /** - * Update the content of the noticeboard object with id corresponding - * to that specified in the argument. + * Updates the values of the NoticeboardContent object. * - * @param nbContentid The id of the requested noticeboard object + * @param nbContent The NoticeboardContent object to update * */ public void updateNoticeboard(NoticeboardContent nbContent); /** - * Save the content of the noticeboard object - * + * Save the content of the NoticeboardContent object + * + * @param nbContent the NoticeboardContent object to persist */ public void saveNoticeboard(NoticeboardContent nbContent); /** - * Remove the noticeboard sessions which contain the noticeboard content - * object that is specified in the argument + * Removes the NoticeboardSessions which is associated with the particular + * NoticeboardContent object. * * @param nbContent The noticeboard content in which its corresponding sessions * must be removed @@ -76,5 +77,12 @@ */ public void removeNoticeboard(Long nbContentId); + /** + * Persists the new NoticeboardSession object into the database. + * + * @param nbSession the NoticeboardSession object to persist + */ + public void saveNoticeboardSession(NoticeboardSession nbSession); + }