Web API 2 documentation with Swagger and FluentValidation

Question

We are developing web api using web api 2 and fluent validation. Everything is working fine.

However, we realize the rules we define in fluent validation is not getting respect by the swagger (Swashbuckle).

For example

Class Customer {
    public string Name {get;set;}
}

If I define the name as required field in the fluent validator, the property is marked as optional in the api. I know we can make that work by using .net annotation attribute. But we don't want to separate the validation logic (some of the logic are not easy to do in .net annotation.

Any comment on that will be appreciated.

Similar question for asp.net core https://stackoverflow.com/questions/44638195/fluent-validation-with-swagger-in-asp-net-core — Michael Freidgeim, Apr 19 '18 at 21:28

score 4 · Answer 1 · edited Aug 09 '18 at 19:40

You can include your Fluent Validation rules to Swagger documentation by adding a custom SchemaFilter to your Swagger configuration.

Add the below code to the SwaggerConfig.cs file:

c.SchemaFilter<FluentValidationRules>();

And inherit ISchemaFilter using the code below:

public class FluentValidationRules : ISchemaFilter
{
    public void Apply(Schema schema, SchemaRegistry schemaRegistry, Type type)
    {
        var validator = new Customer(); //Your fluent validator class

        schema.required = new List<string>();

        var validatorDescriptor = validator.CreateDescriptor();

        foreach (var key in schema.properties.Keys)
        {
            foreach (var validatorType in validatorDescriptor.GetValidatorsForMember(key))
            {
                if (validatorType is NotEmptyValidator)
                {
                    schema.required.Add(key);
                }
            }
        }
    }
}

what about custom validators? I have a custom validator and want to get it inside of the loop as a CustomValidator. What is type for this customValidator? Please think about writing one SchemaFilter for all fluent validation class. — cimey, Jun 18 '19 at 11:52

score -1 · Answer 2 · answered Aug 16 '16 at 09:43

-1

Looking at information from SwashBluckle on Github, it doesn't seem that you can use Fluent Validation with it.

answered Aug 16 '16 at 09:43

Benjamin Soulier

2,223
1
18
30

Web API 2 documentation with Swagger and FluentValidation

2 Answers2