Merge "Bug 1007 - Statistics manager loses threads to uncaught exceptions"
[controller.git] / opendaylight / md-sal / sal-binding-api / src / main / java / org / opendaylight / controller / md / sal / binding / api / DataBroker.java
1 /*
2  * Copyright (c) 2014 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.controller.md.sal.binding.api;
9
10 import org.opendaylight.controller.md.sal.common.api.data.AsyncDataBroker;
11 import org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType;
12 import org.opendaylight.controller.md.sal.common.api.data.TransactionChainFactory;
13 import org.opendaylight.yangtools.concepts.ListenerRegistration;
14 import org.opendaylight.yangtools.yang.binding.DataObject;
15 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
16
17 /**
18  * Provides access to a conceptual data tree store and also provides the ability to
19  * subscribe for changes to data under a given branch of the tree.
20  * <p>
21  * For more information on usage, please see the documentation in {@link AsyncDataBroker}.
22  */
23 public interface DataBroker extends AsyncDataBroker<InstanceIdentifier<?>, DataObject, DataChangeListener>, BindingService, TransactionChainFactory<InstanceIdentifier<?>, DataObject> {
24     @Override
25     ReadOnlyTransaction newReadOnlyTransaction();
26
27     @Override
28     ReadWriteTransaction newReadWriteTransaction();
29
30     @Override
31     WriteTransaction newWriteOnlyTransaction();
32
33     @Override
34     ListenerRegistration<DataChangeListener> registerDataChangeListener(LogicalDatastoreType store,
35             InstanceIdentifier<?> path, DataChangeListener listener, DataChangeScope triggeringScope);
36 }