2 * Copyright (c) 2014 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.yangtools.yang.data.api.schema.tree;
10 import java.util.Optional;
11 import org.eclipse.jdt.annotation.NonNull;
12 import org.opendaylight.yangtools.yang.data.api.YangInstanceIdentifier;
13 import org.opendaylight.yangtools.yang.data.api.schema.NormalizedNode;
14 import org.opendaylight.yangtools.yang.model.api.SchemaContext;
17 * Read-only snapshot of a {@link DataTree}. The snapshot is stable and isolated, e.g. data tree changes occurring after
18 * the snapshot has been taken are not visible through the snapshot.
20 public interface DataTreeSnapshot {
22 * Read a particular node from the snapshot.
24 * @param path Path of the node
25 * @return Optional result encapsulating the presence and value of the node
27 Optional<NormalizedNode<?, ?>> readNode(YangInstanceIdentifier path);
30 * Create a new data tree modification based on this snapshot, using the
31 * specified data application strategy.
33 * @return A new data tree modification
35 DataTreeModification newModification();
38 * Return the current {@link SchemaContext}, which is being used for operations.
40 * @return Current schema context.
42 // FIXME: 3.0.0: Make this method non-default.
43 default @NonNull SchemaContext getSchemaContext() {
44 throw new UnsupportedOperationException("Not implemented by " + getClass());