org.nuxeo.ecm.core.io.marshallers.json

Class AbstractJsonWriter<EntityType>

java.lang.Object

org.nuxeo.ecm.core.io.marshallers.json.AbstractJsonWriter<EntityType>

Type Parameters:

EntityType - The Java type to marshall as Json.

All Implemented Interfaces:

Marshaller<EntityType>, Writer<EntityType>

Direct Known Subclasses:

AbstractJsonEnricher, AuthenticationTokenWriter, DefaultListJsonWriter, DocumentPropertyJsonWriter, ExtensibleEntityJsonWriter

@Supports(value="application/json")
public abstract class AbstractJsonWriter<EntityType>
extends Object
implements Writer<EntityType>

Base class for Json Writer.

This class provides a easy way to produce json and also provides the current context: ctx. It provides you a JsonGenerator to manage the marshalling.

The use of this class optimize the JsonFactory usage especially when aggregating marshallers.

Since:

7.2

Field Summary

Fields

Modifier and Type	Field and Description
protected RenderingContext	ctx The current RenderingContext.
protected MarshallerRegistry	registry The marshaller registry.

Constructor Summary

Constructors

Constructor and Description
AbstractJsonWriter()

Method Summary

Modifier and Type	Method and Description
boolean	accept(Class<?> clazz, Type genericType, javax.ws.rs.core.MediaType mediatype) Checks if this marshaller can handle the marshalling request.
protected org.codehaus.jackson.JsonGenerator	getGenerator(OutputStream out, boolean getCurrentIfAvailable) Get the current Json generator or create it if none was found.
void	write(EntityType entity, Class<?> clazz, Type genericType, javax.ws.rs.core.MediaType mediatype, OutputStream out) Writes the entity to out OutputStream using mediatype format.
abstract void	write(EntityType entity, org.codehaus.jackson.JsonGenerator jg) Implement this method to writes the entity in the provided JsonGenerator.
protected void	writeEntity(Object entity, org.codehaus.jackson.JsonGenerator jg) Delegates writing of an entity to the MarshallerRegistry.
protected <ObjectType> void	writeEntity(ObjectType entity, OutputStream out) Delegates writing of an entity to the MarshallerRegistry.
protected void	writeEntityField(String fieldName, Object entity, org.codehaus.jackson.JsonGenerator jg) Delegates writing of an entity to the MarshallerRegistry.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ctx

@Inject
protected RenderingContext ctx

The current RenderingContext.

registry

@Inject
protected MarshallerRegistry registry

The marshaller registry.

Constructor Detail

AbstractJsonWriter

public AbstractJsonWriter()

Method Detail

accept

public boolean accept(Class<?> clazz,
                      Type genericType,
                      javax.ws.rs.core.MediaType mediatype)

Description copied from interface: Marshaller

Checks if this marshaller can handle the marshalling request.

Please note it's useless to check that clazz is an instance of EntityType or if generic type and entity type are compatible (unlike JAX-RS which just checks the clazz, not the generic type). It's also useless to check Supports is compatible with mediatype. This is already done by the MarshallerRegistry

This method implementation can use injected properties. So you can check the current RenderingContext to accept or reject a marshalling request.

Specified by:

accept in interface Marshaller<EntityType>

Parameters:

clazz - The type to marshall.

genericType - The generic type to marshall.

mediatype - The managed mimetype.

Returns:

true if this converter handle the request, false otherwise.

write

public void write(EntityType entity,
                  Class<?> clazz,
                  Type genericType,
                  javax.ws.rs.core.MediaType mediatype,
                  OutputStream out)
           throws IOException

Description copied from interface: Writer

Writes the entity to out OutputStream using mediatype format.

This method implementation can use injected properties.

Specified by:

write in interface Writer<EntityType>

Parameters:

entity - The entity to marshall.

clazz - The requested marshalled class.

genericType - The requested marshalled generic type.

mediatype - The target mediatype.

out - The output of this marshaller.

Throws:

IOException - If some error append while writing entity to out.

write

public abstract void write(EntityType entity,
                           org.codehaus.jackson.JsonGenerator jg)
                    throws IOException

Implement this method to writes the entity in the provided JsonGenerator.

This method implementation can use injected properties.

The JsonGenerator's flushing is done by this abstract class, it's also not not necessary to flush it. Do not close the provided JsonGenerator. It may be used is another marshaller calling this one.

Parameters:

entity - The entity to marshall as Json.

jg - The JsonGenerator used to produce Json output.

Throws:

IOException

Since:

7.2

writeEntityField

protected void writeEntityField(String fieldName,
                                Object entity,
                                org.codehaus.jackson.JsonGenerator jg)
                         throws IOException

Delegates writing of an entity to the MarshallerRegistry. This will work if a Json Writer is registered in the registry for the given clazz.

Parameters:

fieldName - The name of the Json field in which the entity will be wrote.

entity - The entity to write.

jg - The JsonGenerator used to write the given entity.

Throws:

IOException

Since:

7.2

writeEntity

protected void writeEntity(Object entity,
                           org.codehaus.jackson.JsonGenerator jg)
                    throws IOException

Delegates writing of an entity to the MarshallerRegistry. This will work if a Json Writer is registered in the registry for the given clazz.

Parameters:

entity - The entity to write.

jg - The JsonGenerator used to write the given entity.

Throws:

IOException

Since:

7.2

writeEntity

protected <ObjectType> void writeEntity(ObjectType entity,
                                        OutputStream out)
                                 throws IOException

Delegates writing of an entity to the MarshallerRegistry. This will work if a Json Writer is registered in the registry for the given clazz.

Parameters:

entity - The entity to write.

out - The OutputStream in which the given entity will be wrote.

Throws:

IOException - If some i/o error append while writing entity.

Since:

7.2

getGenerator

protected org.codehaus.jackson.JsonGenerator getGenerator(OutputStream out,
                                                          boolean getCurrentIfAvailable)
                                                   throws IOException

Get the current Json generator or create it if none was found.

Parameters:

out - The OutputStream on which the generator will generate Json.

getCurrentIfAvailable - If true, try to get the current generator in the context.

Returns:

The created generator.

Throws:

IOException

Since:

7.2