2 * Copyright (c) 2016 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.restconf.nb.rfc8040.utils.parser;
10 import com.google.common.base.Preconditions;
12 import java.util.Iterator;
13 import java.util.Map.Entry;
14 import org.opendaylight.restconf.nb.rfc8040.utils.RestconfConstants;
15 import org.opendaylight.restconf.nb.rfc8040.utils.parser.builder.ParserBuilderConstants;
16 import org.opendaylight.restconf.nb.rfc8040.utils.parser.builder.ParserBuilderConstants.Serializer;
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;
20 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeIdentifierWithPredicates;
21 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.NodeWithValue;
22 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier.PathArgument;
23 import org.opendaylight.yangtools.yang.data.util.DataSchemaContextNode;
24 import org.opendaylight.yangtools.yang.data.util.DataSchemaContextTree;
25 import org.opendaylight.yangtools.yang.model.api.Module;
26 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
29 * Serializer for {@link YangInstanceIdentifier} to {@link String} for restconf.
31 public final class YangInstanceIdentifierSerializer {
33 private YangInstanceIdentifierSerializer() {
34 throw new UnsupportedOperationException("Util class.");
38 * Method to create String from {@link Iterable} of {@link PathArgument}
39 * which are parsing from data by {@link SchemaContext}.
41 * @param schemaContext
42 * for validate of parsing path arguments
45 * @return {@link String}
47 public static String create(final SchemaContext schemaContext, final YangInstanceIdentifier data) {
48 final DataSchemaContextNode<?> current = DataSchemaContextTree.from(schemaContext).getRoot();
49 final MainVarsWrapper variables = new MainVarsWrapper(current);
50 final StringBuilder path = new StringBuilder();
52 QNameModule parentModule = null;
53 for (int i = 0; i < data.getPathArguments().size(); i++) {
54 // get module of the parent
55 if (!variables.getCurrent().isMixin()) {
56 parentModule = variables.getCurrent().getDataSchemaNode().getQName().getModule();
59 final PathArgument arg = data.getPathArguments().get(i);
60 variables.setCurrent(variables.getCurrent().getChild(arg));
62 Preconditions.checkArgument(variables.getCurrent() != null,
63 "Invalid input %s: schema for argument %s (after %s) not found", data, arg, path);
65 if (variables.getCurrent().isMixin()) {
69 // append namespace before every node which is defined in other module than its parent
70 // condition is satisfied also for the first path argument
71 if (!arg.getNodeType().getModule().equals(parentModule)) {
72 // append slash if it is not the first path argument
73 if (path.length() > 0) {
74 path.append(RestconfConstants.SLASH);
77 path.append(prefixForNamespace(arg.getNodeType(), schemaContext));
78 path.append(ParserBuilderConstants.Deserializer.COLON);
80 path.append(RestconfConstants.SLASH);
83 if (arg instanceof NodeIdentifierWithPredicates) {
84 prepareNodeWithPredicates(path, arg);
85 } else if (arg instanceof NodeWithValue) {
86 prepareNodeWithValue(path, arg);
88 appendQName(path, arg.getNodeType());
92 return path.toString();
95 private static void prepareNodeWithValue(final StringBuilder path, final PathArgument arg) {
96 path.append(arg.getNodeType().getLocalName());
97 path.append(ParserBuilderConstants.Deserializer.EQUAL);
99 String value = String.valueOf(((NodeWithValue<String>) arg).getValue());
100 if (Serializer.PERCENT_ENCODE_CHARS.matchesAnyOf(value)) {
101 value = parsePercentEncodeChars(value);
106 private static void prepareNodeWithPredicates(final StringBuilder path, final PathArgument arg) {
107 path.append(arg.getNodeType().getLocalName());
109 final Iterator<Entry<QName, Object>> iterator = ((NodeIdentifierWithPredicates) arg).getKeyValues()
110 .entrySet().iterator();
112 if (iterator.hasNext()) {
113 path.append(ParserBuilderConstants.Deserializer.EQUAL);
116 while (iterator.hasNext()) {
117 String valueOf = String.valueOf(iterator.next().getValue());
118 if (Serializer.PERCENT_ENCODE_CHARS.matchesAnyOf(valueOf)) {
119 valueOf = parsePercentEncodeChars(valueOf);
121 path.append(valueOf);
122 if (iterator.hasNext()) {
123 path.append(ParserBuilderConstants.Deserializer.COMMA);
129 * Encode {@link Serializer#DISABLED_CHARS} chars to percent encoded chars.
133 * @return encoded {@link String}
135 private static String parsePercentEncodeChars(final String valueOf) {
136 final StringBuilder sb = new StringBuilder();
138 while (start < valueOf.length()) {
139 if (Serializer.PERCENT_ENCODE_CHARS.matches(valueOf.charAt(start))) {
140 final String format = String.format("%x", (int) valueOf.charAt(start));
141 final String upperCase = format.toUpperCase();
142 sb.append(ParserBuilderConstants.Deserializer.PERCENT_ENCODING + upperCase);
144 sb.append(valueOf.charAt(start));
148 return sb.toString();
152 * Add {@link QName} to the serialized string.
155 * {@link StringBuilder}
158 * @return {@link StringBuilder}
160 private static StringBuilder appendQName(final StringBuilder path, final QName qname) {
161 path.append(qname.getLocalName());
166 * Create prefix of namespace from {@link QName}.
170 * @return {@link String}
172 private static String prefixForNamespace(final QName qname, final SchemaContext schemaContext) {
173 final URI namespace = qname.getNamespace();
174 Preconditions.checkArgument(namespace != null, "Failed to map QName {}", qname);
175 final Module module = schemaContext.findModuleByNamespaceAndRevision(namespace, qname.getRevision());
176 return module.getName();
179 private static final class MainVarsWrapper {
181 private DataSchemaContextNode<?> current;
183 MainVarsWrapper(final DataSchemaContextNode<?> current) {
184 this.setCurrent(current);
187 public DataSchemaContextNode<?> getCurrent() {
191 public void setCurrent(final DataSchemaContextNode<?> current) {
192 this.current = current;