/*

 * Copyright (c) 2009, 2013, 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 com.sun.nio.sctp;

import java.net.SocketAddress;

/**

 * Notification emitted when a destination address on a multi-homed peer

 * encounters a change.

 *

 * @since 1.7

 */

@jdk.Exported

public abstract class PeerAddressChangeNotification

    implements Notification

{

    /**

     * Defines the type of address change event that occurred to the destination

     * address on a multi-homed peer when it encounters a change of interface

     * details.

     *

     * <P> Some of these events types are only generated when the association

     * supports dynamic address reconfiguration, e.g. {@code SCTP_ADDR_ADDED},

     * {@code SCTP_ADDR_REMOVED}, etc.

     *

     * @since 1.7

     */

    @jdk.Exported

    public enum AddressChangeEvent {

        /**

         * This address is now reachable.

         */

       ADDR_AVAILABLE,

       /**

        * The address specified can no longer be reached. Any data sent to this

        * address is rerouted to an alternate until this address becomes reachable.

        */

       ADDR_UNREACHABLE,

       /**

        * The address is no longer part of the association.

        */

       ADDR_REMOVED,

       /**

        * The address is now part of the association.

        */

       ADDR_ADDED,

       /**

        * This address has now been made to be the primary destination address.

        */

       ADDR_MADE_PRIMARY,

       /**

        * This address has now been confirmed as a valid address.

        */

       ADDR_CONFIRMED;

    }

    /**

     * Initializes a new instance of this class.

     */

    protected PeerAddressChangeNotification() {}

    /**

     * Returns the peer address.

     *

     * @return  The peer address

     */

    public abstract SocketAddress address();

    /**

     * Returns the association that this notification is applicable to.

     *

     * @return  The association whose peer address changed

     */

    public abstract Association association();

    /**

     * Returns the type of change event.

     *

     * @return  The event

     */

    public abstract AddressChangeEvent event();

}