eu.dnetlib.api.functionality

Interface ForumService

All Superinterfaces:

DriverService

public interface ForumService
extends DriverService

This interface describes the available methods of a forum service.

Author:

thanos@di.uoa.gr

Method Summary

Modifier and Type	Method and Description
void	deleteThread(long threadId) Delete an existing thread.
void	editThread(long threadId, String topic, List<eu.dnetlib.domain.functionality.Post> posts) Edit an existing thread.
long	openThread(String communityId, String userId, String topic) Open a new thread.
eu.dnetlib.domain.functionality.Thread	searchThread(long threadId) Search for an existing thread by id.
List<eu.dnetlib.domain.functionality.Thread>	searchThread(String communityId) Search for existing threads by community.

Methods inherited from interface eu.dnetlib.api.DriverService

identify, notify

Method Detail

openThread

long openThread(String communityId,
                String userId,
                String topic)
         throws ForumServiceException

Open a new thread.

Parameters:

communityId - the id of the community that the thread belongs to

userId - the id of the user that opens the thread

topic - the topic of the thread

Returns:

the id of the thread just opened

Throws:

ForumServiceException - if any errors occur

editThread

void editThread(long threadId,
                String topic,
                List<eu.dnetlib.domain.functionality.Post> posts)
         throws ForumServiceException

Edit an existing thread.

Parameters:

threadId - the id of the thread to edit

topic - the new topic of the thread

posts - the new posts of the thread

Throws:

ForumServiceException - if any errors occur

deleteThread

void deleteThread(long threadId)
           throws ForumServiceException

Delete an existing thread.

Parameters:

threadId - the id of the thread to delete

Throws:

ForumServiceException - if any errors occur

searchThread

eu.dnetlib.domain.functionality.Thread searchThread(long threadId)
                                             throws ForumServiceException

Search for an existing thread by id.

Parameters:

threadId - the id of the thread to search for

Returns:

the thread with the specified id or null if no such thread exists

Throws:

ForumServiceException - if any errors occur

searchThread

List<eu.dnetlib.domain.functionality.Thread> searchThread(String communityId)
                                                   throws ForumServiceException

Search for existing threads by community.

Parameters:

communityId - the id of the community the threads belong to

Returns:

a list containing all the threads that belong to the specified community

Throws:

ForumServiceException - if any errors occur