kicksolutions / swagger2puml Goto Github PK
View Code? Open in Web Editor NEWGenerate Class Diagrams (UML) for Given Swagger Definition
License: Apache License 2.0
Generate Class Diagrams (UML) for Given Swagger Definition
License: Apache License 2.0
Does uml gen support inheritance definition? I have got NPE when I tried to use json with inheritance definition.
INFO: Processing Model UICLParametrizationBonus
Mar 07, 2018 10:57:49 PM com.kicksolutions.swagger.plantuml.PlantUMLGenerator transformSwagger2Puml
SEVERE: null
java.lang.NullPointerException
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.getClassMembers(PlantUMLCodegen.java:745)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.getClassMembers(PlantUMLCodegen.java:693)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.processSwaggerModels(PlantUMLCodegen.java:577)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.preprocessSwagger(PlantUMLCodegen.java:120)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.generatePuml(PlantUMLCodegen.java:83)
at com.kicksolutions.swagger.plantuml.PlantUMLGenerator.transformSwagger2Puml(PlantUMLGenerator.java:43)
at com.kicksolutions.swagger.Swagger2PlantUML.process(Swagger2PlantUML.java:73)
at com.kicksolutions.swagger.Swagger2PlantUML.init(Swagger2PlantUML.java:57)
at com.kicksolutions.swagger.Swagger2PlantUML.main(Swagger2PlantUML.java:39)
Exception in thread "main" java.lang.RuntimeException: java.lang.NullPointerException
at com.kicksolutions.swagger.plantuml.PlantUMLGenerator.transformSwagger2Puml(PlantUMLGenerator.java:53)
at com.kicksolutions.swagger.Swagger2PlantUML.process(Swagger2PlantUML.java:73)
at com.kicksolutions.swagger.Swagger2PlantUML.init(Swagger2PlantUML.java:57)
at com.kicksolutions.swagger.Swagger2PlantUML.main(Swagger2PlantUML.java:39)
Caused by: java.lang.NullPointerException
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.getClassMembers(PlantUMLCodegen.java:745)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.getClassMembers(PlantUMLCodegen.java:693)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.processSwaggerModels(PlantUMLCodegen.java:577)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.preprocessSwagger(PlantUMLCodegen.java:120)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.generatePuml(PlantUMLCodegen.java:83)
at com.kicksolutions.swagger.plantuml.PlantUMLGenerator.transformSwagger2Puml(PlantUMLGenerator.java:43)
... 3 more
1 Michal-MacBook-Pro:target kolisko$
here is the definition file:
Hello,
I tried using your tool, but found the documentation to be a bit unclear on how to do so. Here's what I did:
mvn clean install
But I can't find the swagger2puml.jar that is mentioned in the docs.
What am I missing ?
Thanks a lot for your help :)
All the best;
A Dockerfile would allow running the application without the need to install Java locally on e.g. a Mac computer for one diagram.
Create swagger2puml core module
Howdy! I found this thing Goolging and it looks awesome. I want to put it on openapi.tools but wanted to point out: the specification has not been called Swagger for a long time.
The name of the specification is OpenAPI, and tools should probably use that in their name instead of Swagger, as that's just the name of the official set of tools (Swagger Codegen, Swagger UI, Swagger Editor).
Maybe rename to openapi2puml, and make the description "Generate Class Diagrams (UML) for Given OpenAPI (f.k.a Swagger) Definition" so it still shows up on Google for both searches.
When processing a yaml with definitions that include multiple levels of inheritance an NPE is thrown.
Example model:
`
GrandParentObj:
discriminator: objType
required:
- objType
properties:
prop1:
type: string
objType:
type: string
ParentObj:
allOf:
- $ref: '#/definitions/GrandParentObj'
- type: object
properties:
prop2:
type: string
ChildObj1:
allOf:
- $ref: '#/definitions/ParentObj'
- type: object
properties:
prop3:
type: string`
NPE Stacktrace:
`
Caused by: java.lang.NullPointerException
at java.util.HashMap.putMapEntries (HashMap.java:501)
at java.util.HashMap.putAll (HashMap.java:785)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.getClassMembers (PlantUMLCodegen.java:745)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.getClassMembers (PlantUMLCodegen.java:693)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.processSwaggerModels (PlantUMLCodegen.java:577)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.preprocessSwagger (PlantUMLCodegen.java:120)
at com.kicksolutions.swagger.plantuml.PlantUMLCodegen.generatePuml (PlantUMLCodegen.java:83)
at com.kicksolutions.swagger.plantuml.PlantUMLGenerator.transformSwagger2Puml (PlantUMLGenerator.java:43)
at com.kicksolutions.swagger.Swagger2PlantUML.process (Swagger2PlantUML.java:71)
at com.kicksolutions.swagger.Swagger2PlantUML.init (Swagger2PlantUML.java:55)
at com.kicksolutions.swagger.Swagger2PlantUML.main (Swagger2PlantUML.java:37)`
It looks like when the getClassMembers(ComposedModel) method loops over the "AllOf" list of the target model to resolve the parent model's properties, that if the parent is itself the child of another type that it's getProperties() method returns null, causing the NPE when we try to put them into the child's Map of properties.
I'm attaching a patch with a proposed fix.
There is a secondary issue, also addressed in the patch, which is that even with the NPE fixed the code wasn't correctly resolving the full list of properties from the descendant types.
In the example above, the UML generated for "ChildObj1" looked like:
`
class ChildObj1 {
- prop3 :String
}`
With the patch applied we recurse to get properties from the descendants, and the output includes prop1 & prop2 from the parent & grandparent types:
`
class ChildObj1 {
- prop3 :String
- prop2:String
- prop1:String
}`
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.