DocumentationCatalogService.cs

이 파일의 문서화 페이지로 가기

using DreamineWeb.Models;
using Microsoft.AspNetCore.Hosting;
using System.IO;
using System.Text.Json;
 
namespace DreamineWeb.Services;

public sealed class DocumentationCatalogService
{
    private readonly IWebHostEnvironment _environment;

    private IReadOnlyList<DocumentationProjectInfo>? _projects;

    public DocumentationCatalogService(IWebHostEnvironment environment)
    {
        _environment = environment ?? throw new ArgumentNullException(nameof(environment));
    }

    public IReadOnlyList<DocumentationProjectInfo> GetProjects()
    {
        if (_projects is not null)
            return _projects;
 
        string catalogPath = Path.Combine(_environment.WebRootPath, "understand", "project-catalog.json");
        if (!File.Exists(catalogPath))
            throw new FileNotFoundException("Project documentation catalog was not generated. Run Publish-UnderstandDashboard.ps1.", catalogPath);
 
        using FileStream stream = File.OpenRead(catalogPath);
        DocumentationProjectCatalog catalog = JsonSerializer.Deserialize<DocumentationProjectCatalog>(stream, new JsonSerializerOptions
        {
            PropertyNameCaseInsensitive = true
        }) ?? new DocumentationProjectCatalog();
        _projects = catalog.Projects.OrderBy(project => project.Category).ThenBy(project => project.Name).ToArray();
        return _projects;
    }
}