/* * Copyright (c) 2017 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.javav2.api; import com.google.common.annotations.Beta; import org.opendaylight.mdsal.binding.javav2.spec.base.InstanceIdentifier; import org.opendaylight.mdsal.binding.javav2.spec.base.TreeNode; import org.opendaylight.mdsal.common.api.AsyncWriteTransaction; import org.opendaylight.mdsal.common.api.LogicalDatastoreType; /** * A transaction that provides mutation capabilities on a data tree. * *
* For more information on usage and examples, please see the documentation in {@link AsyncWriteTransaction}.
*/
@Beta
public interface WriteTransaction extends AsyncWriteTransaction
* This method does not automatically create missing parent nodes. It is equivalent to invoking
* {@link #put(LogicalDatastoreType, InstanceIdentifier, TreeNode, boolean)}
* with
* For more information on usage and examples, please see the documentation in {@link AsyncWriteTransaction}.
*
* If you need to make sure that a parent object exists but you do not want modify
* its pre-existing state by using put, consider using {@link #merge} instead.
*
* @param store
* the logical data store which should be modified
* @param path
* the data object path
* @param data
* the data object to be written to the specified path
* @param
* For more information on usage and examples, please see the documentation
* in {@link AsyncWriteTransaction}.
*
*
* If you need to make sure that a parent object exists but you do not want
* modify its pre-existing state by using put, consider using {@link #merge}
* instead.
*
*
* Note: Using
* This method does not automatically create missing parent nodes. It is equivalent to invoking
* {@link #merge(LogicalDatastoreType, InstanceIdentifier, TreeNode, boolean)}
* with
* For more information on usage and examples, please see the documentation in
* {@link AsyncWriteTransaction}.
*
*
* If you require an explicit replace operation, use {@link #put} instead.
* @param store
* the logical data store which should be modified
* @param path
* the data object path
* @param data
* the data object to be merged to the specified path
* @param
* For more information on usage and examples, please see the documentation
* in {@link AsyncWriteTransaction}.
*
*
* If you require an explicit replace operation, use {@link #put} instead.
*
* @param store
* the logical data store which should be modified
* @param path
* the data object path
* @param data
* the data object to be merged to the specified path
* @param createMissingParents
* if {@link #CREATE_MISSING_PARENTS}, any missing parent nodes will be automatically created
* using a merge operation.
* @param createMissingParents
set to false.
*
* createMissingParents
with value true, may
* introduce garbage in data store, or recreate nodes, which were deleted by
* previous transaction.
*
* @param store
* the logical data store which should be modified
* @param path
* the data object path
* @param data
* the data object to be written to the specified path
* @param createMissingParents
* if {@link #CREATE_MISSING_PARENTS}, any missing parent nodes will be automatically
* created using a merge operation.
* @param createMissingParents
set to false.
*
*