Here is the Swagger JIRA - https://issues.apache.org/jira/browse/ATLAS-328 By the way, per my last observation, the Atlas REST documentation is a bit dated. To keep it really upto date, generating a Swagger driven documentation which builds off the Java REST API definition will always keep it in sync. For now, to know the exact REST end point, I have only been consulting the Atlas code (java REST resources like TypesResource.java, EntityResource.java, MetadataDiscoveryResource.java, HiveLineageResource.java etc.,)
To see what all clients Swagger can generate, go to http://editor.swagger.io/#/ and click on the menu "Generate Client" on the very top. It shows you 30 odd languages in which a client can be generated, and Java/Scala/Python/Javascript are few among them. Thanks Venkat From: Jean-Baptiste Onofré <[email protected]> To: [email protected] Date: 31/03/16 08:39 PM Subject: Re: [PROPOSAL] Java/Scala API on top of the REST API ? Hi Venkata, tanks, I missed this when taking a look on the code. I will test the integration then, and I will work on the Swagger integration. I don't find a Jira about that, should I create one ? Thanks ! Regards JB On 03/31/2016 04:59 PM, Venkata R Madugundu wrote: > There is an AtlasClient.java which wraps around the REST API if you want > to take a look at. > \client\src\main\java\org\apache\atlas\AtlasClient.java > > Also take a look at > \webapp\src\main\java\org\apache\atlas\examples\QuickStart.java to see > how AtlasClient can be used. > > There is a JIRA open for Swagger integration so that one can generate > typed API bindings to interact with Atlas REST API. > As Atlas REST is JAX RS compliant, one can actually make Swagger > generate bindings for different languages (atleast we did > it for Javascript and Python) > > For java based REST calls, we have used google gson for JSON > serialization/deserialization and Apache HttpClient to dispatch REST > requests. > > > Inactive hide details for Jean-Baptiste Onofré ---31/03/2016 07:44:31 > PM---Hi guys, I like the Atlas REST API, and the way it'sJean-Baptiste > Onofré ---31/03/2016 07:44:31 PM---Hi guys, I like the Atlas REST API, > and the way it's documented. > > From: Jean-Baptiste Onofré <[email protected]> > To: [email protected] > Date: 31/03/16 07:44 PM > Subject: [PROPOSAL] Java/Scala API on top of the REST API ? > > ------------------------------------------------------------------------ > > > > Hi guys, > > I like the Atlas REST API, and the way it's documented. > > In some case, to simplify the integration of Atlas in third party > applications, maybe it would be great to provide a Java and Scala APIs > on top of the REST API (wrapping the transport, and adding some > "control" and DataObject/JSON). > For instance, I'm PoCing some shell & Karaf commands to manipulate Atlas > (as we did in Falcon for instance). In that case, even if REST API is > convenient, it's not as straight forward as a turnkey API. > For instance, it's what we did in Syncope: we provide syncope-client on > top of the Syncope REST API. > > Thoughts ? > > Regards > JB > -- > Jean-Baptiste Onofré > [email protected] > http://blog.nanthrax.net > Talend - http://www.talend.com > > > -- Jean-Baptiste Onofré [email protected] http://blog.nanthrax.net Talend - http://www.talend.com
