View Javadoc

1   /*
2    * Copyright 2010 The Apache Software Foundation
3    *
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   *     http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing, software
15   * distributed under the License is distributed on an "AS IS" BASIS,
16   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17   * See the License for the specific language governing permissions and
18   * limitations under the License.
19   */
20  package org.apache.hadoop.hbase.ipc;
21  
22  import java.lang.reflect.Method;
23  import java.io.IOException;
24  import java.net.InetSocketAddress;
25  import javax.net.SocketFactory;
26  
27  import org.apache.hadoop.hbase.ipc.VersionedProtocol;
28  import org.apache.hadoop.hbase.security.User;
29  import org.apache.hadoop.conf.Configuration;
30  
31  /** An RPC implementation. */
32  interface RpcEngine {
33  
34    /** Construct a client-side proxy object. */
35    VersionedProtocol getProxy(Class<? extends VersionedProtocol> protocol,
36                    long clientVersion, InetSocketAddress addr,
37                    User ticket, Configuration conf,
38                    SocketFactory factory, int rpcTimeout) throws IOException;
39  
40    /** Stop this proxy. */
41    void stopProxy(VersionedProtocol proxy);
42  
43    /** Expert: Make multiple, parallel calls to a set of servers. */
44    Object[] call(Method method, Object[][] params, InetSocketAddress[] addrs,
45                  Class<? extends VersionedProtocol> protocol,
46                  User ticket, Configuration conf)
47      throws IOException, InterruptedException;
48  
49    /** Construct a server for a protocol implementation instance. */
50    RpcServer getServer(Class<? extends VersionedProtocol> protocol, Object instance,
51                         Class<?>[] ifaces, String bindAddress,
52                         int port, int numHandlers, int metaHandlerCount,
53                         boolean verbose, Configuration conf, int highPriorityLevel)
54        throws IOException;
55  
56  }