package sh.calaba.org.codehaus.jackson.node; import java.io.IOException; import sh.calaba.org.codehaus.jackson.*; import sh.calaba.org.codehaus.jackson.map.SerializerProvider; import sh.calaba.org.codehaus.jackson.map.TypeSerializer; /** * This singleton node class is generated to denote "missing nodes" * along paths that do not exist. For example, if a path via * element of an array is requested for an element outside range * of elements in the array; or for a non-array value, result * will be reference to this node. *

* In most respects this placeholder node will act as {@link NullNode}; * for example, for purposes of value conversions, value is considered * to be null and represented as value zero when used for numeric * conversions. */ public final class MissingNode extends BaseJsonNode { private final static MissingNode instance = new MissingNode(); private MissingNode() { } public static MissingNode getInstance() { return instance; } @Override public JsonToken asToken() { return JsonToken.NOT_AVAILABLE; } @Override public boolean isMissingNode() { return true; } // as per [JACKSON-775] @Override public String asText() { return ""; } @Override public int asInt(int defaultValue) { return 0; } @Override public long asLong(long defaultValue) { return 0L; } @Override public double asDouble(double defaultValue) { return 0.0; } @Override public JsonNode path(String fieldName) { return this; } @Override public JsonNode path(int index) { return this; } @Override public final void serialize(JsonGenerator jg, SerializerProvider provider) throws IOException, JsonProcessingException { /* Nothing to output... should we signal an error tho? * Chances are, this is an erroneous call. For now, let's * not do that. */ jg.writeNull(); } @Override public void serializeWithType(JsonGenerator jg, SerializerProvider provider, TypeSerializer typeSer) throws IOException, JsonProcessingException { jg.writeNull(); } @Override public boolean equals(Object o) { /* Hmmh. Since there's just a singleton instance, this * fails in all cases but with identity comparison. * However: if this placeholder value was to be considered * similar to Sql NULL, it shouldn't even equal itself? * That might cause problems when dealing with collections * like Sets... so for now, let's let identity comparison * return true. */ return (o == this); } @Override public String toString() { // toString() should never return null return ""; } }