eu.dnetlib.clients.functionality.recommendation.ws

Interface RecommendationWebService

All Superinterfaces:

eu.dnetlib.common.rmi.BaseService, eu.dnetlib.api.DriverServiceEndpoint<eu.dnetlib.api.functionality.RecommendationService>, DriverWebService<eu.dnetlib.api.functionality.RecommendationService>

All Known Implementing Classes:

RecommendationWebServiceImpl

public interface RecommendationWebService
extends DriverWebService<eu.dnetlib.api.functionality.RecommendationService>

Method Summary

Modifier and Type	Method and Description
void	addRecommendationToUser(String recommendationId, String userId)
String	generateAnnouncement(int index, boolean active, String announcementTitle, String announcementText, Date creationDate, Date expirationDate) creates a new recommendation of type announcement
String	generateCommunityRecommendation(int index, boolean active, String title, String recommendationText, Date creationDate, Date expirationDate, Set<String> communityIds) creates a new recommendation of type community
eu.dnetlib.domain.functionality.Recommendation	generateRecommendation(int index, boolean active, String title, String recommendationText, Date creationDate, Date expirationDate) creates a new recommendation
String	generateUserRecommendation(int index, boolean active, String title, String userId, String recommendationText, Date creationDate, Date expirationDate) creates a new recommendation of type user
List<String>	getAllAnnouncementIds() retrieves ths ids of all announcements
List<eu.dnetlib.domain.functionality.Recommendation>	getAllAnnouncements() retrieves the recommendation text of all announcements
List<String>	getAllCommunityRecommendations() retrieves all recommendations of type community, just the content
List<String>	getAllCommunityRecommendations(String communityId) retrieves all community recommendations that are associated with a community
List<eu.dnetlib.domain.functionality.Recommendation>	getAllCommunityRecommendationsObj() retrieves all recommendations Objects, not just the content of type community
List<eu.dnetlib.domain.functionality.Recommendation>	getAllCommunityRecommendationsObj(String communityId)
List<String>	getAllUserRecommendations(String userId)
List<String>	getAnnouncements() retrieves the recommendation text of all announcements that haven't expired
List<String>	getCommunityRecommendations(String communityId)
List<String>	getCommunityRecommendationsForUser(String userId) gets all the community recommendation for a specific user
List<eu.dnetlib.domain.functionality.Recommendation>	getCommunityRecommendationsForUserObj(String userId) gets all the community recommendation objects for a specific user
List<eu.dnetlib.domain.functionality.Recommendation>	getCommunityRecommendationsObj(String communityId)
eu.dnetlib.domain.functionality.Recommendation	getRecommendation(String recommendationId) retrieves a recommendation
List<String>	getRecommendations(List<String> recommendationIds) retrieves the recommendation text of a Set of recommendations
String	getRecommendationText(String recommendationId) retrieves the text of a recommendation
void	removeAnnouncement(String announcementId) removes a recommendation of type announcement
void	removeCommunityRecommendation(String recommendationId) removes a recommendation of type community
void	removeRecommendation(String recommendationId) removes a recommendation
void	removeUserRecommendation(String recommendationId)
void	sendAnnouncement(String announcementId) sends an e-mail to all users with the recommendation text of an announcement
void	swapAnnouncements(String announcementId1, String announcementId2) Swap the index of 2 announcements
void	swapCommunityRecommendations(String communityId1, String communityId2)
void	swapUserRecommendations(String recommendationId1, String recommendationId2)
void	updateAnnouncement(String announcementId, int index, boolean active, String announcementTitle, String announcementText, Date creationDate, Date expirationDate) updates an announcement and the corresponding recommendation
void	updateCommunityRecommendation(String recommendationId, int index, boolean active, String title, String recommendationText, Date creationDate, Date expirationDate, Set<String> communityIds)
void	updateRecommendation(String recommendationId, int index, boolean active, String title, String recommendationText, Date creationDate, Date expirationDate) updates a recommendation

Methods inherited from interface eu.dnetlib.common.rmi.BaseService

identify, notify, start

Method Detail

generateAnnouncement

String generateAnnouncement(int index,
                            boolean active,
                            String announcementTitle,
                            String announcementText,
                            Date creationDate,
                            Date expirationDate)
                     throws RecommendationWebServiceException

creates a new recommendation of type announcement

Parameters:

recommendationText - the text of the recommendation

creationDate - the creation date of the announcement

expirationDate - the date the announcement expires

Returns:

the id of the new recommendation

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException - if the announcement cannot be created

RecommendationWebServiceException

swapAnnouncements

void swapAnnouncements(String announcementId1,
                       String announcementId2)
                throws RecommendationWebServiceException

Swap the index of 2 announcements

Parameters:

announcementId1 - the id of the fist announcement

announcementId2 - the id of the second announcement

Throws:

RecommendationWebServiceException

swapUserRecommendations

void swapUserRecommendations(String recommendationId1,
                             String recommendationId2)
                      throws RecommendationWebServiceException

Throws:

RecommendationWebServiceException

swapCommunityRecommendations

void swapCommunityRecommendations(String communityId1,
                                  String communityId2)
                           throws RecommendationWebServiceException

Throws:

RecommendationWebServiceException

generateRecommendation

eu.dnetlib.domain.functionality.Recommendation generateRecommendation(int index,
                                                                      boolean active,
                                                                      String title,
                                                                      String recommendationText,
                                                                      Date creationDate,
                                                                      Date expirationDate)
                                                               throws RecommendationWebServiceException

creates a new recommendation

Parameters:

rText - the recommendation text

creationDate - the date the recommendation was created

expirationDate - the date the recommendation expires

Returns:

the id of the recommendation

Throws:

RecommendationWebServiceException - if the recommendation cannot be created

generateCommunityRecommendation

String generateCommunityRecommendation(int index,
                                       boolean active,
                                       String title,
                                       String recommendationText,
                                       Date creationDate,
                                       Date expirationDate,
                                       Set<String> communityIds)
                                throws RecommendationWebServiceException

creates a new recommendation of type community

Parameters:

recommendationText - the recommendation text

creationDate -

expirationDate -

communityId - the ids of the associated communities

Returns:

the id of the recommendation

Throws:

RecommendationWebServiceException - if the community recommendation cannot be created

generateUserRecommendation

String generateUserRecommendation(int index,
                                  boolean active,
                                  String title,
                                  String userId,
                                  String recommendationText,
                                  Date creationDate,
                                  Date expirationDate)
                           throws RecommendationWebServiceException

creates a new recommendation of type user

Parameters:

recommendationText -

creationDate -

expirationDate -

Returns:

the id of the recommendation

Throws:

RecommendationWebServiceException - if the user recommendation cannot be created

getAnnouncements

List<String> getAnnouncements()
                       throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves the recommendation text of all announcements that haven't expired

Returns:

the announcements' recommendation text

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllAnnouncementIds

List<String> getAllAnnouncementIds()
                            throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves ths ids of all announcements

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllAnnouncements

List<eu.dnetlib.domain.functionality.Recommendation> getAllAnnouncements()
                                                                  throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves the recommendation text of all announcements

Returns:

the recommendation text of all announcements

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllCommunityRecommendations

List<String> getAllCommunityRecommendations()
                                     throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves all recommendations of type community, just the content

Returns:

the recommendation text of all community recommendations

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllCommunityRecommendationsObj

List<eu.dnetlib.domain.functionality.Recommendation> getAllCommunityRecommendationsObj()
                                                                                throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves all recommendations Objects, not just the content of type community

Returns:

the recommendation text of all community recommendations

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getCommunityRecommendations

List<String> getCommunityRecommendations(String communityId)
                                  throws eu.dnetlib.api.functionality.RecommendationServiceException

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getCommunityRecommendationsObj

List<eu.dnetlib.domain.functionality.Recommendation> getCommunityRecommendationsObj(String communityId)
                                                                             throws eu.dnetlib.api.functionality.RecommendationServiceException

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllCommunityRecommendations

List<String> getAllCommunityRecommendations(String communityId)
                                     throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves all community recommendations that are associated with a community

Parameters:

communityId - the id of the community

Returns:

the recommendation text of the community recommendations

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllCommunityRecommendationsObj

List<eu.dnetlib.domain.functionality.Recommendation> getAllCommunityRecommendationsObj(String communityId)
                                                                                throws eu.dnetlib.api.functionality.RecommendationServiceException

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getAllUserRecommendations

List<String> getAllUserRecommendations(String userId)
                                throws eu.dnetlib.api.functionality.RecommendationServiceException

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getRecommendation

eu.dnetlib.domain.functionality.Recommendation getRecommendation(String recommendationId)
                                                          throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves a recommendation

Parameters:

recommendationId - the recommendation id

Returns:

the recommendation or null if the recommendation does not exist

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getRecommendationText

String getRecommendationText(String recommendationId)
                      throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves the text of a recommendation

Parameters:

recommendationId - the id of the recommendation

Returns:

the recommendation text or null if the recommendation does not exist

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getRecommendations

List<String> getRecommendations(List<String> recommendationIds)
                         throws eu.dnetlib.api.functionality.RecommendationServiceException

retrieves the recommendation text of a Set of recommendations

Parameters:

recommendationIds - the ids of the recommendations

Returns:

a Set of the recommendations' text

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

removeRecommendation

void removeRecommendation(String recommendationId)
                   throws RecommendationWebServiceException

removes a recommendation

Parameters:

recommendationId - the id of the recommendation

Throws:

RecommendationWebServiceException - if the recommendation does not exist or cannot be updated

removeAnnouncement

void removeAnnouncement(String announcementId)
                 throws RecommendationWebServiceException

removes a recommendation of type announcement

Parameters:

announcementId - the id of the announcement

Throws:

RecommendationWebServiceException - if the announcement does not exist or cannot be updated

removeCommunityRecommendation

void removeCommunityRecommendation(String recommendationId)
                            throws RecommendationWebServiceException

removes a recommendation of type community

Parameters:

recommendationId - the id of the recommendation

communityId - the id of the community

Throws:

RecommendationWebServiceException

removeUserRecommendation

void removeUserRecommendation(String recommendationId)
                       throws RecommendationWebServiceException

Throws:

RecommendationWebServiceException

updateRecommendation

void updateRecommendation(String recommendationId,
                          int index,
                          boolean active,
                          String title,
                          String recommendationText,
                          Date creationDate,
                          Date expirationDate)
                   throws RecommendationWebServiceException

updates a recommendation

Parameters:

recommendationId - the id of the recommendation

recommendationText - the text of the recommendation

creationDate - the date the recommendation is created

expirationDate - the date the recommendation expires

Throws:

RecommendationWebServiceException - if the recommendation does not exist or cannot be updated

updateAnnouncement

void updateAnnouncement(String announcementId,
                        int index,
                        boolean active,
                        String announcementTitle,
                        String announcementText,
                        Date creationDate,
                        Date expirationDate)
                 throws RecommendationWebServiceException

updates an announcement and the corresponding recommendation

Parameters:

announcementId - the id of the announcement

recommendationText - the text of the corresponding recommendation

creationDate - the creation date of the announcement

expirationDate - the expiration date of the announcement

Throws:

RecommendationWebServiceException - if the announcement recommendation does not exist or cannot be updated

updateCommunityRecommendation

void updateCommunityRecommendation(String recommendationId,
                                   int index,
                                   boolean active,
                                   String title,
                                   String recommendationText,
                                   Date creationDate,
                                   Date expirationDate,
                                   Set<String> communityIds)
                            throws RecommendationWebServiceException

Throws:

RecommendationWebServiceException

sendAnnouncement

void sendAnnouncement(String announcementId)
               throws RecommendationWebServiceException

sends an e-mail to all users with the recommendation text of an announcement

Parameters:

announcementId - the id of the announcement

Throws:

MessagingException - if the e-mail cannot be sent

RecommendationWebServiceException - if the announcement or recommendation does not exist

addRecommendationToUser

void addRecommendationToUser(String recommendationId,
                             String userId)
                      throws RecommendationWebServiceException

Throws:

RecommendationWebServiceException

getCommunityRecommendationsForUser

List<String> getCommunityRecommendationsForUser(String userId)
                                         throws eu.dnetlib.api.functionality.RecommendationServiceException

gets all the community recommendation for a specific user

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException

getCommunityRecommendationsForUserObj

List<eu.dnetlib.domain.functionality.Recommendation> getCommunityRecommendationsForUserObj(String userId)
                                                                                    throws eu.dnetlib.api.functionality.RecommendationServiceException

gets all the community recommendation objects for a specific user

Throws:

eu.dnetlib.api.functionality.RecommendationServiceException