2 * Copyright (c) 2014 Cisco Systems, Inc. and others. All rights reserved.
4 * This program and the accompanying materials are made available under the
5 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6 * and is available at http://www.eclipse.org/legal/epl-v10.html
8 package org.opendaylight.yangtools.yang.data.codec.gson;
10 import com.google.common.base.Preconditions;
11 import com.google.gson.stream.JsonWriter;
12 import java.io.IOException;
14 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.AugmentationIdentifier;
15 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifier;
16 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates;
17 import org.opendaylight.yangtools.yang.data.api.schema.stream.NormalizedNodeStreamWriter;
18 import org.opendaylight.yangtools.yang.data.impl.codec.SchemaTracker;
19 import org.opendaylight.yangtools.yang.model.api.AnyXmlSchemaNode;
20 import org.opendaylight.yangtools.yang.model.api.LeafListSchemaNode;
21 import org.opendaylight.yangtools.yang.model.api.LeafSchemaNode;
22 import org.opendaylight.yangtools.yang.model.api.SchemaNode;
23 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
26 * This implementation will create JSON output as output stream.
28 * Values of leaf and leaf-list are NOT translated according to codecs.
31 public final class JSONNormalizedNodeStreamWriter implements NormalizedNodeStreamWriter {
33 * RFC6020 deviation: we are not required to emit empty containers unless they
34 * are marked as 'presence'.
36 private static final boolean DEFAULT_EMIT_EMPTY_CONTAINERS = true;
38 private final SchemaTracker tracker;
39 private final JSONCodecFactory codecs;
40 private final JsonWriter writer;
41 private JSONStreamWriterContext context;
43 private JSONNormalizedNodeStreamWriter(final JSONCodecFactory codecFactory, final SchemaPath path, final JsonWriter JsonWriter, final JSONStreamWriterRootContext rootContext) {
44 this.writer = Preconditions.checkNotNull(JsonWriter);
45 this.codecs = Preconditions.checkNotNull(codecFactory);
46 this.tracker = SchemaTracker.create(codecFactory.getSchemaContext(), path);
47 this.context = Preconditions.checkNotNull(rootContext);
51 * Create a new stream writer, which writes to the specified output stream.
53 * The codec factory can be reused between multiple writers.
55 * Returned writer is exclusive user of JsonWriter, which means it will start
56 * top-level JSON element and ends it.
58 * This instance of writer can be used only to emit one top level element,
59 * otherwise it will produce incorrect JSON.
61 * @param codecFactory JSON codec factory
62 * @param path Schema Path
63 * @param initialNs Initial namespace
64 * @param jsonWriter JsonWriter
65 * @return A stream writer instance
67 public static NormalizedNodeStreamWriter createExclusiveWriter(final JSONCodecFactory codecFactory, final SchemaPath path, final URI initialNs, final JsonWriter jsonWriter) {
68 return new JSONNormalizedNodeStreamWriter(codecFactory, path, jsonWriter, new JSONStreamWriterExclusiveRootContext(initialNs));
72 * Create a new stream writer, which writes to the specified output stream.
74 * The codec factory can be reused between multiple writers.
76 * Returned writer can be used emit multiple top level element,
77 * but does not start / close parent JSON object, which must be done
78 * by user providing {@code jsonWriter} instance in order for
81 * @param codecFactory JSON codec factory
82 * @param path Schema Path
83 * @param initialNs Initial namespace
84 * @param jsonWriter JsonWriter
85 * @return A stream writer instance
87 public static NormalizedNodeStreamWriter createNestedWriter(final JSONCodecFactory codecFactory, final SchemaPath path, final URI initialNs, final JsonWriter jsonWriter) {
88 return new JSONNormalizedNodeStreamWriter(codecFactory, path, jsonWriter, new JSONStreamWriterSharedRootContext(initialNs));
92 public void leafNode(final NodeIdentifier name, final Object value) throws IOException {
93 final LeafSchemaNode schema = tracker.leafNode(name);
94 final JSONCodec<Object> codec = codecs.codecFor(schema);
95 context.emittingChild(codecs.getSchemaContext(), writer);
96 context.writeChildJsonIdentifier(codecs.getSchemaContext(), writer, name.getNodeType());
97 writeValue(value, codec);
101 public void startLeafSet(final NodeIdentifier name, final int childSizeHint) throws IOException {
102 tracker.startLeafSet(name);
103 context = new JSONStreamWriterListContext(context, name);
107 public void leafSetEntryNode(final Object value) throws IOException {
108 final LeafListSchemaNode schema = tracker.leafSetEntryNode();
109 final JSONCodec<Object> codec = codecs.codecFor(schema);
110 context.emittingChild(codecs.getSchemaContext(), writer);
111 writeValue(value, codec);
115 * Warning suppressed due to static final constant which triggers a warning
116 * for the call to schema.isPresenceContainer().
118 @SuppressWarnings("unused")
120 public void startContainerNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
121 final SchemaNode schema = tracker.startContainerNode(name);
123 // FIXME this code ignores presence for containers
124 // but datastore does as well and it needs be fixed first (2399)
125 context = new JSONStreamWriterNamedObjectContext(context, name, DEFAULT_EMIT_EMPTY_CONTAINERS);
129 public void startUnkeyedList(final NodeIdentifier name, final int childSizeHint) throws IOException {
130 tracker.startList(name);
131 context = new JSONStreamWriterListContext(context, name);
135 public void startUnkeyedListItem(final NodeIdentifier name, final int childSizeHint) throws IOException {
136 tracker.startListItem(name);
137 context = new JSONStreamWriterObjectContext(context, name, DEFAULT_EMIT_EMPTY_CONTAINERS);
141 public void startMapNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
142 tracker.startList(name);
143 context = new JSONStreamWriterListContext(context, name);
147 public void startMapEntryNode(final NodeIdentifierWithPredicates identifier, final int childSizeHint)
149 tracker.startListItem(identifier);
150 context = new JSONStreamWriterObjectContext(context, identifier, DEFAULT_EMIT_EMPTY_CONTAINERS);
154 public void startOrderedMapNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
155 tracker.startList(name);
156 context = new JSONStreamWriterListContext(context, name);
160 public void startChoiceNode(final NodeIdentifier name, final int childSizeHint) {
161 tracker.startChoiceNode(name);
162 context = new JSONStreamWriterInvisibleContext(context);
166 public void startAugmentationNode(final AugmentationIdentifier identifier) {
167 tracker.startAugmentationNode(identifier);
168 context = new JSONStreamWriterInvisibleContext(context);
172 public void anyxmlNode(final NodeIdentifier name, final Object value) throws IOException {
173 @SuppressWarnings("unused")
174 final AnyXmlSchemaNode schema = tracker.anyxmlNode(name);
175 // FIXME: should have a codec based on this :)
177 context.emittingChild(codecs.getSchemaContext(), writer);
178 context.writeChildJsonIdentifier(codecs.getSchemaContext(), writer, name.getNodeType());
179 // FIXME this kind of serialization is incorrect since the value for AnyXml is now a DOMSource
180 writer.value(String.valueOf(value));
184 public void startYangModeledAnyXmlNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
185 tracker.startYangModeledAnyXmlNode(name);
186 context = new JSONStreamWriterNamedObjectContext(context, name, true);
190 public void endNode() throws IOException {
192 context = context.endNode(codecs.getSchemaContext(), writer);
194 if(context instanceof JSONStreamWriterRootContext) {
195 context.emitEnd(writer);
199 private void writeValue(final Object value, final JSONCodec<Object> codec)
201 codec.serializeToWriter(writer,value);
205 public void flush() throws IOException {
210 public void close() throws IOException {