Servidor de Arquivos

Sisk fornece o namespace Sisk.Http.FileSystem, que contém ferramentas para servir arquivos estáticos, listagem de diretórios e conversão de arquivos. Esse recurso permite servir arquivos de um diretório local, com suporte a solicitações de intervalo (streaming de áudio/vídeo) e processamento personalizado de arquivos.

Servindo arquivos estáticos #

A maneira mais fácil de servir arquivos estáticos é Router.MapFileSystem. Esse método mapeia um prefixo de URL para um diretório no disco.

using Sisk.Core.Http;
using Sisk.Core.Http.FileSystem;

// maps the root of the server to the current directory
mainRouter.MapFileSystem("/", Directory.GetCurrentDirectory());

// maps /assets to the "public/assets" folder
mainRouter.MapFileSystem(
    "/assets",
    Path.Combine(Directory.GetCurrentDirectory(), "public", "assets"));

Quando uma requisição corresponde ao prefixo da rota, o HttpFileServerHandler procurará um arquivo no diretório especificado. Se encontrado, ele servirá o arquivo; caso contrário, retornará uma resposta 404 (ou 403 se o acesso for negado).

HttpFileServer.CreateServingRoute ainda está disponível quando você precisa criar um objeto Route explicitamente, mas MapFileSystem é a opção mais direta para o código da aplicação.

HttpFileServerHandler #

Para ter mais controle sobre como os arquivos são servidos, você pode instanciar e configurar o HttpFileServerHandler manualmente.

var fileHandler = new HttpFileServerHandler("/var/www/html");

// enable directory listing (disabled by default)
fileHandler.AllowDirectoryListing = true;

// set a custom route prefix (this will be trimmed from the request path)
fileHandler.RoutePrefix = "/public";

// register the handler under /public
mainRouter.MapFileSystem("/public", fileHandler);

Configuração #

Listagem de Diretório #

Quando AllowDirectoryListing está habilitado e o usuário solicita um caminho de diretório, o Sisk gerará uma página HTML listando o conteúdo desse diretório.

A listagem de diretório inclui:

• Navegação para o diretório pai (..).
• Lista de subdiretórios.
• Lista de arquivos com tamanho e data da última modificação.

Conversores de Arquivo #

Conversores de arquivo permitem interceptar tipos específicos de arquivos e tratá-los de forma diferente. Por exemplo, você pode querer transcodificar uma imagem, comprimir um arquivo em tempo real ou servir um arquivo usando conteúdo parcial (solicitações de intervalo).

O Sisk inclui dois conversores embutidos para streaming de mídia:

• HttpFileAudioConverter: Lida com .mp3, .ogg, .wav, .flac, .ogv.
• HttpFileVideoConverter: Lida com .webm, .avi, .mkv, .mpg, .mpeg, .wmv, .mov, .mp4.

Esses conversores habilitam o suporte a solicitações de intervalo HTTP, permitindo que os clientes avancem em arquivos de áudio e vídeo.

Criando um conversor personalizado #

Para criar um conversor de arquivo personalizado, herde de HttpFileServerFileConverter e implemente CanConvert e Convert.

using Sisk.Core.Http;
using Sisk.Core.Http.FileSystem;

public class MyTextConverter : HttpFileServerFileConverter
{
    public override bool CanConvert(FileInfo file)
    {
        // apply only to .txt files
        return file.Extension.Equals(".txt", StringComparison.OrdinalIgnoreCase);
    }

    public override HttpResponse Convert(FileInfo file, HttpRequest request)
    {
        string content = File.ReadAllText(file.FullName);
        
        // uppercase all text content
        return new HttpResponse(200)
        {
            Content = new StringContent(content.ToUpper())
        };
    }
}

Então, adicione-o ao seu manipulador:

var handler = new HttpFileServerHandler("./files");
handler.FileConverters.Add(new MyTextConverter());