Extensions via Annotations

Annotations for models that are Extensible do not provide a way to list the extensions. Opening this issue for discussion in case this was not by design (I didn’t see any issues about it).

I would expect to see something like Extension[] extensions() default {} in each of the annotations where the equivalent model is Extensible.

[MikeEdgar]

@ambition-consulting - as you have found, what you want to do can’t be done (yet) via annotations. Your best bet with the current version of MP is to utilize the model to programmatically add the extensions.

public class ExtensionFilter implements OASFilter {
    @Override
    public void filterOpenAPI(OpenAPI model) {
        model.getInfo().addExtension("x-logo", "https://example.com/your-logo.png");
    }
}

This particular issue is to track the change for future releases of the specification to support using annotations for this same functionality. The use of $ref for arbitrary elements is also not supported, e.g. for info:description.

[MikeEdgar]

If done for 3.1, the current functionality of allowing @Extension on fields, methods, params, and types needs to be kept and deprecated.