Add support for Apex API client (#5669)

* Salesforce Apex support

* typo in function name

* comments for clarification

* DoubleProperty and FloatProperty are both DecimalProperty

* test models with default and provided example property values

* adding some more default example values

Author: wing328

modules/swagger-codegen/src/main/java/io/swagger/codegen/languages/ApexClientCodegen.java

@@ -1,4 +1,5 @@
 io.swagger.codegen.languages.AndroidClientCodegen
+io.swagger.codegen.languages.ApexClientCodegen
 io.swagger.codegen.languages.AspNet5ServerCodegen
 io.swagger.codegen.languages.AspNetCoreServerCodegen
 io.swagger.codegen.languages.AsyncScalaClientCodegen

modules/swagger-codegen/src/main/resources/META-INF/services/io.swagger.codegen.CodegenConfig

@@ -0,0 +1,182 @@
+# {{appName}} API Client
+{{#appDescription}}
+
+{{{appDescription}}}
+{{/appDescription}}
+
+## Requirements
+
+- [Java 8 JDK](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
+- [Apache Ant](http://ant.apache.org/) version 1.6 or later
+- [Force.com Migration Tool](https://developer.salesforce.com/docs/atlas.en-us.daas.meta/daas/forcemigrationtool_install.htm)
+  - The `ant-salesforce.jar` file included with the Force.com Migration Tool must be placed in the root directory of this project (in the same directory as this README and `build.xml`)
+- `ANT_HOME` and `JAVA_HOME` environment variables must be set accordingly
+  - On Windows, `JAVA_HOME` will probably look something like this:
+
+    ```
+    JAVA_HOME = C:\Program Files\Java\jdk1.8.0_121
+    ```
+
+- The `bin` directory from Ant must be on your `PATH`
+
+If everything is set correctly:
+
+- Running `java -version` in a command prompt should output something like:
+
+  ```bash
+  java version "1.8.0_121"
+  Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
+  Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)
+  ```
+
+- Running `ant -version` should output something like:
+
+  ```bash
+  Apache Ant(TM) version 1.10.1 compiled on February 2 2017
+  ```
+
+For more information, see <https://developer.salesforce.com/docs/atlas.en-us.daas.meta/daas/forcemigrationtool_prereq.htm>
+
+## Installation
+{{#gitRepoId}}{{#gitUserId}}
+
+1. Clone the repo from GitHub
+
+    ```bash
+    $ git clone [email protected]:{{gitUserId}}/{{gitRepoId}}.git
+    ```
+
+    Or, [download](https://github.com/{{gitUserId}}/{{gitRepoId}}/archive/master.zip) the repo as a ZIP and extract it to `{{gitRepoId}}`
+{{/gitUserId}}{{/gitRepoId}}
+1. Set the `SF_USERNAME` and `SF_PASSWORD` environment variables to your Salesforce username and password. Alternatively, they may be set in `build.properties`. Environment variables will override the values in `build.properties` if set.
+
+    `SF_SESSIONID` may also be set instead of `SF_USERNAME` and `SF_PASSWORD` (more info in `build.properties`)
+
+2. Open up a command prompt in the root project directory {{#gitRepoId}}`{{gitRepoId}}` {{/gitRepoId}}(the same directory as this README and `build.xml`)
+3. Deploy to your Salesforce org
+
+    ```bash
+    $ ant deploy
+    ```
+
+    This command will:
+
+    - deploy all classes in the `deploy/classes` directory to your Salesforce org
+    - create a new [unmanaged package](https://help.salesforce.com/articleView?id=sharing_apps.htm) called **{{appName}} API Client**
+    - execute all of the unit tests included in this package (at least 75% code coverage required)
+    - create a new [remote site](https://help.salesforce.com/articleView?id=configuring_remoteproxy.htm) called **{{sanitizedName}}** configured for the endpoint: <{{basePath}}>
+    - rolls back any changes upon any error
+
+    A successful deployment will look like this:
+
+    ```bash
+    [sf:deploy] Request Status: Succeeded
+    [sf:deploy] *********** DEPLOYMENT SUCCEEDED ***********
+    [sf:deploy] Finished request 0Af7A00000Ebd5oSAB successfully.
+
+    BUILD SUCCESSFUL
+    Total time: 34 seconds
+    ```
+
+### Test deployment only
+
+To perform a test deployment without committing changes:
+
+```bash
+$ ant deployCheckOnly
+```
+
+All of the included tests will run as if it were a real deployment. Tests and other validations will report back while leaving your org untouched, allowing you to verify that a deployment will succeed without affecting anything in the org.
+
+### Uninstallation
+
+```bash
+$ ant undeploy
+```
+
+Removes all classes and the Remote Site created by this package.
+
+## Getting Started
+
+Please follow the [installation](#installation) instruction and execute the following Apex code:
+
+```java{{#apiInfo}}{{#apis}}{{#-first}}{{#operations}}{{#operation}}{{#-first}}
+{{classname}} api = new {{classname}}();
+{{#hasAuthMethods}}
+{{classPrefix}}Client client = api.getClient();
+{{#authMethods}}{{#isBasic}}
+// Configure HTTP basic authorization: {{{name}}}
+HttpBasicAuth {{{name}}} = (HttpBasicAuth) client.getAuthentication('{{{name}}}');
+{{{name}}}.setUsername('YOUR USERNAME');
+{{{name}}}.setPassword('YOUR PASSWORD');
+
+// You can also set your username and password in one line
+{{{name}}}.setCredentials('YOUR USERNAME', 'YOUR PASSWORD');{{/isBasic}}{{#isApiKey}}
+// Configure API key authorization: {{{name}}}
+ApiKeyAuth {{{name}}} = (ApiKeyAuth) client.getAuthentication('{{{name}}}');
+{{{name}}}.setApiKey('YOUR API KEY');{{/isApiKey}}{{#isOAuth}}
+// Configure OAuth2 access token for authorization: {{{name}}}
+Swagger.OAuth {{{name}}} = (Swagger.OAuth) client.getAuthentication('{{{name}}}');
+{{{name}}}.setAccessToken('YOUR ACCESS TOKEN');{{/isOAuth}}
+{{/authMethods}}
+{{/hasAuthMethods}}
+{{#hasParams}}
+
+Map<String, Object> params = new Map<String, Object>{
+  {{#allParams}}
+    '{{{paramName}}}' => {{{example}}}{{#hasMore}},{{/hasMore}}
+  {{/allParams}}
+};
+{{/hasParams}}
+
+try {
+    // cross your fingers
+    {{#returnType}}{{{returnType}}} result = {{/returnType}}api.{{{operationId}}}({{#hasParams}}params{{/hasParams}});
+  {{#returnType}}
+    System.debug(result);
+  {{/returnType}}
+} catch (Swagger.ApiException e) {
+    // ...handle your exceptions
+}{{/-first}}{{/operation}}{{/operations}}{{/-first}}{{/apis}}{{/apiInfo}}
+```
+
+## Documentation for API Endpoints
+
+All URIs are relative to *{{basePath}}*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{summary}}{{/summary}}
+{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
+
+## Documentation for Models
+
+{{#models}}{{#model}} - [{{classname}}]({{modelDocPath}}{{classname}}.md)
+{{/model}}{{/models}}
+
+## Documentation for Authorization
+
+{{^authMethods}}All endpoints do not require authorization.
+{{/authMethods}}Authentication schemes defined for the API:
+{{#authMethods}}### {{name}}
+
+{{#isApiKey}}- **Type**: API key
+- **API key parameter name**: {{keyParamName}}
+- **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}
+{{/isApiKey}}
+{{#isBasic}}- **Type**: HTTP basic authentication
+{{/isBasic}}
+{{#isOAuth}}- **Type**: OAuth
+- **Flow**: {{flow}}
+- **Authorizatoin URL**: {{authorizationUrl}}
+- **Scopes**: {{^scopes}}N/A{{/scopes}}
+{{#scopes}}  - {{scope}}: {{description}}
+{{/scopes}}
+{{/isOAuth}}
+
+{{/authMethods}}
+
+## Author
+
+{{#apiInfo}}{{#apis}}{{^hasMore}}{{infoEmail}}
+{{/hasMore}}{{/apis}}{{/apiInfo}}