SnackJson Java JSON Framework

When upgrading from version 3 to version 4, several method names have changed to be more descriptive. Use the following mapping to update your code:

You can customize how SnackJson handles specific types and formatting using the Options object.

Options options = Options.of();

// Add a type checker (for Feature.Read_AutoType)
options.addChecker(clzName -> {
    if (clzName.startsWith("com.ok.xxx.")) return TypeChecker.ALLOW;
    if (clzName.startsWith("com.no.yyy.")) return TypeChecker.DENY;
    return TypeChecker.SKIP;
});

// Add custom encoder/decoder
options.addEncoder(Date.class, (ctx, value, target) -> {
    target.setValue(DateUtil.format(value, "yyyy-MM-dd"));
});
options.addDecoder(Date.class, ...);

// Add/Remove features
options.addFeature(Feature.Write_PrettyFormat);
options.removeFeature(Feature.Write_PrettyFormat);

// Configure date format for Feature.Write_UseDateFormat
options.addFeature(Feature.Write_UseDateFormat);
options.dateFormat("yyyy-MM");

// Apply options
String json = ONode.ofBean(orderModel, options).toJson();

Options options = Options.of();
//添加检测器（for Feature.Read_AutoType）
options.addChecker(clzName -> {
    //通过
    if (clzName.startsWith("com.ok.xxx.")) {
        return TypeChecker.ALLOW;
    }

    //拒绝
    if (clzName.startsWith("com.no.yyy.")) {
        return TypeChecker.DENY;
    }

    //跳过
    return TypeChecker.SKIP;
});
//添加编码器
options.addEncoder(Date.class, (ctx, value, target) -> {
    target.setValue(DateUtil.format(data, "yyyy-MM-dd"));
});
//添加解码器
options.addDecoder(Date.class, ...);
//添加创建器（接管类实例化）
options.addCreator(...);

//添加特性
options.addFeature(Feature.Write_PrettyFormat);

//移除特性
options.removeFeature(Feature.Write_PrettyFormat);

//设置日期格式附
options.addFeature(Feature.Write_UseDateFormat); //使用日期格式
options.dateFormat("yyyy-MM");

//..

String json = ONode.ofBean(orderModel, options).toJson();

You can extend JSONPath capabilities by registering custom functions via FunctionLib.register. The function receives a context and a list of argument nodes.

import org.noear.snack4.ONode;
import org.noear.snack4.jsonpath.FunctionLib;

FunctionLib.register("floor", (ctx, argNodes) -> {
    ONode arg0 = argNodes.get(0);

    if (ctx.isDescendant()) {
        // Handle descendant selector
        for (ONode n1 : arg0.getArray()) {
            if (n1.isNumber()) {
                n1.setValue(Math.floor(n1.getDouble()));
            }
        }
        return arg0;
    } else {
        // Handle direct selector
        ONode n1 = arg0.get(0);
        if (n1.isNumber()) {
            return ctx.newNode(Math.floor(n1.getDouble()));
        } else {
            return ctx.newNode();
        }
    }
});

// Usage: $.a.floor()

import org.noear.snack4.ONode;
import org.noear.snack4.jsonpath.FunctionLib;

public class FunctionDemo {
    public static void main(String[] args) {
        //定制 floor 函数
        FunctionLib.register("floor", (ctx, argNodes) -> {
            ONode arg0 = argNodes.get(0); //节点列表（选择器的结果）

            if (ctx.isDescendant()) {
                for (ONode n1 : arg0.getArray()) {
                    if (n1.isNumber()) {
                        n1.setValue(Math.floor(n1.getDouble()));
                    }
                }

                return arg0;
            } else {
                ONode n1 = arg0.get(0);

                if (n1.isNumber()) {
                    return ctx.newNode(Math.floor(n1.getDouble()));
                } else {
                    return ctx.newNode();
                }
            }
        });

        //检验效果，在 IETF 规范里以子项进行过滤，即 1,2） //out: 1.0
        System.out.println(ONode.ofJson("{'a':1,'b':2}")
                .select("$.a.floor()")
                .toJson());

        //参考 //out: 2.0
        System.out.println(ONode.ofJson("{'a':1,'b':2}")
                .select("$[?floor(@) > 1].first()")
                .toJson());
    }
}

You can retrieve the path of a node or its parent. There are two ways to handle this:

1. Automatic: When using .select(), paths are automatically generated for the resulting nodes.
2. Manual: Use .usePaths() on the root node to generate paths for all child nodes.

// Case 1: Automatic path generation via select
ONode o = ONode.ofJson(json); 
ONode rst = o.select("$.data.list[*].mobile");
List<String> rstPaths = rst.pathList(); 
for(ONode n1 : rst.getArray()) {
    n1.path(); // Current path
    n1.parent(); // Parent node
}

// Case 2: Manual path generation for all nodes
ONode o = ONode.ofJson(json).usePaths();
ONode rst = o.get("data").get("list").get(2);
rst.path();
rst.parent();

//case1
ONode o = ONode.ofJson(json); 
ONode rst = o.select("$.data.list[*].mobile"); //自动为查询到的节点，生成 path 属性
List<String> rstPaths = rst.pathList(); //获取结果节点的路径列表
for(ONode n1 : rst.getArray()) {
    n1.path(); //当前路径
    n1.parent(); //父级节点
}

//case2
ONode o = ONode.ofJson(json).usePaths(); //手动为每个子节点，生成 path 属性
ONode rst = o.get("data").get("list").get(2);
rst.path();
rst.parent();