1 // 2 // ======================================================================== 3 // Copyright (c) 1995-2012 Mort Bay Consulting Pty. Ltd. 4 // ------------------------------------------------------------------------ 5 // All rights reserved. This program and the accompanying materials 6 // are made available under the terms of the Eclipse Public License v1.0 7 // and Apache License v2.0 which accompanies this distribution. 8 // 9 // The Eclipse Public License is available at 10 // http://www.eclipse.org/legal/epl-v10.html 11 // 12 // The Apache License v2.0 is available at 13 // http://www.opensource.org/licenses/apache2.0.php 14 // 15 // You may elect to redistribute this code under either of these licenses. 16 // ======================================================================== 17 // 18 19 package org.eclipse.jetty.spdy.api; 20 21 /** 22 * <p>A callback abstraction that handles completed/failed events of asynchronous operations.</p> 23 * <p>Instances of this class capture a context that is made available on the completion callback.</p> 24 * 25 * @param <C> the type of the context object 26 */ 27 public interface Handler<C> 28 { 29 /** 30 * <p>Callback invoked when the operation completes.</p> 31 * 32 * @param context the context 33 * @see #failed(Object, Throwable) 34 */ 35 public abstract void completed(C context); 36 37 /** 38 * <p>Callback invoked when the operation fails.</p> 39 * @param context the context 40 * @param x the reason for the operation failure 41 */ 42 public void failed(C context, Throwable x); 43 44 /** 45 * <p>Empty implementation of {@link Handler}</p> 46 * 47 * @param <C> the type of the context object 48 */ 49 public static class Adapter<C> implements Handler<C> 50 { 51 @Override 52 public void completed(C context) 53 { 54 } 55 56 @Override 57 public void failed(C context, Throwable x) 58 { 59 } 60 } 61 }