FileServerPlus.Mvc 1.0.1

File server extensions of ASP.NET Core

An extensions of file server on ASP.NET core to support file version.

Normal (Framework not generate version if use file server)

<img class="d-block m-auto" src="/storage1/cat.jpg" width="200" alt="Sample cat">

File server Plus

<img class="d-block m-auto" src="/storage1/cat.jpg?v=vW8o-DqXyVVm8IQWxIOh8eFuv91UvMW9uJ2ei1a2vX8" width="200" alt="Sample cat">

Installation

Install-Package FileServerPlus.Mvc -Version 1.0.0

Get Started

Register

1. Views/_ViewImports.cshtml

// _ViewImports.cshtml
@using FileServerPlus.Mvc.Extensions
... 
@addTagHelper *, FileServerPlus.Mvc

2. Configure services

// Startup.cs
public void ConfigureServices(IServiceCollection services)
{
    ...

    services.AddFileServerPlus();
}

3. Configure directory

3.1 Sample

// Startup.cs
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    ...
    var rootDirectory1 = new DirectoryInfo("..\\storages\\storage1\\");
    app.UseFileServerPlus("Server1", rootDirectory1, "/storage1", enableDirectoryBrowsing: true);
    ...
}

3.2 Use configure from json file

// appsettings.json
{
  "FileServers": [
    {
      "ServerId": "Server1",
      "RootDirectory": "..\\storages\\storage1\\",
      "RequestPath": "/storage1",
      "EnableDirectoryBrowsing": false
    }
  ]
}

// Startup.cs
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    ...
    var configurationSection = Configuration.GetSection("FileServers");
    app.UseFileServerPlus(configurationSection);
    ...
}

Options

1. Tag Helper

• asp-file-server-version

<img class="d-block m-auto" src="~/cat.jpg" asp-file-server-version="true" width="200" alt="Sample cat" />

2. IUrlHelper

• Url.FileServerContent("PATH")

<img class="d-block m-auto" src="@Url.FileServerContent("~/cat.jpg")" width="200" alt="Sample cat" /> 

3. File server context

• Get
• GetUrl
• GetWorkingDirectory

    // HomeController.cs
    public class HomeController : Controller
    {
        public IActionResult Index()
        {
            var fileInfo1 = _fileServerPlusContext.Get(@"/cat.jpg");
            
            var fileInfo2 = _fileServerPlusContext.Get(@"~/cat.jpg");

            var fileUrl = _fileServerPlusContext.GetUrl(@"/cat.jpg");
            
            var directory = _fileServerPlusContext.GetWorkingDirectory();

            return View();
        }

        private readonly IFileServerPlusContext _fileServerPlusContext;

        public HomeController(IFileServerPlusContext fileServerPlusContext)
        {
            _fileServerPlusContext = fileServerPlusContext;
        }
    }

Multi File server

// appsettings.json
{
  "FileServers": [
    {
      "ServerId": "Server1",
      "RootDirectory": "..\\storages\\storage1\\",
      "RequestPath": "/storage1",
      "EnableDirectoryBrowsing": false
    },
    {
      "ServerId": "Server2",
      "RootDirectory": "..\\storages\\storage2\\",
      "RequestPath": "/storage2",
      "EnableDirectoryBrowsing": false
    }
  ]
}

Selecte sever

• asp-file-server-id

<img class="d-block m-auto" src="~/cat.jpg" asp-file-server-id="Server1" asp-file-server-version="true" width="200" alt="Sample cat" />

<img class="d-block m-auto" src="@Url.FileServerContent("Server1","~/cat.jpg")" width="200" alt="Sample cat" />