ReferenceDataController.cs

/*
 * This file is automatically generated; any changes will be lost. 
 */

using CommonRefDataNamespace = AIChat.AOAI.Common.Entities;

namespace AIChat.AOAI.Api.Controllers;

/// <summary>
/// Provides the <b>ReferenceData</b> Web API functionality.
/// </summary>
[Consumes(System.Net.Mime.MediaTypeNames.Application.Json)]
[Produces(System.Net.Mime.MediaTypeNames.Application.Json)]
public partial class ReferenceDataController : ControllerBase
{
    private readonly ReferenceDataContentWebApi _webApi;
    private readonly ReferenceDataOrchestrator _orchestrator;

    /// <summary>
    /// Initializes a new instance of the <see cref="ReferenceDataController"/> class.
    /// </summary>
    /// <param name="webApi">The <see cref="ReferenceDataContentWebApi"/>.</param>
    /// <param name="orchestrator">The <see cref="ReferenceDataOrchestrator"/>.</param>
    public ReferenceDataController(ReferenceDataContentWebApi webApi, ReferenceDataOrchestrator orchestrator)
        { _webApi = webApi.ThrowIfNull(); _orchestrator = orchestrator.ThrowIfNull(); }

    /// <summary> 
    /// Gets all of the 'Role' reference data items that match the specified criteria.
    /// </summary>
    /// <param name="codes">The reference data code list.</param>
    /// <param name="text">The reference data text (including wildcards).</param>
    /// <returns>The 'Role' array.</returns>
    [HttpGet("ref/roles", Name="ReferenceData_RoleGetAll")]
    [ProducesResponseType(typeof(IEnumerable<CommonRefDataNamespace.Role>), (int)HttpStatusCode.OK)]
    public Task<IActionResult> RoleGetAll([FromQuery] IEnumerable<string>? codes = default, string? text = default)
        => _webApi.GetAsync(Request, p => _orchestrator.GetWithFilterAsync<RefDataNamespace.Role>(codes, text, p.RequestOptions.IncludeInactive));

    /// <summary>
    /// Gets the reference data entries for the specified entities and codes from the query string; e.g: ref?entity=codeX,codeY&amp;entity2=codeZ&amp;entity3
    /// </summary>
    /// <returns>The 'ReferenceDataMultiDictionary'.</returns>
    [HttpGet("ref", Name="ReferenceData_GetNamed")]
    [ProducesResponseType(typeof(CoreEx.RefData.ReferenceDataMultiDictionary), (int)HttpStatusCode.OK)]
    public Task<IActionResult> GetNamed() => _webApi.GetAsync(Request, p => _orchestrator.GetNamedAsync(p.RequestOptions));
}