X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=opendaylight%2Fmd-sal%2Fsal-binding-api%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fcontroller%2Fsal%2Fbinding%2Fapi%2FBindingAwareProvider.java;h=808863262dde665b4b5defcede286d36aff70c62;hb=a81d98f692b80c45bce3fe6a87e731abfb012a9f;hp=cb26cad2f392cacc01757cd6c8bdff1b29920cad;hpb=c222e37f2a0f0f3f6266242fbea2d3b018f4e6e3;p=controller.git diff --git a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/BindingAwareProvider.java b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/BindingAwareProvider.java index cb26cad2f3..808863262d 100644 --- a/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/BindingAwareProvider.java +++ b/opendaylight/md-sal/sal-binding-api/src/main/java/org/opendaylight/controller/sal/binding/api/BindingAwareProvider.java @@ -7,11 +7,7 @@ */ package org.opendaylight.controller.sal.binding.api; -import java.util.Collection; - -import org.opendaylight.controller.sal.binding.api.BindingAwareBroker.ConsumerContext; import org.opendaylight.controller.sal.binding.api.BindingAwareBroker.ProviderContext; -import org.opendaylight.yangtools.yang.binding.RpcService; /** * @@ -49,27 +45,28 @@ import org.opendaylight.yangtools.yang.binding.RpcService; * * To get a NotificationService: * - * {code + * {@code * public void onSessionInitiated(ProviderContext session) { * NotificationProviderService notificationService = session.getSALService(NotificationProviderService.class); * } + * } * For more information on sending notifications via the NotificationProviderService * @see org.opendaylight.controller.sal.binding.api.NotificationProviderService * * To register an RPC implementation: * - * {code + * {@code * public void onSessionInitiated(ProviderContext session) { * RpcRegistration registration = session.addRpcImplementation(MyService.class, myImplementationInstance); * } + * } * *

- * * Where MyService.class is a Service interface generated from a yang model with RPCs modeled in it and myImplementationInstance * is an instance of a class that implements MyService. * * To register a Routed RPC Implementation: - * {code + * {@code * public void onSessionInitiated(ProviderContext session) { * RoutedRpcRegistration flowRegistration = session.addRoutedRpcImplementation(SalFlowService.class, salFlowServiceImplementationInstance); flowRegistration.registerPath(NodeContext.class, nodeInstanceId); @@ -80,7 +77,7 @@ import org.opendaylight.yangtools.yang.binding.RpcService; * of a class that implements SalFlowService. *

* The line: - * {code + * {@code * flowRegistration.registerPath(NodeContext.class, nodeInstanceId); * } * Is indicating that the RPC implementation is registered to handle RPC invocations that have their NodeContext pointing to the node with instance id nodeInstanceId. @@ -96,66 +93,14 @@ import org.opendaylight.yangtools.yang.binding.RpcService; * * To get a DataBroker to allow access to the data tree: * - * {code + * {@code * public void onSessionInitiated(final ProviderContext session) { * DataBroker databroker = session.getSALService(BindingDataBroker.class); * } * } - * @see org.opendaylight.controller.md.sal.common.api.data.BindingDataBroker - * for more info on using the DataBroker. - * */ public interface BindingAwareProvider { - /** - * @deprecated - * - * This interface was originally intended to solve problems of how to get Implementations - * of functionality from a provider, but that is no longer necessary because the Provider - * Registers RPCs in onSessionInitiated. - * - * Recommend: - * {code - * public Collection getImplementations() { - * return Collections.emptySet(); - * } - * } - */ - @Deprecated - Collection getImplementations(); - - /** - * @deprecated - * - * This interface was originally intended to solve problems of how to get Functionality - * a provider could provide, but that is no longer necessary because the Provider - * Registers RPCs in onSessionInitiated. - * - * Recommend: - * {code - * public Collection getFunctionality() { - * return Collections.emptySet(); - * } - * } - * - */ - @Deprecated - Collection getFunctionality(); - - /** - * Functionality provided by the {@link BindingAwareProvider} - * - *

- * Marker interface used to mark the interfaces describing specific - * functionality which could be exposed by providers to other components. - * - * - * - */ - @Deprecated - public interface ProviderFunctionality { - - } /** * Callback signaling initialization of the consumer session to the SAL. * @@ -168,22 +113,4 @@ public interface BindingAwareProvider { * @param session Unique session between consumer and SAL. */ void onSessionInitiated(ProviderContext session); - - /* - * @deprecated - * - * A provider was at one point considered an extension of a consumer, thus this - * call. It is deprecated and the @see org.opendaylight.controller.sal.binding.api.BindingAwareConsumer#onSessionInitiated - * used, or you should simply use {@link #onSessionInitiated(ProviderContext)} - * - * Recommend: - * {code - * public final void onSessionInitialized(ConsumerContext session) { - * // NOOP - as method is deprecated - * } - * } - */ - @Deprecated - void onSessionInitialized(ConsumerContext session); - }