Skip to content

I
ibizlab-generator
提交 c9a5c76c 编写于 作者: sq3536's avatar sq3536
浏览文件
操作

move

上级 9bd67ac8
隐藏空白字符变更
内嵌 并排
正在显示 包含 23 行增加 和 3574 行删除
modules/ibizlab-generator-cli/pom.xml
浏览文件 @ c9a5c76c
......@@ -85,7 +85,7 @@
<dependency>
<groupId>com.ibizlab</groupId>
<artifactId>ibizlab-generator</artifactId>
<artifactId>ibizlab-generator-core</artifactId>
<version>${project.version}</version>
<exclusions>
<exclusion>
......
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/DefaultGenerator.java → modules/ibizlab-generator-core/src/main/java/com/ibizlab/codegen/DefaultGenerator.java
浏览文件 @ c9a5c76c
......@@ -56,7 +56,6 @@ public class DefaultGenerator implements Generator {
private final boolean dryRun;
protected CodegenConfig config;
protected ClientOptInput opts;
protected CodegenIgnoreProcessor ignoreProcessor;
private Boolean generateApis = null;
private Boolean generateModels = null;
private Boolean generateSupportingFiles = null;
......
modules/ibizlab-generator-core/src/main/java/com/ibizlab/codegen/config/Context.java
浏览文件 @ c9a5c76c
......@@ -19,6 +19,7 @@ package com.ibizlab.codegen.config;
import com.github.mustachejava.DefaultMustacheFactory;
import com.github.mustachejava.Mustache;
import com.github.mustachejava.MustacheFactory;
import com.github.mustachejava.reflect.ReflectionObjectHandler;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
......@@ -31,6 +32,7 @@ import java.io.Writer;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
@Getter
@Setter
......@@ -39,7 +41,12 @@ import java.util.List;
public class Context<TSpecDocument> {
private TSpecDocument specDocument;
private GeneratorSettings generatorSettings;
private static class MapMethodReflectionHandler extends ReflectionObjectHandler {
@Override
protected boolean areMethodsAccessible(Map<?, ?> map) {
return true;
}
}
public static void main(String[] args) throws IOException {
HashMap<String, Object> scopes = new HashMap<String, Object>();
......@@ -52,9 +59,16 @@ public class Context<TSpecDocument> {
list.add("b");
scopes.put("list",list);
Map map=new HashMap();
map.put("01","a01");
map.put("02","a02");
scopes.put("map1",map);
System.out.println(map.entrySet());
Writer writer = new OutputStreamWriter(System.out);
MustacheFactory mf = new DefaultMustacheFactory();
Mustache mustache = mf.compile(new StringReader("{{name}}, {{#list}}{{.}}{{/list}}!"), "example");
DefaultMustacheFactory mf = new DefaultMustacheFactory();
mf.setObjectHandler(new MapMethodReflectionHandler());
Mustache mustache = mf.compile(new StringReader("{{name}}, {{map1.entrySet}}{{#map1.entrySet}}{{key}}{{/map1.entrySet}}!"), "example");
mustache.execute(writer, scopes);
writer.flush();
}
......
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/templating/GeneratorTemplateContentLocator.java → modules/ibizlab-generator-core/src/main/java/com/ibizlab/codegen/templating/GeneratorTemplateContentLocator.java
浏览文件 @ c9a5c76c
......@@ -60,43 +60,18 @@ public class GeneratorTemplateContentLocator implements TemplatePathLocator {
public String getFullTemplatePath(String relativeTemplateFile) {
CodegenConfig config = this.codegenConfig;
//check the supplied template library folder for the file
final String library = config.getLibrary();
if (StringUtils.isNotEmpty(library)) {
//look for the file in the library subfolder of the supplied template
final String libTemplateFile = buildLibraryFilePath(config.templateDir(), library, relativeTemplateFile);
// looks for user-defined file or classpath
// supports template dir which refers to local file system or custom path in classpath as defined by templateDir
if (new File(libTemplateFile).exists() || classpathTemplateExists(libTemplateFile)) {
return libTemplateFile;
}
}
// check the supplied template main folder for the file
// File.separator is necessary here as the file load is OS-specific
final String template = config.templateDir() + File.separator + relativeTemplateFile;
final String template = config.getTemplateDir() + File.separator + relativeTemplateFile;
// looks for user-defined file or classpath
// supports template dir which refers to local file system or custom path in classpath as defined by templateDir
if (new File(template).exists() || classpathTemplateExists(template)) {
return template;
}
//try the embedded template library folder next
if (StringUtils.isNotEmpty(library)) {
final String embeddedLibTemplateFile = buildLibraryFilePath(config.embeddedTemplateDir(), library, relativeTemplateFile);
// *only* looks for those files in classpath as defined by embeddedTemplateDir
if (embeddedTemplateExists(embeddedLibTemplateFile)) {
// Fall back to the template file embedded/packaged in the JAR file library folder...
return embeddedLibTemplateFile;
}
}
// Fall back to the template file for generator root directory embedded/packaged in the JAR file...
String loc = config.embeddedTemplateDir() + File.separator + relativeTemplateFile;
// *only* looks for those files in classpath as defined by embeddedTemplateDir
if (embeddedTemplateExists(loc)) {
return loc;
}
return null;
}
......
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/templating/mustache/CaseFormatLambda.java → modules/ibizlab-generator-core/src/main/java/com/ibizlab/codegen/templating/mustache/CaseFormatLambda.java
浏览文件 @ c9a5c76c
......@@ -40,9 +40,7 @@ public class CaseFormatLambda implements Mustache.Lambda {
@Override
public void execute(Template.Fragment fragment, Writer writer) throws IOException {
String text = initialFormat.converterTo(targetFormat).convert(fragment.execute());
if (generator != null && generator.reservedWords().contains(text)) {
text = generator.escapeReservedWord(text);
}
writer.write(text);
}
}
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/templating/mustache/LowercaseLambda.java → modules/ibizlab-generator-core/src/main/java/com/ibizlab/codegen/templating/mustache/LowercaseLambda.java
浏览文件 @ c9a5c76c
......@@ -53,9 +53,7 @@ public class LowercaseLambda implements Mustache.Lambda {
@Override
public void execute(Template.Fragment fragment, Writer writer) throws IOException {
String text = fragment.execute().toLowerCase(Locale.ROOT);
if (generator != null && generator.reservedWords().contains(text)) {
text = generator.escapeReservedWord(text);
}
writer.write(text);
}
......
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/utils/StringAdvUtils.java → modules/ibizlab-generator-core/src/main/java/com/ibizlab/codegen/utils/StringAdvUtils.java
浏览文件 @ c9a5c76c
......@@ -249,7 +249,7 @@ public class StringAdvUtils {
public static String escape(final String name, final Map<String, String> replacementMap,
final List<String> charactersToAllow, final String appendToReplacement) {
EscapedNameOptions ns = new EscapedNameOptions(name, replacementMap.keySet(), charactersToAllow, appendToReplacement);
return escapedWordsCache.get(ns, wordToEscape -> {
return StringAdvUtils.escapedWordsCache.get(ns, wordToEscape -> {
String result = name.chars().mapToObj(c -> {
String character = String.valueOf((char) c);
if (charactersToAllow != null && charactersToAllow.contains(character)) {
......
modules/ibizlab-generator/pom.xml 已删除 100644 → 0
浏览文件 @ 9bd67ac8
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<parent>
<artifactId>ibizlab-generator-project</artifactId>
<groupId>com.ibizlab</groupId>
<version>1.0-SNAPSHOT</version>
<relativePath>../../pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>
<groupId>com.ibizlab</groupId>
<artifactId>ibizlab-generator</artifactId>
<version>1.0-SNAPSHOT</version>
<name>ibizlab-generator</name>
<dependencies>
<dependency>
<groupId>com.ibizlab</groupId>
<artifactId>ibizlab-generator-core</artifactId>
<version>${project.parent.version}</version>
</dependency>
</dependencies>
</project>
\ No newline at end of file
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/CodegenConfigLoader.java 已删除 100644 → 0
浏览文件 @ 9bd67ac8
/*
* 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
*
* https://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.ibizlab.codegen;
import java.util.ArrayList;
import java.util.List;
import java.util.ServiceLoader;
public class CodegenConfigLoader {
/**
* Tries to load config class with SPI first, then with class name directly from classpath
*
* @param name name of config, or full qualified class name in classpath
* @return config class
*/
public static CodegenConfig forName(String name) {
ServiceLoader<CodegenConfig> loader = ServiceLoader.load(CodegenConfig.class, CodegenConfig.class.getClassLoader());
StringBuilder availableConfigs = new StringBuilder();
for (CodegenConfig config : loader) {
if (config.getName().equals(name)) {
return config;
}
availableConfigs.append(config.getName()).append("\n");
}
// else try to load directly
try {
return (CodegenConfig) Class.forName(name).getDeclaredConstructor().newInstance();
} catch (Exception e) {
throw new GeneratorNotFoundException("Can't load config class with name '".concat(name) + "'\nAvailable:\n" + availableConfigs, e);
}
}
public static List<CodegenConfig> getAll() {
ServiceLoader<CodegenConfig> loader = ServiceLoader.load(CodegenConfig.class, CodegenConfig.class.getClassLoader());
List<CodegenConfig> output = new ArrayList<CodegenConfig>();
for (CodegenConfig aLoader : loader) {
output.add(aLoader);
}
return output;
}
}
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/utils/JsonCache.java 已删除 100644 → 0
浏览文件 @ 9bd67ac8
/*
* Copyright 2019 OpenAPI-Generator Contributors (https://openapi-generator.tech)
*
* 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
*
* https://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.ibizlab.codegen.utils;
import com.fasterxml.jackson.core.JsonPointer;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.JsonNodeType;
import java.io.File;
import java.io.InputStream;
import java.io.OutputStream;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.util.List;
/**
* An interface for querying and mutating a JSON object graph. Clients indicate the location within the graph at which a
* value is to be read or written using a <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer</a> as either a
* string or a <code>JsonPointer</code> instance. The latter is more efficient for repeated access to the same location.
* For the <code>set(ptr|path, value)</code> and <code>getXxx(ptr|path, defaultValue)</code>methods, the cache
* automatically creates missing container elements in the path as either object or array nodes according to whether the
* corresponding path segment is a property name or an integer index respectively, and creates the leaf element as a
* JSON value node of the appropriate type. Existing tree elements identified by a JSON pointer must match the pointer
* segments by type; that is, an existing parent of an integer path segment <b>must</b> be an array node and existing
* parent of a property name path segment <b>must</b> be an object node: if this condition is not met, the method throws
* a {@linkplain CacheException}. Note that it is possible to store the same object at multiple locations
* within the tree (thus converting the tree to a <i>graph</i>), in which case the same object may be retrieved using
* any of the corresponding paths. However, this shared object becomes multiple independent objects when serialised to
* JSON and if subsequently loaded into a cache instance. Such graphs <b>must</b> be acyclic: storing a cyclic graph in
* the tree will cause a stack overflow when the cache is saved. Instances are not guaranteed threadsafe and require
* external synchronisation if mutator methods may be called concurrently from multiple threads. Sparse arrays are not
* supported - all array elements have a value, even if it is null.
* <p>
* <em>N.B. some <code>getXxx()</code> methods can return mutable objects, mutations to which will be unobserved by the
* cache instance, thus compromising the reliability of the <code>flush*()</code> methods. Callers relying on these
* methods should either not mutate such objects or they should call the appropriate <code>set()</code> method
* afterwards to ensure that the cache's 'modified' flag is set.</em>
* </p>
*
* @author Adrian Price, TIBCO Software Inc.
* @since 4.0.0
*/
public interface JsonCache {
/**
* Exception thrown by cache operations. Not intended to be created by client code.
*/
static class CacheException extends Exception {
private static final long serialVersionUID = -1215367978375557620L;
CacheException(String message) {
super(message);
}
CacheException(Throwable cause) {
super(cause);
}
}
/**
* A factory for creating JSON cache root instances.
*/
interface Factory {
/**
* The singleton factory instance.
*/
Factory instance = JsonCacheImpl.FactoryImpl.instance;
/**
* Returns a new cache root instance.
*
* @return A new instance.
*/
Root create();
/**
* Returns the singleton cache root instance for the specified key. The same instance is returned every time the
* method is called with the same <code>key</code> value, being lazily created on the first such call.
*
* @param key The instance key.
* @return The singleton instance for <code>key</code>.
*/
Root get(String key);
}
/**
* Load/merge/save/flush functionality implemented by the root of a JSON cache hierarchy.
*/
interface Root extends JsonCache {
/**
* Describes cache behaviour when a load method is called for a cache instance that is already loaded.
*/
enum MergePolicy {
/**
* Calls to <code>load()</code> methods are ignored when the cache is already loaded.
*/
NO_MERGE,
/**
* Recursively merges the incoming tree into the existing tree, retaining existing leaf properties.
*/
MERGE_RECURSIVE,
/**
* Retains existing root properties, ignoring incoming duplicate properties.
*/
KEEP_EXISTING,
/**
* Overwrites existing root properties with incoming duplicate properties.
*/
OVERWRITE_EXISTING
}
/**
* If the cache is dirty, saves the object graph in JSON format to the specified file.
*
* @param file The output file.
* @return The receiver, to allow chaining.
* @throws CacheException if the root node does not exist or if unable to create or write the file.
* @throws NullPointerException if <code>file</code> is <code>null</code>.
* @see #flushOnShutdown(File)
* @see #save(File)
*/
Root flush(File file) throws CacheException;
/**
* If the cache is dirty, saves the object graph in JSON format to the specified stream.
*
* @param out The output stream, which is closed before the method returns.
* @return The receiver, to allow chaining.
* @throws CacheException if the root node does not exist or if unable to create or write the file.
* @throws NullPointerException if <code>out</code> is <code>null</code>.
* @see #flushOnShutdown(OutputStream)
* @see #save(OutputStream)
*/
Root flush(OutputStream out) throws CacheException;
/**
* Makes a best-effort attempt to ensure that the cache gets flushed to a disk file if dirty on shutdown. The
* call has no additional effect if the shutdown hook has already been registered.
*
* @param file The output file.
* @return The receiver, to allow chaining.
* @throws NullPointerException if <code>file</code> is <code>null</code>.
* @see #save(File)
*/
Root flushOnShutdown(File file);
/**
* Makes a best-effort attempt to ensure that the cache gets flushed to an output stream if dirty on shutdown.
* The call has no additional effect if the shutdown hook has already been registered.
*
* @param out The output stream, which is closed after writing it on shutdown.
* @return The receiver, to allow chaining.
* @throws NullPointerException if <code>out</code> is <code>null</code>.
* @see #save(OutputStream)
*/
Root flushOnShutdown(OutputStream out);
/**
* Returns the mapper used for JSON-object marshalling and serialisation operations. Callers may configure the
* mapper to achieve the desired JSON serialisation format.
*
* @return The mapper.
* @see #mapper(ObjectMapper)
*/
ObjectMapper getMapper();
/**
* Returns the merge policy that applies when <code>load()</code> is called on a cache that is already loaded.
* The default is {@link MergePolicy#MERGE_RECURSIVE};
*
* @return The merge policy.
* @see #mergePolicy(MergePolicy)
*/
MergePolicy getMergePolicy();
/**
* Indicates whether the cached has unsaved changes.
*
* @return <code>true</code> if there are unsaved changes.
*/
boolean isDirty();
/**
* Loads the cache from the specified file. If the cache is already loaded, merges the incoming tree according
* to the current {@link #mergePolicy(MergePolicy) merge policy}. The call has no effect if the file does not
* exist.
*
* @param file The JSON file to load.
* @return The receiver, to allow chaining.
* @throws CacheException if the file exists but could not be read or its content is not valid JSON.
* @throws NullPointerException if <code>file</code> is <code>null</code>.
* @see #save(File)
* @see #save(OutputStream)
* @see #unload()
*/
Root load(File file) throws CacheException;
/**
* Loads the cache from the specified stream. If the cache is already loaded, merges the incoming tree according
* to the current {@link #mergePolicy(MergePolicy) merge policy}.
*
* @param in The input stream from which to load, which is closed before the method returns.
* @return The receiver, to allow chaining.
* @throws CacheException if the stream content is not valid JSON.
* @throws NullPointerException if <code>in</code> is <code>null</code>.
* @see #save(File)
* @see #save(OutputStream)
* @see #unload()
*/
Root load(InputStream in) throws CacheException;
/**
* Sets the mapper to use for JSON-object marshalling and serialisation operations.
*
* @param mapper The new mapper.
* @return The receiver, to allow chaining.
* @throws NullPointerException if <code>mapper</code> is <code>null</code>.
* @see #getMapper()
*/
Root mapper(ObjectMapper mapper);
/**
* Sets the merge policy that applies when <code>load()</code> is called for a cache that is already loaded.
*
* @param policy The merge policy.
* @return The receiver, to allow chaining.
* @throws NullPointerException if <code>policy</code> is null.
* @see #getMergePolicy()
*/
Root mergePolicy(MergePolicy policy);
/**
* Saves the object graph in JSON format to the specified file.
*
* @param file The output file.
* @return The receiver, to allow chaining.
* @throws NullPointerException if <code>file</code> is null.
* @throws CacheException if the root node does not exist or if unable to create or write the file.
*/
Root save(File file) throws CacheException;
/**
* Saves the object graph in JSON format to the specified stream.
*
* @param out The output stream, which is closed before the method returns.
* @return The receiver, to allow chaining.
* @throws NullPointerException if <code>out</code> is null.
* @throws CacheException if the root node does not exist or if unable to create or write the file.
*/
Root save(OutputStream out) throws CacheException;
/**
* Unloads the object graph, setting the root node to <code>null</code>.
*
* @return The receiver, to allow chaining.
* @see #load(File)
* @see #load(InputStream)
*/
Root unload();
}
/**
* Adds a <code>BigDecimal</code> to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, BigDecimal value) throws CacheException;
/**
* Adds a <code>BigInteger</code> to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, BigInteger value) throws CacheException;
/**
* Adds a <code>boolean</code> to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, boolean value) throws CacheException;
/**
* Adds a <code>double</code> value to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, double value) throws CacheException;
/**
* Adds a <code>float</code> value to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, float value) throws CacheException;
/**
* Adds an <code>int</code> value to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, int value) throws CacheException;
/**
* Adds a <code>long</code> value to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, long value) throws CacheException;
/**
* Adds an object to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, Object value) throws CacheException;
/**
* Adds a <code>short</code> value to an array. The array is created if it does not already exist.
*
* @param ptr A pointer to the property to set. If the last segment is a positive integer less than the current
* array size, <code>value</code> is inserted at the specified index; otherwise, it is appended to the
* end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
JsonCache add(JsonPointer ptr, short value) throws CacheException;
/**
* Adds a <code>BigDecimal</code> to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, BigDecimal value) throws CacheException;
/**
* Adds a <code>BigInteger</code> to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, BigInteger value) throws CacheException;
/**
* Adds a <code>boolean</code> value to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, boolean value) throws CacheException;
/**
* Adds a <code>double</code> value to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, double value) throws CacheException;
/**
* Adds a <code>float</code> value to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, float value) throws CacheException;
/**
* Adds an <code>int</code> value to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, int value) throws CacheException;
/**
* Adds a <code>long</code> value to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, long value) throws CacheException;
/**
* Adds an object to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, Object value) throws CacheException;
/**
* Adds a <code>short</code> value to an array. The array is created if it does not already exist.
*
* @param path A JSON Pointer expression for the property to set. If the last segment is a positive integer less
* than the current array size, <code>value</code> is inserted at the specified index; otherwise, it is
* appended to the end of the array.
* @param value The value to add.
* @return The receiver, to support chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
*/
JsonCache add(String path, short value) throws CacheException;
/**
* Returns a child cache rooted at the given location relative to the receiver's base pointer.
*
* @param ptr A pointer to the subtree managed by the new cache.
* @return The child cache.
* @throws NullPointerException if <code>ptr</code> is <code>null</code>.
*/
JsonCache child(JsonPointer ptr);
/**
* Returns a child cache rooted at the given location relative to the receiver's base pointer.
*
* @param path A JSON Pointer expression for the subtree managed by the new cache. Note that the expression must
* start with a forward slash character.
* @return The child cache.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
JsonCache child(String path);
/**
* Deletes a property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
void delete(JsonPointer ptr) throws CacheException;
/**
* Deletes a property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the
* receiver.
*/
void delete(String path) throws CacheException;
/**
* Tests for the existence of the specified path within the object graph managed by the receiver.
*
* @param ptr A pointer to the path to test.
* @return <code>true</code> if a JSON node corresponding to <code>ptr</code> exists.
*/
boolean exists(JsonPointer ptr);
/**
* Tests for the existence of the specified path within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the path to test.
* @return <code>true</code> if a JSON node corresponding to <code>ptr</code> exists.
*/
boolean exists(String path);
/**
* Retrieves an <code>Object</code> value from within the graph.
*
* @param ptr A JSON Pointer expression for the value to return.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
Object get(JsonPointer ptr) throws CacheException;
/**
* Retrieves an <code>Object</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A pointer to the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
Object get(JsonPointer ptr, Object defaultValue) throws CacheException;
/**
* Retrieves an <code>Object</code> value from within the graph.
*
* @param path A pointer to the value to return.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
Object get(String path) throws CacheException;
/**
* Retrieves an <code>Object</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
Object get(String path, Object defaultValue) throws CacheException;
/**
* Retrieves a <code>BigDecimal</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
BigDecimal getBigDecimal(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>BigDecimal</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A pointer to the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
BigDecimal getBigDecimal(JsonPointer ptr, BigDecimal defaultValue) throws CacheException;
/**
* Retrieves a <code>BigDecimal</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
BigDecimal getBigDecimal(String path) throws CacheException;
/**
* Retrieves a <code>BigDecimal</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
BigDecimal getBigDecimal(String path, BigDecimal defaultValue) throws CacheException;
/**
* Retrieves a <code>BigInteger</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
BigInteger getBigInteger(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>BigInteger</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
BigInteger getBigInteger(JsonPointer ptr, BigInteger defaultValue) throws CacheException;
/**
* Retrieves a <code>BigInteger</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
BigInteger getBigInteger(String path) throws CacheException;
/**
* Retrieves a <code>BigInteger</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
BigInteger getBigInteger(String path, BigInteger defaultValue) throws CacheException;
/**
* Retrieves a <code>byte[]</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
byte[] getBinary(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>byte[]</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
byte[] getBinary(JsonPointer ptr, byte[] defaultValue) throws CacheException;
/**
* Retrieves a <code>byte[]</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
byte[] getBinary(String path) throws CacheException;
/**
* Retrieves a <code>byte[]</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
byte[] getBinary(String path, byte[] defaultValue) throws CacheException;
/**
* Retrieves a <code>boolean</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>false</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
boolean getBoolean(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>boolean</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
boolean getBoolean(JsonPointer ptr, boolean defaultValue) throws CacheException;
/**
* Retrieves a <code>boolean</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>false</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
boolean getBoolean(String path) throws CacheException;
/**
* Retrieves a <code>boolean</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
boolean getBoolean(String path, boolean defaultValue) throws CacheException;
/**
* Retrieves a <code>double</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>0.0D</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
double getDouble(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>double</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
double getDouble(JsonPointer ptr, double defaultValue) throws CacheException;
/**
* Retrieves a <code>double</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>0.0D</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
double getDouble(String path) throws CacheException;
/**
* Retrieves a <code>double</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
double getDouble(String path, double defaultValue) throws CacheException;
/**
* Retrieves a <code>float</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>0.0F</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
float getFloat(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>float</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
float getFloat(JsonPointer ptr, float defaultValue) throws CacheException;
/**
* Retrieves a <code>float</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>0.0F</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
float getFloat(String path) throws CacheException;
/**
* Retrieves a <code>float</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
float getFloat(String path, float defaultValue) throws CacheException;
/**
* Retrieves an <code>int</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>0</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
int getInt(JsonPointer ptr) throws CacheException;
/**
* Retrieves an <code>int</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
int getInt(JsonPointer ptr, int defaultValue) throws CacheException;
/**
* Retrieves an <code>int</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>0</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
int getInt(String path) throws CacheException;
/**
* Retrieves an <code>int</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
int getInt(String path, int defaultValue) throws CacheException;
/**
* Retrieves a <code>long</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>0L</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
long getLong(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>long</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
long getLong(JsonPointer ptr, long defaultValue) throws CacheException;
/**
* Retrieves a <code>long</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>0L</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
long getLong(String path) throws CacheException;
/**
* Retrieves a <code>long</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
long getLong(String path, long defaultValue) throws CacheException;
/**
* Returns the node type at the specified location in the object graph.
*
* @param ptr A pointer to the node to test.
* @return The node type.
*/
JsonNodeType getNodeType(JsonPointer ptr);
/**
* Returns the node type at the specified location in the object graph.
*
* @param path A JSON Pointer expression for the node to test.
* @return The node type.
*/
JsonNodeType getNodeType(String path);
/**
* Retrieves a <code>Number</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
Number getNumber(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>Number</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
Number getNumber(JsonPointer ptr, Number defaultValue) throws CacheException;
/**
* Retrieves a <code>Number</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
Number getNumber(String path) throws CacheException;
/**
* Retrieves a <code>Number</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
Number getNumber(String path, Number defaultValue) throws CacheException;
/**
* Retrieves a typed object value from within the graph.
*
* @param <T> The type of object to return.
* @param ptr A pointer to the value to return.
* @param type The type of object to return.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver or
* if the node could not be converted to the requested type.
*/
<T> T getObject(JsonPointer ptr, Class<T> type) throws CacheException;
/**
* Retrieves a typed object value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param <T> The type of the object to return.
* @param ptr A pointer to the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver or
* if the node could not be converted to the requested type.
*/
<T> T getObject(JsonPointer ptr, T defaultValue) throws CacheException;
/**
* Retrieves a typed object value from within the graph.
*
* @param <T> The type of object to return.
* @param path A JSON pointer expression for the value to return.
* @param type The type of object to return.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver or if the node could not be converted to the requested type.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
<T> T getObject(String path, Class<T> type) throws CacheException;
/**
* Retrieves a typed object value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param <T> The type of the object to return.
* @param path A JSON pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver or if the node could not be converted to the requested type.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
<T> T getObject(String path, T defaultValue) throws CacheException;
/**
* Retrieves a typed list of objects from within the graph.
*
* @param <T> The list element type.
* @param ptr A pointer to the values to return.
* @param type The list element type.
* @return the property values.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver or
* if the nodes could not be converted to the requested type.
*/
<T> List<T> getObjects(JsonPointer ptr, Class<T> type) throws CacheException;
/**
* Retrieves a typed list of objects from within the graph. If the values are not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param <T> The list element type.
* @param ptr A pointer to the values to return.
* @param type The list element type.
* @param defaultValue The default values to return if <code>ptr</code> is not present in the graph.
* @return the property values.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver or
* if the nodes could not be converted to the requested type.
*/
<T> List<T> getObjects(JsonPointer ptr, Class<T> type, List<T> defaultValue) throws CacheException;
/**
* Retrieves a typed list of objects from within the graph.
*
* @param <T> The list element type.
* @param path A JSON Pointer expression for the values to return.
* @param type The list element type.
* @return the property values.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver or if the nodes could not be converted to the requested type.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
<T> List<T> getObjects(String path, Class<T> type) throws CacheException;
/**
* Retrieves a typed list of objects from within the graph. If the values are not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param <T> The list element type.
* @param path A JSON Pointer expression for the values to return.
* @param type The list element type.
* @param defaultValue The default values to return if <code>path</code> is not present in the graph.
* @return the property values.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the
* receiver or if the nodes could not be converted to the requested type.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
<T> List<T> getObjects(String path, Class<T> type, List<T> defaultValue) throws CacheException;
/**
* Retrieves a <code>short</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>0</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
short getShort(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>short</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
short getShort(JsonPointer ptr, short defaultValue) throws CacheException;
/**
* Retrieves a <code>short</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>0</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
short getShort(String path) throws CacheException;
/**
* Retrieves a <code>short</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
short getShort(String path, short defaultValue) throws CacheException;
/**
* Retrieves a <code>String</code> value from within the graph.
*
* @param ptr A pointer to the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
String getString(JsonPointer ptr) throws CacheException;
/**
* Retrieves a <code>String</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param ptr A pointer to the value to return.
* @param defaultValue The default value to return if <code>ptr</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
*/
String getString(JsonPointer ptr, String defaultValue) throws CacheException;
/**
* Retrieves a <code>String</code> value from within the graph.
*
* @param path A JSON Pointer expression for the value to retrieve.
* @return the property value or <code>null</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
String getString(String path) throws CacheException;
/**
* Retrieves a <code>String</code> value from within the graph. If the value is not present, stores
* <code>defaultValue</code> at the specified location and returns this value.
*
* @param path A JSON Pointer expression for the value to return.
* @param defaultValue The default value to return if <code>path</code> is not present in the graph.
* @return the property value or <code>defaultValue</code> if not present.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON path expression.
*/
String getString(String path, String defaultValue) throws CacheException;
/**
* Returns the parent cache of which this is a descendant.
*
* @return The parent cache, <code>null</code> if the receiver is the root cache.
*/
JsonCache parent();
/**
* Returns the root cache of which this is a descendant.
*
* @return The root cache. The root cache returns itself.
*/
Root root();
/**
* Sets a <code>BigDecimal</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, BigDecimal value) throws CacheException;
/**
* Sets a <code>BigInteger</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, BigInteger value) throws CacheException;
/**
* Sets a <code>boolean</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, boolean value) throws CacheException;
/**
* Sets a <code>double</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, double value) throws CacheException;
/**
* Sets a <code>float</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, float value) throws CacheException;
/**
* Sets an <code>int</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, int value) throws CacheException;
/**
* Sets a <code>List</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param values The values to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, List<?> values) throws CacheException;
/**
* Sets a <code>long</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, long value) throws CacheException;
/**
* Sets an <code>Object</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, Object value) throws CacheException;
/**
* Sets a <code>short</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, short value) throws CacheException;
/**
* Sets a <code>String</code> property within the object graph managed by the receiver.
*
* @param ptr A pointer to the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws CacheException if <code>ptr</code> is not a valid path within the object graph managed by the receiver.
* @see #delete(JsonPointer)
*/
JsonCache set(JsonPointer ptr, String value) throws CacheException;
/**
* Sets a <code>BigDecimal</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, BigDecimal value) throws CacheException;
/**
* Sets a <code>BigInteger</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, BigInteger value) throws CacheException;
/**
* Sets a <code>boolean</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, boolean value) throws CacheException;
/**
* Sets a <code>double</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, double value) throws CacheException;
/**
* Sets a <code>float</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, float value) throws CacheException;
/**
* Sets an <code>int</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, int value) throws CacheException;
/**
* Sets a <code>List</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param values The values to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, List<?> values) throws CacheException;
/**
* Sets a <code>long</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, long value) throws CacheException;
/**
* Sets an <code>Object</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, Object value) throws CacheException;
/**
* Sets a <code>short</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set.
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, short value) throws CacheException;
/**
* Sets a <code>String</code> property within the object graph managed by the receiver.
*
* @param path A JSON Pointer expression for the property to set.
* @param value The value to set (can be null).
* @return The receiver, to allow chaining.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @throws CacheException if <code>path</code> is not a valid path within the object graph managed by the
* receiver.
* @see #delete(String)
*/
JsonCache set(String path, String value) throws CacheException;
/**
* Returns the size of a node within the object graph managed by the receiver. For an array node, size is the number
* of elements; for an object node, size is the number of properties; for other node types, size is <code>0</code>.
*
* @param ptr A pointer to the node.
* @return The size of the node, or <code>0</code> if it does not exist.
* @see #delete(String)
*/
int size(JsonPointer ptr);
/**
* Returns the size of a node within the object graph managed by the receiver. For an array node, size is the number
* of elements; for an object node, size is the number of properties; for other node types, size is <code>0</code>.
*
* @param path A JSON pointer expression for the node.
* @return The size of the node, or <code>0</code> if it does not exist.
* @throws IllegalArgumentException if <code>path</code> is not a valid JSON Pointer expression.
* @see #delete(String)
*/
int size(String path);
}
\ No newline at end of file
modules/ibizlab-generator/src/main/java/com/ibizlab/codegen/utils/JsonCacheImpl.java 已删除 100644 → 0
浏览文件 @ 9bd67ac8
/*
* Copyright 2019 OpenAPI-Generator Contributors (https://openapi-generator.tech)
*
* 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
*
* https://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.ibizlab.codegen.utils;
import com.fasterxml.jackson.core.JsonPointer;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.fasterxml.jackson.databind.node.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import java.io.*;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.util.*;
import java.util.Map.Entry;
import java.util.regex.Pattern;
/**
* A cache implementation for loading, querying, mutating and saving a JSON object graph.
*
* @author Adrian Price, TIBCO Software Inc.
* @since 4.0.0
*/
class JsonCacheImpl implements JsonCache.Root {
/**
* Manages a sub-tree of a parent cache, identified by a base pointer rooted.
*/
private static class ChildCacheImpl implements JsonCache {
private final JsonPointer basePtr;
private final JsonCache parent;
private ChildCacheImpl(JsonCache parent, JsonPointer basePtr) {
this.parent = parent;
this.basePtr = basePtr;
}
@Override
public JsonCache add(JsonPointer ptr, BigDecimal value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, BigInteger value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, boolean value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, double value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, float value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, int value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, long value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, Object value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(JsonPointer ptr, short value) throws CacheException {
parent.add(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache add(String path, BigDecimal value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, BigInteger value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, boolean value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, double value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, float value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, int value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, long value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, Object value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache add(String path, short value) throws CacheException {
parent.add(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache child(JsonPointer basePtr) {
return new ChildCacheImpl(this, basePtr);
}
@Override
public JsonCache child(String path) {
return child(JsonPointer.compile(path));
}
@Override
public void delete(JsonPointer ptr) throws CacheException {
parent.delete(basePtr.append(ptr));
}
@Override
public void delete(String path) throws CacheException {
parent.delete(basePtr.append(JsonPointer.compile(path)));
}
@Override
public boolean exists(JsonPointer ptr) {
return parent.exists(basePtr.append(ptr));
}
@Override
public boolean exists(String path) {
return parent.exists(basePtr.append(JsonPointer.compile(path)));
}
@Override
public Object get(JsonPointer ptr) throws CacheException {
return parent.get(basePtr.append(ptr));
}
@Override
public Object get(JsonPointer ptr, Object defaultValue) throws CacheException {
return parent.get(basePtr.append(ptr), defaultValue);
}
@Override
public Object get(String path) throws CacheException {
return parent.get(basePtr.append(JsonPointer.compile(path)));
}
@Override
public Object get(String path, Object defaultValue) throws CacheException {
return parent.get(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public BigDecimal getBigDecimal(JsonPointer ptr) throws CacheException {
return parent.getBigDecimal(basePtr.append(ptr));
}
@Override
public BigDecimal getBigDecimal(JsonPointer ptr, BigDecimal defaultValue) throws CacheException {
return parent.getBigDecimal(basePtr.append(ptr), defaultValue);
}
@Override
public BigDecimal getBigDecimal(String path) throws CacheException {
return parent.getBigDecimal(basePtr.append(JsonPointer.compile(path)));
}
@Override
public BigDecimal getBigDecimal(String path, BigDecimal defaultValue) throws CacheException {
return parent.getBigDecimal(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public BigInteger getBigInteger(JsonPointer ptr) throws CacheException {
return parent.getBigInteger(basePtr.append(ptr));
}
@Override
public BigInteger getBigInteger(JsonPointer ptr, BigInteger defaultValue) throws CacheException {
return parent.getBigInteger(basePtr.append(ptr), defaultValue);
}
@Override
public BigInteger getBigInteger(String path) throws CacheException {
return parent.getBigInteger(basePtr.append(JsonPointer.compile(path)));
}
@Override
public BigInteger getBigInteger(String path, BigInteger defaultValue) throws CacheException {
return parent.getBigInteger(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public byte[] getBinary(JsonPointer ptr) throws CacheException {
return parent.getBinary(basePtr.append(ptr));
}
@Override
public byte[] getBinary(JsonPointer ptr, byte[] defaultValue) throws CacheException {
return parent.getBinary(basePtr.append(ptr), defaultValue);
}
@Override
public byte[] getBinary(String path) throws CacheException {
return parent.getBinary(basePtr.append(JsonPointer.compile(path)));
}
@Override
public byte[] getBinary(String path, byte[] defaultValue) throws CacheException {
return parent.getBinary(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public boolean getBoolean(JsonPointer ptr) throws CacheException {
return parent.getBoolean(basePtr.append(ptr));
}
@Override
public boolean getBoolean(JsonPointer ptr, boolean defaultValue) throws CacheException {
return parent.getBoolean(basePtr.append(ptr), defaultValue);
}
@Override
public boolean getBoolean(String path) throws CacheException {
return parent.getBoolean(basePtr.append(JsonPointer.compile(path)));
}
@Override
public boolean getBoolean(String path, boolean defaultValue) throws CacheException {
return parent.getBoolean(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public double getDouble(JsonPointer ptr) throws CacheException {
return parent.getDouble(basePtr.append(ptr));
}
@Override
public double getDouble(JsonPointer ptr, double defaultValue) throws CacheException {
return parent.getDouble(basePtr.append(ptr), defaultValue);
}
@Override
public double getDouble(String path) throws CacheException {
return parent.getDouble(basePtr.append(JsonPointer.compile(path)));
}
@Override
public double getDouble(String path, double defaultValue) throws CacheException {
return parent.getDouble(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public float getFloat(JsonPointer ptr) throws CacheException {
return parent.getFloat(basePtr.append(ptr));
}
@Override
public float getFloat(JsonPointer ptr, float defaultValue) throws CacheException {
return parent.getFloat(basePtr.append(ptr), defaultValue);
}
@Override
public float getFloat(String path) throws CacheException {
return parent.getFloat(basePtr.append(JsonPointer.compile(path)));
}
@Override
public float getFloat(String path, float defaultValue) throws CacheException {
return parent.getFloat(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public int getInt(JsonPointer ptr) throws CacheException {
return parent.getInt(basePtr.append(ptr));
}
@Override
public int getInt(JsonPointer ptr, int defaultValue) throws CacheException {
return parent.getInt(basePtr.append(ptr), defaultValue);
}
@Override
public int getInt(String path) throws CacheException {
return parent.getInt(basePtr.append(JsonPointer.compile(path)));
}
@Override
public int getInt(String path, int defaultValue) throws CacheException {
return parent.getInt(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public long getLong(JsonPointer ptr) throws CacheException {
return parent.getLong(basePtr.append(ptr));
}
@Override
public long getLong(JsonPointer ptr, long defaultValue) throws CacheException {
return parent.getLong(basePtr.append(ptr), defaultValue);
}
@Override
public long getLong(String path) throws CacheException {
return parent.getLong(basePtr.append(JsonPointer.compile(path)));
}
@Override
public long getLong(String path, long defaultValue) throws CacheException {
return parent.getLong(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public JsonNodeType getNodeType(JsonPointer ptr) {
return parent.getNodeType(basePtr.append(ptr));
}
@Override
public JsonNodeType getNodeType(String path) {
return parent.getNodeType(basePtr.append(JsonPointer.compile(path)));
}
@Override
public Number getNumber(JsonPointer ptr) throws CacheException {
return parent.getNumber(basePtr.append(ptr));
}
@Override
public Number getNumber(JsonPointer ptr, Number defaultValue) throws CacheException {
return parent.getNumber(basePtr.append(ptr), defaultValue);
}
@Override
public Number getNumber(String path) throws CacheException {
return parent.getNumber(basePtr.append(JsonPointer.compile(path)));
}
@Override
public Number getNumber(String path, Number defaultValue) throws CacheException {
return parent.getNumber(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public <T> T getObject(JsonPointer ptr, Class<T> type) throws CacheException {
return parent.getObject(basePtr.append(ptr), type);
}
@Override
public <T> T getObject(JsonPointer ptr, T defaultValue) throws CacheException {
return parent.getObject(basePtr.append(ptr), defaultValue);
}
@Override
public <T> T getObject(String path, Class<T> type) throws CacheException {
return parent.getObject(basePtr.append(JsonPointer.compile(path)), type);
}
@Override
public <T> T getObject(String path, T defaultValue) throws CacheException {
return parent.getObject(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public <T> List<T> getObjects(JsonPointer ptr, Class<T> type) throws CacheException {
return parent.getObjects(basePtr.append(ptr), type);
}
@Override
public <T> List<T> getObjects(JsonPointer ptr, Class<T> type, List<T> defaultValue) throws CacheException {
return parent.getObjects(basePtr.append(ptr), type, defaultValue);
}
@Override
public <T> List<T> getObjects(String path, Class<T> type) throws CacheException {
return parent.getObjects(basePtr.append(JsonPointer.compile(path)), type);
}
@Override
public <T> List<T> getObjects(String path, Class<T> type, List<T> defaultValue) throws CacheException {
return parent.getObjects(basePtr.append(JsonPointer.compile(path)), type, defaultValue);
}
@Override
public short getShort(JsonPointer ptr) throws CacheException {
return parent.getShort(basePtr.append(ptr));
}
@Override
public short getShort(JsonPointer ptr, short defaultValue) throws CacheException {
return parent.getShort(basePtr.append(ptr), defaultValue);
}
@Override
public short getShort(String path) throws CacheException {
return parent.getShort(basePtr.append(JsonPointer.compile(path)));
}
@Override
public short getShort(String path, short defaultValue) throws CacheException {
return parent.getShort(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public String getString(JsonPointer ptr) throws CacheException {
return parent.getString(basePtr.append(ptr));
}
@Override
public String getString(JsonPointer ptr, String defaultValue) throws CacheException {
return parent.getString(basePtr.append(ptr), defaultValue);
}
@Override
public String getString(String path) throws CacheException {
return parent.getString(basePtr.append(JsonPointer.compile(path)));
}
@Override
public String getString(String path, String defaultValue) throws CacheException {
return parent.getString(basePtr.append(JsonPointer.compile(path)), defaultValue);
}
@Override
public JsonCache parent() {
return parent;
}
@Override
public Root root() {
return parent.root();
}
@Override
public JsonCache set(JsonPointer ptr, BigDecimal value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, BigInteger value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, boolean value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, double value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, float value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, int value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, List<?> values) throws CacheException {
parent.set(basePtr.append(ptr), values);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, long value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, Object value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, short value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(JsonPointer ptr, String value) throws CacheException {
parent.set(basePtr.append(ptr), value);
return this;
}
@Override
public JsonCache set(String path, BigDecimal value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, BigInteger value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, boolean value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, double value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, float value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, int value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, List<?> values) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), values);
return this;
}
@Override
public JsonCache set(String path, long value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, Object value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, short value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public JsonCache set(String path, String value) throws CacheException {
parent.set(basePtr.append(JsonPointer.compile(path)), value);
return this;
}
@Override
public int size(JsonPointer ptr) {
return parent.size(basePtr.append(ptr));
}
@Override
public int size(String path) {
return parent.size(basePtr.append(JsonPointer.compile(path)));
}
@Override
public String toString() {
JsonNode node;
try {
node = getObject(EMPTY_PTR, JsonNode.class);
} catch (CacheException e) {
LOGGER.error("", e);
node = null;
}
return "ChildCacheImpl [basePtr=" + basePtr + ", node=" + node + ']';
}
}
static class FactoryImpl implements Factory {
static final Factory instance = new FactoryImpl();
private final Map<String, JsonCacheImpl> instances = new HashMap<>();
@Override
public Root create() {
return new JsonCacheImpl();
}
@Override
public Root get(String key) {
synchronized (instances) {
JsonCacheImpl instance = instances.get(key);
if (instance == null) {
instance = new JsonCacheImpl();
instances.put(key, instance);
}
return instance;
}
}
}
protected static final JsonPointer EMPTY_PTR = JsonPointer.compile("/");
private static final Pattern INTEGER = Pattern.compile("^\\d+$");
protected static final Logger LOGGER = LoggerFactory.getLogger(JsonCacheImpl.class);
protected boolean isDirty;
protected boolean isLoaded;
protected ObjectMapper mapper;
protected MergePolicy mergePolicy = MergePolicy.MERGE_RECURSIVE;
protected ContainerNode<?> root;
private boolean shutdownHookRegistered;
protected JsonCacheImpl() {
mapper = new ObjectMapper();
mapper.enable(SerializationFeature.INDENT_OUTPUT);
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
}
@Override
public JsonCache add(JsonPointer ptr, BigDecimal value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, BigInteger value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, boolean value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, double value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, float value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, int value) {
return add(ptr, nodeFor(value));
}
protected JsonCache add(JsonPointer ptr, JsonNode node) {
// If ptr ends with an array index, this implies inserting at the specified index.
// If ptr does not end with an array index, this implies appending to the end of the array.
// In both cases the array in question and its ancestors must be created if they do not already exist.
String lastProperty = ptr.last().getMatchingProperty();
boolean isIndexed = isInteger(lastProperty);
ContainerNode<?> container = ensureContainerExists(ptr, !isIndexed);
switch (container.getNodeType()) {
case ARRAY:
ArrayNode array = (ArrayNode) container;
int index = isIndexed ? Integer.parseInt(lastProperty) : array.size();
if (index < array.size()) {
array.insert(index, node);
} else {
// Fill any gap between current size and index with nulls (Jackson doesn't support sparse arrays).
for (int i = array.size(); i < index; i++)
array.add(array.nullNode());
array.add(node);
}
break;
default:
throw new IllegalArgumentException(ptr + " does not identify an array");
}
setDirty();
return this;
}
@Override
public JsonCache add(JsonPointer ptr, long value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, Object value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(JsonPointer ptr, short value) {
return add(ptr, nodeFor(value));
}
@Override
public JsonCache add(String path, BigDecimal value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, BigInteger value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, boolean value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, double value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, float value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, int value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, long value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, Object value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache add(String path, short value) {
return add(JsonPointer.compile(path), value);
}
@Override
public JsonCache child(JsonPointer basePtr) {
return new ChildCacheImpl(this, basePtr);
}
@Override
public JsonCache child(String path) {
return child(JsonPointer.compile(path));
}
@Override
public void delete(JsonPointer ptr) {
JsonPointer head = ptr.head();
if (head == null) {
root = null;
} else if (root != null) {
JsonNode parent = root.at(head);
if (parent.isArray()) {
((ArrayNode) parent).remove(Integer.parseInt(ptr.last().getMatchingProperty()));
} else if (parent.isObject()) {
((ObjectNode) parent).remove(ptr.last().getMatchingProperty());
} else {
throw new IllegalArgumentException(ptr + " does not identify a deletable node");
}
}
setDirty();
}
@Override
public void delete(String path) {
delete(JsonPointer.compile(path));
}
/**
* Ensures that a suitable container exists for the specified JSON pointer.
*
* @param ptr A <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer</a> to the property to set.
* @return The container that owns the property identified by <code>path</code>.
*/
protected ContainerNode<?> ensureContainerExists(JsonPointer ptr) {
return ensureContainerExists(ptr, false);
}
/**
* Ensures that all ancestor containers exist for the specified JSON pointer.
*
* @param ptr A <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer</a> to the property to set.
* @param forceArray <code>true</code> to create an array for the last segment of the pointer if it is non-integral.
* @return The container that owns the property identified by <code>path</code>.
*/
protected ContainerNode<?> ensureContainerExists(JsonPointer ptr, boolean forceArray) {
if (root == null) {
root = isInteger(ptr.getMatchingProperty()) // split
? JsonNodeFactory.instance.arrayNode()
: JsonNodeFactory.instance.objectNode();
}
String lastProperty = ptr.last().getMatchingProperty();
Deque<String> stack = new ArrayDeque<>();
JsonPointer ancestorPtr = forceArray && !isInteger(lastProperty) ? ptr : ptr.head();
JsonNode ancestor = root.at(ancestorPtr);
while (ancestor.isMissingNode()) {
stack.push(ancestorPtr.last().getMatchingProperty());
ancestorPtr = ancestorPtr.head();
ancestor = root.at(ancestorPtr);
}
if (!ancestor.isContainerNode())
throw new IllegalArgumentException(ancestorPtr + " does not identify a container node");
while (!stack.isEmpty()) {
String ancestorProperty = stack.pop();
String childProperty = stack.isEmpty() // split
? forceArray && !isInteger(lastProperty) // split
? "0" // split
: lastProperty // split
: stack.peek();
// Parent can be array or object; child can be array or object - that's four possible combinations.
// Infer the child container type from the child property name: an integer pattern implies an array node.
if (isInteger(childProperty)) {
switch (ancestor.getNodeType()) {
case ARRAY:
// ARRAY/ARRAY
ancestor = ((ArrayNode) ancestor).insertArray(Integer.parseInt(ancestorProperty));
break;
case OBJECT:
// OBJECT/ARRAY
ancestor = ((ObjectNode) ancestor).putArray(ancestorProperty);
break;
default:
throw new IllegalArgumentException(ancestorProperty + " does not identify an array node");
}
} else {
switch (ancestor.getNodeType()) {
case ARRAY:
// ARRAY/OBJECT
ancestor = ((ArrayNode) ancestor).insertObject(Integer.parseInt(ancestorProperty));
break;
case OBJECT:
// OBJECT/OBJECT
ancestor = ((ObjectNode) ancestor).putObject(ancestorProperty);
break;
default:
throw new IllegalArgumentException(ancestorProperty + " does not identify an array node");
}
}
setDirty();
}
return (ContainerNode<?>) ancestor;
}
@Override
public boolean exists(JsonPointer ptr) {
return root != null && !root.at(ptr).isMissingNode();
}
@Override
public boolean exists(String path) {
return exists(JsonPointer.compile(path));
}
@Override
public Root flush(File file) throws CacheException {
if (isDirty)
save(file);
return this;
}
@Override
public Root flush(OutputStream out) throws CacheException {
if (isDirty)
save(out);
return this;
}
@Override
public Root flushOnShutdown(final File file) {
if (!shutdownHookRegistered) {
Runtime.getRuntime().addShutdownHook(new Thread() {
@Override
public void run() {
try {
flush(file);
} catch (CacheException e) {
e.printStackTrace();
}
}
});
shutdownHookRegistered = true;
}
return this;
}
@Override
public Root flushOnShutdown(final OutputStream out) {
if (!shutdownHookRegistered) {
Runtime.getRuntime().addShutdownHook(new Thread() {
@Override
public void run() {
try {
flush(out);
} catch (CacheException e) {
e.printStackTrace();
}
}
});
shutdownHookRegistered = true;
}
return this;
}
@Override
public Object get(JsonPointer ptr) throws CacheException {
Object result;
if (root == null) {
result = null;
} else {
try {
JsonNode node = root.at(ptr);
switch (node.getNodeType()) {
case ARRAY:
case OBJECT:
result = node;
break;
case BINARY:
result = node.binaryValue();
break;
case BOOLEAN:
result = node.booleanValue();
break;
case NUMBER:
result = node.numberValue();
break;
case POJO:
result = ((POJONode) node).getPojo();
break;
case STRING:
result = node.textValue();
break;
default:
result = null;
break;
}
} catch (IOException e) {
throw new CacheException(e);
}
}
return result;
}
@Override
public Object get(JsonPointer ptr, Object defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
Object result;
if (exists(ptr)) {
result = get(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public Object get(String path) throws CacheException {
return get(JsonPointer.compile(path));
}
@Override
public Object get(String path, Object defaultValue) throws CacheException {
return get(JsonPointer.compile(path), defaultValue);
}
@Override
public BigDecimal getBigDecimal(JsonPointer ptr) {
return root == null ? null : root.at(ptr).decimalValue();
}
@Override
public BigDecimal getBigDecimal(JsonPointer ptr, BigDecimal defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
BigDecimal result;
if (exists(ptr)) {
result = getBigDecimal(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public BigDecimal getBigDecimal(String path) {
return getBigDecimal(JsonPointer.compile(path));
}
@Override
public BigDecimal getBigDecimal(String path, BigDecimal defaultValue) throws CacheException {
return getBigDecimal(JsonPointer.compile(path), defaultValue);
}
@Override
public BigInteger getBigInteger(JsonPointer ptr) {
return root == null ? null : root.at(ptr).bigIntegerValue();
}
@Override
public BigInteger getBigInteger(JsonPointer ptr, BigInteger defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
BigInteger result;
if (exists(ptr)) {
result = getBigInteger(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public BigInteger getBigInteger(String path) {
return getBigInteger(JsonPointer.compile(path));
}
@Override
public BigInteger getBigInteger(String path, BigInteger defaultValue) throws CacheException {
return getBigInteger(JsonPointer.compile(path), defaultValue);
}
@Override
public byte[] getBinary(JsonPointer ptr) throws CacheException {
try {
return root == null ? null : root.at(ptr).binaryValue();
} catch (IOException e) {
throw new CacheException(e);
}
}
@Override
public byte[] getBinary(JsonPointer ptr, byte[] defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
byte[] result;
if (exists(ptr)) {
result = getBinary(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public byte[] getBinary(String path) throws CacheException {
return getBinary(JsonPointer.compile(path));
}
@Override
public byte[] getBinary(String path, byte[] defaultValue) throws CacheException {
return getBinary(JsonPointer.compile(path), defaultValue);
}
@Override
public boolean getBoolean(JsonPointer ptr) {
return root != null && root.at(ptr).booleanValue();
}
@Override
public boolean getBoolean(JsonPointer ptr, boolean defaultValue) throws CacheException {
boolean result;
if (exists(ptr)) {
result = getBoolean(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public boolean getBoolean(String path) {
return getBoolean(JsonPointer.compile(path));
}
@Override
public boolean getBoolean(String path, boolean defaultValue) throws CacheException {
return getBoolean(JsonPointer.compile(path), defaultValue);
}
@Override
public double getDouble(JsonPointer ptr) {
return root == null ? 0.0D : root.at(ptr).doubleValue();
}
@Override
public double getDouble(JsonPointer ptr, double defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
double result;
if (exists(ptr)) {
result = getDouble(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public double getDouble(String path) {
return getDouble(JsonPointer.compile(path));
}
@Override
public double getDouble(String path, double defaultValue) throws CacheException {
return getDouble(JsonPointer.compile(path), defaultValue);
}
@Override
public float getFloat(JsonPointer ptr) {
return root == null ? 0.0F : root.at(ptr).floatValue();
}
@Override
public float getFloat(JsonPointer ptr, float defaultValue) throws CacheException {
float result;
if (exists(ptr)) {
result = getFloat(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public float getFloat(String path) {
return getFloat(JsonPointer.compile(path));
}
@Override
public float getFloat(String path, float defaultValue) throws CacheException {
return getFloat(JsonPointer.compile(path), defaultValue);
}
@Override
public int getInt(JsonPointer ptr) {
return root == null ? 0 : root.at(ptr).intValue();
}
@Override
public int getInt(JsonPointer ptr, int defaultValue) throws CacheException {
int result;
if (exists(ptr)) {
result = getInt(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public int getInt(String path) {
return getInt(JsonPointer.compile(path));
}
@Override
public int getInt(String path, int defaultValue) throws CacheException {
return getInt(JsonPointer.compile(path), defaultValue);
}
@Override
public long getLong(JsonPointer ptr) {
return root == null ? 0L : root.at(ptr).longValue();
}
@Override
public long getLong(JsonPointer ptr, long defaultValue) throws CacheException {
long result;
if (exists(ptr)) {
result = getLong(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public long getLong(String path) {
return getLong(JsonPointer.compile(path));
}
@Override
public long getLong(String path, long defaultValue) throws CacheException {
return getLong(JsonPointer.compile(path), defaultValue);
}
@Override
public ObjectMapper getMapper() {
return mapper;
}
@Override
public MergePolicy getMergePolicy() {
return mergePolicy;
}
@Override
public JsonNodeType getNodeType(JsonPointer ptr) {
return root.at(ptr).getNodeType();
}
@Override
public JsonNodeType getNodeType(String path) {
return getNodeType(JsonPointer.compile(path));
}
@Override
public int hashCode() {
// TODO Auto-generated method stub
return super.hashCode();
}
@Override
public boolean equals(Object obj) {
// TODO Auto-generated method stub
return super.equals(obj);
}
@Override
protected Object clone() throws CloneNotSupportedException {
// TODO Auto-generated method stub
return super.clone();
}
@Override
protected void finalize() throws Throwable {
// TODO Auto-generated method stub
super.finalize();
}
@Override
public Number getNumber(JsonPointer ptr) {
return root == null ? null : root.at(ptr).numberValue();
}
@Override
public Number getNumber(JsonPointer ptr, Number defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
Number result;
if (exists(ptr)) {
result = getNumber(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public Number getNumber(String path) {
return getNumber(JsonPointer.compile(path));
}
@Override
public Number getNumber(String path, Number defaultValue) throws CacheException {
return getNumber(JsonPointer.compile(path), defaultValue);
}
@Override
public <T> T getObject(JsonPointer ptr, Class<T> type) throws CacheException {
T result;
if (root == null) {
result = null;
} else {
JsonNode node = root.at(ptr);
Object value = node.isPojo() && !JsonNode.class.isAssignableFrom(type) ? ((POJONode) node).getPojo() : node;
if ((value != null) && (value.getClass() == type)) {
result = (T) value;
} else {
result = mapper.convertValue(value, type);
}
}
return result;
}
@Override
@SuppressWarnings("unchecked")
public <T> T getObject(JsonPointer ptr, T defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
T result;
if (exists(ptr)) {
result = (T) getObject(ptr, defaultValue.getClass());
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public <T> T getObject(String path, Class<T> type) throws CacheException {
return getObject(JsonPointer.compile(path), type);
}
@Override
public <T> T getObject(String path, T defaultValue) throws CacheException {
return getObject(JsonPointer.compile(path), defaultValue);
}
@Override
public <T> List<T> getObjects(JsonPointer ptr, Class<T> type) throws CacheException {
List<T> result;
if (root == null) {
result = null;
} else {
JsonNode node = root.at(ptr);
switch (node.getNodeType()) {
case ARRAY:
case OBJECT:
result = new ArrayList<T>(node.size());
Iterator<JsonNode> elements = node.elements();
while (elements.hasNext())
result.add(mapper.convertValue(elements.next(), type));
break;
default:
result = Collections.emptyList();
break;
}
}
return result;
}
@Override
public <T> List<T> getObjects(JsonPointer ptr, Class<T> type, List<T> defaultValue) throws CacheException {
Objects.requireNonNull(defaultValue, "defaultValue is required");
List<T> result;
if (exists(ptr)) {
result = getObjects(ptr, type);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public <T> List<T> getObjects(String path, Class<T> type) throws CacheException {
return getObjects(JsonPointer.compile(path), type);
}
@Override
public <T> List<T> getObjects(String path, Class<T> type, List<T> defaultValue) throws CacheException {
return getObjects(JsonPointer.compile(path), type, defaultValue);
}
@Override
public short getShort(JsonPointer ptr) {
return root == null ? (short) 0 : root.at(ptr).shortValue();
}
@Override
public short getShort(JsonPointer ptr, short defaultValue) {
short result;
if (exists(ptr)) {
result = getShort(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public short getShort(String path) {
return getShort(JsonPointer.compile(path));
}
@Override
public short getShort(String path, short defaultValue) {
return getShort(JsonPointer.compile(path), defaultValue);
}
@Override
public String getString(JsonPointer ptr) {
return root == null ? null : root.at(ptr).textValue();
}
@Override
public String getString(JsonPointer ptr, String defaultValue) {
Objects.requireNonNull(defaultValue, "defaultValue is required");
String result;
if (exists(ptr)) {
result = getString(ptr);
} else {
set(ptr, defaultValue);
result = defaultValue;
}
return result;
}
@Override
public String getString(String path) {
return getString(JsonPointer.compile(path));
}
@Override
public String getString(String path, String defaultValue) {
return getString(JsonPointer.compile(path), defaultValue);
}
protected void insertNumber(ArrayNode array, int index, Number value) {
if (value instanceof Short) {
array.insert(index, (Short) value);
} else if (value instanceof Integer) {
array.insert(index, (Integer) value);
} else if (value instanceof Long) {
array.insert(index, (Long) value);
} else if (value instanceof Float) {
array.insert(index, (Float) value);
} else if (value instanceof Double) {
array.insert(index, (Double) value);
} else if (value instanceof BigInteger) {
array.insert(index, (BigInteger) value);
} else if (value instanceof BigDecimal) {
array.insert(index, (BigDecimal) value);
} else {
throw new IllegalArgumentException(
"unsupported numeric value: " + value + " (" + value.getClass().getSimpleName() + ')');
}
}
@Override
public boolean isDirty() {
return isDirty;
}
protected boolean isInteger(String s) {
return INTEGER.matcher(s).matches();
}
@Override
public Root load(File file) throws CacheException {
Objects.requireNonNull(file, "file is required");
if (file.exists()) {
try (InputStream in = new FileInputStream(file)) {
load(in);
} catch (IOException e) {
throw new CacheException(e);
}
}
return this;
}
@Override
public Root load(InputStream in) throws CacheException {
Objects.requireNonNull(in, "in is required");
try (InputStream is = in) {
if (isLoaded) {
if (mergePolicy != MergePolicy.NO_MERGE) {
ContainerNode<?> tree = (ContainerNode<?>) mapper.readTree(in);
// The cache is already loaded, so merge the incoming object tree into the existing root.
merge(root, tree);
}
} else {
root = (ContainerNode<?>) mapper.readTree(in);
isDirty = false;
isLoaded = true;
}
} catch (IOException e) {
throw new CacheException(e);
}
return this;
}
@Override
public Root mapper(ObjectMapper mapper) {
Objects.requireNonNull(mapper, "mapper is required");
this.mapper = mapper;
return this;
}
protected void merge(ContainerNode<?> dest, ContainerNode<?> src) {
if (dest.getNodeType() == src.getNodeType()) {
if (dest.isArray()) {
ArrayNode destArray = (ArrayNode) dest;
ArrayNode srcArray = (ArrayNode) src;
outer:
for (int i = 0; i < srcArray.size(); i++) {
// Only add a source element if it is not already present in the destination array.
JsonNode srcElem = srcArray.get(i);
for (int j = 0; j < destArray.size(); j++) {
if (destArray.get(j).equals(srcElem))
continue outer;
}
destArray.add(srcElem);
}
} else if (dest.isObject()) {
ObjectNode destObject = (ObjectNode) dest;
ObjectNode srcObject = (ObjectNode) src;
Iterator<Entry<String, JsonNode>> fields = srcObject.fields();
while (fields.hasNext()) {
Entry<String, JsonNode> field = fields.next();
String fieldName = field.getKey();
JsonNode srcChild = field.getValue();
if (destObject.has(fieldName)) {
JsonNode destChild = destObject.get(fieldName);
switch (mergePolicy) {
case OVERWRITE_EXISTING:
destObject.set(fieldName, srcChild);
// Mark the cache as dirty as we've added items from another file.
isDirty = true;
LOGGER.info("Existing root property '{}' has been overwritten by incoming data",
fieldName);
break;
case MERGE_RECURSIVE:
if (destChild.isContainerNode() && srcChild.isContainerNode())
merge((ContainerNode<?>) destChild, (ContainerNode<?>) srcChild);
break;
case KEEP_EXISTING:
LOGGER.info("Existing root property '{}' will not be overwritten by incoming data",
fieldName);
default:
// Nothing to do.
break;
}
} else {
destObject.set(fieldName, srcChild);
LOGGER.info("New property '{}' has been added from incoming data", fieldName);
// Mark the cache as dirty as we've added items from another file.
isDirty = true;
}
}
}
} else {
LOGGER.warn("Cannot merge containers of differing types");
}
}
@Override
public Root mergePolicy(MergePolicy policy) {
Objects.requireNonNull(policy, "policy is required");
this.mergePolicy = policy;
return this;
}
// @Override
@SuppressWarnings("unchecked")
protected JsonNode nodeFor(Object value) {
JsonNode node;
if (value == null) {
node = root.nullNode();
} else if (value instanceof JsonNode) {
node = (JsonNode) value;
} else if (value instanceof Boolean) {
node = root.booleanNode((Boolean) value);
} else if (value instanceof List) {
node = root.arrayNode();
for (Object element : (List<?>) value)
((ArrayNode) node).add(nodeFor(element));
} else if (value instanceof Map) {
node = root.objectNode();
for (Entry<String, ?> entry : ((Map<String, ?>) value).entrySet())
((ObjectNode) node).set(entry.getKey(), nodeFor(entry.getValue()));
} else if (value instanceof Number) {
if (value instanceof Byte)
node = root.numberNode((Byte) value);
else if (value instanceof Short)
node = root.numberNode((Short) value);
else if (value instanceof Integer)
node = root.numberNode((Integer) value);
else if (value instanceof Long)
node = root.numberNode((Long) value);
else if (value instanceof Float)
node = root.numberNode((Float) value);
else if (value instanceof Double)
node = root.numberNode((Double) value);
else if (value instanceof BigInteger)
node = root.numberNode((BigInteger) value);
else if (value instanceof BigDecimal)
node = root.numberNode((BigDecimal) value);
else
throw new IllegalArgumentException("unsupported number type: " + value.getClass().getSimpleName());
} else if (value instanceof String) {
node = root.textNode((String) value);
} else if (value instanceof byte[]) {
node = root.binaryNode((byte[]) value);
} else {
node = root.pojoNode(value);
}
return node;
}
protected JsonNodeType nodeTypeFor(Object value) {
JsonNodeType type;
if (value == null) {
type = JsonNodeType.NULL;
} else if (value instanceof Boolean) {
type = JsonNodeType.BOOLEAN;
} else if (value instanceof Number) {
type = JsonNodeType.NUMBER;
} else if (value instanceof String) {
type = JsonNodeType.STRING;
} else if (value instanceof ArrayNode || value instanceof List) {
type = JsonNodeType.ARRAY;
} else if (value instanceof byte[]) {
type = JsonNodeType.BINARY;
} else if (value instanceof ObjectNode || value instanceof Map) {
type = JsonNodeType.OBJECT;
} else {
type = JsonNodeType.POJO;
}
return type;
}
@Override
public JsonCache parent() {
return null;
}
protected void putNumber(ObjectNode object, String property, Number value) {
if (value instanceof Short) {
object.put(property, (Short) value);
} else if (value instanceof Integer) {
object.put(property, (Integer) value);
} else if (value instanceof Long) {
object.put(property, (Long) value);
} else if (value instanceof Float) {
object.put(property, (Float) value);
} else if (value instanceof Double) {
object.put(property, (Double) value);
} else if (value instanceof BigInteger) {
object.put(property, (BigInteger) value);
} else if (value instanceof BigDecimal) {
object.put(property, (BigDecimal) value);
} else {
throw new IllegalArgumentException(
"unsupported numeric value: " + value + " (" + value.getClass().getSimpleName() + ')');
}
}
@Override
public Root root() {
return this;
}
@Override
public Root save(File file) throws CacheException {
Objects.requireNonNull(file, "file is required");
file.getParentFile().mkdirs();
try {
save(new FileOutputStream(file));
} catch (FileNotFoundException e) {
throw new CacheException(e);
}
return this;
}
@Override
public Root save(OutputStream out) throws CacheException {
if (root == null || root.isMissingNode())
throw new CacheException("null or missing root node");
Objects.requireNonNull(out, "out is required");
try (OutputStream o = out) {
mapper.writeValue(o, root);
} catch (IOException e) {
throw new CacheException(e);
}
isDirty = false;
return this;
}
@Override
public JsonCache set(JsonPointer ptr, BigDecimal value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, BigInteger value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, boolean value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, double value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, float value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, int value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, List<?> values) throws CacheException {
// Note: if the node identified by ptr is not an array, we must create one before populating it.
ArrayNode array;
ContainerNode<?> container = ensureContainerExists(ptr);
JsonNode target = container.at(ptr.last());
if (target.isArray()) {
array = (ArrayNode) target;
} else {
String property = ptr.last().getMatchingProperty();
array = container.arrayNode();
switch (container.getNodeType()) {
case ARRAY:
int index = Integer.parseInt(property);
((ArrayNode) container).set(index, array);
break;
case OBJECT:
((ObjectNode) container).set(property, array);
break;
default:
throw new CacheException(ptr + " does not identify an array");
}
}
// Now that the target array exists, we can populate it.
array.removeAll();
for (Object value : values) {
JsonNode node = nodeFor(value);
array.add(node);
}
setDirty();
return this;
}
@Override
public JsonCache set(JsonPointer ptr, long value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, Object value) {
String property = ptr.last().getMatchingProperty();
ContainerNode<?> container = ensureContainerExists(ptr);
JsonNode node = nodeFor(value);
switch (container.getNodeType()) {
case ARRAY:
ArrayNode array = (ArrayNode) container;
int index = Integer.parseInt(property);
if (index < array.size()) {
array.set(index, node);
} else {
// Fill any gap between current size and index with nulls (Jackson doesn't support sparse arrays).
for (int i = array.size(); i < index; i++)
array.add(array.nullNode());
array.add(node);
}
break;
case OBJECT:
((ObjectNode) container).set(property, node);
break;
default:
throw new IllegalArgumentException(ptr + " does not identify a settable container");
}
setDirty();
return this;
}
@Override
public JsonCache set(JsonPointer ptr, short value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(JsonPointer ptr, String value) {
return set(ptr, (Object) value);
}
@Override
public JsonCache set(String path, BigDecimal value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, BigInteger value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, boolean value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, double value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, float value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, int value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, List<?> values) throws CacheException {
return set(JsonPointer.compile(path), values);
}
@Override
public JsonCache set(String path, long value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, Object value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, short value) {
return set(JsonPointer.compile(path), value);
}
@Override
public JsonCache set(String path, String value) {
return set(JsonPointer.compile(path), value);
}
protected void setDirty() {
isDirty = true;
isLoaded = true;
}
@Override
public int size(JsonPointer ptr) {
return root == null ? 0 : root.at(ptr).size();
}
@Override
public int size(String path) {
return size(JsonPointer.compile(path));
}
@Override
public String toString() {
return "JsonCacheImpl [root=" + root + ']';
}
@Override
public Root unload() {
isLoaded = false;
isDirty = false;
root = null;
return this;
}
}
pom.xml
浏览文件 @ c9a5c76c
......@@ -14,7 +14,6 @@
<modules>
<module>modules/ibizlab-generator-core</module>
<module>modules/ibizlab-generator</module>
<module>modules/ibizlab-generator-cli</module>
</modules>
......
Markdown 格式
0% or
您添加了 0 人 到此讨论。请谨慎行事。
先完成此消息的编辑！
想要评论请 注册 或