REST Controller method configuration

Introduction

This page contains brief information about how to configure presence a set of a default methods in a custom Controller.

Configuration

There are 3 types of Base Controllers:

• ReadOnly controller
• Full CRUD
• BULK CRUD

Every application controller derives from one of these base controllers. To switch one or more methods use AllowedOperation attribute, consider we are having CRUD ProfileController that must have only a Read, Create and Update operations, example below shows how to configure you controller:

    [AllowedOperation(ControllerOperation.Read | ControllerOperation.ReadOne | 
                      ControllerOperation.Create  | ControllerOperation.Update)]
    public sealed class ProfileController : BasicCrudController<ProfileDto, ProfileEntity, int, EmptyAdditionalFilters>
    {
        public ProfileController(ProfileManager manager)
        {
            Manager = manager;
        }
    }

To make this feature work a AllowedOperationsConvention MUST be passed to the AddControllers exyension method in you Startup:

services.AddControllers(options =>
{
    options.Conventions.Add(new AllowedOperationsConvention());
});

Calling endpoint that were not included by the attribute result with `MethodNotAllowed` status code

This configuration also affect OpenAPI Exploration, see: