swagger-api / swagger-ui

Swagger UI is a collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.
https://swagger.io
Apache License 2.0
26.29k stars 8.91k forks source link

XML hints in the Model view show "OrderedMap" #3954

Open ponelat opened 6 years ago

ponelat commented 6 years ago
Q A
Bug or feature request? Bug
Which Swagger/OpenAPI version? 2.0/3.0.0 ( both )
Which Swagger-UI version? g23fd8a4d (aka 3.5.0)
How did you install Swagger-UI? petstore.swagger.io
Which browser & version? Chrome 60
Which operating system? Linux

Demonstration API definition

petstore.swagger.io ( using its default petstore 2.0 )

Expected Behavior

A UI indicating the XML behaviour that isn't a dump of the underlying immutablejs object. See screencap, look for OrderedMap

Current Behavior

image Note: xml: OrderedMap { "name": "photoUrl", "wrapped": true }string]

Possible Solution

A: xml: <photoUrl></photoUrl> string] B: xml: <photoUrl> (wrapped) string]

Context

I noticed the word "OrderedMap" and realized this is a dump of the underlying immutablejs object. Its a fragile solution, affected by changes to the underlying object as well as how future versions of ImmutableJs convert to a string. If not very performant.

shockey commented 6 years ago

Yep, this is us not serializing the Immutable data correctly.

I wrangled something similar in extension value display ahead of v3.5.0 last week, in this commit: https://github.com/swagger-api/swagger-ui/pull/3945/commits/b42e2a7045543429fcaddc782d6103dfbabd2080

mmamyan commented 5 years ago

i have the same issue,, is there any solution?

mmamyan commented 5 years ago

@shockey help is needed. Please, look at this issue as soon as possible. Thank you.

bbagno commented 5 years ago

There is a workaround for the bug: pass XML you need as a string, e.g. "<tag>Quotes should be \" escaped</tag>"

mmamyan commented 5 years ago

@bbagno In my application i see this in the models when i add XmlAttribue, XmlElement and XmlType annotations to the properties of the model...

mmamyan commented 5 years ago

@shockey Can you look at this issue again? :\

shockey commented 5 years ago

FYI: this is still in my work queue!

ahoehma commented 3 years ago

I'm using springdoc-openapi 1.4.1 and I have this xml-stuff in my swagger-ui too. Any hint to ignore such internal data? In my case its the same as @mmamyan wrote. It have something todo with the Xml***annotations, I generate my classes with jaxb from xsd ... example: image And then I have something like this: image

EduardSergeev commented 3 years ago

Same problem happens with example in JSON: image image

talatkuyuk commented 2 years ago

The same, I see example: OrderedMap { ... } too, in the schema templates. It is annoyed to see the OrderedMap.

ahoehma commented 2 years ago

Any update here? Or hints where to look more closely? If so I could try to fix this?

Maybe this here is related to https://github.com/swagger-api/swagger-core/issues/3153 ?

MrJuliuss commented 2 years ago

Hi, any update ?

MPiorunn commented 2 years ago

Hi, any updates or ideas how to hide this?

realjax commented 1 year ago

I have this problem too.. is this really still a thing after 4 years??

soma0506 commented 1 year ago

Hi, I am not sure whether this issue is fixed already , You can disabling skipOperationExample flag during openapi-generator to hide the "example: OrderedMap"

conlaoch1 commented 1 year ago

still a problem.

inkeytech commented 1 year ago

Can this still be the same issue 6 years later? I'm also seeing "orderedMap" in my examples.

C0DK commented 1 year ago

same

alexu-hbk commented 1 year ago

bump

realjax commented 1 year ago

Someone? we are approaching the '6 year old bug, still not fixed' anniversary day rapidly!!

Kile-Asmussen commented 7 months ago

I'm affected by this, six year old bug.

ahoehma commented 7 months ago

I don't have this problem anymore. I'm using this stack:

springboot: 3.2.2 springdoc-openapi-starter-webmvc-ui: 2.3.0 springdoc-openapi-starter-webflux-ui: 2.3.0 javax.xml.bind:jaxb-api: 2.3.1 jdk17

I still generate some of my api-objects with jaxb and so there are referenced in my openapi schema ... So from my side everything is fine meanwhile :D

cxx5208 commented 6 months ago

Hey Can you assign this to me? I will try to fix the issue Thank you

HavaElboim commented 2 days ago

Any update on this bug? I'm still seeing OrderedMap in an object example.