content: /*
   This file is part of Airsonic.
  
   Airsonic 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.
  
   Airsonic 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 Airsonic.  If not, see <http://www.gnu.org/licenses/>.
  
   Copyright 2016 (C) Airsonic Authors
   Based upon Subsonic, Copyright 2009 (C) Sindre Mehus
   */
  
  package org.airsonic.player.service;
  
  import org.airsonic.player.domain.Album;
  import org.airsonic.player.domain.MediaFile;
  import org.airsonic.player.domain.MusicFolder;
  import org.airsonic.player.domain.ParamSearchResult;
  import org.airsonic.player.domain.RandomSearchCriteria;
  import org.airsonic.player.domain.SearchCriteria;
  import org.airsonic.player.domain.SearchResult;
  import org.airsonic.player.service.search.IndexType;
  
  import java.util.List;
  
  /**
   * Performs Lucene-based searching.
   *
   * @author Sindre Mehus
   * @version $Id$
   * @see MediaScannerService
   */
  public interface SearchService {
  
      SearchResult search(SearchCriteria criteria, List<MusicFolder> musicFolders,
              IndexType indexType);
  
      /**
       * Returns a number of random songs.
       *
       * @param criteria Search criteria.
       * @return List of random songs.
       */
      List<MediaFile> getRandomSongs(RandomSearchCriteria criteria);
  
      /**
       * Returns a number of random albums.
       *
       * @param count Number of albums to return.
       * @param musicFolders Only return albums from these folders.
       * @return List of random albums.
       */
      List<MediaFile> getRandomAlbums(int count, List<MusicFolder> musicFolders);
  
      /**
       * Returns a number of random albums, using ID3 tag.
       *
       * @param count Number of albums to return.
       * @param musicFolders Only return albums from these folders.
       * @return List of random albums.
       */
      List<Album> getRandomAlbumsId3(int count, List<MusicFolder> musicFolders);
  
      <T> ParamSearchResult<T> searchByName(
              String name, int offset, int count, List<MusicFolder> folderList, Class<T> clazz);
  
  }
  