/* * Copyright (c) 2018 Pantheon Technologies, s.r.o. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.mdsal.binding.api; import com.google.common.util.concurrent.FluentFuture; import java.util.Optional; import org.eclipse.jdt.annotation.NonNull; import org.opendaylight.mdsal.common.api.LogicalDatastoreType; import org.opendaylight.mdsal.common.api.ReadFailedException; import org.opendaylight.yangtools.yang.binding.DataObject; import org.opendaylight.yangtools.yang.binding.InstanceIdentifier; /** * Read-like operations supported by {@link ReadTransaction} and {@link ReadWriteTransaction}. This interface defines * the operations without a tie-in with lifecycle management. */ public interface ReadOperations { /** * Reads data from the provided logical data store located at the provided path. * *
* If the target is a subtree, then the whole subtree is read (and will be accessible from the returned data * object). * * @param store Logical data store from which read should occur. * @param path Path which uniquely identifies subtree which client want to read * @return a FluentFuture containing the result of the read. The Future blocks until the operation is complete. Once * complete: *
* Default implementation just delegates to {@link #read(LogicalDatastoreType, InstanceIdentifier)}. Implementations * are recommended to override with a more efficient implementation. * * @param store Logical data store from which read should occur. * @param path Path which uniquely identifies subtree which client want to read * @return a FluentFuture containing the result of the check. The Future blocks until the operation is complete. * Once complete: *