D-Net

{

  "type_source": "SVN", 

  "goal": "package -U -T 4C source:jar", 

  "url": "http://svn-public.driver.research-infrastructures.eu/driver/dnet40/modules/uoa-api/trunk", 

  "deploy_repository": "dnet4-snapshots", 

  "version": "4", 

  "mail": "antleb@di.uoa.gr, kiatrop@di.uoa.gr", 

  "deploy_repository_url": "http://maven.research-infrastructures.eu/nexus/content/repositories/dnet4-snapshots", 

  "name": "uoa-api"

}

package eu.dnetlib.api.functionality;

import java.util.List;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.validator.JobForValidation;

import eu.dnetlib.domain.functionality.validator.RuleSet;

import eu.dnetlib.domain.functionality.validator.StoredJob;

public interface ValidatorService extends DriverService {

	StoredJob getStoredJob(int jobId, String groupBy) throws ValidatorServiceException;

	List<StoredJob> getStoredJobs(String userMail, String jobType, Integer offset, Integer limit, String dateFrom, String dateTo) throws ValidatorServiceException;

	int getStoredJobsTotalNumber(String userMail, String jobType) throws ValidatorServiceException;

	List<StoredJob> getStoredJobsNew(String userMail, String jobType, Integer offset, Integer limit, String dateFrom, String dateTo, String jobStatus) throws ValidatorServiceException;

	int getStoredJobsTotalNumberNew(String userMail, String jobType, String jobStatus) throws ValidatorServiceException;

	List<RuleSet> getRuleSets() throws ValidatorServiceException;

	void submitValidationJob(JobForValidation job) throws ValidatorServiceException;

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.ConversionStatus;

public interface ConversionService extends DriverService { 

	/**

	 * Adds a conversion job

	 * @param fileUrl the url of the file to be converted

	 * @param format the desired format 

	 * @return the {@link ConversionStatus} of the conversion job

	 * @throws ConversionServiceException

	 */

	public ConversionStatus addJob(String fileUrl, String format)  

				throws ConversionServiceException;

	/**

	 * The {@link ConversionStatus} of a conversion job 

	 * @param conversionId the id of the conversion job

	 * @return the {@link ConversionStatus}  

	 * @throws ConversionServiceException

	 */

	public ConversionStatus getStatus(String conversionId) 

				throws ConversionServiceException;

}

package eu.dnetlib.api.functionality;

/**

 * This exception is thrown by alert service if any errors occur.

 * @author thanos@di.uoa.gr

 * @see AlertService

 *

 */

public class AlertServiceException extends Exception {

	private static final long serialVersionUID = 1L;

	/**

	 * Construct a new alert service exception with the specified message and cause.

	 * @param message the message

	 * @param cause the cause

	 */

	public AlertServiceException(final String message, final Throwable cause) {

		super(message, cause);

	}

	/**

	 * Construct a new alert service exception with the specified message.

	 * @param message the message

	 */

	public AlertServiceException(final String message) {

		super(message);

	}

}

package eu.dnetlib.api.functionality;

import java.net.URL;

import java.util.Date;

import java.util.SortedSet;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.NotificationEvent;

import eu.dnetlib.domain.functionality.NotificationQuery;

import eu.dnetlib.domain.functionality.NotificationResult;

import eu.dnetlib.domain.functionality.NotificationSchedule;

import eu.dnetlib.domain.functionality.NotificationSubscription;

import eu.dnetlib.domain.functionality.ObjectPage;

import eu.dnetlib.domain.functionality.ResultPage;

/**

 * This interface declares the available methods of notification service. Alert service is used to manage queries, schedules, events, results and subscriptions.

 * @author thanos@di.uoa.gr

 * @see eu.dnetlib.domain.functionality.NotificationQuery

 * @see eu.dentlib.domain.functionality.NotificationSchedule

 * @see eu.dnetlib.domain.functionality.NotificationEvent

 * @see eu.dnetlib.domain.functionality.NotificationResult

 * @see eu.dnetlib.domain.functionality.NotificationSubscription

 * @see NotificationServiceException

 * 

 */

public interface NotificationService extends DriverService {

	/**

	 * Retrieve all the supported languages in which queries can be expressed.

	 * @return a set containing all the supported languages in which queries can be expressed

	 */

	public SortedSet<String> getSupportedQueryLanguages();

	/**

	 * Retrieve a page of queries.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containing queries

	 * @throws NotificationServiceException if any errors occur

	 */

	public ObjectPage<NotificationQuery> getQueries(final int pageNumber, final int pageSize) throws NotificationServiceException;

	/**

	 * Add a query.

	 * @param query the query to add

	 * @throws NotificationServiceException if any errors occur

	 */

	public void addQuery(final NotificationQuery query) throws NotificationServiceException;

	/**

	 * Remove a query.

	 * @param queryId the unique identifier of the query to remove

	 * @throws NotificationServiceException if any errors occur

	 */

	public void removeQuery(final String queryId) throws NotificationServiceException;

	/**

	 * Execute a query and return the generated result.

	 * @param queryId the unique identifier of the query to execute

	 * @param resultId the unique result identifier to use

	 * @param fromDate the from date to use

	 * @param toDate the to date to use

	 * @param limit the limit to use

	 * @param offset the offset to use

	 * @return a result page containing the generated result

	 * @throws NotificationServiceException if any errors occur

	 */

	public ResultPage executeQuery(final String queryId, final String resultId, final Date fromDate, final Date toDate, final int limit, final int offset) throws NotificationServiceException;

	/**

	 * Retrieve a page of schedules.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containing schedules

	 * @throws NotificationServiceException if any errors occur

	 */

	public ObjectPage<NotificationSchedule> getSchedules(final int pageNumber, final int pageSize) throws NotificationServiceException;

	/**

	 * Add a schedule.

	 * @param schedule the schedule to add

	 * @throws NotificationServiceException if any errors occur

	 */

	public void addSchedule(final NotificationSchedule schedule) throws NotificationServiceException;

	/**

	 * Enable a schedule.

	 * @param queryId the unique identifier of the query whose schedule to enable

	 * @throws NotificationServiceException if any errors occur

	 */

	public void enableSchedule(final String queryId) throws NotificationServiceException;

	/**

	 * Disable a schedule.

	 * @param queryId the unique identifier of the query whose schedule to disable

	 * @throws NotificationServiceException if any errors occur

	 */

	public void disableSchedule(final String queryId) throws NotificationServiceException;

	/**

	 * Remove a schedule.

	 * @param queryId the unique identifier of the query of the schedule to remove

	 * @throws NotificationServiceException if any errors occur

	 */

	public void removeSchedule(final String queryId) throws NotificationServiceException;

	/**

	 * Retrieve a page of events.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containing events

	 * @throws NotificationServiceException if any errors occur

	 */

	public ObjectPage<NotificationEvent> getEvents(final int pageNumber, final int pageSize) throws NotificationServiceException;

	/**

	 * Retrieve a page of results.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containing results

	 * @throws NotificationServiceException if any errors occur

	 */

	public ObjectPage<NotificationResult> getResults(final int pageNumber, final int pageSize) throws NotificationServiceException;

	/**

	 * Retrieve a result of an event of a query.

	 * @param queryId the unique identifier of the query of the event of the result to retrieve

	 * @param date the date corresponding to the event of the result to retrieve

	 * @param resultId the unique identifier of the result to retrieve

	 * @return the specified result of the specified event of the specified query or null if no such result exists

	 * @throws NotificationServiceException if any errors occur

	 */

	public NotificationResult getResult(final String queryId, final Date date, final String resultId) throws NotificationServiceException;

	/**

	 * Retrieve a result of the previous event of an event of a query.

	 * @param queryId the unique identifier of the query of the event of the result to retrieve

	 * @param date the date corresponding to the next event of the event whose result to retrieve 

	 * @param resultId the unique identifier of the result to retrieve

	 * @return the specified result of the previous event of the specified event of the specified query or null if no such result exists

	 * @throws NotificationServiceException if any errors occur

	 */

	public NotificationResult getPreviousResult(final String queryId, final Date date, final String resultId) throws NotificationServiceException;

	/**

	 * Retrieve a page of subscriptions.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containign subscriptions

	 * @throws NotificationServiceException if any errors occur

	 */

	public ObjectPage<NotificationSubscription> getSubscriptions(final int pageNumber, final int pageSize) throws NotificationServiceException;

	/**

	 * Add a subscription.

	 * @param subscription the subscription to add

	 * @throws NotificationServiceException if any errors occur

	 */

	public void addSubscription(final NotificationSubscription subscription) throws NotificationServiceException;

	/**

	 * Enable a subscription.

	 * @param queryId the unique identifier of the query of the schedule of the subscription to enable

	 * @param alertService the URL of the alert service of the subscription to enable

	 * @throws NotificationServiceException if any errors occur

	 */

	public void enableSubscription(final String queryId, final URL alertService) throws NotificationServiceException;

	/**

	 * Disable a subscription.

	 * @param queryId the unique identifier of the query of the schedule of the subscription to disable

	 * @param alertService the URL of the alert service of the subscription to disable

	 * @throws NotificationServiceException if any errors occur

	 */

	public void disableSubscription(final String queryId, final URL alertService) throws NotificationServiceException;

	/**

	 * Remove a subscription.

	 * @param queryId the unique identifier of the query of the schedule of the subscription to remove

	 * @param alertService the URL of the alert service of the subscription to remove

	 * @throws NotificationServiceException if any errors occur

	 */

	public void removeSubscription(final String queryId, final URL alertService) throws NotificationServiceException;

}

package eu.dnetlib.api.functionality;

import java.util.List;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.Post;

import eu.dnetlib.domain.functionality.Thread;

/**

 * This interface describes the available methods  of a forum service.

 * @author thanos@di.uoa.gr

 *

 */

public interface ForumService extends DriverService {

	/**

	 * Open a new thread.

	 * @param communityId the id of the community that the thread belongs to

	 * @param userId the id of the user that opens the thread

	 * @param topic the topic of the thread

	 * @return the id of the thread just opened

	 * @throws ForumServiceException if any errors occur

	 */

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

	/**

	 * Edit an existing thread.

	 * @param threadId the id of the thread to edit

	 * @param topic the new topic of the thread

	 * @param posts the new posts of the thread

	 * @throws ForumServiceException if any errors occur

	 */

	public void editThread(long threadId, String topic, List<Post> posts) throws ForumServiceException;

	/**

	 * Delete an existing thread.

	 * @param threadId the id of the thread to delete

	 * @throws ForumServiceException if any errors occur

	 */

	public void deleteThread(long threadId) throws ForumServiceException;

	/**

	 * Search for an existing thread by id.

	 * @param threadId the id of the thread to search for

	 * @return the thread with the specified id or null if no such thread exists

	 * @throws ForumServiceException if any errors occur

	 */

	public Thread searchThread(long threadId) throws ForumServiceException;

	/**

	 * Search for existing threads by community.

	 * @param communityId the id of the community the threads belong to

	 * @return a list containing all the threads that belong to the specified community

	 * @throws ForumServiceException if any errors occur

	 */

	public List<Thread> searchThread(String communityId) throws ForumServiceException;

}

package eu.dnetlib.api.functionality;

import java.util.List;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.Collection;

import eu.dnetlib.domain.functionality.CollectionSearchCriteria;

public interface CollectionService extends DriverService {

	public Collection getCollection(String collectionId)

			throws CollectionServiceException;

	public List<Collection> getCollections(List<String> collectionIds)

			throws CollectionServiceException;

	public void updateCollection(Collection collection)

			throws CollectionServiceException;

	public void deleteCollection(String collectionId)

			throws CollectionServiceException;

	public String createCollection(Collection collection)

			throws CollectionServiceException;

	public List<Collection> searchCollections(CollectionSearchCriteria criteria) 

			throws CollectionServiceException;

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverService;

/**

 * The webInterface service interface

 * 

 */

public interface WebInterfaceService extends DriverService {

}

package eu.dnetlib.api.functionality;

import java.util.List;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.UserProfile;

import eu.dnetlib.domain.functionality.UserProfileSearchCriteria;

/**

 * Class that manages UserProfile objects.

 */

public interface UserProfileService extends DriverService {

	public UserProfile saveUser(UserProfile profile)

			throws UserProfileServiceException;

	public void deleteUser(UserProfile profile)

			throws UserProfileServiceException;

	public void deleteUserById(String id) throws UserProfileServiceException;

	public UserProfile getUserById(String id)

			throws UserProfileServiceException;

	public List<UserProfile> searchUsers(UserProfileSearchCriteria criteria)

			throws UserProfileServiceException;

	public List<String> searchUserIds(UserProfileSearchCriteria criteria)

			throws UserProfileServiceException;

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverServiceException;

public class CommunityServiceException extends DriverServiceException {

	private static final long serialVersionUID = 8752304807357459107L;

	public CommunityServiceException() {

        super();

    }

    public CommunityServiceException(String message, Throwable cause) {

        super(message, cause);

    }

    public CommunityServiceException(String message) {

        super(message);

    }

    public CommunityServiceException(Throwable cause) {

        super(cause);

    }

}

package eu.dnetlib.api.functionality;

public class RatingServiceException extends Exception {

	/**

	 * Used for serialization / deserialization.

	 */

	private static final long serialVersionUID = 1L;

	/**

	 * Create a new rating service exception.

	 *

	 */

	public RatingServiceException() {

		super();

	}

	/**

	 * Create a new rating service exception with the specified error message.

	 * @param message the error message

	 */

	public RatingServiceException(String message) {

		super(message);

	}

	/**

	 * Create a new rating service exception with the specified cause.

	 * @param cause the cause

	 */

	public RatingServiceException(Throwable cause) {

		super(cause);

	}

	/**

	 * Create a new rating service exception with the specified error message and cause.

	 * @param message the error message

	 * @param cause the cause

	 */

	public RatingServiceException(String message, Throwable cause) {

		super(message, cause);

	}

}

package eu.dnetlib.api.functionality;

@SuppressWarnings("serial")

public class ConversionServiceException extends Exception {

	public ConversionServiceException() {

		super();

	}

	public ConversionServiceException(String message, Throwable cause) {

		super(message, cause);

	}

	public ConversionServiceException(String message) {

		super(message);

	}

	public ConversionServiceException(Throwable cause) {

		super(cause);

	}

}

package eu.dnetlib.api.functionality;

import java.util.Date;

import java.util.List;

import java.util.Set;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.Recommendation;

/**

 * The class that manages Recommendation objects

 */

public interface RecommendationService extends DriverService {

	/**

	 * creates a new recommendation of type announcement

	 * 

	 * @param recommendationText

	 *            the text of the recommendation

	 * @param creationDate

	 *            the creation date of the announcement

	 * @param expirationDate

	 *            the date the announcement expires

	 * @return the id of the new recommendation

	 * @throws RecommendationWebServiceException

	 *             if the announcement cannot be created

	 */

	public String generateAnnouncement(int index, boolean active,

			String announcementTitle, String announcementText,

			Date creationDate, Date expirationDate)

			throws RecommendationServiceException;

	/**

	 * Swap the index of 2 announcements

	 * 

	 * @param announcementId1

	 *            the id of the fist announcement

	 * @param announcementId2

	 *            the id of the second announcement

	 */

	public void swapAnnouncements(String announcementId1, String announcementId2)

			throws RecommendationServiceException;

	/**

	 * Swap the index of 2 user recommendaitons

	 * 

	 * @param announcementId1

	 *            the id of the fist announcement

	 * @param announcementId2

	 *            the id of the second announcement

	 */

	public void swapUserRecommendations(String announcementId1, String announcementId2) 

			throws RecommendationServiceException;;

	/**

	 * Swap the index of 2 community recommendations

	 * 

	 * @param announcementId1

	 *            the id of the fist announcement

	 * @param announcementId2

	 *            the id of the second announcement

	 */

	public void swapCommunityRecommendations(String announcementId1, String announcementId2)

			throws RecommendationServiceException;

	/**

	 * creates a new recommendation

	 * 

	 * @param index

	 *            the recommendation index

	 * @param active

	 *            the state of the recommendaiton, is it active or not #param

	 *            title the title of the recommendation

	 * @param rText

	 *            the recommendation text

	 * @param creationDate

	 *            the date the recommendation was created

	 * @param expirationDate

	 *            the date the recommendation expires

	 * @return the id of the recommendation

	 * @throws RecommendationServiceException

	 *             if the recommendation cannot be created

	 */

	public Recommendation generateRecommendation(int index, boolean active,

			String title, String recommendationText, Date creationDate,

			Date expirationDate) throws RecommendationServiceException;

	/**

	 * creates a new recommendation of type community

	 * 

	 * @param recommendationText

	 *            the recommendation text

	 * @param creationDate

	 * @param expirationDate

	 * @param communityId

	 *            the ids of the associated communities

	 * @return the id of the recommendation

	 * @throws RecommendationServiceException

	 *             if the community recommendation cannot be created

	 */

	public String generateCommunityRecommendation(int index, boolean active,

			String title, String recommendationText, Date creationDate,

			Date expirationDate, Set<String> communityIds)

			throws RecommendationServiceException;

	/**

	 * creates a new recommendation of type user

	 * 

	 * @param recommendationText

	 * @param creationDate

	 * @param expirationDate

	 * @return the id of the recommendation

	 * @throws RecommendationServiceException

	 *             if the user recommendation cannot be created

	 */

	public String generateUserRecommendation(int index, boolean active,

			String title, String userId, String recommendationText,

			Date creationDate, Date expirationDate)

			throws RecommendationServiceException;

	/**

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

	 * expired

	 * 

	 * @return the announcements' recommendation text

	 * @throws RecommendationServiceException

	 */

	public List<String> getAnnouncements()

			throws RecommendationServiceException;

	/**

	 * retrieves ths ids of all announcements

	 * 

	 * @throws RecommendationServiceException

	 */

	public List<String> getAllAnnouncementIds()

			throws RecommendationServiceException;

	/**

	 * retrieves the recommendation text of all announcements

	 * 

	 * @return the recommendation text of all announcements

	 * @throws RecommendationServiceException

	 */

	public List<Recommendation> getAllAnnouncements()

			throws RecommendationServiceException;

	/**

	 * retrieves all recommendations of type community, only the content

	 * 

	 * @return the recommendation text of all community recommendations

	 * @throws RecommendationServiceException

	 */

	public List<String> getAllCommunityRecommendations()

			throws RecommendationServiceException;

	/**

	 * retrieves all recommendations of type community, the objects

	 * 

	 * @return the recommendation text of all community recommendations

	 * @throws RecommendationServiceException

	 */

	public List<Recommendation> getAllCommunityRecommendationsObj()

			throws RecommendationServiceException;

	public List<String> getCommunityRecommendations(String communityId)

			throws RecommendationServiceException;

	public List<Recommendation> getCommunityRecommendationsObj(

			String communityId) throws RecommendationServiceException;

	/**

	 * retrieves all community recommendation content that are associated with a

	 * community

	 * 

	 * @param communityId

	 *            the id of the community

	 * @return the recommendation text of the community recommendations

	 * @throws RecommendationServiceException

	 */

	public List<String> getAllCommunityRecommendations(String communityId)

			throws RecommendationServiceException;

	/**

	 * retrieves all community recommendation objects that are associated with a

	 * community.

	 * 

	 * @param communityId

	 *            the id of the community

	 * @return the recommendation text of the community recommendations

	 * @throws RecommendationServiceException

	 */

	public List<Recommendation> getAllCommunityRecommendationsObj(

			String communityId) throws RecommendationServiceException;

	public List<String> getAllUserRecommendations(String userId)

			throws RecommendationServiceException;

	/**

	 * retrieves a recommendation

	 * 

	 * @param recommendationId

	 *            the recommendation id

	 * @return the recommendation or null if the recommendation does not exist

	 * @throws RecommendationServiceException

	 * 

	 */

	public Recommendation getRecommendation(String recommendationId)

			throws RecommendationServiceException;

	/**

	 * retrieves the text of a recommendation

	 * 

	 * @param recommendationId

	 *            the id of the recommendation

	 * @return the recommendation text or null if the recommendation does not

	 *         exist

	 * @throws RecommendationServiceException

	 * 

	 */

	public String getRecommendationText(String recommendationId)

			throws RecommendationServiceException;

	/**

	 * retrieves the recommendation text of a Set of recommendations

	 * 

	 * @param recommendationIds

	 *            the ids of the recommendations

	 * @return a Set of the recommendations' text

	 * @throws RecommendationServiceException

	 * 

	 */

	public List<String> getRecommendations(List<String> recommendationIds)

			throws RecommendationServiceException;

	/**

	 * removes a recommendation

	 * 

	 * @param recommendationId

	 *            the id of the recommendation

	 * @throws RecommendationServiceException

	 *             if the recommendation does not exist or cannot be updated

	 */

	public void removeRecommendation(String recommendationId)

			throws RecommendationServiceException;

	/**

	 * removes a recommendation of type announcement

	 * 

	 * @param announcementId

	 *            the id of the announcement

	 * @throws RecommendationServiceException

	 *             if the announcement does not exist or cannot be updated

	 */

	public void removeAnnouncement(String announcementId)

			throws RecommendationServiceException;

	/**

	 * removes a recommendation of type community

	 * 

	 * @param recommendationId

	 *            the id of the recommendation

	 * @param communityId

	 *            the id of the community

	 * @throws RecommendationServiceException

	 */

	public void removeCommunityRecommendation(String recommendationId)

			throws RecommendationServiceException;

	public void removeUserRecommendation(String recommendationId)

			throws RecommendationServiceException;

	/**

	 * updates a recommendation

	 * 

	 * @param recommendationId

	 *            the id of the recommendation

	 * @param recommendationText

	 *            the text of the recommendation

	 * @param creationDate

	 *            the date the recommendation is created

	 * @param expirationDate

	 *            the date the recommendation expires

	 * @throws RecommendationServiceException

	 *             if the recommendation does not exist or cannot be updated

	 */

	public void updateRecommendation(String recommendationId, int index,

			boolean active, String title, String recommendationText,

			Date creationDate, Date expirationDate)

			throws RecommendationServiceException;

	/**

	 * updates an announcement and the corresponding recommendation

	 * 

	 * @param announcementId

	 *            the id of the announcement

	 * @param recommendationText

	 *            the text of the corresponding recommendation

	 * @param creationDate

	 *            the creation date of the announcement

	 * @param expirationDate

	 *            the expiration date of the announcement

	 * @throws RecommendationServiceException

	 *             if the announcement recommendation does not exist or cannot

	 *             be updated

	 */

	public void updateAnnouncement(String announcementId, int index,

			boolean active, String announcementTitle, String announcementText,

			Date creationDate, Date expirationDate)

			throws RecommendationServiceException;

	public void updateCommunityRecommendation(String recommendationId,

			int index, boolean active, String title, String recommendationText,

			Date creationDate, Date expirationDate, Set<String> communityIds)

			throws RecommendationServiceException;

	/*

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

	 * announcement

	 * 

	 * @param announcementId the id of the announcement @throws

	 * RecommendationServiceException if the announcement or recommendation does

	 * not exist

	 * 

	 * public void sendAnnouncement( String announcementId ) throws

	 * RecommendationServiceException;

	 */

	public void addRecommendationToUser(String recommendationId, String userId)

			throws RecommendationServiceException;

	/**

	 * gets all the community recommendation for a specific user

	 * 

	 * @throws RecommendationServiceException

	 */

	public List<String> getCommunityRecommendationsForUser(String userId)

			throws RecommendationServiceException;

	/**

	 * gets all the community recommendation objects for a specific user

	 * 

	 * @throws RecommendationServiceException

	 */

	public List<Recommendation> getCommunityRecommendationsForUserObj(

			String userId) throws RecommendationServiceException;

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverServiceException;

public class ValidatorServiceException extends DriverServiceException {

	/**

	 * 

	 */

	private static final long serialVersionUID = 1L;

	public ValidatorServiceException() {

		super();

	}

	public ValidatorServiceException(String message, Throwable cause) {

		super(message, cause);

	}

	public ValidatorServiceException(String message) {

		super(message);

	}

	public ValidatorServiceException(Throwable cause) {

		super(cause);

	}

}

package eu.dnetlib.api.functionality;

/**

 * This exception is thrown by notification service if any errors occur.

 * @author thanos@di.uoa.gr

 * @see NotificationService

 * 

 */

public class NotificationServiceException extends Exception {

	private static final long serialVersionUID = 1L;

	/**

	 * Construct a new notification service exception with the specified message and cause.

	 * @param message the message

	 * @param cause the cause

	 */

	public NotificationServiceException(final String message, final Throwable cause) {

		super(message, cause);

	}

	/**

	 * Construct a new notification service exception with the specified message.

	 * @param message the message

	 */

	public NotificationServiceException(final String message) {

		super(message);

	}

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverServiceException;

/**

 * This exception is thrown by forum service on any error.

 * @author thanos@di.uoa.gr

 *

 */

public class ForumServiceException extends DriverServiceException {

	/**

	 * Used for serialization / deserialization

	 */

	private static final long serialVersionUID = -8624823395470214377L;

	/**

	 * Create a new forum service exception.

	 */

	public ForumServiceException() {

		super();

	}

	/**

	 * Create a new forum service exception with the specified error message.

	 * @param message the error message

	 */

	public ForumServiceException(String message) {

		super(message);

	}

	/**

	 * Create a new forum service exception with the specified cause.

	 * @param cause the cause

	 */

	public ForumServiceException(Throwable cause) {

		super(cause);

	}

	/**

	 * Create a new forum service exception with the specified error message and cause.

	 * @param message the error message

	 * @param cause the cause

	 */

	public ForumServiceException(String message, Throwable cause) {

		super(message, cause);

	}

}

package eu.dnetlib.api.functionality;

import java.net.URI;

import java.net.URL;

import java.util.Date;

import java.util.SortedSet;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.AlertSubscription;

import eu.dnetlib.domain.functionality.AlertTemplate;

import eu.dnetlib.domain.functionality.NotificationEvent;

import eu.dnetlib.domain.functionality.ObjectPage;

import eu.dnetlib.domain.functionality.ResultPage;

/**

 * This interface declares the available methods of alert service. Alert service is used to manage templates and subscriptions. 

 * @author thanos@di.uoa.gr

 * @see eu.dnetlib.domain.functionality.AlertTemplate

 * @see eu.dnetlib.domain.functionality.AlertSubscription

 * @see eu.dnetlib.domain.functionality.NotificationEvent

 * @see AlertServiceException

 * 

 */

public interface AlertService extends DriverService {

	/**

	 * Retrieve all the supported modes in which alerts can be sent.

	 * @return a sorted set containing all the supported modes in which alerts can be sent

	 */

	public SortedSet<String> getSupportedAlertModes();

	/**

	 * Retrieve a page of templates.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containing templates

	 * @throws AlertServiceException if any errors occur

	 */

	public ObjectPage<AlertTemplate> getTemplates(final int pageNumber, final int pageSize) throws AlertServiceException;

	/**

	 * Add a template.

	 * @param template the template to add

	 * @throws AlertServiceException if any errors occur

	 */

	public void addTemplate(final AlertTemplate template) throws AlertServiceException;

	/**

	 * Remove a template.

	 * @param templateId the unique identifier of the template to remove

	 * @throws AlertServiceException if any errors occur

	 */

	public void removeTemplate(final String templateId) throws AlertServiceException;	

	/**

	 * Retrieve a page of subscriptions.

	 * @param pageNumber the number of the page to retrieve

	 * @param pageSize the size of the page to retrieve

	 * @return an object page containing subscriptions

	 * @throws AlertServiceException if any errors occur

	 */

	public ObjectPage<AlertSubscription> getSubscriptions(final int pageNumber, final int pageSize) throws AlertServiceException;

	/**

	 * Retrieve some subscriptions by alert mode and subscriber.

	 * @param alertMode the alert mode of the subscriptions to retrieve

	 * @param subscriber the subscriber URI of the subscriptions to retrieve (prefix match)

	 * @param limit the maximum number of subscriptions to retrieve

	 * @param offset the offset to start at 

	 * @return a list of subscriptions

	 * @throws AlertServiceException if any errors occur

	 */ 

	public SortedSet<AlertSubscription> getSubscriptions(final String alerMode, final String subscriber, final int limit, final int offset) throws AlertServiceException;

	/**

	 * Add a new subscription.

	 * @param subscription the subscription to add

	 * @throws AlertServiceException if any errors occur

	 */

	public void addSubscription(final AlertSubscription subscription) throws AlertServiceException;

	/**

	 * Enable a subscription.

	 * @param templateId the unique identifier of the template of the subscription to enable

	 * @param notificationService the URL of the notification service of the subscription to enable

	 * @param queryId the unique identifier of the notification query  of the subscription to enable

	 * @param resultId the unique identifier of the result of the subscription to enable

	 * @param alertMode the alert mode of the subscription to enable

	 * @param subscriber the URI of the subscriber of the subscription to enable 

	 * @throws AlertServiceException if any errors occur

	 */

	public void enableSubscription(final String templateId, final URL notificationService, final String queryId, final String resultId, final String alertMode, final URI subscriber) throws AlertServiceException;

	/**

	 * Disable a subscription.

	 * @param templateId the unique identifier of the template the subscription to disable

	 * @param notificationService the URL of the notification service of the subscription to disable

	 * @param queryId the unique identifier of the notification query of the subscription to disable

	 * @param resultId the unique identifier of the result of the subscription to disable

	 * @param alertMode the alert mode of the subscription to disable

	 * @param subscriber the URI of the subscriber of the subscription to disable 

	 * @throws AlertServiceException if any errors occur

	 */

	public void disableSubscription(final String templateId, final URL notificationService, final String queryId, final String resultId, final String alertMode, final URI subscriber) throws AlertServiceException;

	/**

	 * Remove a subscription.

	 * @param templateId the unique identifier of the template of the subscription to remove

	 * @param notificationService the URL of the notification service of the subscription to remove

	 * @param queryId the unique identifier of the notification query of the subscription to remove

	 * @param resultId the unique identifier of the result of the subscription to remove

	 * @param alertMode the alert mode of the subscription to remove

	 * @param subscriber the URI of the subscriber of the subscription to remove 

	 * @throws AlertServiceException if any errors occur

	 */

	public void removeSubscription(final String templateId, final URL notificationService, final String queryId, final String resultId, final String alertMode, final URI subscriber) throws AlertServiceException;

	/**

	 * Count the results of an alert.

	 * @param templateId the unique identifier of the template of the alert results to count

	 * @param notificationService the URL of the notification service of the alert results to count

	 * @param queryId the unique identifier of the notification query of the alert results to count

	 * @param date the date that corresponds to the notification event of the alert results to count

	 * @param resultId the unique identifier of the notification result of the alert results to count

	 * @return the total number of the specified alert results

	 * @throws AlertServiceException if any errors occur

	 */

	public int countAlertResults(final URL notificationService, final String queryId, final Date date, final String resultId) throws AlertServiceException;

	/**

	 * Retrieve the results of an alert.

	 * @param notificationService the URL of the notification service of the alert results to retrieve

	 * @param queryId the unique identfier of the notification query of the alert results to retrieve

	 * @param resultId the unique identifier of the notification result of the alert results to retrieve

	 * @param fromDate the date from which to retrieve alert results

	 * @param toDate the date up to which to retrieve alert results 

	 * @param limit the maximum number of alert results to retrieve

	 * @param offset the offset to start at

	 * @return a result page

	 * @throws AlertServiceException if any errors occur

	 */

	public ResultPage getAlertResults(final URL notificationService, final String queryId, final String resultId, final Date fromDate, final Date toDate, final int limit, final int offset) throws AlertServiceException;

	/**

	 * Alert this service about an event generated by a notification service.

	 * @param notificationService the URL of the notification service

	 * @param event the notification event

	 * @throws AlertServiceException if any errors occur

	 */

	public void alert(final URL notificationService, final NotificationEvent event) throws AlertServiceException; 

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverServiceException;

public class CollectionServiceException extends DriverServiceException{

	private static final long serialVersionUID = 1L;

	public CollectionServiceException(){

		super();

	}

	public CollectionServiceException(String message, Throwable cause){

		super(message, cause);

	}

	public CollectionServiceException(String message){

		super(message);

	}

	public CollectionServiceException(Throwable cause){

		super(cause);

	}

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverService;

public interface LocalDownloadManagerService extends DriverService {

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverServiceException;

public class UserProfileServiceException extends DriverServiceException {

	private static final long serialVersionUID = 8051839588351350465L;

	public UserProfileServiceException() {

		super();

	}

	public UserProfileServiceException(String message, Throwable cause) {

		super(message, cause);

	}

	public UserProfileServiceException(String message) {

		super(message);

	}

	public UserProfileServiceException(Throwable cause) {

		super(cause);

	}

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverService;

public interface MadgikValidator extends DriverService {

}

package eu.dnetlib.api.functionality;

import eu.dnetlib.api.DriverServiceException;

public class RecommendationServiceException extends DriverServiceException {

	private static final long serialVersionUID = 1L;

	public RecommendationServiceException() {

		super();

	}

	public RecommendationServiceException(String message, Throwable cause) {

		super(message, cause);

	}

	public RecommendationServiceException(String message) {

		super(message);

	}

	public RecommendationServiceException(Throwable cause) {

		super(cause);

	}

}

package eu.dnetlib.api.functionality;

import java.util.List;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.Community;

import eu.dnetlib.domain.functionality.CommunitySearchCriteria;

/**

 * The class that manages Community objects

 * 

 */

public interface CommunityService extends DriverService {

	/**

	 * Create or edit a community.

	 * @param community the community to save 

	 * @return the community just saved

	 * @throws CommunityServiceException if any errors occur

	 */

	public Community saveCommunity(Community community) throws CommunityServiceException;

	/**

	 * Delete a community.

	 * @param community the community to delete

	 * @throws CommunityServiceException if any errors occur

	 */

	public void deleteCommunity(Community community) throws CommunityServiceException;

	/**

	 * Delete a community.

	 * @param id the id of the community to delete

	 * @throws CommunityServiceException if any errors occur

	 */

	public void deleteCommunityById(String id) throws CommunityServiceException;

	/**

	 * Search for a community by id

	 * @param id the id of the community to search for

	 * @return the community with the specified id or null if no such community exists

	 * @throws CommunityServiceException

	 */

	public Community getCommunityById(String id) throws CommunityServiceException;

	/**

	 * Search for communities by the specified criteria.

	 * @param criteria the search criteria to match

	 * @return a list containing all the communities that match the specified criteria

	 * @throws CommunityServiceException if any errors occur

	 */

	public List<Community> searchCommunities(CommunitySearchCriteria criteria)

			throws CommunityServiceException;

	/**

	 * Search for communities by the specified criteria.

	 * @param criteria the search criteria to match

	 * @return a list containing the ids of all the communities that match the specified criteria

	 * @throws CommunityServiceException if any errors occur

	 */

	public List<String> searchCommunityIds(CommunitySearchCriteria criteria)

			throws CommunityServiceException;

	/**

	 * Check if a user is owner of a community.

	 * @param communityId the id of the community to check for

	 * @param userId the id of the user to check for

	 * @return true if the user is owner of the community; false otherwise

	 * @throws CommunityServiceException if any errors occur

	 */

	public boolean isOwner(String communityId, String userId) throws CommunityServiceException;

	/**

	 * Check if a user is manager of a community.

	 * @param communityId the id of the community to check for

	 * @param userId the id of the user to check for

	 * @return true if the user is manager of the community; false otherwise

	 * @throws CommunityServiceException

	 */

	public boolean isManager(String communityId, String userId) throws CommunityServiceException;

}

package eu.dnetlib.api.functionality;

import java.util.List;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.functionality.Rating;

/**

 * This interface describes the methods available for a rating service.

 * @author thanos@di.uoa.gr

 *

 */

public interface RatingService extends DriverService {

	/**

	 * Rate a document by a specifed user.

	 * @param userId the id of the user

	 * @param documentId the id of the document

	 * @param score the rating score

	 * @throws RatingServiceException if any errors occur

	 */

	public void rate(String userId, String documentId, float score) throws RatingServiceException;

	/**

	 * Search for existing ratings by user.

	 * @param userId the id of the user

	 * @return a list containing all the ratings of the specified user ordered by score

	 * @throws RatingServiceException if any errors occur

	 */

	public List<Rating> searchRatingsByUser(String userId) throws RatingServiceException;

	/**

	 * Search for existing ratings by document.

	 * @param documentId the id of the document

	 * @return a list containing all the ratings of the soecified document ordered by score

	 * @throws RatingServiceException if any errors occur

	 */

	public List<Rating> searchRatingsByDocument(String documentId) throws RatingServiceException;

	/**

	 * Get the top ratings.

	 * @param limit the maximum number of ratings to retrieve

	 * @return a list containing the top ratings ordered by score

	 * @throws RatingServiceException if any errors occur

	 */

	public List<Rating> getTopRatings(int limit) throws RatingServiceException;

	/**

	 * Get the top documents.

	 * @param limit the maximum number of ratings to retrieve

	 * @return a list containing the top document average ratings ordered by score

	 * @throws RatingServiceException if any errors occur

	 */

	public List<Rating> getTopDocuments(int limit) throws RatingServiceException;

}

package eu.dnetlib.api.data;

@SuppressWarnings("serial")

public class DatasourceManagerServiceException extends Exception {

	public DatasourceManagerServiceException() {

		super();

	}

	public DatasourceManagerServiceException(String message, Throwable cause) {

		super(message, cause);

	}

	public DatasourceManagerServiceException(String message) {

		super(message);

	}

	public DatasourceManagerServiceException(Throwable cause) {

		super(cause);

	}

}

package eu.dnetlib.api.data;

import eu.dnetlib.api.DriverServiceException;

public class SearchServiceException extends DriverServiceException {

	private static final long serialVersionUID = 4233470724221380778L;

	public SearchServiceException(String message) {

		super(message);

	}

	public SearchServiceException(String message, Throwable cause) {

		super(message, cause);

	}

}

package eu.dnetlib.api.data;

import java.util.Date;

import java.util.List;

import javax.jws.WebParam;

import eu.dnetlib.api.DriverService;

import eu.dnetlib.domain.data.Repository;

import eu.dnetlib.domain.data.RepositoryInterface;

public interface DatasourceManagerService extends DriverService {

	/**

	 * Register a datasource.

	 *