X-Git-Url: https://code.wpia.club/?p=gigi.git;a=blobdiff_plain;f=lib%2Fjetty%2Forg%2Feclipse%2Fjetty%2Futil%2FCallback.java;fp=lib%2Fjetty%2Forg%2Feclipse%2Fjetty%2Futil%2FCallback.java;h=973d94137cb50c1697bea655268eee5e4d55b8ed;hp=0000000000000000000000000000000000000000;hb=73ef54a38e3930a1a789cdc6b5fa23cdd4c9d086;hpb=515007c7c1351045420669d65b59c08fa46850f2 diff --git a/lib/jetty/org/eclipse/jetty/util/Callback.java b/lib/jetty/org/eclipse/jetty/util/Callback.java new file mode 100644 index 00000000..973d9413 --- /dev/null +++ b/lib/jetty/org/eclipse/jetty/util/Callback.java @@ -0,0 +1,79 @@ +// +// ======================================================================== +// Copyright (c) 1995-2014 Mort Bay Consulting Pty. Ltd. +// ------------------------------------------------------------------------ +// All rights reserved. This program and the accompanying materials +// are made available under the terms of the Eclipse Public License v1.0 +// and Apache License v2.0 which accompanies this distribution. +// +// The Eclipse Public License is available at +// http://www.eclipse.org/legal/epl-v10.html +// +// The Apache License v2.0 is available at +// http://www.opensource.org/licenses/apache2.0.php +// +// You may elect to redistribute this code under either of these licenses. +// ======================================================================== +// + +/* + * Copyright (c) 2012 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.eclipse.jetty.util; + +/** + *

A callback abstraction that handles completed/failed events of asynchronous operations.

+ * + *

Semantically this is equivalent to an optimise Promise<Void>, but callback is a more meaningful + * name than EmptyPromise

+ */ +public interface Callback +{ + /** + *

Callback invoked when the operation completes.

+ * + * @see #failed(Throwable) + */ + public abstract void succeeded(); + + /** + *

Callback invoked when the operation fails.

+ * @param x the reason for the operation failure + */ + public void failed(Throwable x); + + /** + *

Empty implementation of {@link Callback}

+ */ + public static class Adapter implements Callback + { + /** + * Instance of Adapter that can be used when the callback methods need an empty + * implementation without incurring in the cost of allocating a new Adapter object. + */ + public static final Adapter INSTANCE = new Adapter(); + + @Override + public void succeeded() + { + } + + @Override + public void failed(Throwable x) + { + } + } +}