Bug 2497: Added YIN Export for Effective Schema Context.
[yangtools.git] / yang / yang-model-export / src / main / java / org / opendaylight / yangtools / yang / model / export / SingleModuleYinStatementWriter.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.yang.model.export;
9
10 import com.google.common.annotations.Beta;
11 import com.google.common.base.Preconditions;
12 import com.google.common.collect.BiMap;
13 import com.google.common.collect.HashBiMap;
14 import java.net.URI;
15 import java.util.Iterator;
16 import java.util.Map;
17 import java.util.Map.Entry;
18 import javax.annotation.Nullable;
19 import javax.annotation.concurrent.NotThreadSafe;
20 import javax.xml.XMLConstants;
21 import javax.xml.stream.XMLStreamException;
22 import javax.xml.stream.XMLStreamWriter;
23 import org.opendaylight.yangtools.yang.common.QName;
24 import org.opendaylight.yangtools.yang.common.YangConstants;
25 import org.opendaylight.yangtools.yang.model.api.RevisionAwareXPath;
26 import org.opendaylight.yangtools.yang.model.api.Rfc6020Mapping;
27 import org.opendaylight.yangtools.yang.model.api.SchemaPath;
28 import org.opendaylight.yangtools.yang.model.api.meta.StatementDefinition;
29
30 @Beta
31 @NotThreadSafe
32 class SingleModuleYinStatementWriter implements StatementTextWriter {
33
34     private final XMLStreamWriter writer;
35     private final URI currentModuleNs;
36     private final BiMap<String, URI> prefixToNamespace;
37     private StatementDefinition currentStatement;
38
39     private SingleModuleYinStatementWriter(final XMLStreamWriter writer, final URI moduleNamespace,
40             final Map<String, URI> prefixToNs) {
41         super();
42         this.writer = writer;
43         this.currentModuleNs = moduleNamespace;
44         this.prefixToNamespace = HashBiMap.create(prefixToNs);
45         initializeYinNamespaceInXml();
46
47     }
48
49     private void initializeYinNamespaceInXml() {
50        try {
51             final String defaultNs = writer.getNamespaceContext().getNamespaceURI(XMLConstants.NULL_NS_URI);
52             if (defaultNs == null) {
53                 writer.setDefaultNamespace(YangConstants.RFC6020_YIN_NAMESPACE.toString());
54             } else if (!YangConstants.RFC6020_YIN_NAMESPACE.toString().equals(defaultNs)) {
55                 // FIXME: Implement support for exporting YIN as part of other XML document.
56                 throw new UnsupportedOperationException("Not implemented support for nesting YIN in different XML element.");
57             }
58         } catch (final XMLStreamException e) {
59             throw new IllegalStateException(e);
60         }
61     }
62
63     static final StatementTextWriter create(final XMLStreamWriter writer, final URI moduleNs,
64             final Map<String, URI> prefixToNs) {
65         return new SingleModuleYinStatementWriter(writer, moduleNs, prefixToNs);
66     }
67
68     @Override
69     public void startStatement(final StatementDefinition statement) {
70         currentStatement = Preconditions.checkNotNull(statement);
71         try {
72             writeStartXmlElement(statement.getStatementName());
73             if (Rfc6020Mapping.Module.equals(statement) || Rfc6020Mapping.Submodule.equals(statement)) {
74                 declareXmlNamespaces(prefixToNamespace);
75             }
76         } catch (final XMLStreamException e) {
77             // FIXME: Introduce proper expression
78             throw new IllegalStateException(e);
79         }
80     }
81
82     @Override
83     public void endStatement() {
84         currentStatement = null;
85         try {
86             writeXmlEndElement();
87         } catch (final XMLStreamException e) {
88             // FIXME: Introduce proper expression
89             throw new IllegalStateException(e);
90         }
91     }
92
93     @Override
94     public void writeArgument(final String strRep) {
95         checkArgumentApplicable();
96         writeArgument0(strRep);
97     }
98
99     @Override
100     public void writeArgument(final QName value) {
101         checkArgumentApplicable();
102         final String valueStr = toPrefixedString(value);
103         writeArgument0(valueStr);
104     }
105
106     @Override
107     public void writeArgument(final SchemaPath targetPath) {
108         checkArgumentApplicable();
109         final StringBuilder valueStr = new StringBuilder();
110         if(targetPath.isAbsolute()) {
111             valueStr.append("/");
112         }
113         final Iterator<QName> argIt = targetPath.getPathFromRoot().iterator();
114         while(argIt.hasNext()) {
115             valueStr.append(toPrefixedString(argIt.next()));
116             if(argIt.hasNext()) {
117                 valueStr.append("/");
118             }
119         }
120         writeArgument0(valueStr.toString());
121     }
122
123     @Override
124     public void writeArgument(final RevisionAwareXPath xpath) {
125         checkArgumentApplicable();
126         // FIXME: This implementation assumes prefixes are unchanged
127         // and were not changed in schema context.
128         writeArgument0(xpath.toString());
129     }
130
131
132     private void writeArgument0(final String strRep) {
133         try {
134             if (isArgumentYinElement(currentStatement)) {
135                 writeStartXmlElement(currentStatement.getArgumentName());
136                 writeXmlText(strRep);
137                 writeXmlEndElement();
138             } else {
139                 writeXmlArgument(currentStatement.getArgumentName(), strRep);
140             }
141         } catch (final XMLStreamException e) {
142             // FIXME: throw proper exception
143             throw new IllegalStateException(e);
144         }
145     }
146
147     private boolean isArgumentYinElement(StatementDefinition currentStatement2) {
148         // FIXME: Implement this
149         return false;
150     }
151
152     private void checkArgumentApplicable() {
153         Preconditions.checkState(currentStatement != null, "No statement is opened.");
154         Preconditions.checkState(currentStatement.getArgumentName() != null, "Statement %s does not take argument.",
155                 currentStatement.getArgumentName());
156     }
157
158
159
160     private String toPrefixedString(@Nullable final String prefix, final String localName) {
161         if (prefix == null || prefix.isEmpty()) {
162             return localName;
163         }
164         return prefix + ":" + localName;
165     }
166
167     private String toPrefixedString(final QName value) {
168         final URI valueNs = value.getNamespace();
169         final String valueLocal = value.getLocalName();
170         if (currentModuleNs.equals(valueNs)) {
171             return valueLocal;
172         }
173         final String prefix = ensureAndGetXmlNamespacePrefix(valueNs);
174         return toPrefixedString(prefix, valueLocal);
175     }
176
177     private @Nullable String ensureAndGetXmlNamespacePrefix(final URI namespace) {
178         if(YangConstants.RFC6020_YANG_NAMESPACE.equals(namespace)) {
179          // YANG namespace does not have prefix if used in arguments.
180             return null;
181
182         }
183         String prefix = writer.getNamespaceContext().getPrefix(namespace.toString());
184         if (prefix == null) {
185             // FIXME: declare prefix
186             prefix =prefixToNamespace.inverse().get(namespace);
187         }
188         if(prefix == null) {
189             throw new IllegalArgumentException("Namespace " + namespace + " is not bound to imported prefixes.");
190         }
191         return prefix;
192     }
193
194     private void writeXmlText(final String strRep) throws XMLStreamException {
195         writer.writeCharacters(strRep);
196     }
197
198     private void declareXmlNamespaces(final Map<String, URI> prefixToNamespace) {
199         try {
200             writer.writeDefaultNamespace(YangConstants.RFC6020_YIN_NAMESPACE.toString());
201             for (final Entry<String, URI> nsDeclaration : prefixToNamespace.entrySet()) {
202                 writer.writeNamespace(nsDeclaration.getKey(), nsDeclaration.getValue().toString());
203             }
204         } catch (final XMLStreamException e) {
205             throw new IllegalStateException(e);
206         }
207     }
208
209     private void writeXmlEndElement() throws XMLStreamException {
210         writer.writeEndElement();
211     }
212
213     private void writeXmlArgument(final QName qName, final String value) throws XMLStreamException {
214         writer.writeAttribute(qName.getNamespace().toString(), qName.getLocalName(), value);
215     }
216
217     private void writeStartXmlElement(final QName name) throws XMLStreamException {
218         writer.writeStartElement(name.getNamespace().toString(), name.getLocalName());
219     }
220
221 }