loafle/openapi-generator
3
0
Fork 0
forked from loafle/openapi-generator-original
Code Pull Requests Activity

[Apex] migrating to OpenAPI Generator project (#692)

Browse Source 
* [apex] migrating to OpenAPITools

* migrate apex to openapi-generator
This commit is contained in:
William Cheng 2018-07-31 15:28:54 +08:00 committed by GitHub
parent 824654964b
commit d8ec6b2003
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
49 changed files with 1005 additions and 589 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

698
modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/AbstractApexCodegen.java Normal file
View File

@ -0,0 +1,698 @@
/*
* Copyright 2018 OpenAPI-Generator Contributors (https://openapi-generator.tech)
* Copyright 2018 SmartBear Software
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.openapitools.codegen.languages;
import java.util.*;
import org.apache.commons.lang3.StringUtils;
import com.google.common.base.Strings;
import org.openapitools.codegen.CodegenOperation;
import org.openapitools.codegen.CodegenParameter;
import org.openapitools.codegen.CodegenModel;
import org.openapitools.codegen.CodegenConfig;
import org.openapitools.codegen.CodegenProperty;
import org.openapitools.codegen.CodegenType;
import org.openapitools.codegen.DefaultCodegen;
import org.openapitools.codegen.utils.ModelUtils;
import io.swagger.v3.oas.models.media.*;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.Operation;
import io.swagger.v3.oas.models.responses.ApiResponse;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public abstract class AbstractApexCodegen extends DefaultCodegen implements CodegenConfig {
private static final Logger LOGGER = LoggerFactory.getLogger(AbstractApexCodegen.class);
protected Boolean serializableModel = false;
public AbstractApexCodegen() {
super();
}
@Override
public CodegenType getTag() {
return CodegenType.CLIENT;
}
@Override
public String getName() {
return "apex";
}
@Override
public String getHelp() {
return "Generates an Apex API client library.";
}
@Override
public void processOpts() {
super.processOpts();
}
@Override
public String escapeReservedWord(String name) {
if (this.reservedWordsMappings().containsKey(name)) {
return this.reservedWordsMappings().get(name);
}
return "_" + name;
}
@Override
public String sanitizeName(String name) {
name = super.sanitizeName(name);
if (name.contains("__")) { // Preventing namespacing
name.replaceAll("__", "_");
}
if (name.matches("^\\d.*")) { // Prevent named credentials with leading number
name.replaceAll("^\\d.*", "");
}
return name;
}
@Override
public String toVarName(String name) {
// sanitize name
name = sanitizeName(name); // FIXME: a parameter should not be assigned. Also declare the methods parameters as 'final'.
if (name.toLowerCase().matches("^_*class$")) {
return "propertyClass";
}
if ("_".equals(name)) {
name = "_u";
}
// if it's all uppper case, do nothing
if (name.matches("^[A-Z_]*$")) {
if (isReservedWord(name)) {
name = escapeReservedWord(name);
}
return name;
}
if (startsWithTwoUppercaseLetters(name)) {
name = name.substring(0, 2).toLowerCase() + name.substring(2);
}
// camelize (lower first character) the variable name
// pet_id => petId
name = camelize(name, true);
// for reserved word or word starting with number, append _
if (isReservedWord(name) || name.matches("^\\d.*")) {
name = escapeReservedWord(name);
}
return name;
}
private boolean startsWithTwoUppercaseLetters(String name) {
boolean startsWithTwoUppercaseLetters = false;
if (name.length() > 1) {
startsWithTwoUppercaseLetters = name.substring(0, 2).equals(name.substring(0, 2).toUpperCase());
}
return startsWithTwoUppercaseLetters;
}
@Override
public String toParamName(String name) {
// to avoid conflicts with 'callback' parameter for async call
if ("callback".equals(name)) {
return "paramCallback";
}
// should be the same as variable name
return toVarName(name);
}
@Override
public String toModelName(final String name) {
final String sanitizedName = sanitizeName(name);
String nameWithPrefixSuffix = sanitizedName;
if (!StringUtils.isEmpty(modelNamePrefix)) {
// add '_' so that model name can be camelized correctly
nameWithPrefixSuffix = modelNamePrefix + "_" + nameWithPrefixSuffix;
}
if (!StringUtils.isEmpty(modelNameSuffix)) {
// add '_' so that model name can be camelized correctly
nameWithPrefixSuffix = nameWithPrefixSuffix + "_" + modelNameSuffix;
}
// camelize the model name
// phone_number => PhoneNumber
final String camelizedName = camelize(nameWithPrefixSuffix);
// model name cannot use reserved keyword, e.g. return
if (isReservedWord(camelizedName)) {
final String modelName = "Model" + camelizedName;
LOGGER.warn(camelizedName + " (reserved word) cannot be used as model name. Renamed to " + modelName);
return modelName;
}
// model name starts with number
if (camelizedName.matches("^\\d.*")) {
final String modelName = "Model" + camelizedName; // e.g. 200Response => Model200Response (after camelize)
LOGGER.warn(name + " (model name starts with number) cannot be used as model name. Renamed to " + modelName);
return modelName;
}
return camelizedName;
}
@Override
public String toModelFilename(String name) {
// should be the same as the model name
return toModelName(name);
}
@Override
public String getTypeDeclaration(Schema p) {
if (ModelUtils.isArraySchema(p)) {
ArraySchema ap = (ArraySchema) p;
Schema inner = ap.getItems();
if (inner == null) {
LOGGER.warn(ap.getName() + "(array property) does not have a proper inner type defined");
// TODO maybe better defaulting to StringProperty than returning null
return null;
}
return getSchemaType(p) + "<" + getTypeDeclaration(inner) + ">";
} else if (ModelUtils.isMapSchema(p)) {
Schema inner = (Schema) p.getAdditionalProperties();
if (inner == null) {
LOGGER.warn(p.getName() + "(map property) does not have a proper inner type defined");
// TODO maybe better defaulting to StringProperty than returning null
return null;
}
return getSchemaType(p) + "<String, " + getTypeDeclaration(inner) + ">";
}
return super.getTypeDeclaration(p);
}
@Override
public String getAlias(String name) {
if (typeAliases != null && typeAliases.containsKey(name)) {
return typeAliases.get(name);
}
return name;
}
@Override
public String toDefaultValue(Schema p) {
if (ModelUtils.isArraySchema(p)) {
final ArraySchema ap = (ArraySchema) p;
final String pattern = "new ArrayList<%s>()";
if (ap.getItems() == null) {
return null;
}
return String.format(pattern, getTypeDeclaration(ap.getItems()));
} else if (ModelUtils.isMapSchema(p)) {
final MapSchema ap = (MapSchema) p;
final String pattern = "new HashMap<%s>()";
if (ap.getAdditionalProperties() == null) {
return null;
}
return String.format(pattern, String.format("String, %s", getTypeDeclaration((Schema) ap.getAdditionalProperties())));
} else if (ModelUtils.isLongSchema(p)) {
if (p.getDefault() != null) {
return p.getDefault().toString() + "l";
}
return "null";
} else if (ModelUtils.isIntegerSchema(p)) {
if (p.getDefault() != null) {
return p.getDefault().toString();
}
return "null";
} else if (ModelUtils.isFloatSchema(p)) {
if (p.getDefault() != null) {
return p.getDefault().toString() + "f";
}
return "null";
} else if (ModelUtils.isDoubleSchema(p)) {
if (p.getDefault() != null) {
return p.getDefault().toString() + "d";
}
return "null";
} else if (ModelUtils.isBooleanSchema(p)) {
if (p.getDefault() != null) {
return p.getDefault().toString();
}
return "null";
} else if (ModelUtils.isStringSchema(p)) {
if (p.getDefault() != null) {
String _default = (String) p.getDefault();
if (p.getEnum() == null) {
return "\"" + escapeText(_default) + "\"";
} else {
// convert to enum var name later in postProcessModels
return _default;
}
}
return "null";
}
return super.toDefaultValue(p);
}
@Override
public void setParameterExampleValue(CodegenParameter p) {
if (Boolean.TRUE.equals(p.isLong)) {
p.example = "2147483648L";
} else if (Boolean.TRUE.equals(p.isFile)) {
p.example = "Blob.valueOf('Sample text file\\nContents')";
} else if (Boolean.TRUE.equals(p.isDate)) {
p.example = "Date.newInstance(1960, 2, 17)";
} else if (Boolean.TRUE.equals(p.isDateTime)) {
p.example = "Datetime.newInstanceGmt(2013, 11, 12, 3, 3, 3)";
} else if (Boolean.TRUE.equals(p.isListContainer)) {
if (p.items != null && p.items.example != null) {
p.example = "new " + p.dataType + "{" + p.items.example + "}";
}
} else if (Boolean.TRUE.equals(p.isMapContainer)) {
if (p.items != null && p.items.example != null) {
p.example = "new " + p.dataType + "{" + p.items.example + "}";
}
} else if (Boolean.TRUE.equals(p.isString)) {
p.example = "'" + p.example + "'";
} else if ("".equals(p.example) || p.example == null && p.dataType != "Object") {
// Get an example object from the generated model
if (!isReservedWord(p.dataType.toLowerCase())) {
p.example = p.dataType + ".getExample()";
}
} else {
p.example = "''";
}
}
@Override
public String toExampleValue(Schema p) {
if (p == null) {
return "";
}
Object obj = p.getExample();
String example = obj == null ? "" : obj.toString();
if (ModelUtils.isArraySchema(p)) {
example = "new " + getTypeDeclaration(p) + "{" + toExampleValue(
((ArraySchema) p).getItems()) + "}";
} else if (ModelUtils.isBooleanSchema(p)) {
example = String.valueOf(!"false".equals(example));
} else if (ModelUtils.isByteArraySchema(p)) {
if (example.isEmpty()) {
example = "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wZWQgb3ZlciB0aGUgbGF6eSBkb2cu";
}
((ByteArraySchema) p).setExample(example);
example = "EncodingUtil.base64Decode('" + example + "')";
} else if (ModelUtils.isDateSchema(p)) {
if (example.matches("^\\d{4}(-\\d{2}){2}")) {
example = example.substring(0, 10).replaceAll("-0?", ", ");
} else if (example.isEmpty()) {
example = "2000, 1, 23";
} else {
LOGGER.warn(String.format("The example provided for property '%s' is not a valid RFC3339 date. Defaulting to '2000-01-23'. [%s]", p
.getName(), example));
example = "2000, 1, 23";
}
example = "Date.newInstance(" + example + ")";
} else if (ModelUtils.isDateTimeSchema(p)) {
if (example.matches("^\\d{4}([-T:]\\d{2}){5}.+")) {
example = example.substring(0, 19).replaceAll("[-T:]0?", ", ");
} else if (example.isEmpty()) {
example = "2000, 1, 23, 4, 56, 7";
} else {
LOGGER.warn(String.format("The example provided for property '%s' is not a valid RFC3339 datetime. Defaulting to '2000-01-23T04-56-07Z'. [%s]", p
.getName(), example));
example = "2000, 1, 23, 4, 56, 7";
}
example = "Datetime.newInstanceGmt(" + example + ")";
} else if (ModelUtils.isNumberSchema(p)) {
example = example.replaceAll("[^-0-9.]", "");
example = example.isEmpty() ? "1.3579" : example;
} else if (ModelUtils.isFileSchema(p)) {
if (example.isEmpty()) {
example = "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wZWQgb3ZlciB0aGUgbGF6eSBkb2cu";
p.setExample(example);
}
example = "EncodingUtil.base64Decode(" + example + ")";
} else if (ModelUtils.isEmailSchema(p)) {
if (example.isEmpty()) {
example = "example@example.com";
p.setExample(example);
}
example = "'" + example + "'";
} else if (ModelUtils.isLongSchema(p)) {
example = example.isEmpty() ? "123456789L" : example + "L";
} else if (ModelUtils.isMapSchema(p)) {
example = "new " + getTypeDeclaration(p) + "{'key'=>" + toExampleValue((Schema) p.getAdditionalProperties()) + "}";
} else if (ModelUtils.isPasswordSchema(p)) {
example = example.isEmpty() ? "password123" : escapeText(example);
p.setExample(example);
example = "'" + example + "'";
} else if (ModelUtils.isStringSchema(p)) {
List<String> enums = p.getEnum();
if (enums != null && example.isEmpty()) {
example = enums.get(0);
p.setExample(example);
} else if (example.isEmpty()) {
example = "";
} else {
example = escapeText(example);
p.setExample(example);
}
example = "'" + example + "'";
} else if (ModelUtils.isUUIDSchema(p)) {
example = example.isEmpty()
? "'046b6c7f-0b8a-43b9-b35d-6489e6daee91'"
: "'" + escapeText(example) + "'";
} else if (ModelUtils.isIntegerSchema(p)) {
example = example.matches("^-?\\d+$") ? example : "0";
} else if (ModelUtils.isObjectSchema(p)) {
example = example.isEmpty() ? "null" : example;
} else {
example = super.toExampleValue(p);
}
return example;
}
@Override
public String getSchemaType(Schema p) {
String schemaType = super.getSchemaType(p);
schemaType = getAlias(schemaType);
// don't apply renaming on types from the typeMapping
if (typeMapping.containsKey(schemaType)) {
return typeMapping.get(schemaType);
}
if (null == schemaType) {
LOGGER.error("No Type defined for Property " + p);
}
return toModelName(schemaType);
}
@Override
public String toOperationId(String operationId) {
// throw exception if method name is empty
if (StringUtils.isEmpty(operationId)) {
throw new RuntimeException("Empty method/operation name (operationId) not allowed");
}
operationId = camelize(sanitizeName(operationId), true);
// method name cannot use reserved keyword, e.g. return
if (isReservedWord(operationId)) {
String newOperationId = camelize("call_" + operationId, true);
LOGGER.warn(operationId + " (reserved word) cannot be used as method name. Renamed to " + newOperationId);
return newOperationId;
}
return operationId;
}
@Override
public CodegenModel fromModel(String name, Schema model, Map<String, Schema> allDefinitions) {
CodegenModel cm = super.fromModel(name, model, allDefinitions);
// TODO Check enum model handling
if (cm.interfaces == null) {
cm.interfaces = new ArrayList<String>();
}
Boolean hasDefaultValues = false;
// for (de)serializing properties renamed for Apex (e.g. reserved words)
List<Map<String, String>> propertyMappings = new ArrayList<>();
for (CodegenProperty p : cm.allVars) {
hasDefaultValues |= p.defaultValue != null;
if (!p.baseName.equals(p.name)) {
Map<String, String> mapping = new HashMap<>();
mapping.put("externalName", p.baseName);
mapping.put("internalName", p.name);
propertyMappings.add(mapping);
}
}
cm.vendorExtensions.put("hasPropertyMappings", !propertyMappings.isEmpty());
cm.vendorExtensions.put("hasDefaultValues", hasDefaultValues);
cm.vendorExtensions.put("propertyMappings", propertyMappings);
if (!propertyMappings.isEmpty()) {
cm.interfaces.add("Swagger.MappedProperties");
}
return cm;
}
@Override
public void postProcessParameter(CodegenParameter parameter) {
if (parameter.isBodyParam && parameter.isListContainer) {
// items of array bodyParams are being nested an extra level too deep for some reason
parameter.items = parameter.items.items;
setParameterExampleValue(parameter);
}
}
@Override
public Map<String, Object> postProcessModels(Map<String, Object> objs) {
return postProcessModelsEnum(objs);
}
/* the following function is not used anywhere in this class so we'll remove it later
private static String getAccept(Operation operation) {
String accepts = null;
String defaultContentType = "application/json";
if (operation.getProduces() != null && !operation.getProduces().isEmpty()) {
StringBuilder sb = new StringBuilder();
for (String produces : operation.getProduces()) {
if (defaultContentType.equalsIgnoreCase(produces)) {
accepts = defaultContentType;
break;
} else {
if (sb.length() > 0) {
sb.append(",");
}
sb.append(produces);
}
}
if (accepts == null) {
accepts = sb.toString();
}
} else {
accepts = defaultContentType;
}
return accepts;
}*/
@Override
protected boolean needToImport(String type) {
return super.needToImport(type) && type.indexOf(".") < 0;
}
@Override
public String toEnumName(CodegenProperty property) {
return sanitizeName(camelize(property.name)) + "Enum";
}
@Override
public String toEnumVarName(String value, String datatype) {
if (value.length() == 0) {
return "EMPTY";
}
// for symbol, e.g. $, #
if (getSymbolName(value) != null) {
return getSymbolName(value).toUpperCase();
}
// number
if ("Integer".equals(datatype) || "Long".equals(datatype) ||
"Float".equals(datatype) || "Double".equals(datatype)) {
String varName = "NUMBER_" + value;
varName = varName.replaceAll("-", "MINUS_");
varName = varName.replaceAll("\\+", "PLUS_");
varName = varName.replaceAll("\\.", "_DOT_");
return varName;
}
// string
String var = value.replaceAll("\\W+", "_").toUpperCase();
if (var.matches("\\d.*")) {
return "_" + var;
} else {
return var;
}
}
@Override
public String toEnumValue(String value, String datatype) {
if ("Integer".equals(datatype) || "Double".equals(datatype)) {
return value;
} else if ("Long".equals(datatype)) {
// add l to number, e.g. 2048 => 2048l
return value + "l";
} else if ("Float".equals(datatype)) {
// add f to number, e.g. 3.14 => 3.14f
return value + "f";
} else {
return "\"" + escapeText(value) + "\"";
}
}
@Override
public CodegenOperation fromOperation(String path, String httpMethod, Operation operation, Map<String, Schema> definitions, OpenAPI openAPI) {
/* TODO the following logic revised. Maybe we should simply use the consumes, produces provided by the spec
Boolean hasFormParams = false;
for (Parameter p : operation.getParameters()) {
if ("formData".equals(p.getIn())) {
hasFormParams = true;
break;
}
}
// only support serialization into JSON and urlencoded forms for now
operation.setConsumes(
Collections.singletonList(hasFormParams
? "application/x-www-form-urlencoded"
: "application/json"));
// only support deserialization from JSON for now
operation.setProduces(Collections.singletonList("application/json"));
*/
CodegenOperation op = super.fromOperation(
path, httpMethod, operation, definitions, openAPI);
if (op.getHasExamples()) {
// prepare examples for Apex test classes
ApiResponse apiResponse = findMethodResponse(operation.getResponses());
final Schema responseSchema = ModelUtils.getSchemaFromResponse(apiResponse);
String deserializedExample = toExampleValue(responseSchema);
for (Map<String, String> example : op.examples) {
example.put("example", escapeText(example.get("example")));
example.put("deserializedExample", deserializedExample);
}
}
return op;
}
private static CodegenModel reconcileInlineEnums(CodegenModel codegenModel, CodegenModel parentCodegenModel) {
// This generator uses inline classes to define enums, which breaks when
// dealing with models that have subTypes. To clean this up, we will analyze
// the parent and child models, look for enums that match, and remove
// them from the child models and leave them in the parent.
// Because the child models extend the parents, the enums will be available via the parent.
// Only bother with reconciliation if the parent model has enums.
if (!parentCodegenModel.hasEnums) {
return codegenModel;
}
// Get the properties for the parent and child models
final List<CodegenProperty> parentModelCodegenProperties = parentCodegenModel.vars;
List<CodegenProperty> codegenProperties = codegenModel.vars;
// Iterate over all of the parent model properties
boolean removedChildEnum = false;
for (CodegenProperty parentModelCodegenPropery : parentModelCodegenProperties) {
// Look for enums
if (parentModelCodegenPropery.isEnum) {
// Now that we have found an enum in the parent class,
// and search the child class for the same enum.
Iterator<CodegenProperty> iterator = codegenProperties.iterator();
while (iterator.hasNext()) {
CodegenProperty codegenProperty = iterator.next();
if (codegenProperty.isEnum && codegenProperty.equals(parentModelCodegenPropery)) {
// We found an enum in the child class that is
// a duplicate of the one in the parent, so remove it.
iterator.remove();
removedChildEnum = true;
}
}
}
}
if (removedChildEnum) {
// If we removed an entry from this model's vars, we need to ensure hasMore is updated
int count = 0, numVars = codegenProperties.size();
for (CodegenProperty codegenProperty : codegenProperties) {
count += 1;
codegenProperty.hasMore = (count < numVars) ? true : false;
}
codegenModel.vars = codegenProperties;
}
return codegenModel;
}
private static String sanitizePackageName(String packageName) {
packageName = packageName.trim(); // FIXME: a parameter should not be assigned. Also declare the methods parameters as 'final'.
packageName = packageName.replaceAll("[^a-zA-Z0-9_\\.]", "_");
if (Strings.isNullOrEmpty(packageName)) {
return "invalidPackageName";
}
return packageName;
}
public void setSerializableModel(Boolean serializableModel) {
this.serializableModel = serializableModel;
}
private String sanitizePath(String p) {
//prefer replace a ", instead of a fuLL URL encode for readability
return p.replaceAll("\"", "%22");
}
public String toRegularExpression(String pattern) {
return escapeText(pattern);
}
public boolean convertPropertyToBoolean(String propertyKey) {
boolean booleanValue = false;
if (additionalProperties.containsKey(propertyKey)) {
booleanValue = Boolean.valueOf(additionalProperties.get(propertyKey).toString());
}
return booleanValue;
}
public void writePropertyBack(String propertyKey, boolean value) {
additionalProperties.put(propertyKey, value);
}
@Override
public String sanitizeTag(String tag) {
return camelize(sanitizeName(tag));
}
@Override
public String toModelTestFilename(String name) {
return toModelName(name) + "Test";
}
}

486
modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/ApexClientCodegen.java
View File

@ -17,39 +17,19 @@
package org.openapitools.codegen.languages; package org.openapitools.codegen.languages;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.Operation;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.media.ArraySchema;
import io.swagger.v3.oas.models.media.BooleanSchema;
import io.swagger.v3.oas.models.media.ByteArraySchema;
import io.swagger.v3.oas.models.media.EmailSchema;
import io.swagger.v3.oas.models.media.FileSchema;
import io.swagger.v3.oas.models.media.PasswordSchema;
import io.swagger.v3.oas.models.media.Schema;
import io.swagger.v3.oas.models.responses.ApiResponse;
import org.apache.commons.lang3.StringUtils;
import org.openapitools.codegen.CliOption; import org.openapitools.codegen.CliOption;
import org.openapitools.codegen.CodegenModel;
import org.openapitools.codegen.CodegenOperation;
import org.openapitools.codegen.CodegenParameter;
import org.openapitools.codegen.CodegenProperty; import org.openapitools.codegen.CodegenProperty;
import org.openapitools.codegen.CodegenType;
import org.openapitools.codegen.SupportingFile; import org.openapitools.codegen.SupportingFile;
import org.openapitools.codegen.utils.ModelUtils; import org.openapitools.codegen.utils.ModelUtils;
import io.swagger.v3.oas.models.media.*;
import io.swagger.v3.oas.models.info.*;
import io.swagger.v3.oas.models.OpenAPI;
import org.slf4j.Logger; import org.slf4j.Logger;
import org.slf4j.LoggerFactory; import org.slf4j.LoggerFactory;
import java.io.File; import java.io.File;
import java.util.ArrayList; import java.util.*;
import java.util.Arrays;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
public class ApexClientCodegen extends AbstractJavaCodegen { public class ApexClientCodegen extends AbstractApexCodegen {
private static final String CLASS_PREFIX = "classPrefix"; private static final String CLASS_PREFIX = "classPrefix";
private static final String API_VERSION = "apiVersion"; private static final String API_VERSION = "apiVersion";
@ -57,25 +37,23 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
private static final String NAMED_CREDENTIAL = "namedCredential"; private static final String NAMED_CREDENTIAL = "namedCredential";
private static final Logger LOGGER = LoggerFactory.getLogger(ApexClientCodegen.class); private static final Logger LOGGER = LoggerFactory.getLogger(ApexClientCodegen.class);
private String classPrefix = "Swag"; private String classPrefix = "Swag";
private String apiVersion = "39.0"; private String apiVersion = "42.0";
private String buildMethod = "sfdx"; private String buildMethod = "sfdx";
private String namedCredential = classPrefix; private String namedCredential = classPrefix;
private String srcPath = "force-app/main/default/"; private String srcPath = "force-app/main/default/";
private String sfdxConfigPath = "config/";
private HashMap<String, Object> primitiveDefaults = new HashMap<String, Object>();
public ApexClientCodegen() { public ApexClientCodegen() {
super(); super();
importMapping.clear(); importMapping.clear();
testFolder = sourceFolder = srcPath;
embeddedTemplateDir = templateDir = "apex"; embeddedTemplateDir = templateDir = "apex";
outputFolder = "generated-code" + File.separator + "apex"; outputFolder = "generated-code" + File.separator + "apex";
apiPackage = "classes"; modelPackage = apiPackage = srcPath + "classes";
modelPackage = "classes";
testPackage = "force-app.main.default.classes"; testPackage = "force-app.main.default.classes";
modelNamePrefix = classPrefix; modelNamePrefix = classPrefix;
dateLibrary = "";
apiTemplateFiles.put("api.mustache", ".cls"); apiTemplateFiles.put("api.mustache", ".cls");
apiTemplateFiles.put("cls-meta.mustache", ".cls-meta.xml"); apiTemplateFiles.put("cls-meta.mustache", ".cls-meta.xml");
@ -109,14 +87,15 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
typeMapping.put("short", "Integer"); typeMapping.put("short", "Integer");
typeMapping.put("UUID", "String"); typeMapping.put("UUID", "String");
// https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_reserved_words.htm
setReservedWordsLowerCase( setReservedWordsLowerCase(
Arrays.asList("abstract", "activate", "and", "any", "array", "as", "asc", "autonomous", Arrays.asList("abstract", "activate", "and", "any", "array", "as", "asc", "autonomous",
"begin", "bigdecimal", "blob", "break", "bulk", "by", "byte", "case", "cast", "begin", "bigdecimal", "blob", "break", "bulk", "by", "byte", "case", "cast",
"catch", "char", "class", "collect", "commit", "const", "continue", "catch", "char", "class", "collect", "commit", "const", "continue",
"convertcurrency", "date", "decimal", "default", "delete", "desc", "do", "else", "convertcurrency", "currency", "date", "datetime", "decimal", "default", "delete", "desc", "do", "else",
"end", "enum", "exception", "exit", "export", "extends", "false", "final", "end", "enum", "exception", "exit", "export", "extends", "false", "final",
"finally", "float", "for", "from", "future", "global", "goto", "group", "having", "finally", "float", "for", "from", "future", "global", "goto", "group", "having",
"hint", "if", "implements", "import", "inner", "insert", "instanceof", "int", "hint", "if", "implements", "import", "in", "inner", "insert", "instanceof", "int",
"interface", "into", "join", "last_90_days", "last_month", "last_n_days", "interface", "into", "join", "last_90_days", "last_month", "last_n_days",
"last_week", "like", "limit", "list", "long", "loop", "map", "merge", "new", "last_week", "like", "limit", "list", "long", "loop", "map", "merge", "new",
"next_90_days", "next_month", "next_n_days", "next_week", "not", "null", "nulls", "next_90_days", "next_month", "next_n_days", "next_week", "not", "null", "nulls",
@ -124,7 +103,7 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
"pragma", "private", "protected", "public", "retrieve", "return", "returning", "pragma", "private", "protected", "public", "retrieve", "return", "returning",
"rollback", "savepoint", "search", "select", "set", "short", "sort", "stat", "rollback", "savepoint", "search", "select", "set", "short", "sort", "stat",
"static", "super", "switch", "synchronized", "system", "testmethod", "then", "this", "static", "super", "switch", "synchronized", "system", "testmethod", "then", "this",
"this_month", "this_week", "throw", "today", "tolabel", "tomorrow", "transaction", "this_month", "this_week", "throw", "time", "today", "tolabel", "tomorrow", "transaction",
"trigger", "true", "try", "type", "undelete", "update", "upsert", "using", "trigger", "true", "try", "type", "undelete", "update", "upsert", "using",
"virtual", "webservice", "when", "where", "while", "yesterday" "virtual", "webservice", "when", "where", "while", "yesterday"
)); ));
@ -133,6 +112,17 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
Arrays.asList("Blob", "Boolean", "Date", "Datetime", "Decimal", "Double", "ID", Arrays.asList("Blob", "Boolean", "Date", "Datetime", "Decimal", "Double", "ID",
"Integer", "Long", "Object", "String", "Time" "Integer", "Long", "Object", "String", "Time"
)); ));
primitiveDefaults.put("Boolean", true);
primitiveDefaults.put("Decimal", 1);
primitiveDefaults.put("Double", 1);
primitiveDefaults.put("Integer", 1);
primitiveDefaults.put("Long", 1);
primitiveDefaults.put("String", "");
instantiationTypes.put("array", "List");
instantiationTypes.put("map", "Map");
} }
@Override @Override
@ -162,6 +152,48 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
postProcessOpts(); postProcessOpts();
} }
@Override
public void preprocessOpenAPI(OpenAPI openAPI) {
Info info = openAPI.getInfo();
String calloutLabel = info.getTitle();
additionalProperties.put("calloutLabel", calloutLabel);
String sanitized = sanitizeName(calloutLabel);
additionalProperties.put("calloutName", sanitized);
supportingFiles.add(new SupportingFile("namedCredential.mustache", srcPath + "/namedCredentials",
sanitized + ".namedCredential-meta.xml"
));
if (additionalProperties.get(BUILD_METHOD).equals("sfdx")) {
generateSfdxSupportingFiles();
} else if (additionalProperties.get(BUILD_METHOD).equals("ant")) {
generateAntSupportingFiles();
}
}
@Override
public String escapeQuotationMark(String input) {
return input.replace("'", "\\'");
}
@Override
public String escapeUnsafeCharacters(String input) {
return input.replace("*/", "*_/").replace("/*", "/_*");
}
@Override
public String escapeText(String input) {
if (input == null) {
return input;
}
return input.replace("'", "\\'").replace("\n", "\\n").replace("\r", "\\r").replace("*/", "*_/").replace("/*", "/_*");
}
@Override
public String toApiName(String name) {
return camelize(classPrefix + super.toApiName(name));
}
@Override @Override
public String escapeReservedWord(String name) { public String escapeReservedWord(String name) {
// Identifiers must start with a letter // Identifiers must start with a letter
@ -191,17 +223,20 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
} else if (ModelUtils.isBooleanSchema(p)) { } else if (ModelUtils.isBooleanSchema(p)) {
// true => "true", false => "false", null => "null" // true => "true", false => "false", null => "null"
out = String.valueOf(((BooleanSchema) p).getDefault()); out = String.valueOf(((BooleanSchema) p).getDefault());
} else if (ModelUtils.isLongSchema(p)) { // long } else if (ModelUtils.isLongSchema(p)) {
out = p.getDefault() == null ? out : p.getDefault().toString() + "L"; Long def = (Long) p.getDefault();
out = def == null ? out : def.toString() + "L";
} else if (ModelUtils.isMapSchema(p)) { } else if (ModelUtils.isMapSchema(p)) {
Schema inner = (Schema) p.getAdditionalProperties(); Schema inner = (Schema) p.getAdditionalProperties();
String s = inner == null ? "Object" : getTypeDeclaration(inner); String s = inner == null ? "Object" : getTypeDeclaration(inner);
out = String.format("new Map<String, %s>()", s); out = String.format("new Map<String, %s>()", s);
} else if (ModelUtils.isStringSchema(p)) { } else if (ModelUtils.isStringSchema(p)) {
String def = (String) p.getDefault(); if (p.getDefault() != null) {
String def = p.getDefault().toString();
if (def != null) { if (def != null) {
out = p.getEnum() == null ? String.format("'%s'", escapeText(def)) : def; out = p.getEnum() == null ? String.format("'%s'", escapeText(def)) : def;
} }
}
} else { } else {
out = super.toDefaultValue(p); out = super.toDefaultValue(p);
} }
@ -210,256 +245,12 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
return "null".equals(out) ? null : out; return "null".equals(out) ? null : out;
} }
@Override
public void setParameterExampleValue(CodegenParameter p) {
String example;
if (p.defaultValue == null) {
example = p.example;
} else {
example = p.defaultValue;
}
String type = p.baseType;
if (type == null) {
type = p.dataType;
}
if (Boolean.TRUE.equals(p.isInteger)) {
if (example == null) {
example = "56";
}
} else if (Boolean.TRUE.equals(p.isLong)) {
if (example == null) {
example = "2147483648L";
}
} else if (Boolean.TRUE.equals(p.isDouble)
|| Boolean.TRUE.equals(p.isFloat)
|| Boolean.TRUE.equals(p.isNumber)) {
if (example == null) {
example = "3.4";
}
} else if (Boolean.TRUE.equals(p.isBoolean)) {
if (Boolean.parseBoolean(p.example)) {
p.example = "1";
} else {
p.example = "0";
}
} else if (Boolean.TRUE.equals(p.isFile) || Boolean.TRUE.equals(p.isBinary)) {
example = "Blob.valueOf('Sample text file\\nContents')";
} else if (Boolean.TRUE.equals(p.isByteArray)) {
if (example == null) {
example = "YmFzZSA2NCBkYXRh";
}
example = "\"" + escapeText(example) + "\"";
} else if (Boolean.TRUE.equals(p.isDate)) {
if (example == null) {
example = "1960, 2, 17";
}
example = "Date.newInstance(" + escapeText(p.example) + ")";
} else if (Boolean.TRUE.equals(p.isDateTime)) {
if (example == null) {
example = "2013, 11, 12, 3, 3, 3";
}
example = "Datetime.newInstanceGmt(" + escapeText(p.example) + ")";
} else if (Boolean.TRUE.equals(p.isString)) {
if (example == null) {
example = p.paramName + "_example";
}
example = "\'" + escapeText(example) + "\'";
} else if (!languageSpecificPrimitives.contains(type)) {
// type is a model class, e.g. User
example = type + ".getExample()";
}
// container
if (Boolean.TRUE.equals(p.isListContainer)) {
example = setPropertyExampleValue(p.items);
example = "new " + p.dataType + "{" + example + "}";
} else if (Boolean.TRUE.equals(p.isMapContainer)) {
example = setPropertyExampleValue(p.items);
example = "new " + p.dataType + "{" + example + "}";
} else if (example == null) {
example = "null";
}
p.example = example;
}
protected String setPropertyExampleValue(CodegenProperty p) {
String example;
if (p == null) {
return "null";
}
if (p.defaultValue == null) {
example = p.example;
} else {
example = p.defaultValue;
}
String type = p.baseType;
if (type == null) {
type = p.dataType;
}
if (Boolean.TRUE.equals(p.isInteger)) {
if (example == null) {
example = "56";
}
} else if (Boolean.TRUE.equals(p.isLong)) {
if (example == null) {
example = "2147483648L";
}
} else if (Boolean.TRUE.equals(p.isDouble)
|| Boolean.TRUE.equals(p.isFloat)
|| Boolean.TRUE.equals(p.isNumber)) {
if (example == null) {
example = "3.4";
}
} else if (Boolean.TRUE.equals(p.isBoolean)) {
if (example == null) {
example = "true";
}
} else if (Boolean.TRUE.equals(p.isFile) || Boolean.TRUE.equals(p.isBinary)) {
if (example == null) {
example = "Blob.valueOf('Sample text file\\nContents')";
}
example = escapeText(example);
} else if (Boolean.TRUE.equals(p.isDate)) {
if (example == null) {
example = "1960, 2, 17";
}
example = "Date.newInstance(" + escapeText(p.example) + ")";
} else if (Boolean.TRUE.equals(p.isDateTime)) {
if (example == null) {
example = "2013, 11, 12, 3, 3, 3";
}
example = "Datetime.newInstanceGmt(" + escapeText(p.example) + ")";
} else if (Boolean.TRUE.equals(p.isString)) {
if (example == null) {
example = p.name + "_example";
}
example = "\'" + escapeText(example) + "\'";
} else if (!languageSpecificPrimitives.contains(type)) {
// type is a model class, e.g. User
example = type + ".getExample()";
}
return example;
}
@Override
public CodegenModel fromModel(String name, Schema model, Map<String, Schema> allDefinitions) {
CodegenModel cm = super.fromModel(name, model, allDefinitions);
if (cm.interfaces == null) {
cm.interfaces = new ArrayList<String>();
}
Boolean hasDefaultValues = false;
// for (de)serializing properties renamed for Apex (e.g. reserved words)
List<Map<String, String>> propertyMappings = new ArrayList<>();
for (CodegenProperty p : cm.allVars) {
hasDefaultValues |= p.defaultValue != null;
if (!p.baseName.equals(p.name)) {
Map<String, String> mapping = new HashMap<>();
mapping.put("externalName", p.baseName);
mapping.put("internalName", p.name);
propertyMappings.add(mapping);
}
}
cm.vendorExtensions.put("hasPropertyMappings", !propertyMappings.isEmpty());
cm.vendorExtensions.put("hasDefaultValues", hasDefaultValues);
cm.vendorExtensions.put("propertyMappings", propertyMappings);
if (!propertyMappings.isEmpty()) {
cm.interfaces.add("Swagger.MappedProperties");
}
return cm;
}
/* the following workaround is no longer needed
@Override
public void postProcessParameter(CodegenParameter parameter) {
if (parameter.isBodyParam && parameter.isListContainer) {
// items of array bodyParams are being nested an extra level too deep for some reason
parameter.items = parameter.items.items;
setParameterExampleValue(parameter);
}
}
*/
@Override
public void preprocessOpenAPI(OpenAPI openAPI) {
Info info = openAPI.getInfo();
String calloutLabel = info.getTitle();
additionalProperties.put("calloutLabel", calloutLabel);
String sanitized = sanitizeName(calloutLabel);
additionalProperties.put("calloutName", sanitized);
supportingFiles.add(new SupportingFile("namedCredential.mustache", srcPath + "/namedCredentials",
sanitized + ".namedCredential"
));
if (additionalProperties.get(BUILD_METHOD).equals("sfdx")) {
generateSfdxSupportingFiles();
} else if (additionalProperties.get(BUILD_METHOD).equals("ant")) {
generateAntSupportingFiles();
}
}
@Override
public CodegenOperation fromOperation(String path,
String httpMethod,
Operation operation,
Map<String, Schema> definitions,
OpenAPI openAPI) {
Boolean hasFormParams = false;
// comment out the following as there's no consume/produce in OAS3.0
// we can move the logic below to postProcessOperations if needed
/*
// only support serialization into JSON and urlencoded forms for now
operation.setConsumes(
Collections.singletonList(hasFormParameter(operation)
? "application/x-www-form-urlencoded"
: "application/json"));
// only support deserialization from JSON for now
operation.setProduces(Collections.singletonList("application/json"));
*/
CodegenOperation op = super.fromOperation(path, httpMethod, operation, definitions, openAPI);
if (op.getHasExamples()) {
// prepare examples for Apex test classes
ApiResponse responseProperty = findMethodResponse(operation.getResponses());
String deserializedExample = toExampleValue(ModelUtils.getSchemaFromResponse(responseProperty));
for (Map<String, String> example : op.examples) {
example.put("example", escapeText(example.get("example")));
example.put("deserializedExample", deserializedExample);
}
}
return op;
}
@Override
public String escapeQuotationMark(String input) {
return input.replace("'", "\\'");
}
public void setBuildMethod(String buildMethod) { public void setBuildMethod(String buildMethod) {
if (buildMethod.equals("ant")) { if (buildMethod.equals("ant")) {
this.srcPath = "deploy/"; this.srcPath = "deploy/";
} else { } else {
this.srcPath = "src/"; this.srcPath = "src/";
} }
testFolder = sourceFolder = srcPath;
this.buildMethod = buildMethod; this.buildMethod = buildMethod;
} }
@ -494,114 +285,6 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
)); ));
} }
@Override
public String escapeText(String input) {
if (input == null) {
return input;
}
return input.replace("'", "\\'").replace("\n", "\\n").replace("\r", "\\r");
}
@Override
public String toModelTestFilename(String name) {
return toModelName(name) + "Test";
}
@Override
public String toExampleValue(Schema p) {
if (p == null) {
return "";
}
Object obj = p.getExample();
String example = obj == null ? "" : obj.toString();
if (ModelUtils.isArraySchema(p)) { // array
example = "new " + getTypeDeclaration(p) + "{" + toExampleValue(
((ArraySchema) p).getItems()) + "}";
} else if (ModelUtils.isBooleanSchema(p)) {
example = String.valueOf(!"false".equals(example));
} else if (ModelUtils.isByteArraySchema(p)) { // byte array
if (example.isEmpty()) {
example = "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wZWQgb3ZlciB0aGUgbGF6eSBkb2cu";
}
((ByteArraySchema) p).setExample(example);
example = "EncodingUtil.base64Decode('" + example + "')";
} else if (ModelUtils.isDateSchema(p)) { // date
if (example.matches("^\\d{4}(-\\d{2}){2}")) {
example = example.substring(0, 10).replaceAll("-0?", ", ");
} else if (example.isEmpty()) {
example = "2000, 1, 23";
} else {
LOGGER.warn(String.format("The example provided for property '%s' is not a valid RFC3339 date. Defaulting to '2000-01-23'. [%s]", p
.getName(), example));
example = "2000, 1, 23";
}
example = "Date.newInstance(" + example + ")";
} else if (ModelUtils.isDateTimeSchema(p)) { // datetime
if (example.matches("^\\d{4}([-T:]\\d{2}){5}.+")) {
example = example.substring(0, 19).replaceAll("[-T:]0?", ", ");
} else if (example.isEmpty()) {
example = "2000, 1, 23, 4, 56, 7";
} else {
LOGGER.warn(String.format("The example provided for property '%s' is not a valid RFC3339 datetime. Defaulting to '2000-01-23T04-56-07Z'. [%s]", p
.getName(), example));
example = "2000, 1, 23, 4, 56, 7";
}
example = "Datetime.newInstanceGmt(" + example + ")";
} else if (ModelUtils.isNumberSchema(p)) { // number
example = example.replaceAll("[^-0-9.]", "");
example = example.isEmpty() ? "1.3579" : example;
} else if (ModelUtils.isFileSchema(p)) { // file
if (example.isEmpty()) {
example = "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wZWQgb3ZlciB0aGUgbGF6eSBkb2cu";
((FileSchema) p).setExample(example);
}
example = "EncodingUtil.base64Decode(" + example + ")";
} else if (ModelUtils.isEmailSchema(p)) { // email
if (example.isEmpty()) {
example = "example@example.com";
((EmailSchema) p).setExample(example);
}
example = "'" + example + "'";
} else if (ModelUtils.isLongSchema(p)) { // long
example = example.isEmpty() ? "123456789L" : example + "L";
} else if (ModelUtils.isMapSchema(p)) { // map
example = "new " + getTypeDeclaration(p) + "{'key'=>" + toExampleValue(
(Schema) p.getAdditionalProperties()) + "}";
} else if (ModelUtils.isObjectSchema(p)) { // object
example = example.isEmpty() ? "null" : example;
} else if (ModelUtils.isPasswordSchema(p)) { // password
example = example.isEmpty() ? "password123" : escapeText(example);
((PasswordSchema) p).setExample(example);
example = "'" + example + "'";
} else if (!StringUtils.isEmpty(p.get$ref())) {
example = getTypeDeclaration(p) + ".getExample()";
} else if (ModelUtils.isUUIDSchema(p)) {
example = example.isEmpty()
? "'046b6c7f-0b8a-43b9-b35d-6489e6daee91'"
: "'" + escapeText(example) + "'";
} else if (ModelUtils.isStringSchema(p)) { // string
List<String> enums = p.getEnum();
if (enums != null && example.isEmpty()) {
example = enums.get(0);
p.setExample(example);
} else if (example.isEmpty()) {
example = "aeiou";
} else {
example = escapeText(example);
p.setExample(example);
}
example = "'" + example + "'";
}
return example;
}
@Override
public String toApiName(String name) {
return camelize(classPrefix + super.toApiName(name));
}
@Override @Override
public void updateCodegenPropertyEnum(CodegenProperty var) { public void updateCodegenPropertyEnum(CodegenProperty var) {
super.updateCodegenPropertyEnum(var); super.updateCodegenPropertyEnum(var);
@ -612,21 +295,6 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
} }
} }
@Override
public CodegenType getTag() {
return CodegenType.CLIENT;
}
@Override
public String getName() {
return "apex";
}
@Override
public String getHelp() {
return "Generates an Apex API client library (beta).";
}
private void generateAntSupportingFiles() { private void generateAntSupportingFiles() {
supportingFiles.add(new SupportingFile("package.mustache", "deploy", "package.xml")); supportingFiles.add(new SupportingFile("package.mustache", "deploy", "package.xml"));
@ -638,11 +306,17 @@ public class ApexClientCodegen extends AbstractJavaCodegen {
supportingFiles.add(new SupportingFile("gitignore.mustache", "", ".gitignore")); supportingFiles.add(new SupportingFile("gitignore.mustache", "", ".gitignore"));
writeOptional(outputFolder, new SupportingFile("README_ant.mustache", "README.md")); writeOptional(outputFolder, new SupportingFile("README_ant.mustache", "README.md"));
} }
private void generateSfdxSupportingFiles() { private void generateSfdxSupportingFiles() {
supportingFiles.add(new SupportingFile("sfdx.mustache", "", "sfdx-oss-manifest.json"));
supportingFiles.add(new SupportingFile("sfdx-project-scratch-def.json", sfdxConfigPath, "project-scratch-def.json"));
supportingFiles.add(new SupportingFile("sfdx-project.json.mustache", "sfdx-project.json"));
writeOptional(outputFolder, new SupportingFile("README_sfdx.mustache", "README.md")); writeOptional(outputFolder, new SupportingFile("README_sfdx.mustache", "README.md"));
}
}
} }

2
modules/openapi-generator/src/main/resources/apex/README_sfdx.mustache
View File

@ -100,7 +100,7 @@ Class | Method | HTTP request | Description
{{/isBasic}} {{/isBasic}}
{{#isOAuth}}- **Type**: OAuth {{#isOAuth}}- **Type**: OAuth
- **Flow**: {{flow}} - **Flow**: {{flow}}
- **Authorizatoin URL**: {{authorizationUrl}} - **Authorization URL**: {{authorizationUrl}}
- **Scopes**: {{^scopes}}N/A{{/scopes}} - **Scopes**: {{^scopes}}N/A{{/scopes}}
{{#scopes}} - {{scope}}: {{description}} {{#scopes}} - {{scope}}: {{description}}
{{/scopes}} {{/scopes}}

6
modules/openapi-generator/src/main/resources/apex/Swagger.cls
View File

@ -271,9 +271,7 @@ public class Swagger {
@TestVisible @TestVisible
protected virtual void applyAuthentication(List<String> names, Map<String, Object> headers, protected virtual void applyAuthentication(List<String> names, Map<String, Object> headers,
List<Param> query) { List<Param> query) {
for (Authentication auth : getAuthMethods(names)) { // TODO Check auth methods
auth.apply(headers, query);
}
} }
@TestVisible @TestVisible
@ -298,7 +296,7 @@ public class Swagger {
protected virtual String toEndpoint(String path, Map<String, Object> params, protected virtual String toEndpoint(String path, Map<String, Object> params,
List<Param> queryParams) { List<Param> queryParams) {
String query = '?' + paramsToString(queryParams); String query = '?' + paramsToString(queryParams);
return '"callout:' + calloutName + toPath(path, params) + query.removeEnd('?') + '""'; return 'callout:' + calloutName + toPath(path, params) + query.removeEnd('?');
} }
@TestVisible @TestVisible

5
modules/openapi-generator/src/main/resources/apex/SwaggerTest.cls
View File

@ -292,7 +292,7 @@ private class SwaggerTest {
new Swagger.Param('foo', 'bar'), new Swagger.Param('foo', 'bar'),
new Swagger.Param('bat', '123') new Swagger.Param('bat', '123')
}; };
String expected = 'https://www.mccombs.utexas.edu/departments/finance?foo=bar&bat=123'; String expected = 'callout:Winkelmeyer/departments/finance?foo=bar&bat=123';
String actual = client.toEndpoint(path, params, queryParams); String actual = client.toEndpoint(path, params, queryParams);
System.assertEquals(expected, actual); System.assertEquals(expected, actual);
} }
@ -360,7 +360,8 @@ private class SwaggerTest {
private class MockApiClient extends Swagger.ApiClient { private class MockApiClient extends Swagger.ApiClient {
public MockApiClient() { public MockApiClient() {
basePath = 'https://www.mccombs.utexas.edu'; basePath = 'https://blog.winkelmeyer.com';
calloutName = 'Winkelmeyer';
} }
} }
} }

4
modules/openapi-generator/src/main/resources/apex/api.mustache
View File

@ -88,13 +88,13 @@ public class {{classname}} {
{{/headerParams}} {{/headerParams}}
}{{/hasHeaderParams}}{{^hasHeaderParams}}(){{/hasHeaderParams}}, }{{/hasHeaderParams}}{{^hasHeaderParams}}(){{/hasHeaderParams}},
{{#hasProduces}} {{#hasProduces}}
new List<String>{ {{#produces}}'{{{mediaType}}}'{{#hasMore}}, {{/hasMore}}{{/produces}} }, new List<String>{ {{#produces}}'{{mediaType}}'{{#hasMore}}, {{/hasMore}}{{/produces}} },
{{/hasProduces}} {{/hasProduces}}
{{^hasProduces}} {{^hasProduces}}
new List<String>(), new List<String>(),
{{/hasProduces}} {{/hasProduces}}
{{#hasConsumes}} {{#hasConsumes}}
new List<String>{ {{#consumes}}'{{{mediaType}}}'{{#hasMore}}, {{/hasMore}}{{/consumes}} }, new List<String>{ {{#consumes}}'{{mediaType}}'{{#hasMore}}, {{/hasMore}}{{/consumes}} },
{{/hasConsumes}} {{/hasConsumes}}
{{^hasConsumes}} {{^hasConsumes}}
new List<String>(), new List<String>(),

12
modules/openapi-generator/src/main/resources/apex/api_test.mustache
View File

@ -34,18 +34,19 @@ private class {{classname}}Test {
{{{returnType}}} response; {{{returnType}}} response;
{{{returnType}}} expectedResponse; {{{returnType}}} expectedResponse;
{{/returnType}} {{/returnType}}
String js = '';
{{#authMethods}} {{#authMethods}}
client = new {{classPrefix}}Client(); client = new {{classPrefix}}Client();
api = new {{classname}}(client);{{#isApiKey}} api = new {{classname}}(client);{{#isApiKey}}
((Swagger.ApiKeyAuth){{/isApiKey}} client.getAuthentication('{{name}}'); ((Swagger.ApiKeyAuth)client.getAuthentication('{{name}}')).setApiKey('foo-bar-api-key');
{{#isApiKey}}
client.setApiKey('foo-bar-api-key');
{{/isApiKey}} {{/isApiKey}}
{{#examples}} {{#examples}}
js = JSON.serialize({{{deserializedExample}}});
res.setHeader('Content-Type', '{{contentType}}'); res.setHeader('Content-Type', '{{contentType}}');
res.setBody('{{{example}}}'); res.setBody(js);
expectedResponse = {{{deserializedExample}}}; expectedResponse = {{{deserializedExample}}};
response = ({{{returnType}}}) api.{{operationId}}({{#hasParams}}params{{/hasParams}}); response = ({{{returnType}}}) api.{{operationId}}({{#hasParams}}params{{/hasParams}});
System.assertEquals(expectedResponse, response); System.assertEquals(expectedResponse, response);
@ -59,8 +60,9 @@ private class {{classname}}Test {
api = new {{classname}}(new {{classPrefix}}Client()); api = new {{classname}}(new {{classPrefix}}Client());
{{#examples}} {{#examples}}
js = JSON.serialize({{{deserializedExample}}});
res.setHeader('Content-Type', '{{contentType}}'); res.setHeader('Content-Type', '{{contentType}}');
res.setBody('{{{example}}}'); res.setBody(js);
expectedResponse = {{{deserializedExample}}}; expectedResponse = {{{deserializedExample}}};
response = ({{{returnType}}}) api.{{operationId}}({{#hasParams}}params{{/hasParams}}); response = ({{{returnType}}}) api.{{operationId}}({{#hasParams}}params{{/hasParams}});
System.assertEquals(expectedResponse, response); System.assertEquals(expectedResponse, response);

4
modules/openapi-generator/src/main/resources/apex/git_push.sh.mustache
View File

@ -1,7 +1,7 @@
#!/bin/sh #!/bin/sh
# ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/ # ref: https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/
# #
# Usage example: /bin/sh ./git_push.sh wing328 openapi-pestore-perl "minor update" # Usage example: /bin/sh ./git_push.sh wing328 swagger-petstore-perl "minor update"
git_user_id=$1 git_user_id=$1
git_repo_id=$2 git_repo_id=$2
@ -36,7 +36,7 @@ git_remote=`git remote`
if [ "$git_remote" = "" ]; then # git remote not defined if [ "$git_remote" = "" ]; then # git remote not defined
if [ "$GIT_TOKEN" = "" ]; then if [ "$GIT_TOKEN" = "" ]; then
echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git credential in your environment." echo "[INFO] \$GIT_TOKEN (environment variable) is not set. Using the git crediential in your environment."
git remote add origin https://github.com/${git_user_id}/${git_repo_id}.git git remote add origin https://github.com/${git_user_id}/${git_repo_id}.git
else else
git remote add origin https://${git_user_id}:${GIT_TOKEN}@github.com/${git_user_id}/${git_repo_id}.git git remote add origin https://${git_user_id}:${GIT_TOKEN}@github.com/${git_user_id}/${git_repo_id}.git

4
modules/openapi-generator/src/main/resources/apex/licenseInfo.mustache
View File

@ -5,7 +5,7 @@
* {{#version}}OpenAPI spec version: {{{version}}}{{/version}} * {{#version}}OpenAPI spec version: {{{version}}}{{/version}}
* {{#infoEmail}}Contact: {{{infoEmail}}}{{/infoEmail}} * {{#infoEmail}}Contact: {{{infoEmail}}}{{/infoEmail}}
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */

9
modules/openapi-generator/src/main/resources/apex/model_test.mustache
View File

@ -45,15 +45,6 @@ private class {{classname}}Test {
System.assert({{classVarName}}4.equals({{classVarName}}3)); System.assert({{classVarName}}4.equals({{classVarName}}3));
} }
@isTest
private static void notEqualsUnlikeInstance() {
{{classname}} {{classVarName}}1 = {{classname}}.getExample();
{{classname}} {{classVarName}}2 = new {{classname}}();
System.assertEquals(false, {{classVarName}}1.equals({{classVarName}}2));
System.assertEquals(false, {{classVarName}}2.equals({{classVarName}}1));
}
@isTest @isTest
private static void notEqualsDifferentType() { private static void notEqualsDifferentType() {
{{classname}} {{classVarName}}1 = {{classname}}.getExample(); {{classname}} {{classVarName}}1 = {{classname}}.getExample();

2
modules/openapi-generator/src/main/resources/apex/package.mustache
View File

@ -3,7 +3,7 @@
<fullName>{{appName}} API Client</fullName> <fullName>{{appName}} API Client</fullName>
<description>Client library for calling the {{appName}} API.{{#appDescription}} <description>Client library for calling the {{appName}} API.{{#appDescription}}
{{{appDescription}}}{{/appDescription}} {{{appDescription}}}{{/appDescription}}
Generated with OpenAPI Generator (https://openapi-generator.tech)</description> Generated with Swagger Codegen (github.com/swagger-api/swagger-codegen)</description>
<types> <types>
{{#apiInfo}} {{#apiInfo}}
{{#apis}} {{#apis}}

19
modules/openapi-generator/src/main/resources/apex/pojo.mustache
View File

@ -6,13 +6,15 @@ public class {{classname}}{{#parent}} extends {{{parent}}}{{/parent}}{{#interfac
{{#isEnum}} {{#isEnum}}
{{^isContainer}} {{^isContainer}}
{{>modelInnerEnum}} {{>modelInnerEnum}}
{{/isContainer}}
{{#isContainer}}
{{#mostInnerItems}}
{{>modelInnerEnum}}
{{/mostInnerItems}}
{{/isContainer}} {{/isContainer}}
{{/isEnum}} {{/isEnum}}
{{#items.isEnum}}
{{#items}}
{{^isContainer}}
{{>modelInnerEnum}}
{{/isContainer}}
{{/items}}
{{/items.isEnum}}
/** /**
{{#description}} {{#description}}
* {{{description}}} * {{{description}}}
@ -58,16 +60,17 @@ public class {{classname}}{{#parent}} extends {{{parent}}}{{/parent}}{{#interfac
public static {{classname}} getExample() { public static {{classname}} getExample() {
{{classname}} {{classVarName}} = new {{classname}}(); {{classname}} {{classVarName}} = new {{classname}}();
{{#vars}} {{#vars}}
{{classVarName}}.{{name}} = {{{example}}}; {{#example}}{{classVarName}}.{{name}} = {{{example}}};{{/example}}
{{/vars}} {{/vars}}
return {{classVarName}}; return {{classVarName}};
} }
public Boolean equals(Object obj) { public Boolean equals(Object obj) {
if (obj instanceof {{classname}}) { if (obj instanceof {{classname}}) { {{#hasVars}}
{{classname}} {{classVarName}} = ({{classname}}) obj; {{classname}} {{classVarName}} = ({{classname}}) obj;
return {{#vars}}this.{{name}} == {{classVarName}}.{{name}}{{#hasMore}} return {{#vars}}this.{{name}} == {{classVarName}}.{{name}}{{#hasMore}}
&& {{/hasMore}}{{/vars}}; && {{/hasMore}}{{/vars}};{{/hasVars}}{{^hasVars}}
return true;{{/hasVars}}
} }
return false; return false;
} }

2
modules/openapi-generator/src/main/resources/apex/pojo_doc.mustache
View File

@ -3,7 +3,7 @@
## Properties ## Properties
Name | Type | Description | Notes Name | Type | Description | Notes
------------ | ------------- | ------------- | ------------- ------------ | ------------- | ------------- | -------------
{{#vars}}**{{name}}** | {{#isEnum}}[**{{datatypeWithEnum}}**](#{{datatypeWithEnum}}){{/isEnum}}{{^isEnum}}{{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{dataType}}**]({{complexType}}.md){{/isPrimitiveType}}{{/isEnum}} | {{description}} | {{^required}} [optional]{{/required}}{{#readOnly}} [readonly]{{/readOnly}} {{#vars}}**{{name}}** | {{#isEnum}}[**{{datatypeWithEnum}}**](#{{datatypeWithEnum}}){{/isEnum}}{{^isEnum}}{{#isPrimitiveType}}**{{datatype}}**{{/isPrimitiveType}}{{^isPrimitiveType}}[**{{datatype}}**]({{complexType}}.md){{/isPrimitiveType}}{{/isEnum}} | {{description}} | {{^required}} [optional]{{/required}}{{#readOnly}} [readonly]{{/readOnly}}
{{/vars}} {{/vars}}
{{#vars}}{{#isEnum}} {{#vars}}{{#isEnum}}

8
modules/openapi-generator/src/main/resources/apex/sfdx-project-scratch-def.json Normal file
View File

@ -0,0 +1,8 @@
{
"orgName": "muenzpraeger - René Winkelmeyer",
"edition": "Developer",
"orgPreferences": {
"enabled": ["S1DesktopEnabled"],
"disabled": ["S1EncryptedStoragePref2"]
}
}

11
modules/openapi-generator/src/main/resources/apex/sfdx-project.json.mustache Normal file
View File

@ -0,0 +1,11 @@
{
"packageDirectories": [
{
"path": "force-app",
"default": true
}
],
"namespace": "",
"sfdcLoginUrl": "https://login.salesforce.com",
"sourceApiVersion": "{{apiVersion}}"
}

10
modules/openapi-generator/src/main/resources/apex/sfdx.mustache
View File

@ -1,10 +0,0 @@
{
"sfdxSource": true,
"version": "1.0.0",
"sourceFolder": "src/",
"folders": [
"src/classes"
],
"files": [
]
}

6
samples/client/petstore/apex/.openapi-generator-ignore
View File

@ -1,11 +1,11 @@
# OpenAPI Generator Ignore # Swagger Codegen Ignore
# Generated by openapi-generator https://github.com/openapitools/openapi-generator # Generated by swagger-codegen https://github.com/swagger-api/swagger-codegen
# Use this file to prevent files from being overwritten by the generator. # Use this file to prevent files from being overwritten by the generator.
# The patterns follow closely to .gitignore or .dockerignore. # The patterns follow closely to .gitignore or .dockerignore.
# As an example, the C# client generator defines ApiClient.cs. # As an example, the C# client generator defines ApiClient.cs.
# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line: # You can make changes and tell Swagger Codgen to ignore just this file by uncommenting the following line:
#ApiClient.cs #ApiClient.cs
# You can match any string of characters against a directory, file or extension with a single asterisk (*): # You can match any string of characters against a directory, file or extension with a single asterisk (*):

2
samples/client/petstore/apex/.openapi-generator/VERSION
View File

@ -1 +1 @@
3.0.0-SNAPSHOT 3.2.0-SNAPSHOT

1
samples/client/petstore/apex/.swagger-codegen/VERSION Normal file
View File

@ -0,0 +1 @@
2.4.0-SNAPSHOT

52
samples/client/petstore/apex/docs/SwagPetApi.md
View File

@ -16,10 +16,12 @@ Method | HTTP request | Description
<a name="addPet"></a> <a name="addPet"></a>
# **addPet** # **addPet**
> addPet(swagPet) > addPet(body)
Add a new pet to the store Add a new pet to the store
### Example ### Example
```java ```java
SwagPetApi api = new SwagPetApi(); SwagPetApi api = new SwagPetApi();
@ -30,7 +32,7 @@ Swagger.OAuth petstore_auth = (Swagger.OAuth) client.getAuthentication('petstore
petstore_auth.setAccessToken('YOUR ACCESS TOKEN'); petstore_auth.setAccessToken('YOUR ACCESS TOKEN');
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'swagPet' => SwagPet.getExample() 'body' => SwagPet.getExample()
}; };
try { try {
@ -45,7 +47,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**swagPet** | [**SwagPet**](SwagPet.md)| Pet object that needs to be added to the store | **body** | [**SwagPet**](Pet.md)| Pet object that needs to be added to the store |
### Return type ### Return type
@ -57,8 +59,8 @@ null (empty response body)
### HTTP request headers ### HTTP request headers
- **Content-Type**: application/json, application/xml - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="deletePet"></a> <a name="deletePet"></a>
# **deletePet** # **deletePet**
@ -66,6 +68,8 @@ null (empty response body)
Deletes a pet Deletes a pet
### Example ### Example
```java ```java
SwagPetApi api = new SwagPetApi(); SwagPetApi api = new SwagPetApi();
@ -105,8 +109,8 @@ null (empty response body)
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="findPetsByStatus"></a> <a name="findPetsByStatus"></a>
# **findPetsByStatus** # **findPetsByStatus**
@ -154,8 +158,8 @@ Name | Type | Description | Notes
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json
<a name="findPetsByTags"></a> <a name="findPetsByTags"></a>
# **findPetsByTags** # **findPetsByTags**
@ -175,7 +179,7 @@ Swagger.OAuth petstore_auth = (Swagger.OAuth) client.getAuthentication('petstore
petstore_auth.setAccessToken('YOUR ACCESS TOKEN'); petstore_auth.setAccessToken('YOUR ACCESS TOKEN');
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'tags' => new List<String>{'\'aeiou\''} 'tags' => new List<String>{'aeiou'}
}; };
try { try {
@ -203,8 +207,8 @@ Name | Type | Description | Notes
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json
<a name="getPetById"></a> <a name="getPetById"></a>
# **getPetById** # **getPetById**
@ -252,15 +256,17 @@ Name | Type | Description | Notes
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json
<a name="updatePet"></a> <a name="updatePet"></a>
# **updatePet** # **updatePet**
> updatePet(swagPet) > updatePet(body)
Update an existing pet Update an existing pet
### Example ### Example
```java ```java
SwagPetApi api = new SwagPetApi(); SwagPetApi api = new SwagPetApi();
@ -271,7 +277,7 @@ Swagger.OAuth petstore_auth = (Swagger.OAuth) client.getAuthentication('petstore
petstore_auth.setAccessToken('YOUR ACCESS TOKEN'); petstore_auth.setAccessToken('YOUR ACCESS TOKEN');
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'swagPet' => SwagPet.getExample() 'body' => SwagPet.getExample()
}; };
try { try {
@ -286,7 +292,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**swagPet** | [**SwagPet**](SwagPet.md)| Pet object that needs to be added to the store | **body** | [**SwagPet**](Pet.md)| Pet object that needs to be added to the store |
### Return type ### Return type
@ -298,8 +304,8 @@ null (empty response body)
### HTTP request headers ### HTTP request headers
- **Content-Type**: application/json, application/xml - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="updatePetWithForm"></a> <a name="updatePetWithForm"></a>
# **updatePetWithForm** # **updatePetWithForm**
@ -307,6 +313,8 @@ null (empty response body)
Updates a pet in the store with form data Updates a pet in the store with form data
### Example ### Example
```java ```java
SwagPetApi api = new SwagPetApi(); SwagPetApi api = new SwagPetApi();
@ -349,7 +357,7 @@ null (empty response body)
### HTTP request headers ### HTTP request headers
- **Content-Type**: application/x-www-form-urlencoded - **Content-Type**: application/x-www-form-urlencoded
- **Accept**: Not defined - **Accept**: application/json
<a name="uploadFile"></a> <a name="uploadFile"></a>
# **uploadFile** # **uploadFile**
@ -357,6 +365,8 @@ null (empty response body)
uploads an image uploads an image
### Example ### Example
```java ```java
SwagPetApi api = new SwagPetApi(); SwagPetApi api = new SwagPetApi();
@ -399,6 +409,6 @@ Name | Type | Description | Notes
### HTTP request headers ### HTTP request headers
- **Content-Type**: multipart/form-data - **Content-Type**: application/x-www-form-urlencoded
- **Accept**: application/json - **Accept**: application/json

24
samples/client/petstore/apex/docs/SwagStoreApi.md
View File

@ -50,8 +50,8 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="getInventory"></a> <a name="getInventory"></a>
# **getInventory** # **getInventory**
@ -84,7 +84,7 @@ This endpoint does not need any parameter.
### Return type ### Return type
**Map&lt;String, Integer&gt;** [**Map&lt;String, Integer&gt;**](Map.md)
### Authorization ### Authorization
@ -92,7 +92,7 @@ This endpoint does not need any parameter.
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/json - **Accept**: application/json
<a name="getOrderById"></a> <a name="getOrderById"></a>
@ -136,21 +136,23 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json
<a name="placeOrder"></a> <a name="placeOrder"></a>
# **placeOrder** # **placeOrder**
> SwagOrder placeOrder(swagOrder) > SwagOrder placeOrder(body)
Place an order for a pet Place an order for a pet
### Example ### Example
```java ```java
SwagStoreApi api = new SwagStoreApi(); SwagStoreApi api = new SwagStoreApi();
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'swagOrder' => SwagOrder.getExample() 'body' => SwagOrder.getExample()
}; };
try { try {
@ -166,7 +168,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**swagOrder** | [**SwagOrder**](SwagOrder.md)| order placed for purchasing the pet | **body** | [**SwagOrder**](Order.md)| order placed for purchasing the pet |
### Return type ### Return type
@ -178,6 +180,6 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json

66
samples/client/petstore/apex/docs/SwagUserApi.md
View File

@ -16,7 +16,7 @@ Method | HTTP request | Description
<a name="createUser"></a> <a name="createUser"></a>
# **createUser** # **createUser**
> createUser(swagUser) > createUser(body)
Create user Create user
@ -27,7 +27,7 @@ This can only be done by the logged in user.
SwagUserApi api = new SwagUserApi(); SwagUserApi api = new SwagUserApi();
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'swagUser' => SwagUser.getExample() 'body' => SwagUser.getExample()
}; };
try { try {
@ -42,7 +42,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**swagUser** | [**SwagUser**](SwagUser.md)| Created user object | **body** | [**SwagUser**](User.md)| Created user object |
### Return type ### Return type
@ -54,21 +54,23 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="createUsersWithArrayInput"></a> <a name="createUsersWithArrayInput"></a>
# **createUsersWithArrayInput** # **createUsersWithArrayInput**
> createUsersWithArrayInput(swagUser) > createUsersWithArrayInput(body)
Creates list of users with given input array Creates list of users with given input array
### Example ### Example
```java ```java
SwagUserApi api = new SwagUserApi(); SwagUserApi api = new SwagUserApi();
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'swagUser' => new List<SwagUser>{SwagUser.getExample()} 'body' => new List<SwagUser>{SwagUser.getExample()}
}; };
try { try {
@ -83,7 +85,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**swagUser** | [**List&lt;SwagUser&gt;**](List.md)| List of user object | **body** | [**List&lt;SwagUser&gt;**](SwagUser.md)| List of user object |
### Return type ### Return type
@ -95,21 +97,23 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="createUsersWithListInput"></a> <a name="createUsersWithListInput"></a>
# **createUsersWithListInput** # **createUsersWithListInput**
> createUsersWithListInput(swagUser) > createUsersWithListInput(body)
Creates list of users with given input array Creates list of users with given input array
### Example ### Example
```java ```java
SwagUserApi api = new SwagUserApi(); SwagUserApi api = new SwagUserApi();
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'swagUser' => new List<SwagUser>{SwagUser.getExample()} 'body' => new List<SwagUser>{SwagUser.getExample()}
}; };
try { try {
@ -124,7 +128,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**swagUser** | [**List&lt;SwagUser&gt;**](List.md)| List of user object | **body** | [**List&lt;SwagUser&gt;**](SwagUser.md)| List of user object |
### Return type ### Return type
@ -136,8 +140,8 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="deleteUser"></a> <a name="deleteUser"></a>
# **deleteUser** # **deleteUser**
@ -179,8 +183,8 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="getUserByName"></a> <a name="getUserByName"></a>
# **getUserByName** # **getUserByName**
@ -188,6 +192,8 @@ No authorization required
Get user by user name Get user by user name
### Example ### Example
```java ```java
SwagUserApi api = new SwagUserApi(); SwagUserApi api = new SwagUserApi();
@ -221,8 +227,8 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json
<a name="loginUser"></a> <a name="loginUser"></a>
# **loginUser** # **loginUser**
@ -230,6 +236,8 @@ No authorization required
Logs user into the system Logs user into the system
### Example ### Example
```java ```java
SwagUserApi api = new SwagUserApi(); SwagUserApi api = new SwagUserApi();
@ -265,8 +273,8 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: application/xml, application/json - **Accept**: application/json
<a name="logoutUser"></a> <a name="logoutUser"></a>
# **logoutUser** # **logoutUser**
@ -274,6 +282,8 @@ No authorization required
Logs out current logged in user session Logs out current logged in user session
### Example ### Example
```java ```java
SwagUserApi api = new SwagUserApi(); SwagUserApi api = new SwagUserApi();
@ -299,12 +309,12 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json
<a name="updateUser"></a> <a name="updateUser"></a>
# **updateUser** # **updateUser**
> updateUser(username, swagUser) > updateUser(username, body)
Updated user Updated user
@ -316,7 +326,7 @@ SwagUserApi api = new SwagUserApi();
Map<String, Object> params = new Map<String, Object>{ Map<String, Object> params = new Map<String, Object>{
'username' => 'username_example', 'username' => 'username_example',
'swagUser' => SwagUser.getExample() 'body' => SwagUser.getExample()
}; };
try { try {
@ -332,7 +342,7 @@ try {
Name | Type | Description | Notes Name | Type | Description | Notes
------------- | ------------- | ------------- | ------------- ------------- | ------------- | ------------- | -------------
**username** | **String**| name that need to be deleted | **username** | **String**| name that need to be deleted |
**swagUser** | [**SwagUser**](SwagUser.md)| Updated user object | **body** | [**SwagUser**](User.md)| Updated user object |
### Return type ### Return type
@ -344,6 +354,6 @@ No authorization required
### HTTP request headers ### HTTP request headers
- **Content-Type**: Not defined - **Content-Type**: application/json
- **Accept**: Not defined - **Accept**: application/json

10
samples/client/petstore/apex/force-app/main/default/classes/SwagApiResponse.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */
@ -42,9 +42,9 @@ public class SwagApiResponse implements Swagger.MappedProperties {
public static SwagApiResponse getExample() { public static SwagApiResponse getExample() {
SwagApiResponse apiResponse = new SwagApiResponse(); SwagApiResponse apiResponse = new SwagApiResponse();
apiResponse.code = ; apiResponse.code = 0;
apiResponse.r_type = 'aeiou'; apiResponse.r_type = '';
apiResponse.message = 'aeiou'; apiResponse.message = '';
return apiResponse; return apiResponse;
} }

2
samples/client/petstore/apex/force-app/main/default/classes/SwagApiResponse.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

6
samples/client/petstore/apex/force-app/main/default/classes/SwagCategory.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */
@ -29,7 +29,7 @@ public class SwagCategory {
public static SwagCategory getExample() { public static SwagCategory getExample() {
SwagCategory category = new SwagCategory(); SwagCategory category = new SwagCategory();
category.id = 123456789L; category.id = 123456789L;
category.name = 'aeiou'; category.name = '';
return category; return category;
} }

2
samples/client/petstore/apex/force-app/main/default/classes/SwagCategory.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

2
samples/client/petstore/apex/force-app/main/default/classes/SwagClient.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

6
samples/client/petstore/apex/force-app/main/default/classes/SwagOrder.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */
@ -67,7 +67,7 @@ public class SwagOrder {
SwagOrder order = new SwagOrder(); SwagOrder order = new SwagOrder();
order.id = 123456789L; order.id = 123456789L;
order.petId = 123456789L; order.petId = 123456789L;
order.quantity = ; order.quantity = 0;
order.shipDate = Datetime.newInstanceGmt(2000, 1, 23, 4, 56, 7); order.shipDate = Datetime.newInstanceGmt(2000, 1, 23, 4, 56, 7);
order.status = StatusEnum.PLACED; order.status = StatusEnum.PLACED;
order.complete = true; order.complete = true;

2
samples/client/petstore/apex/force-app/main/default/classes/SwagOrder.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

10
samples/client/petstore/apex/force-app/main/default/classes/SwagPet.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */
@ -67,10 +67,10 @@ public class SwagPet {
public static SwagPet getExample() { public static SwagPet getExample() {
SwagPet pet = new SwagPet(); SwagPet pet = new SwagPet();
pet.id = 123456789L; pet.id = 123456789L;
pet.category = SwagCategory.getExample();
pet.name = 'doggie'; pet.name = 'doggie';
pet.photoUrls = new List<String>{'aeiou'}; pet.photoUrls = new List<String>{''};
pet.tags = new List<SwagTag>{SwagTag.getExample()}; pet.tags = new List<SwagTag>{null};
pet.status = StatusEnum.AVAILABLE; pet.status = StatusEnum.AVAILABLE;
return pet; return pet;
} }

2
samples/client/petstore/apex/force-app/main/default/classes/SwagPet.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

4
samples/client/petstore/apex/force-app/main/default/classes/SwagPetApi.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */

2
samples/client/petstore/apex/force-app/main/default/classes/SwagPetApi.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

4
samples/client/petstore/apex/force-app/main/default/classes/SwagStoreApi.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */

2
samples/client/petstore/apex/force-app/main/default/classes/SwagStoreApi.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

6
samples/client/petstore/apex/force-app/main/default/classes/SwagTag.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */
@ -29,7 +29,7 @@ public class SwagTag {
public static SwagTag getExample() { public static SwagTag getExample() {
SwagTag tag = new SwagTag(); SwagTag tag = new SwagTag();
tag.id = 123456789L; tag.id = 123456789L;
tag.name = 'aeiou'; tag.name = '';
return tag; return tag;
} }

2
samples/client/petstore/apex/force-app/main/default/classes/SwagTag.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

18
samples/client/petstore/apex/force-app/main/default/classes/SwagUser.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */
@ -65,13 +65,13 @@ public class SwagUser {
public static SwagUser getExample() { public static SwagUser getExample() {
SwagUser user = new SwagUser(); SwagUser user = new SwagUser();
user.id = 123456789L; user.id = 123456789L;
user.username = 'aeiou'; user.username = '';
user.firstName = 'aeiou'; user.firstName = '';
user.lastName = 'aeiou'; user.lastName = '';
user.email = 'aeiou'; user.email = '';
user.password = 'aeiou'; user.password = '';
user.phone = 'aeiou'; user.phone = '';
user.userStatus = ; user.userStatus = 0;
return user; return user;
} }

2
samples/client/petstore/apex/force-app/main/default/classes/SwagUser.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

4
samples/client/petstore/apex/force-app/main/default/classes/SwagUserApi.cls
View File

@ -5,8 +5,8 @@
* OpenAPI spec version: 1.0.0 * OpenAPI spec version: 1.0.0
* *
* *
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech). * NOTE: This class is auto generated by the swagger code generator program.
* https://openapi-generator.tech * https://github.com/swagger-api/swagger-codegen.git
* Do not edit the class manually. * Do not edit the class manually.
*/ */

2
samples/client/petstore/apex/force-app/main/default/classes/SwagUserApi.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

6
samples/client/petstore/apex/force-app/main/default/classes/Swagger.cls
View File

@ -271,9 +271,7 @@ public class Swagger {
@TestVisible @TestVisible
protected virtual void applyAuthentication(List<String> names, Map<String, Object> headers, protected virtual void applyAuthentication(List<String> names, Map<String, Object> headers,
List<Param> query) { List<Param> query) {
for (Authentication auth : getAuthMethods(names)) { // TODO Check auth methods
auth.apply(headers, query);
}
} }
@TestVisible @TestVisible
@ -298,7 +296,7 @@ public class Swagger {
protected virtual String toEndpoint(String path, Map<String, Object> params, protected virtual String toEndpoint(String path, Map<String, Object> params,
List<Param> queryParams) { List<Param> queryParams) {
String query = '?' + paramsToString(queryParams); String query = '?' + paramsToString(queryParams);
return '"callout:' + calloutName + toPath(path, params) + query.removeEnd('?') + '""'; return 'callout:' + calloutName + toPath(path, params) + query.removeEnd('?');
} }
@TestVisible @TestVisible

2
samples/client/petstore/apex/force-app/main/default/classes/Swagger.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

2
samples/client/petstore/apex/force-app/main/default/classes/SwaggerResponseMock.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

5
samples/client/petstore/apex/force-app/main/default/classes/SwaggerTest.cls
View File

@ -292,7 +292,7 @@ private class SwaggerTest {
new Swagger.Param('foo', 'bar'), new Swagger.Param('foo', 'bar'),
new Swagger.Param('bat', '123') new Swagger.Param('bat', '123')
}; };
String expected = 'https://www.mccombs.utexas.edu/departments/finance?foo=bar&bat=123'; String expected = 'callout:Winkelmeyer/departments/finance?foo=bar&bat=123';
String actual = client.toEndpoint(path, params, queryParams); String actual = client.toEndpoint(path, params, queryParams);
System.assertEquals(expected, actual); System.assertEquals(expected, actual);
} }
@ -360,7 +360,8 @@ private class SwaggerTest {
private class MockApiClient extends Swagger.ApiClient { private class MockApiClient extends Swagger.ApiClient {
public MockApiClient() { public MockApiClient() {
basePath = 'https://www.mccombs.utexas.edu'; basePath = 'https://blog.winkelmeyer.com';
calloutName = 'Winkelmeyer';
} }
} }
} }

2
samples/client/petstore/apex/force-app/main/default/classes/SwaggerTest.cls-meta.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata"> <ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>39.0</apiVersion> <apiVersion>42.0</apiVersion>
<status>Active</status> <status>Active</status>
</ApexClass> </ApexClass>

0
samples/client/petstore/apex/force-app/main/default/namedCredentials/OpenAPI_Petstore.namedCredential → samples/client/petstore/apex/force-app/main/default/namedCredentials/OpenAPI_Petstore.namedCredential-meta.xml
View File

7
samples/client/petstore/apex/force-app/main/default/namedCredentials/Swagger_Petstore.namedCredential-meta.xml Normal file
View File

@ -0,0 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<NamedCredential xmlns="http://soap.sforce.com/2006/04/metadata">
<endpoint>http://petstore.swagger.io/v2</endpoint>
<principalType>Anonymous</principalType>
<protocol>NoAuthentication</protocol>
<label>Swagger_Petstore</label>
</NamedCredential>

11
samples/client/petstore/apex/sfdx-project.json Normal file
View File

@ -0,0 +1,11 @@
{
"packageDirectories": [
{
"path": "force-app",
"default": true
}
],
"namespace": "",
"sfdcLoginUrl": "https://login.salesforce.com",
"sourceApiVersion": "42.0"
}