jdk.dio.AsyncErrorHandler Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of org.openjdk.dio Show documentation

Maven/OSGi repackaging of OpenJDK's Device I/O library

The newest version!

/*
 * Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */
package jdk.dio;

/**
 * The {@code AsyncErrorHandler} interface defines methods for getting notified of errors of
 * asynchronous I/O operations.
 * 
 * Note though that contrarily to how classes implementing sub-interfaces of
 * {@link DeviceEventListener} handle events, handling of I/O errors reported through this
 * interface is not subject to the same time-sensitivity constrains.
 * 
 *
 * @param 
 *            the device type that generates the error.
 * @since 1.0
 */
@apimarker.API("device-io_1.1")
public interface AsyncErrorHandler> {

    /**
     * Invoked when an I/O operation fails.
     *
     * @param exception
     *            the exception to indicate why the I/O operation failed.
     * @param source
     *            the {@code Device} instance that generated the error.
     */
    void failed(Throwable exception, P source);
}