yang/yang-data-transform/src/main/java/org/opendaylight/yangtools/transform/QNameTransformingStreamWriter.java

   1 /*
   2  * Copyright (c) 2015 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.transform;
   9
  10 import com.google.common.collect.ForwardingObject;
  11 import com.google.common.collect.ImmutableSet;
  12 import java.io.IOException;
  13 import java.util.HashMap;
  14 import java.util.Map;
  15 import java.util.function.Function;
  16 import org.eclipse.jdt.annotation.NonNull;
  17 import org.opendaylight.yangtools.yang.common.QName;
  18 import org.opendaylight.yangtools.yang.common.QNameModule;
  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.YangInstanceIdentifier.NodeWithValue;
  23 import org.opendaylight.yangtools.yang.data.api.schema.stream.NormalizedNodeStreamWriter;
  24
  25 /**
  26  * Stateless Normalized Node Stream Writer decorator, which performs QName translation.
  27  *
  28  * <p>
  29  * This class serves as base for Normalized Node Stream Writer decorators with option to transform
  30  * QNames by user-implemented {@link #transform(QName)} function.
  31  */
  32 public abstract class QNameTransformingStreamWriter extends ForwardingObject implements NormalizedNodeStreamWriter {
  33
  34     // FIXME: Probably use loading cache to decrease memory
  35     @Override
  36     protected abstract NormalizedNodeStreamWriter delegate();
  37
  38     /**
  39      * Returns decorator, which uses supplied function to transform QNames.
  40      *
  41      * @param delegate Underlying normalized node stream writer
  42      * @param transformation Transformation function, function is required to return non-null
  43      *        values.
  44      * @return decorator, which uses supplied function to transform QNames.
  45      */
  46     public static NormalizedNodeStreamWriter fromFunction(final NormalizedNodeStreamWriter delegate,
  47             final Function<QName, QName> transformation) {
  48         return new QNameTransformingStreamWriter() {
  49
  50             @Override
  51             protected NormalizedNodeStreamWriter delegate() {
  52                 return delegate;
  53             }
  54
  55             @Override
  56             protected QName transform(final QName key) {
  57                 return transformation.apply(key);
  58             }
  59         };
  60     }
  61
  62     /**
  63      * Returns decorator, which uses supplied map to transform QNames. QNames not present in map are left unchanged.
  64      *
  65      * @param delegate Underlying normalized node stream writer
  66      * @param mapping Immutable map which represent mapping from original to new values.
  67      * @return decorator, which uses supplied mapping to transform QNames.
  68      */
  69     public static NormalizedNodeStreamWriter createQNameReplacing(final NormalizedNodeStreamWriter delegate,
  70             final Map<QName, QName> mapping) {
  71         return fromFunction(delegate, new QNameReplacementFunction(mapping));
  72     }
  73
  74     /**
  75      * Returns decorator, which uses supplied map to transform QNameModules. QNameModules not present in map are left
  76      * unchanged.
  77      *
  78      * @param delegate Underlying normalized node stream writer
  79      * @param mapping Immutable map which represent mapping from original to new values.
  80      * @return decorator, which uses supplied mapping to transform QNameModules.
  81      */
  82     public static NormalizedNodeStreamWriter createQNameModuleReplacing(final NormalizedNodeStreamWriter delegate,
  83             final Map<QNameModule, QNameModule> mapping) {
  84         return fromFunction(delegate, new QNameModuleReplacementFunction(mapping));
  85     }
  86
  87     @Override
  88     public void startLeafNode(final NodeIdentifier name) throws IOException {
  89         delegate().startLeafNode(transform(name));
  90     }
  91
  92     @Override
  93     public void startLeafSet(final NodeIdentifier name, final int childSizeHint) throws IOException {
  94         delegate().startLeafSet(transform(name), childSizeHint);
  95     }
  96
  97     @Override
  98     public void startOrderedLeafSet(final NodeIdentifier name, final int childSizeHint) throws IOException {
  99         delegate().startOrderedLeafSet(transform(name), childSizeHint);
 100     }
 101
 102     @Override
 103     public void startLeafSetEntryNode(final NodeWithValue<?> name) throws IOException {
 104         delegate().startLeafSetEntryNode(transform(name));
 105     }
 106
 107     @Override
 108     public void startContainerNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 109         delegate().startContainerNode(transform(name), childSizeHint);
 110     }
 111
 112     @Override
 113     public void startUnkeyedList(final NodeIdentifier name, final int childSizeHint) throws IOException {
 114         delegate().startUnkeyedList(transform(name), childSizeHint);
 115     }
 116
 117     @Override
 118     public void startUnkeyedListItem(final NodeIdentifier name, final int childSizeHint) throws IOException {
 119         delegate().startUnkeyedListItem(transform(name), childSizeHint);
 120     }
 121
 122     @Override
 123     public void startMapNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 124         delegate().startMapNode(transform(name), childSizeHint);
 125     }
 126
 127     @Override
 128     public void startMapEntryNode(final NodeIdentifierWithPredicates identifier, final int childSizeHint)
 129             throws IOException {
 130         delegate().startMapEntryNode(transform(identifier), childSizeHint);
 131     }
 132
 133     @Override
 134     public void startOrderedMapNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 135         delegate().startOrderedMapNode(transform(name), childSizeHint);
 136     }
 137
 138     @Override
 139     public void startChoiceNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 140         delegate().startChoiceNode(transform(name), childSizeHint);
 141     }
 142
 143     @Override
 144     public void startAugmentationNode(final AugmentationIdentifier identifier) throws IOException {
 145         delegate().startAugmentationNode(transform(identifier));
 146     }
 147
 148     @Override
 149     public void startAnyxmlNode(final NodeIdentifier name) throws IOException {
 150         delegate().startAnyxmlNode(transform(name));
 151     }
 152
 153     @Override
 154     public void startYangModeledAnyXmlNode(final NodeIdentifier name, final int childSizeHint) throws IOException {
 155         delegate().startYangModeledAnyXmlNode(transform(name), childSizeHint);
 156     }
 157
 158     @Override
 159     public void endNode() throws IOException {
 160         delegate().endNode();
 161     }
 162
 163     @Override
 164     public void close() throws IOException {
 165         delegate().close();
 166     }
 167
 168     @Override
 169     public void flush() throws IOException {
 170         delegate().flush();
 171     }
 172
 173     @Override
 174     public void nodeValue(final Object value) throws IOException {
 175         delegate().nodeValue(value);
 176     }
 177
 178     /**
 179      * Transforms a QName to new mapping.
 180      *
 181      * <p>
 182      * NOTE: If QName should be unchanged implementation needs to return original QName.
 183      *
 184      * @param key QName to transform.
 185      * @return Returns new value of QName.
 186      */
 187     protected abstract @NonNull QName transform(@NonNull QName key);
 188
 189     private NodeIdentifier transform(final NodeIdentifier name) {
 190         return new NodeIdentifier(transform(name.getNodeType()));
 191     }
 192
 193     private <T> NodeWithValue<T> transform(final NodeWithValue<T> name) {
 194         return new NodeWithValue<>(transform(name.getNodeType()), name.getValue());
 195     }
 196
 197     private AugmentationIdentifier transform(final AugmentationIdentifier identifier) {
 198         ImmutableSet.Builder<QName> builder = ImmutableSet.builder();
 199         for (QName original : identifier.getPossibleChildNames()) {
 200             builder.add(transform(original));
 201         }
 202         return new AugmentationIdentifier(builder.build());
 203     }
 204
 205     private NodeIdentifierWithPredicates transform(final NodeIdentifierWithPredicates identifier) {
 206         Map<QName, Object> keyValues = new HashMap<>();
 207         for (Map.Entry<QName, Object> original : identifier.getKeyValues().entrySet()) {
 208             keyValues.put(transform(original.getKey()), original.getValue());
 209         }
 210         return new NodeIdentifierWithPredicates(transform(identifier.getNodeType()), keyValues);
 211     }
 212 }