/*
 * Copyright 2016-present Open Networking Laboratory
 *
 * 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.onosproject.net.behaviour;

import org.onlab.packet.VlanId;
import org.onosproject.net.DeviceId;
import org.onosproject.net.device.DeviceInterfaceDescription;
import org.onosproject.net.driver.HandlerBehaviour;

import java.util.List;

/**
 * Means to configure interfaces on devices.
 */
public interface InterfaceConfig extends HandlerBehaviour {

    /**
     * Adds an access interface to a VLAN.
     *
     * @param deviceId the device ID
     * @param intf the name of the interface
     * @param vlanId the VLAN ID
     * @return the result of operation
     * @deprecated in 1.7.0 Hummingbird release - use of addAccessMode() instead
     */
    @Deprecated
    boolean addAccessInterface(DeviceId deviceId, String intf, VlanId vlanId);

    /**
     * Adds an access interface to a VLAN.
     *
     * @param intf the name of the interface
     * @param vlanId the VLAN ID
     * @return the result of operation
     */
    boolean addAccessMode(String intf, VlanId vlanId);

    /**
     * Removes an access interface to a VLAN.
     *
     * @param deviceId the device ID
     * @param intf the name of the interface
     * @return the result of operation
     * @deprecated in 1.7.0 Hummingbird release - use of removeAccessMode() instead
     */
    @Deprecated
    boolean removeAccessInterface(DeviceId deviceId, String intf);

    /**
     * Removes an access interface to a VLAN.
     *
     * @param intf the name of the interface
     * @return the result of operation
     */
    boolean removeAccessMode(String intf);

    /**
     *  Adds a trunk interface for VLANs.
     *
     * @param deviceId the device ID
     * @param intf the name of the interface
     * @param vlanIds the VLAN IDs
     * @return the result of operation
     * @deprecated in 1.7.0 Hummingbird release - use of addTrunkMode() instead
     */
    @Deprecated
    boolean addTrunkInterface(DeviceId deviceId, String intf, List<VlanId> vlanIds);

    /**
     *  Adds a trunk interface for VLANs.
     *
     * @param intf the name of the interface
     * @param vlanIds the VLAN IDs
     * @return the result of operation
     */
    boolean addTrunkMode(String intf, List<VlanId> vlanIds);

    /**
     * Removes trunk mode configuration from an interface.
     *
     * @param deviceId the device ID
     * @param intf the name of the interface
     * @return the result of operation
     * @deprecated in 1.7.0 Hummingbird release - use of removeTrunkMode() instead
     */
    @Deprecated
    boolean removeTrunkInterface(DeviceId deviceId, String intf);

    /**
     *  Removes trunk mode configuration from an interface.
     *
     * @param intf the name of the interface
     * @return the result of operation
     */
    boolean removeTrunkMode(String intf);

    /**
     * Adds a rate limit on an interface.
     *
     * @param intf the name of the interface
     * @param limit the limit as a percentage
     * @return the result of operation
     */
    boolean addRateLimit(String intf, short limit);

    /**
     * Removes rate limit from an interface.
     *
     * @param intf the name of the interface
     * @return the result of operation
     */
    boolean removeRateLimit(String intf);

    /**
     * Adds a tunnel mode to supplied interface.
     *
     * @param intf the name of the interface
     * @param tunnelDesc tunnel interface description
     * @return true if the operation succeeds
     */
    boolean addTunnelMode(String intf, TunnelDescription tunnelDesc);

    /**
     * Removes a tunnel interface.
     *
     * @param intf tunnel interface name
     * @return true if the operation succeeds
     */
    boolean removeTunnelMode(String intf);

    /**
     * Adds a patch mode to the supplied interface.
     *
     * @param ifaceName interface name to set patch mode
     * @param patchInterface interface description
     * @return true if the operation succeeds
     */
    boolean addPatchMode(String ifaceName, PatchDescription patchInterface);

    /**
     * Removes a patch mode from the supplied interface.
     *
     * @param ifaceName interface name
     * @return true if the operation succeeds
     */
    boolean removePatchMode(String ifaceName);

    /**
     * Provides the interfaces configured on a device.
     *
     * @param deviceId the device ID
     * @return the list of the configured interfaces
     * @deprecated in 1.7.0 Hummingbird release - use of getInterfaces() without
     * deviceId as parameter instead
     */
    @Deprecated
    List<DeviceInterfaceDescription> getInterfaces(DeviceId deviceId);

    /**
     * Provides the interfaces configured on a device.
     *
     * @return the list of the configured interfaces
     */
    List<DeviceInterfaceDescription> getInterfaces();

    /**
     *  TODO Addition of more methods to make the behavior symmetrical.
     *  Methods getInterfacesForVlan(VlanId), hasAccessMode(), hasTrunkMode(),
     *  getTrunkVlans(Interface), getAccessVlan(Interface) should be added to
     *  complete the behavior.
     */
}