org.jsonschema2pojo.rules.PropertyRule Maven / Gradle / Ivy
/**
* Copyright © 2010-2017 Nokia
*
* 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.jsonschema2pojo.rules;
import com.fasterxml.jackson.databind.JsonNode;
import com.sun.codemodel.*;
import org.jsonschema2pojo.GenerationConfig;
import org.jsonschema2pojo.Schema;
import static org.apache.commons.lang3.StringUtils.capitalize;
/**
* Applies the schema rules that represent a property definition.
*
* @see http:/
* /tools.ietf.org/html/draft-zyp-json-schema-03#section-5.2
*/
public class PropertyRule implements Rule {
private final RuleFactory ruleFactory;
protected PropertyRule(RuleFactory ruleFactory) {
this.ruleFactory = ruleFactory;
}
/**
* Applies this schema rule to take the required code generation steps.
*
* This rule adds a property to a given Java class according to the Java
* Bean spec. A private field is added to the class, along with accompanying
* accessor methods.
*
* If this rule's schema mapper is configured to include builder methods
* (see {@link GenerationConfig#isGenerateBuilders()} ),
* then a builder method of the form withFoo(Foo foo); is also
* added.
*
* @param nodeName the name of the property to be applied
* @param node the node describing the characteristics of this property
* @param jclass the Java class which should have this property added
* @return the given jclass
*/
@Override
public JDefinedClass apply(String nodeName, JsonNode node, JDefinedClass jclass, Schema schema) {
String propertyName = ruleFactory.getNameHelper().getPropertyName(nodeName, node);
JType propertyType = ruleFactory.getSchemaRule().apply(nodeName, node, jclass, schema);
boolean isIncludeAccessors = ruleFactory.getGenerationConfig().isIncludeAccessors();
boolean isIncludeGetters = ruleFactory.getGenerationConfig().isIncludeGetters();
boolean isIncludeSetters = ruleFactory.getGenerationConfig().isIncludeSetters();
node = resolveRefs(node, schema);
int accessModifier = isIncludeAccessors || isIncludeGetters || isIncludeSetters ? JMod.PRIVATE : JMod.PUBLIC;
JFieldVar field = jclass.field(accessModifier, propertyType, propertyName);
propertyAnnotations(nodeName, node, schema, field);
formatAnnotation(field, node);
ruleFactory.getAnnotator().propertyField(field, jclass, nodeName, node);
if (isIncludeAccessors || isIncludeGetters) {
JMethod getter = addGetter(jclass, field, nodeName, node, isRequired(nodeName, node, schema));
ruleFactory.getAnnotator().propertyGetter(getter, nodeName);
propertyAnnotations(nodeName, node, schema, getter);
}
if (isIncludeAccessors || isIncludeSetters) {
JMethod setter = addSetter(jclass, field, nodeName, node);
ruleFactory.getAnnotator().propertySetter(setter, nodeName);
propertyAnnotations(nodeName, node, schema, setter);
}
if (ruleFactory.getGenerationConfig().isGenerateBuilders()) {
addBuilder(jclass, field);
}
if (node.has("pattern")) {
ruleFactory.getPatternRule().apply(nodeName, node.get("pattern"), field, schema);
}
ruleFactory.getDefaultRule().apply(nodeName, node.get("default"), field, schema);
ruleFactory.getMinimumMaximumRule().apply(nodeName, node, field, schema);
ruleFactory.getMinItemsMaxItemsRule().apply(nodeName, node, field, schema);
ruleFactory.getMinLengthMaxLengthRule().apply(nodeName, node, field, schema);
if (isObject(node) || isArray(node)) {
ruleFactory.getValidRule().apply(nodeName, node, field, schema);
}
return jclass;
}
private boolean isRequired(String nodeName, JsonNode node, Schema schema) {
if (node.has("required")) {
final JsonNode requiredNode = node.get("required");
return requiredNode.asBoolean();
}
JsonNode requiredArray = schema.getContent().get("required");
if (requiredArray != null) {
for (JsonNode requiredNode : requiredArray) {
if (nodeName.equals(requiredNode.asText()))
return true;
}
}
return false;
}
private void propertyAnnotations(String nodeName, JsonNode node, Schema schema, JDocCommentable generatedJavaConstruct) {
if (node.has("title")) {
ruleFactory.getTitleRule().apply(nodeName, node.get("title"), generatedJavaConstruct, schema);
}
if (node.has("javaName")) {
ruleFactory.getJavaNameRule().apply(nodeName, node.get("javaName"), generatedJavaConstruct, schema);
}
if (node.has("description")) {
ruleFactory.getDescriptionRule().apply(nodeName, node.get("description"), generatedJavaConstruct, schema);
}
if (node.has("required")) {
ruleFactory.getRequiredRule().apply(nodeName, node.get("required"), generatedJavaConstruct, schema);
} else {
ruleFactory.getNotRequiredRule().apply(nodeName, node.get("required"), generatedJavaConstruct, schema);
}
}
private void formatAnnotation(JFieldVar field, JsonNode node) {
String format = node.path("format").asText();
if ("date-time".equalsIgnoreCase(format)) {
ruleFactory.getAnnotator().dateTimeField(field, node);
} else if ("date".equalsIgnoreCase(format)) {
ruleFactory.getAnnotator().dateField(field, node);
} else if ("time".equalsIgnoreCase(format)) {
ruleFactory.getAnnotator().timeField(field, node);
}
}
private JsonNode resolveRefs(JsonNode node, Schema parent) {
if (node.has("$ref")) {
Schema refSchema = ruleFactory.getSchemaStore().create(parent, node.get("$ref").asText(), ruleFactory.getGenerationConfig().getRefFragmentPathDelimiters());
JsonNode refNode = refSchema.getContent();
return resolveRefs(refNode, parent);
} else {
return node;
}
}
private boolean isObject(JsonNode node) {
return node.path("type").asText().equals("object");
}
private boolean isArray(JsonNode node) {
return node.path("type").asText().equals("array");
}
private JType getReturnType(final JDefinedClass c, final JFieldVar field, final boolean required) {
JType returnType = field.type();
if (ruleFactory.getGenerationConfig().isUseOptionalForGetters()) {
if (!required && field.type().isReference()) {
returnType = c.owner().ref("java.util.Optional").narrow(field.type());
}
}
return returnType;
}
private JMethod addGetter(JDefinedClass c, JFieldVar field, String jsonPropertyName, JsonNode node, boolean isRequired) {
JType type = getReturnType(c, field, isRequired);
JMethod getter = c.method(JMod.PUBLIC, type, getGetterName(jsonPropertyName, field.type(), node));
JBlock body = getter.body();
if (ruleFactory.getGenerationConfig().isUseOptionalForGetters() && !isRequired
&& field.type().isReference()) {
body._return(c.owner().ref("java.util.Optional").staticInvoke("ofNullable").arg(field));
} else {
body._return(field);
}
return getter;
}
private JMethod addSetter(JDefinedClass c, JFieldVar field, String jsonPropertyName, JsonNode node) {
JMethod setter = c.method(JMod.PUBLIC, void.class, getSetterName(jsonPropertyName, node));
JVar param = setter.param(field.type(), field.name());
JBlock body = setter.body();
body.assign(JExpr._this().ref(field), param);
return setter;
}
private JMethod addBuilder(JDefinedClass c, JFieldVar field) {
JMethod builder = c.method(JMod.PUBLIC, c, getBuilderName(field.name()));
JVar param = builder.param(field.type(), field.name());
JBlock body = builder.body();
body.assign(JExpr._this().ref(field), param);
body._return(JExpr._this());
return builder;
}
private String getBuilderName(String propertyName) {
propertyName = ruleFactory.getNameHelper().replaceIllegalCharacters(propertyName);
return "with" + capitalize(ruleFactory.getNameHelper().capitalizeTrailingWords(propertyName));
}
private String getSetterName(String propertyName, JsonNode node) {
return ruleFactory.getNameHelper().getSetterName(propertyName, node);
}
private String getGetterName(String propertyName, JType type, JsonNode node) {
return ruleFactory.getNameHelper().getGetterName(propertyName, type, node);
}
}