Jim
It will be the next feature to focus on.
Practically, I need to sort out how to best represent this option in the (EMF) model, since things are getting quite complicated for
the user to grasp. (Too many options to find and choose from.)
I will prepare some ideas, and bounce it for feedback.
regards
______________________________
Jad El-khoury,
PhD
KTH Royal Institute of Technology
School of Industrial Engineering and Management, Mechatronics Division
Brinellvägen 83, SE-100 44 Stockholm, Sweden
Phone: +46(0)8 790 6877 Mobile: +46(0)70 773 93 45
jad@xxxxxx,
www.kth.se
From: lyo-dev-bounces@xxxxxxxxxxx [mailto:lyo-dev-bounces@xxxxxxxxxxx]
On Behalf Of Jim Amsden
Sent: 02 May 2018 15:00
To: Lyo project developer discussions <lyo-dev@xxxxxxxxxxx>
Subject: Re: [lyo-dev] Swagger/OpenAPI support for OSLC4J projects
Jad,
This is incredibly valuable to move OSLC into the latest API management tools. And its so easy.
When will we have the option in Lyo Designer?
Jim Amsden, Senior Technical Staff Member
OSLC and Linked Lifecycle Data
919-525-6575
From: Jad El-Khoury <jad@xxxxxx>
To: Lyo project developer discussions <lyo-dev@xxxxxxxxxxx>
Date: 05/02/2018 06:44 AM
Subject: [lyo-dev] Swagger/OpenAPI support for OSLC4J projects
Sent by: lyo-dev-bounces@xxxxxxxxxxx
Hi
I have put together some instructions on how to document an OSLC server using Swagger/OpenAPI. This assumes you are using the Lyo SDK.
https://wiki.eclipse.org/Lyo/creating_OSLC4J_project#OpenApi.2FSwagger_Support_.28Optional.29
Since OSLC servers are already RESTful, a basic setup is quite easy (minor changes to pom.xml, web.xml. Plus a single @Api annotation for each OSLC Service).
Anyone that has been using Swagger with OSLC?
I would like to discuss if/how we can leverage more of the Swagger functionality such as the generation of Clients & Servers from a larger number of languages.
Swagger provides a very good overview of the OSLC services. It also provides an interactive console that allows one to test the services from a web browser.
But, one challenge I see is the fact that Swagger does not recognise OSLC’s Shapes. Instead, it introspects the java classes to produce json structures.
How useful would a generation of client/server code be in the end?
For those using Lyo Designer (https://wiki.eclipse.org/Lyo/Lyo_Designer)
to model and generate OSLC4J code, the next step will naturally be to provide a checkbox to allow you to enable/disable Swagger documentation.
This way, you can go from a graphical model all the way to Swagger’s interactive UI.
Finally, if you want to see Swagger+OSLC in action, have a look at the sample RM server under the swagger branch on
https://github.com/OSLC/lyo-adaptor-sample-modelling/tree/swagger/adaptor-rm-webapp
Regards
______________________________
Jad El-khoury, PhD
KTH Royal Institute of Technology
School of Industrial Engineering and Management, Mechatronics Division
Brinellvägen 83, SE-100 44 Stockholm, Sweden
Phone: +46(0)8 790 6877 Mobile: +46(0)70 773 93 45
jad@xxxxxx,
www.kth.se
_______________________________________________
lyo-dev mailing list
lyo-dev@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://urldefense.proofpoint.com/v2/url?u=https-3A__dev.eclipse.org_mailman_listinfo_lyo-2Ddev&d=DwICAg&c=jf_iaSHvJObTbx-siA1ZOg&r=xgy4nj5m_kJTOHN7s4QIytEQ1JlaarieVwljmSSD6d0&m=pUNl_sJEH8CVFJxATIqN9_Jti4OxT_gqHITjS-IKJ4I&s=s7vg9MUFmYZ8pkyuHCM-RLcqYNUyr6vu45JB845k92Q&e=