data/yang-data-util/src/main/java/org/opendaylight/yangtools/yang/data/util/DataSchemaContextTree.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.data.util;
   9
  10 import com.google.common.cache.CacheBuilder;
  11 import com.google.common.cache.CacheLoader;
  12 import com.google.common.cache.LoadingCache;
  13 import java.util.Optional;
  14 import org.eclipse.jdt.annotation.NonNull;
  15 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
  16 import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
  17 import org.opendaylight.yangtools.yang.model.api.EffectiveModelContext;
  18 import org.opendaylight.yangtools.yang.model.spi.AbstractEffectiveModelContextProvider;
  19
  20 /**
  21  * Semantic tree binding a {@link EffectiveModelContext} to a {@link NormalizedNode} tree. Since the layout of the
  22  * schema and data has differences, the mapping is not trivial -- which is where this class comes in.
  23  *
  24  * @author Robert Varga
  25  */
  26 public final class DataSchemaContextTree extends AbstractEffectiveModelContextProvider {
  27     private static final LoadingCache<EffectiveModelContext, DataSchemaContextTree> TREES = CacheBuilder.newBuilder()
  28             .weakKeys().weakValues().build(new CacheLoader<EffectiveModelContext, DataSchemaContextTree>() {
  29                 @Override
  30                 public DataSchemaContextTree load(final EffectiveModelContext key) {
  31                     return new DataSchemaContextTree(key);
  32                 }
  33             });
  34
  35     private final DataSchemaContextNode<?> root;
  36
  37     private DataSchemaContextTree(final EffectiveModelContext ctx) {
  38         super(ctx);
  39         root = DataSchemaContextNode.from(ctx);
  40     }
  41
  42     public static @NonNull DataSchemaContextTree from(final @NonNull EffectiveModelContext ctx) {
  43         return TREES.getUnchecked(ctx);
  44     }
  45
  46     /**
  47      * Find a child node as identified by an absolute {@link YangInstanceIdentifier}.
  48      *
  49      * @param path Path towards the child node
  50      * @return Child node if present, or empty when corresponding child is not found.
  51      * @throws NullPointerException if {@code path} is null
  52      */
  53     public @NonNull Optional<@NonNull DataSchemaContextNode<?>> findChild(final @NonNull YangInstanceIdentifier path) {
  54         return getRoot().findChild(path);
  55     }
  56
  57     public @NonNull DataSchemaContextNode<?> getRoot() {
  58         return root;
  59     }
  60 }