org.eclipse.persistence.oxm.record
Class JSONWriterRecord

java.lang.Object
  org.eclipse.persistence.internal.sessions.AbstractRecord
      org.eclipse.persistence.oxm.record.XMLRecord
          org.eclipse.persistence.oxm.record.MarshalRecord
              org.eclipse.persistence.oxm.record.JSONWriterRecord

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map, Record

Direct Known Subclasses:

JSONFormattedWriterRecord

public class JSONWriterRecord
extends MarshalRecord

Use this type of MarshalRecord when the marshal target is a Writer and the JSON should not be formatted with carriage returns or indenting.

XMLContext xmlContext = new XMLContext("session-name");
XMLMarshaller xmlMarshaller = xmlContext.createMarshaller();
JSONRecord jsonWriterRecord = new JSONWriterRecord();
jsonWriterRecord.setWriter(myWriter);
xmlMarshaller.marshal(myObject, jsonWriterRecord);


If the marshal(Writer) and setMediaType(MediaType.APPLICATION_JSON) and setFormattedOutput(false) method is called on XMLMarshaller, then the Writer is automatically wrapped in a JSONWriterRecord.

XMLContext xmlContext = new XMLContext("session-name");
XMLMarshaller xmlMarshaller = xmlContext.createMarshaller();
xmlMarshaller.setMediaType(MediaType.APPLICATION_JSON); xmlMarshaller xmlMarshaller.setFormattedOutput(false);
xmlMarshaller.marshal(myObject, myWriter);


See Also:

XMLMarshaller, Serialized Form

Nested Class Summary

protected static class	JSONWriterRecord.Level Instances of this class are used to maintain state about the current level of the JSON message being marshalled.
protected class	JSONWriterRecord.WriterRecordContentHandler This class will typically be used in conjunction with an XMLFragmentReader.

Nested classes/interfaces inherited from class org.eclipse.persistence.internal.sessions.AbstractRecord

org.eclipse.persistence.internal.sessions.AbstractRecord.EntrySet, org.eclipse.persistence.internal.sessions.AbstractRecord.KeySet, org.eclipse.persistence.internal.sessions.AbstractRecord.NoEntry, org.eclipse.persistence.internal.sessions.AbstractRecord.RecordEntry, org.eclipse.persistence.internal.sessions.AbstractRecord.RecordEntryIterator, org.eclipse.persistence.internal.sessions.AbstractRecord.RecordKeyIterator, org.eclipse.persistence.internal.sessions.AbstractRecord.RecordValuesIterator, org.eclipse.persistence.internal.sessions.AbstractRecord.ValuesSet

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Field Summary

protected java.lang.String	attributePrefix
protected boolean	charactersAllowed
protected boolean	isProcessingCData
protected boolean	isStartElementOpen
protected java.util.Stack<JSONWriterRecord.Level>	levels
protected static java.lang.String	NULL
protected java.io.Writer	writer

Fields inherited from class org.eclipse.persistence.oxm.record.MarshalRecord

COLON_W_SCHEMA_NIL_ATTRIBUTE, textWrapperFragment, TRUE

Fields inherited from class org.eclipse.persistence.oxm.record.XMLRecord

currentObject, marshaller, namespaceAware, namespaceResolver, namespaceSeparator, NIL, session, unmarshaller

Fields inherited from class org.eclipse.persistence.internal.sessions.AbstractRecord

fields, lookupField, noEntry, nullValueInFields, size, values

Constructor Summary

JSONWriterRecord()

Method Summary

void	attribute(java.lang.String namespaceURI, java.lang.String localName, java.lang.String qName, java.lang.String value) INTERNAL:
void	attribute(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment, NamespaceResolver namespaceResolver, java.lang.Object value, javax.xml.namespace.QName schemaType) Convert the value if necessary and write out the attribute and converted value.
void	attribute(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment, NamespaceResolver namespaceResolver, java.lang.String value) INTERNAL:
void	cdata(java.lang.String value) INTERNAL:
void	characters(javax.xml.namespace.QName schemaType, java.lang.Object value, java.lang.String mimeType, boolean isCDATA) Convert the value if necessary and write out the converted value.
void	characters(java.lang.String value) INTERNAL:
protected void	closeComplex()
void	closeStartElement() INTERNAL:
void	defaultNamespaceDeclaration(java.lang.String defaultNamespace) Add the defaultNamespace declaration
void	element(org.eclipse.persistence.internal.oxm.XPathFragment frag) INTERNAL:
void	emptyComplex(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment, NamespaceResolver namespaceResolver) Used when an empty complex item should be written
void	emptySimple(NamespaceResolver namespaceResolver) Used when an empty simple value should be written
void	endCollection() This method is used to inform the MarshalRecord that it is done receiving element events that are part of a collection.
void	endDocument() INTERNAL:
void	endElement(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment, NamespaceResolver namespaceResolver) INTERNAL:
void	endPrefixMappings(NamespaceResolver namespaceResolver) INTERNAL: override so we don't iterate over namespaces when endPrefixMapping doesn't do anything
org.eclipse.persistence.internal.oxm.XPathFragment	getTextWrapperFragment() INTERNAL: The optional fragment used to wrap the text() mappings
java.io.Writer	getWriter() Return the Writer that the object will be marshalled to.
void	namespaceDeclaration(java.lang.String prefix, java.lang.String namespaceURI) Add the specified namespace declaration
void	namespaceDeclarations(NamespaceResolver namespaceResolver) INTERNAL:
void	nilComplex(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment, NamespaceResolver namespaceResolver) INTERNAL:
void	nilSimple(NamespaceResolver namespaceResolver) INTERNAL:
void	node(org.w3c.dom.Node node, NamespaceResolver namespaceResolver) Receive notification of a node.
protected void	nonStringCharacters(java.lang.String value)
void	openStartElement(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment, NamespaceResolver namespaceResolver) INTERNAL:
void	setMarshaller(XMLMarshaller marshaller) INTERNAL:
void	setWriter(java.io.Writer writer) Set the Writer that the object will be marshalled to.
void	startCollection() This method is used to inform the MarshalRecord that the element events it is about to receive are part of a collection.
void	startDocument(java.lang.String encoding, java.lang.String version) INTERNAL:
void	startPrefixMappings(NamespaceResolver namespaceResolver) INTERNAL: override so we don't iterate over namespaces when startPrefixMapping doesn't do anything
boolean	supportsSingleNode() Return true is this record can support the usesSingleNode option on XMLCompositeDirectCollectionMapping
protected void	writeKey(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment)
protected void	writeValue(java.lang.String value) INTERNAL:

Methods inherited from class org.eclipse.persistence.oxm.record.MarshalRecord

add, addGroupingElement, addPositionalNodes, afterContainmentMarshal, beforeContainmentMarshal, clear, closeStartGroupingElements, emptyAttribute, endPrefixMapping, getDocument, getDOM, getGroupingElements, getLocalName, getNameForFragment, getNameForFragmentBytes, getNamespaceURI, getPositionalNodes, getPrefixForFragment, getStringForQName, getValueToWrite, openStartGroupingElements, predicateAttribute, processNamespaceResolverForXSIPrefix, put, removeGroupingElement, setGroupingElement, startPrefixMapping, transformToXML

Methods inherited from class org.eclipse.persistence.oxm.record.XMLRecord

contains, convertToXMLField, convertToXMLField, get, get, getCurrentObject, getDocPresPolicy, getIndicatingNoEntry, getLeafElementType, getMarshaller, getNamespaceResolver, getNamespaceSeparator, getOwningObject, getSession, getUnmarshaller, hasCustomNamespaceMapper, isNamespaceAware, isXOPPackage, put, resolveNamespacePrefix, setCurrentObject, setCustomNamespaceMapper, setDocPresPolicy, setLeafElementType, setLeafElementType, setNamespaceResolver, setOwningObject, setSession, setUnmarshaller, setXOPPackage

Methods inherited from class org.eclipse.persistence.internal.sessions.AbstractRecord

clone, containsKey, containsKey, containsKey, containsValue, elements, entrySet, get, getField, getFields, getIndicatingNoEntry, getLookupField, getValues, getValues, getValues, hasNullValueInFields, isEmpty, keys, keySet, mergeFrom, put, putAll, remove, remove, remove, replaceAt, resetSize, setFields, setNullValueInFields, setValues, size, toString, values

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

equals, hashCode

Field Detail

writer

protected java.io.Writer writer

isStartElementOpen

protected boolean isStartElementOpen

isProcessingCData

protected boolean isProcessingCData

levels

protected java.util.Stack<JSONWriterRecord.Level> levels

NULL

protected static final java.lang.String NULL

See Also:

Constant Field Values

attributePrefix

protected java.lang.String attributePrefix

charactersAllowed

protected boolean charactersAllowed

Constructor Detail

JSONWriterRecord

public JSONWriterRecord()

Method Detail

supportsSingleNode

public boolean supportsSingleNode()

Description copied from class: XMLRecord

Return true is this record can support the usesSingleNode option on XMLCompositeDirectCollectionMapping

Overrides:

supportsSingleNode in class XMLRecord

setMarshaller

public void setMarshaller(XMLMarshaller marshaller)

INTERNAL:

Overrides:

setMarshaller in class MarshalRecord

getWriter

public java.io.Writer getWriter()

Return the Writer that the object will be marshalled to.

Returns:

The marshal target.

setWriter

public void setWriter(java.io.Writer writer)

Set the Writer that the object will be marshalled to.

Parameters:

writer - The marshal target.

namespaceDeclaration

public void namespaceDeclaration(java.lang.String prefix,
                                 java.lang.String namespaceURI)

Description copied from class: MarshalRecord

Add the specified namespace declaration

Overrides:

namespaceDeclaration in class MarshalRecord

defaultNamespaceDeclaration

public void defaultNamespaceDeclaration(java.lang.String defaultNamespace)

Description copied from class: MarshalRecord

Add the defaultNamespace declaration

Overrides:

defaultNamespaceDeclaration in class MarshalRecord

startDocument

public void startDocument(java.lang.String encoding,
                          java.lang.String version)

INTERNAL:

Specified by:

startDocument in class MarshalRecord

Parameters:

encoding - The XML document will be encoded using this encoding.

version - This specifies the version of XML.

endDocument

public void endDocument()

INTERNAL:

Specified by:

endDocument in class MarshalRecord

openStartElement

public void openStartElement(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
                             NamespaceResolver namespaceResolver)

INTERNAL:

Overrides:

openStartElement in class MarshalRecord

Parameters:

xPathFragment - The XPathFragment contains the name and prefix information about the XML element being ended.

namespaceResolver - The NamespaceResolver can be used to resolve the namespace URI for the namespace prefix held by the XPathFragment (if required).

element

public void element(org.eclipse.persistence.internal.oxm.XPathFragment frag)

INTERNAL:

Specified by:

element in class MarshalRecord

Parameters:

frag - The XPathFragment of the element

attribute

public void attribute(java.lang.String namespaceURI,
                      java.lang.String localName,
                      java.lang.String qName,
                      java.lang.String value)

INTERNAL:

Specified by:

attribute in class MarshalRecord

Parameters:

namespaceURI - The namespace URI, if the attribute is not namespace qualified the value of this parameter wil be null.

localName - The local name of the attribute.

qName - The qualified name of the attribute.

value - This is the complete value for the attribute.

attribute

public void attribute(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
                      NamespaceResolver namespaceResolver,
                      java.lang.String value)

INTERNAL:

Specified by:

attribute in class MarshalRecord

Parameters:

xPathFragment - The XPathFragment contains the name and prefix information about the XML element being ended.

namespaceResolver - The NamespaceResolver can be used to resolve the namespace URI for the namespace prefix held by the XPathFragment (if required).

value - This is the complete value for the attribute.

startPrefixMappings

public void startPrefixMappings(NamespaceResolver namespaceResolver)

INTERNAL: override so we don't iterate over namespaces when startPrefixMapping doesn't do anything

Overrides:

startPrefixMappings in class MarshalRecord

endPrefixMappings

public void endPrefixMappings(NamespaceResolver namespaceResolver)

INTERNAL: override so we don't iterate over namespaces when endPrefixMapping doesn't do anything

Overrides:

endPrefixMappings in class MarshalRecord

closeStartElement

public void closeStartElement()

INTERNAL:

Specified by:

closeStartElement in class MarshalRecord

endElement

public void endElement(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
                       NamespaceResolver namespaceResolver)

INTERNAL:

Specified by:

endElement in class MarshalRecord

Parameters:

xPathFragment - The XPathFragment contains the name and prefix information about the XML element being ended.

namespaceResolver - The NamespaceResolver can be used to resolve the namespace URI for the namespace prefix held by the XPathFragment (if required).

closeComplex

protected void closeComplex()
                     throws java.io.IOException

Throws:

java.io.IOException

startCollection

public void startCollection()

Description copied from class: MarshalRecord

This method is used to inform the MarshalRecord that the element events it is about to receive are part of a collection.

Overrides:

startCollection in class MarshalRecord

See Also:

endCollection

endCollection

public void endCollection()

Description copied from class: MarshalRecord

This method is used to inform the MarshalRecord that it is done receiving element events that are part of a collection.

Overrides:

endCollection in class MarshalRecord

See Also:

startCollection

characters

public void characters(java.lang.String value)

INTERNAL:

Specified by:

characters in class MarshalRecord

Parameters:

value - This is the entire value of the text node.

attribute

public void attribute(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
                      NamespaceResolver namespaceResolver,
                      java.lang.Object value,
                      javax.xml.namespace.QName schemaType)

Description copied from class: MarshalRecord

Convert the value if necessary and write out the attribute and converted value.

Overrides:

attribute in class MarshalRecord

characters

public void characters(javax.xml.namespace.QName schemaType,
                       java.lang.Object value,
                       java.lang.String mimeType,
                       boolean isCDATA)

Description copied from class: MarshalRecord

Convert the value if necessary and write out the converted value.

Overrides:

characters in class MarshalRecord

namespaceDeclarations

public void namespaceDeclarations(NamespaceResolver namespaceResolver)

INTERNAL:

Overrides:

namespaceDeclarations in class MarshalRecord

Parameters:

namespaceResolver - The NamespaceResolver contains the namespace prefix and URI pairings that need to be declared.

nilComplex

public void nilComplex(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
                       NamespaceResolver namespaceResolver)

INTERNAL:

Overrides:

nilComplex in class MarshalRecord

nilSimple

public void nilSimple(NamespaceResolver namespaceResolver)

INTERNAL:

Overrides:

nilSimple in class MarshalRecord

emptySimple

public void emptySimple(NamespaceResolver namespaceResolver)

Used when an empty simple value should be written

Overrides:

emptySimple in class MarshalRecord

Since:

EclipseLink 2.4

emptyComplex

public void emptyComplex(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
                         NamespaceResolver namespaceResolver)

Used when an empty complex item should be written

Overrides:

emptyComplex in class MarshalRecord

Since:

EclipseLink 2.4

nonStringCharacters

protected void nonStringCharacters(java.lang.String value)

cdata

public void cdata(java.lang.String value)

INTERNAL:

Specified by:

cdata in class MarshalRecord

Parameters:

value - This is the value of the text to be wrapped

getTextWrapperFragment

public org.eclipse.persistence.internal.oxm.XPathFragment getTextWrapperFragment()

INTERNAL: The optional fragment used to wrap the text() mappings

Overrides:

getTextWrapperFragment in class MarshalRecord

Since:

2.4

writeKey

protected void writeKey(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment)
                 throws java.io.IOException

Throws:

java.io.IOException

writeValue

protected void writeValue(java.lang.String value)

INTERNAL:

node

public void node(org.w3c.dom.Node node,
                 NamespaceResolver namespaceResolver)

Receive notification of a node.

Specified by:

node in class MarshalRecord

Parameters:

node - The Node to be added to the document

namespaceResolver - The NamespaceResolver can be used to resolve the namespace URI/prefix of the node