Introducing Swagger to MSF4J support

75 views
Skip to first unread message

Sanjeewa Malalgoda

unread,
Oct 24, 2016, 3:49:59 AM10/24/16
to Swagger
Hi All,
Recently i was working on project and it required to generate Java micro service skeleton(for MSF4J Framework[1]) from swagger definition.
So i used existing jax-rs implementation and modified it to generate MSF4J code. I have tried this with different swagger definitions include pet store samples. After testing this feature i sent pull request to swagger code generator master branch. Please include this change to swagger code generator if you think this helps to other users in the swagger community. WSO2 MSF4J is one of the highest performing lightweight Java microservices frameworks and I'm sure swagger community will love this.

Also i generated documents for https://github.com/swagger-api/swagger-codegen.wiki.git page and it seems we cannot create pull requests for that document. Please let me know where should i send this updated document. I'm planning to add following text to wiki document.

Java Micro Services Framework For Java

MSF4J generator uses java-msf4j as the default library

java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \
  -i http://petstore.swagger.io/v2/swagger.json \
  -l msf4j \
  -o samples/server/petstore/msf4j

Before you build/run service replace .deploy(new PetApi()) with your actual service class name in Application.java file like .deploy(new ApisAPI()) then it will start that service. If you have multiple service classes add them in , separated manner.

        new MicroservicesRunner()
                .deploy(new PetApi())
                .start();
    }

To Use-it : in the generated folder try mvn package for build jar.
Start your server java -jar target/micro-service-server-1.0.0.jar
Java Microservice listening on default port 8080

Run the following command or simply go to http://127.0.0.1:8080/pet/12 from your browser.

curl http://127.0.0.1:8080/pet/12


[1]https://github.com/wso2/msf4j
[2]https://github.com/swagger-api/swagger-codegen/pull/4056

Thanks,
sanjeewa.
Thanks,
sanjeewa.
Reply all
Reply to author
Forward
0 new messages