/**
 * Copyright (c) 2014, 2017 Cisco Systems, Inc. and others.  All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
 * and is available at http://www.eclipse.org/legal/epl-v10.html
 */

package org.opendaylight.openflowplugin.applications.frm;

import org.opendaylight.controller.md.sal.binding.api.ReadOnlyTransaction;
import org.opendaylight.openflowplugin.applications.frm.impl.FlowNodeConnectorInventoryTranslatorImpl;
import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.inventory.rev130819.FlowCapableNode;
import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.inventory.rev130819.meters.Meter;
import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.inventory.rev130819.tables.table.Flow;
import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.service.rev130819.SalFlowService;
import org.opendaylight.yang.gen.v1.urn.opendaylight.group.service.rev130918.SalGroupService;
import org.opendaylight.yang.gen.v1.urn.opendaylight.group.types.rev131018.groups.Group;
import org.opendaylight.yang.gen.v1.urn.opendaylight.meter.service.rev130918.SalMeterService;
import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.openflowplugin.app.forwardingrules.manager.config.rev160511.ForwardingRulesManagerConfig;
import org.opendaylight.yang.gen.v1.urn.opendaylight.table.service.rev131026.SalTableService;
import org.opendaylight.yang.gen.v1.urn.opendaylight.table.types.rev131026.table.features.TableFeatures;
import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;

/**
 * It represent a central point for whole module. Implementation
 * Flow Provider registers the link FlowChangeListener} and it holds all needed
 * services for link FlowChangeListener}.
 *
 * @author <a href="mailto:vdemcak@cisco.com">Vaclav Demcak</a>
 */
public interface ForwardingRulesManager extends AutoCloseable {

    void start();

    /**
     * Method returns information :
     * "is Node with send InstanceIdentifier connected"?
     *
     * @param ident - the key of the node
     * @return boolean - true if device is connected
     */
    boolean isNodeActive(InstanceIdentifier<FlowCapableNode> ident);

    /**
     * Method returns information :
     * "is Node with send InstanceIdentifier present in operational data store"?
     *
     * @param ident - the key of the node
     * @return boolean - true if device is present in operational data store
     */
    boolean checkNodeInOperationalDataStore(InstanceIdentifier<FlowCapableNode> ident);

    /**
     * Method returns generated transaction ID, which is unique for
     * every transaction. ID is composite from prefix ("DOM") and unique number.
     *
     * @return String transactionID for RPC transaction identification
     */
    String getNewTransactionId();

    /**
     * Method returns Read Transacion. It is need for Node reconciliation only.
     *
     * @return ReadOnlyTransaction
     */
    ReadOnlyTransaction getReadTranaction();

    /**
     * Flow RPC service
     *
     * @return
     */
    SalFlowService getSalFlowService();

    /**
     * Group RPC service
     *
     * @return
     */
    SalGroupService getSalGroupService();

    /**
     * Meter RPC service
     *
     * @return
     */
    SalMeterService getSalMeterService();

    /**
     * Table RPC service
     *
     * @return
     */
    SalTableService getSalTableService();

    /**
     * Content definition method and prevent code duplicity in Reconcil
     * @return ForwardingRulesCommiter<Flow>
     */
    ForwardingRulesCommiter<Flow> getFlowCommiter();

    /**
     * Content definition method and prevent code duplicity in Reconcil
     * @return ForwardingRulesCommiter<Group>
     */
    ForwardingRulesCommiter<Group> getGroupCommiter();

    /**
     * Content definition method and prevent code duplicity
     * @return ForwardingRulesCommiter<Meter>
     */
    ForwardingRulesCommiter<Meter> getMeterCommiter();

    /**
     * Content definition method and prevent code duplicity
     * @return ForwardingRulesCommiter<Table>
     */
    ForwardingRulesCommiter<TableFeatures> getTableFeaturesCommiter();

    /**
     * Returns the config-subsystem/fallback configuration of FRM
     * @return ForwardingRulesManagerConfig
     */
    ForwardingRulesManagerConfig getConfiguration();

    /**
     * Method checks if *this* instance of openflowplugin is owner of
     * the given openflow node.
     * @return True if owner, else false
     */
    boolean isNodeOwner(InstanceIdentifier<FlowCapableNode> ident);

    /**
     * Content definition method and prevent code duplicity
     * @return FlowNodeConnectorInventoryTranslatorImpl
     */
    FlowNodeConnectorInventoryTranslatorImpl getFlowNodeConnectorInventoryTranslatorImpl();

}