Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 1 | package org.onlab.netty; |
| 2 | |
| 3 | import java.io.IOException; |
| 4 | import java.net.UnknownHostException; |
| 5 | import java.util.concurrent.ConcurrentHashMap; |
| 6 | import java.util.concurrent.ConcurrentMap; |
| 7 | import java.util.concurrent.TimeUnit; |
| 8 | |
| 9 | import io.netty.bootstrap.Bootstrap; |
| 10 | import io.netty.bootstrap.ServerBootstrap; |
| 11 | import io.netty.buffer.PooledByteBufAllocator; |
| 12 | import io.netty.channel.Channel; |
| 13 | import io.netty.channel.ChannelFuture; |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 14 | import io.netty.channel.ChannelHandler; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 15 | import io.netty.channel.ChannelHandlerContext; |
| 16 | import io.netty.channel.ChannelInitializer; |
| 17 | import io.netty.channel.ChannelOption; |
| 18 | import io.netty.channel.EventLoopGroup; |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 19 | import io.netty.channel.ServerChannel; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 20 | import io.netty.channel.SimpleChannelInboundHandler; |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 21 | import io.netty.channel.epoll.EpollEventLoopGroup; |
| 22 | import io.netty.channel.epoll.EpollServerSocketChannel; |
| 23 | import io.netty.channel.epoll.EpollSocketChannel; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 24 | import io.netty.channel.nio.NioEventLoopGroup; |
| 25 | import io.netty.channel.socket.SocketChannel; |
| 26 | import io.netty.channel.socket.nio.NioServerSocketChannel; |
| 27 | import io.netty.channel.socket.nio.NioSocketChannel; |
| 28 | |
| 29 | import org.apache.commons.lang.math.RandomUtils; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 30 | import org.apache.commons.pool.KeyedPoolableObjectFactory; |
| 31 | import org.apache.commons.pool.impl.GenericKeyedObjectPool; |
| 32 | import org.slf4j.Logger; |
| 33 | import org.slf4j.LoggerFactory; |
| 34 | |
| 35 | import com.google.common.cache.Cache; |
| 36 | import com.google.common.cache.CacheBuilder; |
| 37 | |
| 38 | /** |
| 39 | * A Netty based implementation of MessagingService. |
| 40 | */ |
| 41 | public class NettyMessagingService implements MessagingService { |
| 42 | |
| 43 | private final Logger log = LoggerFactory.getLogger(getClass()); |
| 44 | |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 45 | private final Endpoint localEp; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 46 | private final ConcurrentMap<String, MessageHandler> handlers = new ConcurrentHashMap<>(); |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 47 | private final Cache<Long, AsyncResponse> responseFutures = CacheBuilder.newBuilder() |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 48 | .maximumSize(100000) |
| 49 | .weakValues() |
| 50 | // TODO: Once the entry expires, notify blocking threads (if any). |
| 51 | .expireAfterWrite(10, TimeUnit.MINUTES) |
| 52 | .build(); |
| 53 | private final GenericKeyedObjectPool<Endpoint, Channel> channels |
| 54 | = new GenericKeyedObjectPool<Endpoint, Channel>(new OnosCommunicationChannelFactory()); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 55 | |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 56 | private EventLoopGroup serverGroup; |
| 57 | private EventLoopGroup clientGroup; |
| 58 | private Class<? extends ServerChannel> serverChannelClass; |
| 59 | private Class<? extends Channel> clientChannelClass; |
| 60 | |
Madan Jampani | 5e83f33 | 2014-10-20 15:35:09 -0700 | [diff] [blame] | 61 | private void initEventLoopGroup() { |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 62 | // try Epoll first and if that does work, use nio. |
| 63 | // TODO: make this configurable. |
| 64 | try { |
Madan Jampani | 99e9fe2 | 2014-10-21 13:47:12 -0700 | [diff] [blame] | 65 | clientGroup = new EpollEventLoopGroup(); |
| 66 | serverGroup = new EpollEventLoopGroup(); |
| 67 | serverChannelClass = EpollServerSocketChannel.class; |
| 68 | clientChannelClass = EpollSocketChannel.class; |
| 69 | return; |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 70 | } catch (Throwable t) { |
Madan Jampani | 99e9fe2 | 2014-10-21 13:47:12 -0700 | [diff] [blame] | 71 | log.warn("Failed to initialize native (epoll) transport. Proceeding with nio.", t); |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 72 | } |
| 73 | clientGroup = new NioEventLoopGroup(); |
| 74 | serverGroup = new NioEventLoopGroup(); |
| 75 | serverChannelClass = NioServerSocketChannel.class; |
| 76 | clientChannelClass = NioSocketChannel.class; |
Madan Jampani | 5e83f33 | 2014-10-20 15:35:09 -0700 | [diff] [blame] | 77 | } |
| 78 | |
Madan Jampani | 8710093 | 2014-10-21 16:46:12 -0700 | [diff] [blame] | 79 | public NettyMessagingService(String ip, int port) { |
| 80 | localEp = new Endpoint(ip, port); |
| 81 | } |
| 82 | |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 83 | public NettyMessagingService() { |
| 84 | // TODO: Default port should be configurable. |
| 85 | this(8080); |
| 86 | } |
| 87 | |
| 88 | // FIXME: Constructor should not throw exceptions. |
| 89 | public NettyMessagingService(int port) { |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 90 | try { |
| 91 | localEp = new Endpoint(java.net.InetAddress.getLocalHost().getHostName(), port); |
| 92 | } catch (UnknownHostException e) { |
| 93 | // bailing out. |
| 94 | throw new RuntimeException(e); |
| 95 | } |
| 96 | } |
| 97 | |
| 98 | public void activate() throws Exception { |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 99 | channels.setTestOnBorrow(true); |
| 100 | channels.setTestOnReturn(true); |
Madan Jampani | 5e83f33 | 2014-10-20 15:35:09 -0700 | [diff] [blame] | 101 | initEventLoopGroup(); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 102 | startAcceptingConnections(); |
| 103 | } |
| 104 | |
| 105 | public void deactivate() throws Exception { |
| 106 | channels.close(); |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 107 | serverGroup.shutdownGracefully(); |
| 108 | clientGroup.shutdownGracefully(); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 109 | } |
| 110 | |
Madan Jampani | 8710093 | 2014-10-21 16:46:12 -0700 | [diff] [blame] | 111 | /** |
| 112 | * Returns the local endpoint for this instance. |
| 113 | * @return local end point. |
| 114 | */ |
| 115 | public Endpoint localEp() { |
| 116 | return localEp; |
| 117 | } |
| 118 | |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 119 | @Override |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 120 | public void sendAsync(Endpoint ep, String type, byte[] payload) throws IOException { |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 121 | InternalMessage message = new InternalMessage.Builder(this) |
| 122 | .withId(RandomUtils.nextLong()) |
| 123 | .withSender(localEp) |
| 124 | .withType(type) |
| 125 | .withPayload(payload) |
| 126 | .build(); |
| 127 | sendAsync(ep, message); |
| 128 | } |
| 129 | |
| 130 | protected void sendAsync(Endpoint ep, InternalMessage message) throws IOException { |
| 131 | Channel channel = null; |
| 132 | try { |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 133 | try { |
| 134 | channel = channels.borrowObject(ep); |
| 135 | channel.eventLoop().execute(new WriteTask(channel, message)); |
| 136 | } finally { |
| 137 | channels.returnObject(ep, channel); |
| 138 | } |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 139 | } catch (Exception e) { |
Madan Jampani | 8710093 | 2014-10-21 16:46:12 -0700 | [diff] [blame] | 140 | throw new IOException("Failed to send message to " + ep.toString(), e); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 141 | } |
| 142 | } |
| 143 | |
| 144 | @Override |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 145 | public Response sendAndReceive(Endpoint ep, String type, byte[] payload) |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 146 | throws IOException { |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 147 | AsyncResponse futureResponse = new AsyncResponse(); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 148 | Long messageId = RandomUtils.nextLong(); |
| 149 | responseFutures.put(messageId, futureResponse); |
| 150 | InternalMessage message = new InternalMessage.Builder(this) |
| 151 | .withId(messageId) |
| 152 | .withSender(localEp) |
| 153 | .withType(type) |
| 154 | .withPayload(payload) |
| 155 | .build(); |
| 156 | sendAsync(ep, message); |
| 157 | return futureResponse; |
| 158 | } |
| 159 | |
| 160 | @Override |
| 161 | public void registerHandler(String type, MessageHandler handler) { |
| 162 | // TODO: Is this the right semantics for handler registration? |
| 163 | handlers.putIfAbsent(type, handler); |
| 164 | } |
| 165 | |
| 166 | public void unregisterHandler(String type) { |
| 167 | handlers.remove(type); |
| 168 | } |
| 169 | |
| 170 | private MessageHandler getMessageHandler(String type) { |
| 171 | return handlers.get(type); |
| 172 | } |
| 173 | |
| 174 | private void startAcceptingConnections() throws InterruptedException { |
| 175 | ServerBootstrap b = new ServerBootstrap(); |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 176 | b.option(ChannelOption.WRITE_BUFFER_HIGH_WATER_MARK, 32 * 1024); |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 177 | b.option(ChannelOption.WRITE_BUFFER_LOW_WATER_MARK, 8 * 1024); |
| 178 | // TODO: Need JVM options to configure PooledByteBufAllocator. |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 179 | b.option(ChannelOption.ALLOCATOR, PooledByteBufAllocator.DEFAULT); |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 180 | b.group(serverGroup, clientGroup) |
| 181 | .channel(serverChannelClass) |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 182 | .childHandler(new OnosCommunicationChannelInitializer()) |
| 183 | .option(ChannelOption.SO_BACKLOG, 128) |
| 184 | .childOption(ChannelOption.SO_KEEPALIVE, true); |
| 185 | |
| 186 | // Bind and start to accept incoming connections. |
Madan Jampani | 8710093 | 2014-10-21 16:46:12 -0700 | [diff] [blame] | 187 | b.bind(localEp.port()).sync(); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 188 | } |
| 189 | |
| 190 | private class OnosCommunicationChannelFactory |
| 191 | implements KeyedPoolableObjectFactory<Endpoint, Channel> { |
| 192 | |
| 193 | @Override |
| 194 | public void activateObject(Endpoint endpoint, Channel channel) |
| 195 | throws Exception { |
| 196 | } |
| 197 | |
| 198 | @Override |
| 199 | public void destroyObject(Endpoint ep, Channel channel) throws Exception { |
| 200 | channel.close(); |
| 201 | } |
| 202 | |
| 203 | @Override |
| 204 | public Channel makeObject(Endpoint ep) throws Exception { |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 205 | Bootstrap bootstrap = new Bootstrap(); |
| 206 | bootstrap.option(ChannelOption.ALLOCATOR, PooledByteBufAllocator.DEFAULT); |
| 207 | bootstrap.option(ChannelOption.WRITE_BUFFER_HIGH_WATER_MARK, 32 * 1024); |
| 208 | bootstrap.option(ChannelOption.WRITE_BUFFER_LOW_WATER_MARK, 8 * 1024); |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 209 | bootstrap.group(clientGroup); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 210 | // TODO: Make this faster: |
| 211 | // http://normanmaurer.me/presentations/2014-facebook-eng-netty/slides.html#37.0 |
Madan Jampani | 824a7c1 | 2014-10-21 09:46:15 -0700 | [diff] [blame] | 212 | bootstrap.channel(clientChannelClass); |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 213 | bootstrap.option(ChannelOption.SO_KEEPALIVE, true); |
| 214 | bootstrap.handler(new OnosCommunicationChannelInitializer()); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 215 | // Start the client. |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 216 | ChannelFuture f = bootstrap.connect(ep.host(), ep.port()).sync(); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 217 | return f.channel(); |
| 218 | } |
| 219 | |
| 220 | @Override |
| 221 | public void passivateObject(Endpoint ep, Channel channel) |
| 222 | throws Exception { |
| 223 | } |
| 224 | |
| 225 | @Override |
| 226 | public boolean validateObject(Endpoint ep, Channel channel) { |
| 227 | return channel.isOpen(); |
| 228 | } |
| 229 | } |
| 230 | |
| 231 | private class OnosCommunicationChannelInitializer extends ChannelInitializer<SocketChannel> { |
| 232 | |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 233 | private final ChannelHandler dispatcher = new InboundMessageDispatcher(); |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 234 | private final ChannelHandler encoder = new MessageEncoder(); |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 235 | |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 236 | @Override |
| 237 | protected void initChannel(SocketChannel channel) throws Exception { |
| 238 | channel.pipeline() |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 239 | .addLast("encoder", encoder) |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 240 | .addLast("decoder", new MessageDecoder(NettyMessagingService.this)) |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 241 | .addLast("handler", dispatcher); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 242 | } |
| 243 | } |
| 244 | |
| 245 | private class WriteTask implements Runnable { |
| 246 | |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 247 | private final InternalMessage message; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 248 | private final Channel channel; |
| 249 | |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 250 | public WriteTask(Channel channel, InternalMessage message) { |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 251 | this.channel = channel; |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 252 | this.message = message; |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 253 | } |
| 254 | |
| 255 | @Override |
| 256 | public void run() { |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 257 | channel.writeAndFlush(message, channel.voidPromise()); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 258 | } |
| 259 | } |
| 260 | |
Madan Jampani | ddf7622 | 2014-10-04 23:48:44 -0700 | [diff] [blame] | 261 | @ChannelHandler.Sharable |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 262 | private class InboundMessageDispatcher extends SimpleChannelInboundHandler<InternalMessage> { |
| 263 | |
| 264 | @Override |
| 265 | protected void channelRead0(ChannelHandlerContext ctx, InternalMessage message) throws Exception { |
| 266 | String type = message.type(); |
| 267 | if (type.equals(InternalMessage.REPLY_MESSAGE_TYPE)) { |
| 268 | try { |
Madan Jampani | 53e44e6 | 2014-10-07 12:39:51 -0700 | [diff] [blame] | 269 | AsyncResponse futureResponse = |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 270 | NettyMessagingService.this.responseFutures.getIfPresent(message.id()); |
| 271 | if (futureResponse != null) { |
| 272 | futureResponse.setResponse(message.payload()); |
Madan Jampani | f1d425a | 2014-10-07 09:52:36 -0700 | [diff] [blame] | 273 | } else { |
| 274 | log.warn("Received a reply. But was unable to locate the request handle"); |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 275 | } |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 276 | } finally { |
| 277 | NettyMessagingService.this.responseFutures.invalidate(message.id()); |
| 278 | } |
| 279 | return; |
| 280 | } |
| 281 | MessageHandler handler = NettyMessagingService.this.getMessageHandler(type); |
| 282 | handler.handle(message); |
| 283 | } |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 284 | |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 285 | @Override |
| 286 | public void exceptionCaught(ChannelHandlerContext context, Throwable cause) { |
Madan Jampani | 29e5dfd | 2014-10-07 17:26:25 -0700 | [diff] [blame] | 287 | log.error("Exception inside channel handling pipeline.", cause); |
Madan Jampani | 86ed055 | 2014-10-03 16:45:42 -0700 | [diff] [blame] | 288 | context.close(); |
| 289 | } |
Madan Jampani | ab6d311 | 2014-10-02 16:30:14 -0700 | [diff] [blame] | 290 | } |
| 291 | } |