#region license
// This file is part of Vocaluxe.
//
// Vocaluxe 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.
//
// Vocaluxe 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 Vocaluxe. If not, see .
#endregion
using System.Threading.Tasks;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using VocaluxeWeb.Contracts;
using VocaluxeWeb.Services;
namespace VocaluxeWeb.Api
{
[Route("api/v1/songs")]
[RequireSession]
public sealed class SongsController : ApiControllerBase
{
private readonly CSongLibrary _Songs;
private readonly CImageService _Images;
public SongsController(CSongLibrary songs, CImageService images)
{
_Songs = songs;
_Images = images;
}
/// Searches the song library. All words of the query must appear in artist, title or edition.
[HttpGet]
public async Task> Search([FromQuery] SongSearchDto request)
{
return await _Songs.SearchAsync(new CSongQuery
{
Text = request.Query,
Language = request.Language,
Genre = request.Genre,
Decade = request.Decade,
Duet = request.Duet,
Sort = request.Sort,
Page = request.Page,
PageSize = request.PageSize
});
}
/// Available languages, genres and decades with the number of songs, for filters.
[HttpGet("facets")]
public async Task> GetFacets()
{
return await _Songs.GetFacetsAsync();
}
[HttpGet("{id}")]
public async Task> Get(int id)
{
var song = await _Songs.GetAsync(id);
if (song == null)
{
return Problem(StatusCodes.Status404NotFound, "Song not found.");
}
return CSongLibrary.ToDto(song);
}
/// The audio file of the song, for previews. Supports range requests, so the browser can jump to the preview start.
[HttpGet("{id}/audio")]
[Produces("audio/mpeg", "audio/ogg", "audio/mp4", "audio/wav", "audio/flac")]
[ProducesResponseType(typeof(FileResult), StatusCodes.Status200OK)]
public async Task GetAudio(int id)
{
var song = await _Songs.GetAsync(id);
if (string.IsNullOrEmpty(song?.AudioPath) || !System.IO.File.Exists(song.AudioPath))
{
return NotFound();
}
Response.Headers["Cache-Control"] = "private, max-age=3600";
return PhysicalFile(song.AudioPath, _GetAudioType(song.AudioPath), true);
}
private static string _GetAudioType(string path)
{
switch (System.IO.Path.GetExtension(path).ToLowerInvariant())
{
case ".ogg":
case ".oga":
case ".opus":
return "audio/ogg";
case ".m4a":
case ".mp4":
case ".aac":
return "audio/mp4";
case ".wav":
return "audio/wav";
case ".flac":
return "audio/flac";
case ".webm":
return "audio/webm";
default:
return "audio/mpeg";
}
}
/// The cover as JPEG, scaled to fit the given size (96, 200 or 400).
[HttpGet("{id}/cover")]
[Produces("image/jpeg")]
[ProducesResponseType(typeof(FileResult), StatusCodes.Status200OK)]
public async Task GetCover(int id, [FromQuery] int size = 200)
{
var song = await _Songs.GetAsync(id);
var file = _Images.GetScaled(song?.CoverPath, size, out var etag);
if (file == null)
{
return NotFound();
}
return CImageResult.Create(this, file, etag);
}
}
}