/*
 * Copyright 2021-2023 Open Networking Foundation (ONF) and the ONF Contributors
 *
 * 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.opencord.olt;

import org.onlab.packet.VlanId;
import org.onosproject.event.ListenerService;
import org.onosproject.net.ConnectPoint;
import org.onosproject.net.DeviceId;

import java.util.List;

public interface AccessDeviceService extends ListenerService<AccessDeviceEvent, AccessDeviceListener> {
    /**
     * Provisions connectivity for a subscriber on an access device.
     * It installs flows for all uni tag information
     *
     * @param cp subscriber's connection point
     * @return true if the request is accepted (does not guarantee the subscriber is provisioned)
     */
    boolean provisionSubscriber(ConnectPoint cp);

    /**
     * Removes subscriber flows from a given ConnectPoint.
     * @param cp subscriber's connect point
     * @return true if the request is accepted (does not guarantee the subscriber is removed)
     */
    boolean removeSubscriber(ConnectPoint cp);

    /**
     * Provisions connectivity for a particular service for a subscriber.
     * @param cp subscriber's connect point
     * @param cTag service's cTag
     * @param sTag service's sTag
     * @param tpId service's Technology Profile ID
     * @return true if the request is accepted (does not guarantee the subscriber is provisioned)
     */
    boolean provisionSubscriber(ConnectPoint cp, VlanId cTag, VlanId sTag, Integer tpId);

    /**
     * Removes connectivity for a particular service for a subscriber.
     * @param cp subscriber's connect point
     * @param cTag service's cTag
     * @param sTag service's sTag
     * @param tpId service's Technology Profile ID
     * @return true if the request is accepted (does not guarantee the subscriber is removed)
     */
    boolean removeSubscriber(ConnectPoint cp, VlanId cTag, VlanId sTag, Integer tpId);

    /**
     * Returns a list of connected OLT devices ID.
     * @return a list of devices
     */
    List<DeviceId> getConnectedOlts();

    /**
     * Finds the ConnectPoint to which a subscriber is connected.
     *
     * @param id The id of the subscriber, this is the same ID as in Sadis
     * @return Subscribers ConnectPoint if found else null
     */
    ConnectPoint findSubscriberConnectPoint(String id);

}