"originalRef" duplicates "$ref"

Hey guys, I’m using swagger 1.5.21 for documentation of a Java Rest API using annotations.

I am using io.swagger.jaxrs.Reader and a JsonSerializer to output the documentation in .json format for further processing.

I discovered that the .json output contains both $ref and originalRef. This is an issue for me when further working with this file, and when passing my file to https://editor.swagger.io/, it also complains about “siblings are not allowed beside $ref”.

So, should the getOriginalRef() method in io.swagger.models.RefModel have the @JsonIgnore annotation?

Would be grateful for any insights! 😃

Thanks!

Yve

[frantuma]

1.5.21 and previous versions use Jackson mixin in some cases (for backward compatibility or other reasons) to provide some Jackson annotations and behavior; this is true also for $ref (introduced in #2849, please check PR comment). swagger-core provides JSON and YAML helpers to obtain a correctly configured object mapper (e.g. JSON.mapper()) which also registers such Mixins. If for any reason you need to use an own mapper, you can register such mixins in your code, using ReferenceSerializationConfigurer.serializeAsComputedRef(mapper);

[dcassiani]

Hi… does anyone know since which version was this fix released into stable production?