yang/yang-data-codec-gson/src/main/java/org/opendaylight/yangtools/yang/data/codec/gson/JSONNormalizedNodeStreamWriter.java

   1 /*
   2  * Copyright (c) 2014 Cisco Systems, Inc. and others.  All rights reserved.
   3  *
   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
   7  */
   8 package org.opendaylight.yangtools.yang.data.codec.gson;
   9
  10 import com.google.common.base.Preconditions;
  11 import com.google.common.base.Strings;
  12 import com.google.gson.stream.JsonWriter;
  13 import java.io.IOException;
  14 import java.io.Writer;
  15 import java.net.URI;
  16 import java.util.ArrayDeque;
  17 import java.util.Deque;
  18 import org.opendaylight.yangtools.concepts.Codec;
  19 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.AugmentationIdentifier;
  20 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifier;
  21 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates;
  22 import org.opendaylight.yangtools.yang.data.api.schema.stream.NormalizedNodeStreamWriter;
  23 import org.opendaylight.yangtools.yang.data.impl.codec.SchemaTracker;
  24 import org.opendaylight.yangtools.yang.model.api.AnyXmlSchemaNode;
  25 import org.opendaylight.yangtools.yang.model.api.LeafListSchemaNode;
  26 import org.opendaylight.yangtools.yang.model.api.LeafSchemaNode;
  27 import org.opendaylight.yangtools.yang.model.api.Module;
  28 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
  29 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
  30
  31 /**
  32  * This implementation will create JSON output as output stream.
  33  *
  34  * Values of leaf and leaf-list are NOT translated according to codecs.
  35  *
  36  * FIXME: rewrite this in terms of {@link JsonWriter}.
  37  */
  38 public class JSONNormalizedNodeStreamWriter implements NormalizedNodeStreamWriter {
  39
  40     private static enum NodeType {
  41         OBJECT,
  42         LIST,
  43         OTHER,
  44     }
  45
  46     private static class TypeInfo {
  47         private boolean hasAtLeastOneChild = false;
  48         private final NodeType type;
  49         private final URI uri;
  50
  51         public TypeInfo(final NodeType type, final URI uri) {
  52             this.type = type;
  53             this.uri = uri;
  54         }
  55
  56         public void setHasAtLeastOneChild(final boolean hasChildren) {
  57             this.hasAtLeastOneChild = hasChildren;
  58         }
  59
  60         public NodeType getType() {
  61             return type;
  62         }
  63
  64         public URI getNamespace() {
  65             return uri;
  66         }
  67
  68         public boolean hasAtLeastOneChild() {
  69             return hasAtLeastOneChild;
  70         }
  71     }
  72
  73     private final Deque<TypeInfo> stack = new ArrayDeque<>();
  74     private final SchemaContext schemaContext;
  75     private final CodecFactory codecs;
  76     private final SchemaTracker tracker;
  77     private final Writer writer;
  78     private final String indent;
  79
  80     private URI currentNamespace = null;
  81     private int currentDepth = 0;
  82
  83     private JSONNormalizedNodeStreamWriter(final SchemaContext schemaContext,
  84             final Writer writer, final int indentSize) {
  85         this.schemaContext = Preconditions.checkNotNull(schemaContext);
  86         this.writer = Preconditions.checkNotNull(writer);
  87
  88         Preconditions.checkArgument(indentSize >= 0, "Indent size must be non-negative");
  89         if (indentSize != 0) {
  90             indent = Strings.repeat(" ", indentSize);
  91         } else {
  92             indent = null;
  93         }
  94
  95         this.codecs = CodecFactory.create(schemaContext);
  96         this.tracker = SchemaTracker.create(schemaContext);
  97     }
  98
  99     private JSONNormalizedNodeStreamWriter(final SchemaContext schemaContext, final SchemaPath path,
 100             final Writer writer, final int indentSize) {
 101         this.schemaContext = Preconditions.checkNotNull(schemaContext);
 102         this.writer = Preconditions.checkNotNull(writer);
 103
 104         Preconditions.checkArgument(indentSize >= 0, "Indent size must be non-negative");
 105         if (indentSize != 0) {
 106             indent = Strings.repeat(" ", indentSize);
 107         } else {
 108             indent = null;
 109         }
 110
 111         this.codecs = CodecFactory.create(schemaContext);
 112         this.tracker = SchemaTracker.create(schemaContext,path);
 113     }
 114
 115     /**
 116      * Create a new stream writer, which writes to the specified {@link Writer}.
 117      *
 118      * @param schemaContext Schema context
 119      * @param writer Output writer
 120      * @return A stream writer instance
 121      */
 122     public static NormalizedNodeStreamWriter create(final SchemaContext schemaContext, final Writer writer) {
 123         return new JSONNormalizedNodeStreamWriter(schemaContext, writer, 0);
 124     }
 125
 126     /**
 127      * Create a new stream writer, which writes to the specified {@link Writer}.
 128      *
 129      * @param schemaContext Schema context
 130      * @param writer Output writer
 131      * @return A stream writer instance
 132      */
 133     public static NormalizedNodeStreamWriter create(final SchemaContext schemaContext, SchemaPath path,final Writer writer) {
 134         return new JSONNormalizedNodeStreamWriter(schemaContext, path, writer, 0);
 135     }
 136
 137     /**
 138      * Create a new stream writer, which writes to the specified output stream.
 139      *
 140      * @param schemaContext Schema context
 141      * @param writer Output writer
 142      * @param indentSize indentation size
 143      * @return A stream writer instance
 144      */
 145     public static NormalizedNodeStreamWriter create(final SchemaContext schemaContext, final Writer writer, final int indentSize) {
 146         return new JSONNormalizedNodeStreamWriter(schemaContext, writer, indentSize);
 147     }
 148
 149     @Override
 150     public void leafNode(final NodeIdentifier name, final Object value) throws IOException {
 151         final LeafSchemaNode schema = tracker.leafNode(name);
 152         final Codec<Object, Object> codec = codecs.codecFor(schema.getType());
 153
 154         separateElementFromPreviousElement();
 155         writeJsonIdentifier(name);
 156         currentNamespace = stack.peek().getNamespace();
 157         writeValue(String.valueOf(codec.serialize(value)));
 158         separateNextSiblingsWithComma();
 159     }
 160
 161     @Override
 162     public void startLeafSet(final NodeIdentifier name, final int childSizeHint) throws IOException {
 163         tracker.startLeafSet(name);
 164
 165         separateElementFromPreviousElement();
 166         stack.push(new TypeInfo(NodeType.LIST, name.getNodeType().getNamespace()));
 167         writeJsonIdentifier(name);
 168         writeStartList();
 169         indentRight();
 170     }
 171
 172     @Override
 173     public void leafSetEntryNode(final Object value) throws IOException {
 174         final LeafListSchemaNode schema = tracker.leafSetEntryNode();
 175         final Codec<Object, Object> codec = codecs.codecFor(schema.getType());
 176
 177         separateElementFromPreviousElement();
 178         writeValue(String.valueOf(codec.serialize(value)));
 179         separateNextSiblingsWithComma();
 180     }
 181
 182     @Override
 183     public void startContainerNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 184         tracker.startContainerNode(name);
 185
 186         separateElementFromPreviousElement();
 187         stack.push(new TypeInfo(NodeType.OBJECT, name.getNodeType().getNamespace()));
 188         writeJsonIdentifier(name);
 189         writeStartObject();
 190         indentRight();
 191     }
 192
 193     @Override
 194     public void startUnkeyedList(final NodeIdentifier name, final int childSizeHint) throws IOException {
 195         tracker.startList(name);
 196
 197         separateElementFromPreviousElement();
 198         stack.push(new TypeInfo(NodeType.LIST, name.getNodeType().getNamespace()));
 199         writeJsonIdentifier(name);
 200         writeStartList();
 201         indentRight();
 202     }
 203
 204     @Override
 205     public void startUnkeyedListItem(final NodeIdentifier name, final int childSizeHint) throws IOException {
 206         tracker.startListItem(name);
 207
 208         stack.push(new TypeInfo(NodeType.OBJECT, name.getNodeType().getNamespace()));
 209         separateElementFromPreviousElement();
 210         writeStartObject();
 211         indentRight();
 212     }
 213
 214     @Override
 215     public void startMapNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 216         tracker.startList(name);
 217
 218         separateElementFromPreviousElement();
 219         stack.push(new TypeInfo(NodeType.LIST, name.getNodeType().getNamespace()));
 220         writeJsonIdentifier(name);
 221         writeStartList();
 222         indentRight();
 223     }
 224
 225     @Override
 226     public void startMapEntryNode(final NodeIdentifierWithPredicates identifier, final int childSizeHint)
 227             throws IOException {
 228         tracker.startListItem(identifier);
 229         separateElementFromPreviousElement();
 230         stack.push(new TypeInfo(NodeType.OBJECT, identifier.getNodeType().getNamespace()));
 231
 232
 233         writeStartObject();
 234         indentRight();
 235     }
 236
 237     @Override
 238     public void startOrderedMapNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 239         tracker.startListItem(name);
 240
 241         stack.push(new TypeInfo(NodeType.LIST, name.getNodeType().getNamespace()));
 242         separateElementFromPreviousElement();
 243         writeJsonIdentifier(name);
 244         writeStartList();
 245         indentRight();
 246     }
 247
 248     @Override
 249     public void startChoiceNode(final NodeIdentifier name, final int childSizeHint) throws IllegalArgumentException {
 250         tracker.startChoiceNode(name);
 251         handleInvisibleNode(name.getNodeType().getNamespace());
 252     }
 253
 254     @Override
 255     public void startAugmentationNode(final AugmentationIdentifier identifier) throws IllegalArgumentException {
 256         tracker.startAugmentationNode(identifier);
 257         handleInvisibleNode(currentNamespace);
 258     }
 259
 260     @Override
 261     public void anyxmlNode(final NodeIdentifier name, final Object value) throws IOException {
 262         final AnyXmlSchemaNode schema = tracker.anyxmlNode(name);
 263         // FIXME: should have a codec based on this :)
 264
 265         separateElementFromPreviousElement();
 266         writeJsonIdentifier(name);
 267         currentNamespace = stack.peek().getNamespace();
 268         writeValue(value.toString());
 269         separateNextSiblingsWithComma();
 270     }
 271
 272     @Override
 273     public void endNode() throws IOException {
 274         tracker.endNode();
 275
 276         final TypeInfo t = stack.pop();
 277         switch (t.getType()) {
 278         case LIST:
 279             indentLeft();
 280             newLine();
 281             writer.append(']');
 282             break;
 283         case OBJECT:
 284             indentLeft();
 285             newLine();
 286             writer.append('}');
 287             break;
 288         default:
 289             break;
 290         }
 291
 292         currentNamespace = stack.isEmpty() ? null : stack.peek().getNamespace();
 293         separateNextSiblingsWithComma();
 294     }
 295
 296     private void separateElementFromPreviousElement() throws IOException {
 297         if (!stack.isEmpty() && stack.peek().hasAtLeastOneChild()) {
 298             writer.append(',');
 299         }
 300         newLine();
 301     }
 302
 303     private void newLine() throws IOException {
 304         if (indent != null) {
 305             writer.append('\n');
 306
 307             for (int i = 0; i < currentDepth; i++) {
 308                 writer.append(indent);
 309             }
 310         }
 311     }
 312
 313     private void separateNextSiblingsWithComma() {
 314         if (!stack.isEmpty()) {
 315             stack.peek().setHasAtLeastOneChild(true);
 316         }
 317     }
 318
 319     /**
 320      * Invisible nodes have to be also pushed to stack because of pairing of start*() and endNode() methods. Information
 321      * about child existing (due to printing comma) has to be transfered to invisible node.
 322      */
 323     private void handleInvisibleNode(final URI uri) {
 324         TypeInfo typeInfo = new TypeInfo(NodeType.OTHER, uri);
 325         typeInfo.setHasAtLeastOneChild(stack.peek().hasAtLeastOneChild());
 326         stack.push(typeInfo);
 327     }
 328
 329     private void writeStartObject() throws IOException {
 330         writer.append('{');
 331     }
 332
 333     private void writeStartList() throws IOException {
 334         writer.append('[');
 335     }
 336
 337     private void writeModulName(final URI namespace) throws IOException {
 338         if (this.currentNamespace == null || namespace != this.currentNamespace) {
 339             Module module = schemaContext.findModuleByNamespaceAndRevision(namespace, null);
 340             writer.append(module.getName());
 341             writer.append(':');
 342             currentNamespace = namespace;
 343         }
 344     }
 345
 346     private void writeValue(final String value) throws IOException {
 347         writer.append('"');
 348         writer.append(value);
 349         writer.append('"');
 350     }
 351
 352     private void writeJsonIdentifier(final NodeIdentifier name) throws IOException {
 353         writer.append('"');
 354         writeModulName(name.getNodeType().getNamespace());
 355         writer.append(name.getNodeType().getLocalName());
 356         writer.append("\":");
 357     }
 358
 359     private void indentRight() {
 360         currentDepth++;
 361     }
 362
 363     private void indentLeft() {
 364         currentDepth--;
 365     }
 366
 367     @Override
 368     public void flush() throws IOException {
 369         writer.flush();
 370     }
 371
 372     @Override
 373     public void close() throws IOException {
 374         writer.flush();
 375         writer.close();
 376     }
 377
 378 }