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.codegen;
10 import org.opendaylight.controller.sal.binding.spi.NotificationInvokerFactory;
11 import org.opendaylight.controller.sal.binding.spi.RpcRouter;
12 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
13 import org.opendaylight.yangtools.yang.binding.RpcService;
14 import org.opendaylight.yangtools.yang.binding.annotations.RoutingContext;
16 public interface RuntimeCodeGenerator {
19 * Returns an instance of provided RpcService type which delegates all calls
25 * <li>implements provided subclass of RpcService type and
26 * {@link DelegateProxy} interface.
29 * delegates all invocations of methods, which are defined in RpcService
30 * subtype to delegate which is defined by
31 * {@link DelegateProxy#setDelegate(Object)}.
33 * If delegate is not defined (<code>getDelegate() == null</code>)
34 * implementation throws {@link IllegalStateException}
35 * <li>{@link DelegateProxy#getDelegate()} - returns the delegate to which
36 * all calls are delegated.
37 * <li>{@link DelegateProxy#setDelegate(Object)} - sets the delegate for
43 * - Subclass of RpcService for which direct proxy is to be
45 * @return Instance of RpcService of provided serviceType which implements
46 * and {@link DelegateProxy}
47 * @throws IllegalArgumentException
50 <T extends RpcService> T getDirectProxyFor(Class<T> serviceType) throws IllegalArgumentException;
53 * Returns an instance of provided RpcService type which routes all calls to
54 * other instances selected on particular input field.
61 * <li>{@link DelegateProxy}
62 * <li>{@link RpcRouter}
65 * routes all invocations of methods, which are defined in RpcService
66 * subtype based on method arguments and routing information defined in the
67 * RpcRoutingTables for this instance
68 * {@link RpcRouter#getRoutingTable(Class)}.
72 * {@link RpcRouter#getService(Class, InstanceIdentifier)} method to
73 * retrieve particular instance to which call will be routed.
75 * Instance of {@link InstanceIdentifier} is determined by first argument of
76 * method and is retrieved via method which is annotated with
77 * {@link RoutingContext}. Class representing Routing Context Identifier is
78 * retrieved by {@link RoutingContext}.
79 * <li>If first argument is not defined / {@link RoutingContext} annotation
80 * is not present on any field invocation will be delegated to default
81 * service {@link RpcRouter#getDefaultService()}.
85 * - Subclass of RpcService for which Router is to be generated.
86 * @return Instance of RpcService of provided serviceType which implements
87 * also {@link RpcRouter}<T> and {@link DelegateProxy}
89 <T extends RpcService> RpcRouter<T> getRouterFor(Class<T> serviceType,String name) throws IllegalArgumentException;
91 NotificationInvokerFactory getInvokerFactory();