com.googlecode.jsonschema2pojo.rules.RuleFactory Maven / Gradle / Ivy
/**
* Copyright © 2010-2011 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 com.googlecode.jsonschema2pojo.rules;
import com.googlecode.jsonschema2pojo.Annotator;
import com.googlecode.jsonschema2pojo.DefaultGenerationConfig;
import com.googlecode.jsonschema2pojo.GenerationConfig;
import com.googlecode.jsonschema2pojo.Jackson2Annotator;
import com.googlecode.jsonschema2pojo.SchemaStore;
import com.sun.codemodel.JClass;
import com.sun.codemodel.JClassContainer;
import com.sun.codemodel.JDefinedClass;
import com.sun.codemodel.JDocComment;
import com.sun.codemodel.JDocCommentable;
import com.sun.codemodel.JFieldVar;
import com.sun.codemodel.JPackage;
import com.sun.codemodel.JType;
/**
* Provides factory/creation methods for the code generation rules.
*/
public class RuleFactory {
private final GenerationConfig generationConfig;
private final Annotator annotator;
private final SchemaStore schemaStore;
private final NameHelper nameHelper;
/**
* Create a new rule factory with the given generation config options.
*
* @param generationConfig
* The generation config options for type generation. These
* config options will influence the java code generated by rules
* created by this factory.
* @param annotator
* the annotator used to mark up Java types with any annotations
* that are required to build JSON compatible types
* @param schemaStore
* the object used by this factory to get and store schemas
*/
public RuleFactory(GenerationConfig generationConfig, Annotator annotator, SchemaStore schemaStore) {
this.generationConfig = generationConfig;
this.annotator = annotator;
this.schemaStore = schemaStore;
this.nameHelper = new NameHelper(generationConfig);
}
/**
* Create a rule factory with the default generation config options.
*
* @see DefaultGenerationConfig
*/
public RuleFactory() {
this(new DefaultGenerationConfig(), new Jackson2Annotator(), new SchemaStore());
}
/**
* Provides a rule instance that should be applied when an "array"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "array" declaration.
*/
public SchemaRule getArrayRule() {
return new ArrayRule(this);
}
/**
* Provides a rule instance that should be applied when a "description"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "description" declaration.
*/
public SchemaRule getDescriptionRule() {
return new DescriptionRule();
}
/**
* Provides a rule instance that should be applied when an "enum"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "enum" declaration.
*/
public SchemaRule getEnumRule() {
return new EnumRule(this);
}
/**
* Provides a rule instance that should be applied when a "format"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "format" declaration.
*/
public SchemaRule getFormatRule() {
return new FormatRule(this);
}
/**
* Provides a rule instance that should be applied when an "object"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "object" declaration.
*/
public SchemaRule getObjectRule() {
return new ObjectRule(this);
}
/**
* Provides a rule instance that should be applied when a "properties"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "properties" declaration.
*/
public SchemaRule getPropertiesRule() {
return new PropertiesRule(this);
}
/**
* Provides a rule instance that should be applied when a property
* declaration (child of the "properties" declaration) is found in the
* schema.
*
* @return a schema rule that can handle a property declaration.
*/
public SchemaRule getPropertyRule() {
return new PropertyRule(this);
}
/**
* Provides a rule instance that should be applied when a "required"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "required" declaration.
*/
public SchemaRule getRequiredRule() {
return new RequiredRule(this);
}
/**
* Provides a rule instance that should be applied to a node to find its
* equivalent Java type. Typically invoked for properties, arrays, etc for
* which a Java type must be found/generated.
*
* @return a schema rule that can find/generate the relevant Java type for a
* given schema node.
*/
public SchemaRule getTypeRule() {
return new TypeRule(this);
}
/**
* Provides a rule instance that should be applied when an
* "additionalProperties" declaration is found in the schema.
*
* @return a schema rule that can handle the "additionalProperties"
* declaration.
*/
public SchemaRule getAdditionalPropertiesRule() {
return new AdditionalPropertiesRule(this);
}
/**
* Provides a rule instance that should be applied when a "title"
* declaration is found in the schema.
*
* @return a schema rule that can handle the "title" declaration.
*/
public SchemaRule getTitleRule() {
return new TitleRule();
}
/**
* Provides a rule instance that should be applied when a schema declaration
* is found in the schema.
*
* @return a schema rule that can handle a schema declaration.
*/
public SchemaRule getSchemaRule() {
return new JsonSchemaRule(this);
}
/**
* Provides a rule instance that should be applied when a property
* declaration is found in the schema to assign any appropriate default
* value to that property.
*
* @return a schema rule that can handle the "default" declaration.
*/
public SchemaRule getDefaultRule() {
return new DefaultRule();
}
/**
* Provides a rule instance that should be applied when a property
* declaration is found in the schema, to assign any minimum/maximum
* validation on that property
*
* @return a schema rule that can handle the "default" declaration.
*/
public SchemaRule getMinimumMaximumRule() {
return new MinimumMaximumRule(this);
}
/**
* Provides a rule instance that should be applied when a property
* declaration is found in the schema, to assign any size validation
* (minItems/maxItems) on that property
*
* @return a schema rule that can handle the "default" declaration.
*/
public SchemaRule getMinItemsMaxItemsRule() {
return new MinItemsMaxItemsRule(this);
}
/**
* Provides a rule instance that should be applied when a "pattern"
* declaration is found in the schema for a property.
*
* @return a schema rule that can handle the "pattern" declaration.
*/
public SchemaRule getPatternRule() {
return new PatternRule(this);
}
/**
* Gets the configuration options that will influence the java code
* generated by rules created by this factory.
*
* @return A configuration object containing all configuration property
* values.
*/
public GenerationConfig getGenerationConfig() {
return generationConfig;
}
/**
* Gets the annotator that will in apply annotations to the generated code
* to allow correct serialization and deserialization, according to the
* chosen annotation style.
*
* @return an annotator that can annotate various code constructs for JSON
* support
*/
public Annotator getAnnotator() {
return annotator;
}
/**
* Gets the store that finds and saves JSON schemas
*
* @return a store that finds and caches schema objects during type
* generation.
*/
public SchemaStore getSchemaStore() {
return schemaStore;
}
/**
* Gets the name helper that is used to generate normalized Class and field
* names.
*
* @return a name helper instance that can be used to normalize Class and
* field names.
*/
public NameHelper getNameHelper() {
return nameHelper;
}
}