import static org.opendaylight.yangtools.yang.parser.spi.meta.StmtContextUtils.firstAttributeOf;
-import java.net.URI;
-import java.net.URISyntaxException;
+import com.google.common.base.CharMatcher;
+import com.google.common.base.Splitter;
+import com.google.common.collect.Iterables;
+
import java.util.ArrayList;
import java.util.Arrays;
-import java.util.Date;
+import java.util.Collection;
+import java.util.HashSet;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.List;
+import java.util.Objects;
+import java.util.Set;
import javax.annotation.Nullable;
import javax.xml.xpath.XPath;
import org.opendaylight.yangtools.antlrv4.code.gen.YangStatementParser;
import org.opendaylight.yangtools.yang.common.QName;
import org.opendaylight.yangtools.yang.common.QNameModule;
+import org.opendaylight.yangtools.yang.common.SimpleDateFormatUtil;
+import org.opendaylight.yangtools.yang.common.YangConstants;
+import org.opendaylight.yangtools.yang.model.api.DataSchemaNode;
+import org.opendaylight.yangtools.yang.model.api.Deviation;
import org.opendaylight.yangtools.yang.model.api.ModuleIdentifier;
import org.opendaylight.yangtools.yang.model.api.SchemaPath;
+import org.opendaylight.yangtools.yang.model.api.Status;
+import org.opendaylight.yangtools.yang.model.api.stmt.AugmentStatement;
import org.opendaylight.yangtools.yang.model.api.stmt.BelongsToStatement;
+import org.opendaylight.yangtools.yang.model.api.stmt.ChoiceStatement;
import org.opendaylight.yangtools.yang.model.api.stmt.ModuleStatement;
-import org.opendaylight.yangtools.yang.model.api.stmt.PrefixStatement;
import org.opendaylight.yangtools.yang.model.api.stmt.SchemaNodeIdentifier;
+import org.opendaylight.yangtools.yang.model.api.stmt.SchemaNodeIdentifier.Relative;
import org.opendaylight.yangtools.yang.model.api.stmt.SubmoduleStatement;
+import org.opendaylight.yangtools.yang.model.api.stmt.UsesStatement;
import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext;
+import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContext.Mutable;
import org.opendaylight.yangtools.yang.parser.spi.meta.StmtContextUtils;
import org.opendaylight.yangtools.yang.parser.spi.source.BelongsToPrefixToModuleName;
import org.opendaylight.yangtools.yang.parser.spi.source.ImpPrefixToModuleIdentifier;
+import org.opendaylight.yangtools.yang.parser.spi.source.ModuleCtxToModuleQName;
import org.opendaylight.yangtools.yang.parser.spi.source.ModuleIdentifierToModuleQName;
import org.opendaylight.yangtools.yang.parser.spi.source.ModuleNameToModuleQName;
import org.opendaylight.yangtools.yang.parser.spi.source.PrefixToModule;
+import org.opendaylight.yangtools.yang.parser.spi.source.QNameToStatementDefinition;
+import org.opendaylight.yangtools.yang.parser.spi.validation.ValidationBundlesNamespace;
+import org.opendaylight.yangtools.yang.parser.spi.validation.ValidationBundlesNamespace.ValidationBundleType;
import org.opendaylight.yangtools.yang.parser.stmt.reactor.StatementContextBase;
-
-import com.google.common.base.CharMatcher;
-import com.google.common.base.Splitter;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public final class Utils {
- private Utils() {
- }
-
private static final Logger LOG = LoggerFactory.getLogger(Utils.class);
private static final CharMatcher DOUBLE_QUOTE_MATCHER = CharMatcher.is('"');
private static final CharMatcher SINGLE_QUOTE_MATCHER = CharMatcher.is('\'');
+ public static final QName EMPTY_QNAME = QName.create("empty", "empty");
+
private static final char SEPARATOR_NODENAME = '/';
- private static final String REGEX_PATH_ABS = "/[^/].+";
+ private static final String REGEX_PATH_ABS = "/[^/].*";
+
+ public static final char SEPARATOR = ' ';
+
+ private Utils() {
+ }
+
+ public static Collection<SchemaNodeIdentifier.Relative> transformKeysStringToKeyNodes(StmtContext<?, ?, ?> ctx,
+ String value) {
+ Splitter keySplitter = Splitter.on(SEPARATOR).omitEmptyStrings().trimResults();
+ List<String> keyTokens = keySplitter.splitToList(value);
+
+ // to detect if key contains duplicates
+ if ((new HashSet<>(keyTokens)).size() < keyTokens.size()) {
+ throw new IllegalArgumentException();
+ }
+
+ Set<SchemaNodeIdentifier.Relative> keyNodes = new HashSet<>();
+
+ for (String keyToken : keyTokens) {
+
+ SchemaNodeIdentifier.Relative keyNode = (Relative) SchemaNodeIdentifier.Relative.create(false,
+ Utils.qNameFromArgument(ctx, keyToken));
+ keyNodes.add(keyNode);
+ }
+
+ return keyNodes;
+ }
public static List<String> splitPathToNodeNames(String path) {
return keySplitter.splitToList(path);
}
- public static void validateXPath(String path) {
+ public static void validateXPath(final StmtContext<?, ?, ?> ctx, String path) {
final XPath xPath = XPathFactory.newInstance().newXPath();
try {
xPath.compile(path);
} catch (XPathExpressionException e) {
- throw new IllegalArgumentException("Argument is not valid XPath string", e);
+ throw new IllegalArgumentException(String.format("Argument %s is not valid XPath string at %s", path, ctx
+ .getStatementSourceReference().toString()), e);
}
}
- public static boolean isXPathAbsolute(String path) {
+ private static String trimSingleLastSlashFromXPath(final String path) {
+ return path.replaceAll("/$", "");
+ }
+
+ public static boolean isXPathAbsolute(final StmtContext<?, ?, ?> ctx, String path) {
- validateXPath(path);
+ validateXPath(ctx, trimSingleLastSlashFromXPath(path));
return path.matches(REGEX_PATH_ABS);
}
+ public static QName trimPrefix(QName identifier) {
+ String prefixedLocalName = identifier.getLocalName();
+ String[] namesParts = prefixedLocalName.split(":");
+
+ if (namesParts.length == 2) {
+ String localName = namesParts[1];
+ return QName.create(identifier.getModule(), localName);
+ }
+
+ return identifier;
+ }
+
+ public static String getPrefixFromArgument(String prefixedLocalName) {
+ String[] namesParts = prefixedLocalName.split(":");
+ if (namesParts.length == 2) {
+ return namesParts[0];
+ }
+ return null;
+ }
+
+ public static boolean isValidStatementDefinition(PrefixToModule prefixes, QNameToStatementDefinition stmtDef,
+ QName identifier) {
+ if (stmtDef.get(identifier) != null) {
+ return true;
+ } else {
+ String prefixedLocalName = identifier.getLocalName();
+ String[] namesParts = prefixedLocalName.split(":");
+
+ if (namesParts.length == 2) {
+ String prefix = namesParts[0];
+ String localName = namesParts[1];
+ if (prefixes != null && prefixes.get(prefix) != null
+ && stmtDef.get(new QName(YangConstants.RFC6020_YIN_NAMESPACE, localName)) != null) {
+ return true;
+ } else {
+ if (stmtDef.get(new QName(YangConstants.RFC6020_YIN_NAMESPACE, localName)) != null) {
+ return true;
+ }
+ }
+ }
+ }
+ return false;
+ }
+
public static Iterable<QName> parseXPath(StmtContext<?, ?, ?> ctx, String path) {
- validateXPath(path);
+ String trimmedPath = trimSingleLastSlashFromXPath(path);
+
+ validateXPath(ctx, trimmedPath);
- List<String> nodeNames = splitPathToNodeNames(path);
+ List<String> nodeNames = splitPathToNodeNames(trimmedPath);
List<QName> qNames = new ArrayList<>();
for (String nodeName : nodeNames) {
public static String stringFromStringContext(final YangStatementParser.ArgumentContext context) {
StringBuilder sb = new StringBuilder();
List<TerminalNode> strings = context.STRING();
- if (strings.size() == 0) {
+ if (strings.isEmpty()) {
strings = Arrays.asList(context.IDENTIFIER());
}
for (TerminalNode stringNode : strings) {
public static QName qNameFromArgument(StmtContext<?, ?, ?> ctx, String value) {
- String prefix = null;
- QNameModule qNameModule = null;
- try {
- qNameModule = QNameModule.create(new URI(""), new Date(0));
- } catch (URISyntaxException e) {
- LOG.warn(e.getMessage(), e);
+ if (value == null || value.equals("")) {
+ return EMPTY_QNAME;
}
+
+ String prefix;
+ QNameModule qNameModule = null;
String localName = null;
String[] namesParts = value.split(":");
switch (namesParts.length) {
case 1:
localName = namesParts[0];
-
- if (StmtContextUtils.producesDeclared(ctx.getRoot(), ModuleStatement.class)) {
- prefix = firstAttributeOf(ctx.getRoot().declaredSubstatements(), PrefixStatement.class);
- qNameModule = ctx.getFromNamespace(PrefixToModule.class, prefix);
-
- } else if (StmtContextUtils.producesDeclared(ctx.getRoot(), SubmoduleStatement.class)) {
- String belongsToModuleName = firstAttributeOf(ctx.getRoot().declaredSubstatements(),
- BelongsToStatement.class);
- qNameModule = ctx.getFromNamespace(ModuleNameToModuleQName.class, belongsToModuleName);
- }
+ qNameModule = getRootModuleQName(ctx);
break;
case 2:
prefix = namesParts[0];
localName = namesParts[1];
-
- ModuleIdentifier impModIdentifier = ctx.getRoot().getFromNamespace(ImpPrefixToModuleIdentifier.class,
- prefix);
- qNameModule = ctx.getFromNamespace(ModuleIdentifierToModuleQName.class, impModIdentifier);
-
- if (qNameModule == null && StmtContextUtils.producesDeclared(ctx.getRoot(), SubmoduleStatement.class)) {
- String moduleName = ctx.getRoot().getFromNamespace(BelongsToPrefixToModuleName.class, prefix);
- qNameModule = ctx.getFromNamespace(ModuleNameToModuleQName.class, moduleName);
+ qNameModule = getModuleQNameByPrefix(ctx, prefix);
+ // in case of unknown statement argument, we're not going to parse it
+ if (qNameModule == null
+ && ctx.getPublicDefinition().getDeclaredRepresentationClass()
+ .isAssignableFrom(UnknownStatementImpl.class)) {
+ localName = value;
+ qNameModule = getRootModuleQName(ctx);
+ }
+ if (qNameModule == null
+ && Iterables.getLast(ctx.getCopyHistory()) == StmtContext.TypeOfCopy.ADDED_BY_AUGMENTATION) {
+ ctx = ctx.getOriginalCtx();
+ qNameModule = getModuleQNameByPrefix(ctx, prefix);
}
-
break;
default:
break;
}
- return QName.create(qNameModule, localName);
+ if (qNameModule == null) {
+ if (StmtContextUtils.producesDeclared(ctx, UnknownStatementImpl.class)
+ && StmtContextUtils.producesDeclared(ctx.getParentContext(), UnknownStatementImpl.class)) {
+
+ qNameModule = getRootModuleQName(ctx);
+ localName = value;
+ } else {
+ throw new IllegalArgumentException("Error in module '" + ctx.getRoot().rawStatementArgument()
+ + "': can not resolve QNameModule for '" + value + "'.");
+ }
+ }
+
+ QNameModule resultQNameModule = qNameModule.getRevision() == null ? QNameModule.create(
+ qNameModule.getNamespace(), SimpleDateFormatUtil.DEFAULT_DATE_REV) : qNameModule;
+
+ return QName.create(resultQNameModule, localName);
}
- @Nullable
- public static StatementContextBase<?, ?, ?> findCtxOfNodeInRoot(StatementContextBase<?, ?, ?> rootStmtCtx,
- final SchemaNodeIdentifier node) {
+ public static QNameModule getModuleQNameByPrefix(StmtContext<?, ?, ?> ctx, String prefix) {
+ QNameModule qNameModule;
+ ModuleIdentifier impModIdentifier = ctx.getRoot().getFromNamespace(ImpPrefixToModuleIdentifier.class, prefix);
+ qNameModule = ctx.getFromNamespace(ModuleIdentifierToModuleQName.class, impModIdentifier);
- StatementContextBase<?, ?, ?> parent = rootStmtCtx;
- final Iterator<QName> pathIter = node.getPathFromRoot().iterator();
+ if (qNameModule == null && StmtContextUtils.producesDeclared(ctx.getRoot(), SubmoduleStatement.class)) {
+ String moduleName = ctx.getRoot().getFromNamespace(BelongsToPrefixToModuleName.class, prefix);
+ qNameModule = ctx.getFromNamespace(ModuleNameToModuleQName.class, moduleName);
+ }
+ return qNameModule;
+ }
- QName targetNode = pathIter.next();
+ public static QNameModule getRootModuleQName(StmtContext<?, ?, ?> ctx) {
- while (pathIter.hasNext()) {
+ if (ctx == null) {
+ return null;
+ }
- for (StatementContextBase<?, ?, ?> child : parent.declaredSubstatements()) {
+ StmtContext<?, ?, ?> rootCtx = ctx.getRoot();
+ QNameModule qNameModule = null;
- if (targetNode.equals(child.getStatementArgument())) {
- parent = child;
- targetNode = pathIter.next();
- }
- }
+ if (StmtContextUtils.producesDeclared(rootCtx, ModuleStatement.class)) {
+ qNameModule = rootCtx.getFromNamespace(ModuleCtxToModuleQName.class, rootCtx);
+ } else if (StmtContextUtils.producesDeclared(rootCtx, SubmoduleStatement.class)) {
+ String belongsToModuleName = firstAttributeOf(ctx.getRoot().declaredSubstatements(),
+ BelongsToStatement.class);
+ qNameModule = rootCtx.getFromNamespace(ModuleNameToModuleQName.class, belongsToModuleName);
+ }
+
+ return qNameModule.getRevision() == null ? QNameModule.create(qNameModule.getNamespace(),
+ SimpleDateFormatUtil.DEFAULT_DATE_REV) : qNameModule;
+ }
- if (parent.equals(rootStmtCtx)) {
+ @Nullable
+ public static StatementContextBase<?, ?, ?> findNode(StatementContextBase<?, ?, ?> rootStmtCtx,
+ final Iterable<QName> path) {
+ StatementContextBase<?, ?, ?> parent = rootStmtCtx;
+
+ Iterator<QName> pathIter = path.iterator();
+ while (pathIter.hasNext()) {
+ QName nextPathQName = pathIter.next();
+ StatementContextBase<?, ?, ?> foundSubstatement = getSubstatementByQName(parent, nextPathQName);
+
+ if (foundSubstatement == null) {
return null;
}
+ if (!pathIter.hasNext()) {
+ return foundSubstatement;
+ }
+
+ parent = foundSubstatement;
}
- StatementContextBase<?, ?, ?> targetCtx = null;
+ return null;
+ }
- for (StatementContextBase<?, ?, ?> child : parent.declaredSubstatements()) {
+ public static StatementContextBase<?, ?, ?> getSubstatementByQName(StatementContextBase<?, ?, ?> parent,
+ QName nextPathQName) {
- if (targetNode.equals(child.getStatementArgument())) {
- targetCtx = child;
+ Collection<StatementContextBase<?, ?, ?>> declaredSubstatement = parent.declaredSubstatements();
+ Collection<StatementContextBase<?, ?, ?>> effectiveSubstatement = parent.effectiveSubstatements();
+
+ Collection<StatementContextBase<?, ?, ?>> allSubstatements = new LinkedList<>();
+ allSubstatements.addAll(declaredSubstatement);
+ allSubstatements.addAll(effectiveSubstatement);
+
+ for (StatementContextBase<?, ?, ?> substatement : allSubstatements) {
+ if (nextPathQName.equals(substatement.getStatementArgument())) {
+ return substatement;
}
}
- return targetCtx;
+ return null;
+ }
+
+ @Nullable
+ public static StatementContextBase<?, ?, ?> findNode(StatementContextBase<?, ?, ?> rootStmtCtx,
+ final SchemaNodeIdentifier node) {
+ return findNode(rootStmtCtx, node.getPathFromRoot());
}
public static SchemaPath getSchemaPath(StmtContext<?, ?, ?> ctx) {
- Iterator<Object> argumentsIterator = ctx.getArgumentsFromRoot().iterator();
- argumentsIterator.next(); // skip root argument
+ if (ctx == null) {
+ return null;
+ }
- List<QName> qNamesFromRoot = new LinkedList<>();
+ Iterator<StmtContext<?, ?, ?>> iteratorFromRoot = ctx.getStmtContextsFromRoot().iterator();
+
+ if (iteratorFromRoot.hasNext()) {
+ iteratorFromRoot.next(); // skip root argument
+ }
- while (argumentsIterator.hasNext()) {
- Object argument = argumentsIterator.next();
- if (argument instanceof QName) {
- QName qname = (QName) argument;
+ List<QName> qNamesFromRoot = new LinkedList<>();
+ while (iteratorFromRoot.hasNext()) {
+ StmtContext<?, ?, ?> nextStmtCtx = iteratorFromRoot.next();
+ Object nextStmtArgument = nextStmtCtx.getStatementArgument();
+ if (nextStmtArgument instanceof QName) {
+ QName qname = (QName) nextStmtArgument;
+ if (StmtContextUtils.producesDeclared(nextStmtCtx, UsesStatement.class)) {
+ continue;
+ }
+ if (StmtContextUtils.producesDeclared(nextStmtCtx.getParentContext(), ChoiceStatement.class)
+ && isSupportedAsShorthandCase(nextStmtCtx)) {
+ qNamesFromRoot.add(qname);
+ }
qNamesFromRoot.add(qname);
+ } else if (nextStmtArgument instanceof String) {
+ QName qName = qNameFromArgument(ctx, ((String) nextStmtArgument));
+ qNamesFromRoot.add(qName);
+ } else if (StmtContextUtils.producesDeclared(nextStmtCtx, AugmentStatement.class)
+ && nextStmtArgument instanceof SchemaNodeIdentifier) {
+ addQNamesFromSchemaNodeIdentifierToList(qNamesFromRoot, (SchemaNodeIdentifier) nextStmtArgument);
+ } else if (nextStmtCtx.getPublicDefinition().getDeclaredRepresentationClass()
+ .isAssignableFrom(UnknownStatementImpl.class)) {
+ qNamesFromRoot.add(nextStmtCtx.getPublicDefinition().getStatementName());
} else {
return SchemaPath.SAME;
}
}
- return SchemaPath.create(qNamesFromRoot, true);
+ final SchemaPath schemaPath = SchemaPath.create(qNamesFromRoot, true);
+ return schemaPath;
+ }
+
+ private static boolean isSupportedAsShorthandCase(StmtContext<?, ?, ?> statementCtx) {
+
+ Collection<?> supportedCaseShorthands = statementCtx.getFromNamespace(ValidationBundlesNamespace.class,
+ ValidationBundleType.SUPPORTED_CASE_SHORTHANDS);
+
+ return supportedCaseShorthands == null || supportedCaseShorthands.contains(statementCtx.getPublicDefinition());
+ }
+
+ private static void addQNamesFromSchemaNodeIdentifierToList(List<QName> qNamesFromRoot,
+ SchemaNodeIdentifier augmentTargetPath) {
+ Iterator<QName> augmentTargetPathIterator = augmentTargetPath.getPathFromRoot().iterator();
+ while (augmentTargetPathIterator.hasNext()) {
+ qNamesFromRoot.add(augmentTargetPathIterator.next());
+ }
+ }
+
+ public static Deviation.Deviate parseDeviateFromString(final String deviate) {
+
+ // Yang constants should be lowercase so we have throw if value does not
+ // suit this
+ String deviateUpper = deviate.toUpperCase();
+ if (Objects.equals(deviate, deviateUpper)) {
+ throw new IllegalArgumentException(String.format("String %s is not valid deviate argument", deviate));
+ }
+
+ // but Java enum is uppercase so we cannot use lowercase here
+ try {
+ return Deviation.Deviate.valueOf(deviateUpper);
+ } catch (IllegalArgumentException e) {
+ throw new IllegalArgumentException(String.format("String %s is not valid deviate argument", deviate), e);
+ }
+ }
+
+ public static Status parseStatus(String value) {
+
+ Status status = null;
+ switch (value) {
+ case "current":
+ status = Status.CURRENT;
+ break;
+ case "deprecated":
+ status = Status.DEPRECATED;
+ break;
+ case "obsolete":
+ status = Status.OBSOLETE;
+ break;
+ default:
+ LOG.warn("Invalid 'status' statement: " + value);
+ }
+
+ return status;
+ }
+
+ public static SchemaPath SchemaNodeIdentifierToSchemaPath(SchemaNodeIdentifier identifier) {
+ return SchemaPath.create(identifier.getPathFromRoot(), identifier.isAbsolute());
}
}