Add `RawValue` helper type

[cowtowncoder]

(note: related to #737, #348)

Supporting handling of "raw values" is tricky due to various reasons. But one possibly workable way would be to allow passing of raw values as JsonToken.VALUE_EMBEDDED_OBJECT of specific type.
Since there is nothing existing that quite fits the use case it is probably best to just add a simple value type in com.fasterxml.jackson.databind.util, say, "JsonRawValue".
It should be possible to construct from java.lang.String, but possible also from other sources to support alternate forms of writeRawValue().
The main method for accessing data should be one to simply write contents using given JsonGenerator, but alternate accessors may be added as well.

Once this type is added, it should be possible to work on end-to-end handling of raw values, to support use cases where such values need to be passed through various conversions.

[cowtowncoder]

Additional work done:

1. RawValue works fully with TokenBuffer, so that writeRawValue() methods that take String or SerializableString will construct RawValue under the hood; and serialization method will write it using JsonGenerator.writeRawValue()
2. When reading from TokenBuffer, raw values are exposed as JsonToken.VALUE_EMBEDDED_OBJECT.
3. Tree Model supports raw values as well:
   • JsonNodeFactory has rawValueNode() factory method
     *ObjectNode has putRawValue()
   • ArrayNode has addRawValue

So: it should be possible to inject raw values into TokenBuffer and JsonNode, for serialization purposes. Deserialization can not be supported, by definition, although it is possible to recover RawValue wrapper from TokenBuffer if necessary.

[martin-g]

Hi,

I've just tried to use JsonGenerator.writeRawValue() but I'm not sure whether I use it correctly.
At martin-g/wicket-jquery-selectors@ac61f56#diff-370a00d3f658d65a011325ed28899f48R19 I needed to use JsonGenerator.writeObject(new RV(someString)) instead of JsonGenerator.writeRawValue(someString) because if I use the latter Jackson serializes it as: "someKey": com.fasterxml.jackson.databind.util.RawValue@4386d484.
RV is just an extension of com.fasterxml.jackson.databind.util.RawValue that overrides #toString().

[cowtowncoder]

@martin-g Unless there is specific reason to do so, you should call JsonGenerator.writeRawValue(...) directly. This has much less overhead and should work reliably. JsonGenerator.writeObject() is a method that perhaps should not have been added in the API because it will need a back-reference to ObjectMapper, and induces significant setup overhead. But from method definition it can appear as a simple piece of functionality.

[martin-g]

@cowtowncoder I would like to use JsonGenerator.writeRawValue(...) but I can't because it produces wrong result.
I'd like to produce "someKey": someValue (note there are no quotes around someValue). If I use JsonGenerator.writeRawValue(...) it produces "someKey": com.fasterxml.jackson.databind.util.RawValue@12345678

[cowtowncoder]

@martin-g Hmmh. How exactly are you calling writeRawValue() here? It does not take RawValue but a String, so maybe you are accidentally callling toString() on it... ?

So I guess a code snippet would be helpful here in understanding the problem.

[martin-g]

See martin-g/wicket-jquery-selectors@ac61f56#diff-370a00d3f658d65a011325ed28899f48R18. Here I try to serialize my own custom type Json.RawValue as Jackson's RawValue.
My first attempt was to use jsonGenerator.writeRawValue(value.value()) (where value.value() returns a String). But this produced "someKey": com.fasterxml.jackson.databind.util.RawValue@12345678.
So I did my workaround - override Jackson's RawValue just to override its toString() - martin-g/wicket-jquery-selectors@ac61f56#diff-370a00d3f658d65a011325ed28899f48R34

It should be easy for you to reproduce the problem by cloning https://github.com/l0rdn1kk0n/wicket-jquery-selectors, checkout branch jackson-raw-value, change the code in src/main/java/de/agilecoders/wicket/jquery/util/serializer/RawSerializer.java to use generator.writeRawValue() and execute the tests with mvn clean test.
If this is too much for you then I'll try to create a failing unit test in Jackson tomorrow :-)

[cowtowncoder]

@martin-g ok I will try to diagnose what is going on here.