2 * Copyright (c) 2013 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.controller.sal.binding.api.rpc;
12 import org.opendaylight.controller.md.sal.common.api.routing.RouteChangePublisher;
13 import org.opendaylight.controller.sal.binding.api.BindingAwareBroker.RoutedRpcRegistration;
14 import org.opendaylight.controller.sal.binding.api.BindingAwareBroker.RpcRegistration;
15 import org.opendaylight.yangtools.yang.binding.BaseIdentity;
16 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
17 import org.opendaylight.yangtools.yang.binding.RpcImplementation;
18 import org.opendaylight.yangtools.yang.binding.RpcService;
21 * RpcRouter is responsible for selecting RpcService based on provided routing
22 * context identifier {@link RpcRoutingTable#getContextIdentifier()} and path in
23 * overal data tree (@link {@link InstanceIdentifier}.
26 * @author Tony Tkacik <ttkacik@cisco.com>
29 * Type of RpcService for which router provides routing information
30 * and route selection.
32 public interface RpcRouter<T extends RpcService> extends //
33 RouteChangePublisher<Class<? extends BaseIdentity>, InstanceIdentifier<?>> {
36 * Returns a type of RpcService which is served by this instance of router.
38 * @return type of RpcService which is served by this instance of router.
40 Class<T> getServiceType();
44 * Returns a instance of T which is associated with this router instance
45 * and routes messages based on routing tables.
47 * @return type of RpcService which is served by this instance of router.
49 T getInvocationProxy();
52 * Returns a routing table for particular route context
55 * @return Routing Table for particular route context.
57 <C extends BaseIdentity> RpcRoutingTable<C, T> getRoutingTable(Class<C> routeContext);
60 * Returns an instance of RpcService which is responsible for processing
66 * Instance Identifier which is used as a selector of instance.
67 * @return instance of RpcService which is responsible for processing
70 T getService(Class<? extends BaseIdentity> context, InstanceIdentifier<?> path);
73 * Returns a default fallback instance of RpcService which is responsible
74 * for handling all unknown imports.
76 * @return default instance responsible for processing RPCs.
78 T getDefaultService();
80 Set<Class<? extends BaseIdentity>> getContexts();
82 RoutedRpcRegistration<T> addRoutedRpcImplementation(T service);
84 RpcRegistration<T> registerDefaultService(T service);