All Downloads are FREE. Search and download functionalities are using the official Maven repository.
Please wait. This can take some minutes ...
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
com.reprezen.kaizen.oasparser.val3.ParameterValidator Maven / Gradle / Ivy
/*******************************************************************************
* Copyright (c) 2017 ModelSolv, Inc. and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* ModelSolv, Inc. - initial API and implementation and/or initial documentation
*******************************************************************************/
package com.reprezen.kaizen.oasparser.val3;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_allowEmptyValue;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_contentMediaTypes;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_deprecated;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_description;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_example;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_examples;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_explode;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_in;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_name;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_schema;
import static com.reprezen.kaizen.oasparser.ovl3.ParameterImpl.F_style;
import static com.reprezen.kaizen.oasparser.val.msg.Messages.msg;
import static com.reprezen.kaizen.oasparser.val3.OpenApi3Messages.PathParamReq;
import java.util.Map;
import com.reprezen.jsonoverlay.Overlay;
import com.reprezen.jsonoverlay.PropertiesOverlay;
import com.reprezen.kaizen.oasparser.model3.Example;
import com.reprezen.kaizen.oasparser.model3.MediaType;
import com.reprezen.kaizen.oasparser.model3.Parameter;
import com.reprezen.kaizen.oasparser.model3.Path;
import com.reprezen.kaizen.oasparser.model3.Schema;
import com.reprezen.kaizen.oasparser.val.ObjectValidatorBase;
public class ParameterValidator extends ObjectValidatorBase {
@Override
public void runObjectValidations() {
Parameter parameter = (Parameter) value.getOverlay();
validateStringField(F_description, false);
validateBooleanField(F_deprecated, false);
validateBooleanField(F_allowEmptyValue, false);
validateBooleanField(F_explode, false);
Overlay example = validateField(F_example, false, Object.class, null);
Overlay> examples = validateMapField(F_examples, false, false, Example.class,
new ExampleValidator());
checkExampleExclusion(examples, example);
validateStringField(F_name, true);
validateStringField(F_in, true, Regexes.PARAM_IN_REGEX);
checkPathParam(parameter);
checkRequired(parameter);
validateStringField(F_style, false, Regexes.STYLE_REGEX);
checkAllowReserved(parameter);
// TODO Q: Should schema be required in parameter object?
validateField(F_schema, false, Schema.class, new SchemaValidator());
validateMapField(F_contentMediaTypes, false, false, MediaType.class, new MediaTypeValidator());
validateExtensions(parameter.getExtensions());
}
private void checkPathParam(Parameter parameter) {
if (parameter.getIn() != null && parameter.getIn().equals("path") && parameter.getName() != null) {
String path = getPathString(parameter);
if (path != null) {
if (!path.matches(".*\\{" + parameter.getName() + "\\}(.*)?")) {
results.addError(msg(OpenApi3Messages.MissingPathTplt, parameter.getName(), path), value);
}
}
}
}
private void checkRequired(Parameter parameter) {
if ("path".equals(parameter.getIn())) {
if (parameter.getRequired() != Boolean.TRUE) {
results.addError(msg(PathParamReq, parameter.getName()), value);
}
}
}
private void checkAllowReserved(Parameter parameter) {
if (parameter.isAllowReserved() && !"query".equals(parameter.getIn())) {
results.addWarning(msg(OpenApi3Messages.NonQryAllowRsvd, parameter.getName(), parameter.getIn()), value);
}
}
private String getPathString(Parameter parameter) {
PropertiesOverlay> parent = Overlay.of(parameter).getParentPropertiesOverlay();
while (parent != null && !(parent instanceof Path)) {
parent = Overlay.of(parent).getParentPropertiesOverlay();
}
return parent != null && parent instanceof Path ? Overlay.getPathInParent(parent) : null;
}
void checkExampleExclusion(Overlay> examples, Overlay example) {
boolean examplesPresent = examples != null && examples.isPresent()
&& Overlay.getMapOverlay(examples).size() > 0;
boolean examplePresent = example != null && example.isPresent();
if (examplesPresent && examplePresent) {
results.addError("ExmplExclusion|The 'example' and 'exmaples' properties may not both appear", value);
}
}
}