Attributes & DI snippets

On API actions / controllers

1. Anonymous access (no token):

[AllowAnonymous]

2. HTTP verb & route:

[HttpPost("mdmzhdangerSubCount")]

3. Skip response wrapping (default stack may wrap results):

[NonUnify]

4. Disable audit logging for this endpoint:

[SuppressMonitor]

5. Display name (e.g. Swagger):

[DisplayName("Swagger login check")]

On parameters

[FromBody]

[FromQuery]

[Required]

Dependency injection

Current user:

UserManager _userManager;

Cache:

SysCacheService sysCacheService

HTTP context:

IHttpContextAccessor _httpContextAccessor

Example service:

/// <summary>
/// Login / auth service
/// </summary>
[ApiDescriptionSettings(Order = 500)]
public class SysAuthService : IDynamicApiController, ITransient
{
    
    private readonly UserManager _userManager;
    private readonly SqlSugarRepository<SysUser> _sysUserRep;
    private readonly IHttpContextAccessor _httpContextAccessor;
    private readonly SysMenuService _sysMenuService;
    private readonly SysOnlineUserService _sysOnlineUserService;
    private readonly SysConfigService _sysConfigService;
    private readonly ICaptcha _captcha;
    private readonly SysCacheService _sysCacheService;
    private MatchUser matchUser= new MatchUser();
    public SysAuthService(UserManager userManager,
        SqlSugarRepository<SysUser> sysUserRep,
        IHttpContextAccessor httpContextAccessor,
        SysMenuService sysMenuService,
        SysOnlineUserService sysOnlineUserService,
        SysConfigService sysConfigService,
        ICaptcha captcha,
        SysCacheService sysCacheService)
    {
        _userManager = userManager;
        _sysUserRep = sysUserRep;
        _httpContextAccessor = httpContextAccessor;
        _sysMenuService = sysMenuService;
        _sysOnlineUserService = sysOnlineUserService;
        _sysConfigService = sysConfigService;
        _captcha = captcha;
        _sysCacheService = sysCacheService;
    }

Helpers

User-friendly error:

throw Oops.Oh("The captcha is missing or expired. Request a new one.");

Log every SQL from a kit to the console:

kit.println();