In addition to REST Clients is also generates HTML documentation and Atlassian Confluence markup. The Confluence markup is in the cwiki project and the different HTML documentations are in dynamic-html, html, and html2 projects. The html2 project is probably the nicest of the three as it also contains sample usage code with each endpoint that corresponds to the other Swagger clients (curl, Java, Android, Obj-C, Javascript, C#, PHP, Perl, and Python). The online Swagger Editor itself uses the live documentation Swagger UI project which you can also download and use with your Swagger YAML/JSON files.
What was somewhat disappointing about the Swagger CodeGen clients so far is that of the three clients that I tried (bash, csharp, and powershell) all of them require extra work to get running. They have various syntax errors out of the box that have to be fixed before they will compile. This was not unique to the RAD Server JSON definition either as I tried the Swagger CodeGen with other Swagger JSON files with similar results. Additionally, I’m not so sure how clean this generated code is as it seems to have a lot of boilerplate code for what are relatively simple endpoints. The cross platform FireMonkey client code (for Android, IOS, OSX, Windows, and Linux) generated by Auto Tables for RAD Server feels much easier to read and simpler to use. At the same time starting out with a pre-generated client in the programming language or framework you need really goes a long way towards making RAD Server accessible and eases the integration process.
Here is a list of the REST clients/projects I generated for RAD Server:
- ada
- akka-scala
- android
- apex
- bash
- clojure
- cpprest (generator errored out)
- csharp
- csharp-dotnet2
- cwiki
- dart
- dart-jaguar
- dynamic-html
- eiffel
- elixir
- elm
- erlang-client
- flash
- go
- groovy
- haskell-http-client
- html
- html2
- java
- javascript (generator errored out)
- javascript-closure-angular
- jaxrs-cxf-client
- jmeter
- kotlin
- lua
- objc
- perl
- php
- powershell
- python
- qt5cpp
- r
- ruby
- rust
- scala
- scala-gatling
- scalaz
- swift
- swift3
- swift4
- tizen
- typescript-angular
- typescript-angularjs
- typescript-aurelia
- typescript-fetch
- typescript-inversify
- typescript-jquery
- typescript-node
Head over and check out all 50+ clients in many languages for RAD Server over on GitHub.