/*
This file is part of Subsonic.
Subsonic is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Subsonic is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with Subsonic. If not, see .
Copyright 2009 (C) Sindre Mehus
*/
package net.sourceforge.subsonic.service;
import net.sourceforge.subsonic.dao.*;
import net.sourceforge.subsonic.domain.*;
import net.sourceforge.subsonic.util.FileUtil;
import java.util.*;
import java.io.File;
/**
* Provides services for user ratings.
*
* @author Sindre Mehus
*/
public class RatingService {
private RatingDao ratingDao;
private SecurityService securityService;
private MediaFileService mediaFileService;
/**
* Returns the highest rated music files.
*
* @param offset Number of files to skip.
* @param count Maximum number of files to return.
* @return The highest rated music files.
*/
public List getHighestRated(int offset, int count) {
List highestRated = ratingDao.getHighestRated(offset, count);
List result = new ArrayList();
for (String path : highestRated) {
File file = new File(path);
if (FileUtil.exists(file) && securityService.isReadAllowed(file)) {
result.add(mediaFileService.getMediaFile(path));
}
}
return result;
}
/**
* Sets the rating for a music file and a given user.
*
* @param username The user name.
* @param mediaFile The music file.
* @param rating The rating between 1 and 5, or null
to remove the rating.
*/
public void setRatingForUser(String username, MediaFile mediaFile, Integer rating) {
ratingDao.setRatingForUser(username, mediaFile, rating);
}
/**
* Returns the average rating for the given music file.
*
* @param mediaFile The music file.
* @return The average rating, or null
if no ratings are set.
*/
public Double getAverageRating(MediaFile mediaFile) {
return ratingDao.getAverageRating(mediaFile);
}
/**
* Returns the rating for the given user and music file.
*
* @param username The user name.
* @param mediaFile The music file.
* @return The rating, or null
if no rating is set.
*/
public Integer getRatingForUser(String username, MediaFile mediaFile) {
return ratingDao.getRatingForUser(username, mediaFile);
}
public void setRatingDao(RatingDao ratingDao) {
this.ratingDao = ratingDao;
}
public void setSecurityService(SecurityService securityService) {
this.securityService = securityService;
}
public void setMediaFileService(MediaFileService mediaFileService) {
this.mediaFileService = mediaFileService;
}
}