Bridging multiple API description languages with Restlet
12
BRIDGING MULTIPLE API DESCRIPTION FORMATS WITH RESTLET FRAMEWORK Leading Web API Framework for Java http://restlet.com May 20, 2014 Jérôme LOUVEL [email protected]
description
Presentation for API Strategy & Practice workshop at Gluecon 2014 in Boulder, Colorado. 1) Code your web API in Java language 2) Document your web API in Java language 3) Don't get locked in 4) Demo of Restlet Framework + APISpark 5) Restlet Platform, what we are working on! 6) Restlet Framework, web API framework for Java 7) Keep in touch
Transcript of Bridging multiple API description languages with Restlet
BRIDGING MULTIPLE API DESCRIPTION FORMATSWITH RESTLET FRAMEWORK
Leading Web API Framework for Java
http://restlet.com
May 20, 2014
Jérôme [email protected]
CODE YOUR WEB APIIN JAVA LANGUAGE
JAX-RS API
Restlet API
Spring RESTSwagger
annotations
Bean Validationannotations
Google Cloud Endpoints API
1. Select
a main
Java API
Javasourcecode
3. Write your
Java code
JAXBannotations
2. Add extra
annotation
APIs
Jackson annotations
RESTfulWeb API
4. Get your
web API
DOCUMENT YOUR WEB APIIN JAVA LANGUAGE
RESTfulWeb API
Web API definition
1. Code your
web API
(iterate)
3. Introspect
source code
2. Select
target API
specs
4. Complete
API definition
manually
Swagger
APIBlueprint
RAML
Google APIDiscovery
WADL
Intro-spector
DON’T GET LOCKED-INAPI DEFINITION PORTABILITY & COPYRIGHT
– No clear winner at this stage
translate your API definition between various languages
use the best of each language ecosystem (tooling, directory)
– Take API copyright seriously (now)
play nice in the API economy: open your API definition– select a Creative Commons or Open Source license
– publish to the « API Commons »
verify the legal terms of the APIs you depend on
LAUNCH INTROSPECTOR TOOLSUPPORTS RESTLET API, NEW JAVA APIS COMING
1) Launch fromyour IDE or the command line
2) Web API definition pushed
to APISpark
DISPLAY YOUR WEB API DOCRELAUNCH INTROSPECTOR TO KEEP IN SYNC
CHECK OUT API COMMONS TABWEB API MANIFEST BASED ON SWAGGER
CHECK OUT THE HOSTED SWAGGER UIEMBEDDED IN YOUR WEB SITE
RESTLET PLATFORMWHAT WE ARE WORKING ON !
Restlet Framework (open source)– introspect all main Java APIs
– import & export main API languages
– generate Client SDKs, Server skeletons & HTML
APISpark (full stack PaaS)– complete integration of Swagger tool chain
– embed additional tool chains
– GitHub synchronization
WEB API FRAMEWORK
FOR JAVA DEVELOPERS
6 editions44 extensions
1,5 M downloads100 000 developers
Version 2.2.0 launched in March 2014
Covers our ROA/DAPI guidelines
Consistent client & server APIPowerful routing & filtering
Comprehensive web securityAligned with REST & HTTP
Fast & scalable
KEEP IN TOUCH!
http://restlet.com
Twitter: @jlouvel
Restlet Platform
PaaS and Web API integrationInterview with Daniel Jacobson (Netflix)
![[lirmm-00862477, v1] Bridging the Gap between Component ...dony/postscript/comp-reflect13.pdf · framework including languages that all support CBSE, then offering a conceptual continuum](https://static.fdocuments.in/doc/165x107/5f2af3eee9bf3f6ef673c9f1/lirmm-00862477-v1-bridging-the-gap-between-component-donypostscriptcomp-.jpg)
