Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Models: Are ServerVariables really Extensible?

See original GitHub issue

org.eclipse.microprofile.openapi.models.servers.ServerVariables represents a map of org.eclipse.microprofile.openapi.models.servers.ServerVariable in org.eclipse.microprofile.openapi.models.servers.Server

See spec: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#server-variable-object

I do not think that the map <variable-name, instance> is extensible. I know Swagger-Core has implemented it, but Kaizen Model did not and I think this is correct.

Swagger-Core: ServerVariables.java L57-L78
KaiZen: Server.java is using Map<String, ServerVariable>, there is no ServerVariables interface.

Of course ServerVariable is extensible.

Issue Analytics

State:
Created 5 years ago
Comments:10 (10 by maintainers)

Top GitHub Comments

1reaction

arthurdmcommented, Aug 29, 2018

Thanks for digging the OAS history on this @jmini!

I guess the summary is that ServerVariables is a legacy artifact that was removed from the OAS spec during the RC process, but some tools have adopted it during their early implementation.

Since it no longer exists in the spec, I think we should deprecate ServerVariables in 1.1 and remove it in 2.0. So then it becomes less important on whether it’s extensible or not, if it goes away. =)

Each individual ServerVariable is still extensible, as per the spec.

0reactions

jminicommented, Jan 4, 2019

A Model Test for Server#setVariables(Map<String, ServerVariable> variables); should be added, because for the moment there are only tests for the method that is deprecated: (Server#setVariables(ServerVariables variables)😉

Top Results From Across the Web

ServerVariables (MicroProfile OpenAPI API 1.1.1 API)

Deprecated. Set the server variables map to this ServerVariables object. Methods inherited from interface org.eclipse.microprofile.openapi.models.Extensible.

A Low Level Look at ASP.NET Architecture - CODE Magazine

However, ASP.NET provides much more flexibility at a lower level. The HTTP runtime and the request pipeline provide all the same power that...

VB.Net - Web Programming - Tutorialspoint

Net applications are compiled codes written using the extensible and reusable ... This includes forms, cookies, server variables, and certificate data.

XML Classes Enable Personalized User Experiences on ASP.NET ...

In the original ASP model, the system for handling Web requests was not extensible. Every Web request was mapped to an ASP file...

OpenAPI Specification v3.0.3 | Introduction, Definitions, & More

Models are defined using the Schema Object, which is an extended subset of JSON ... This URL supports Server Variables and MAY be...