/*
 * Copyright (C) 2014 Red Hat, Inc.
 *
 * 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
 *
 *  Authors : Dave Tucker
 */

package org.opendaylight.ovsdb.openstack.netvirt.api;

import org.opendaylight.yang.gen.v1.urn.tbd.params.xml.ns.yang.network.topology.rev131021.network.topology.topology.Node;

import java.net.InetAddress;
import java.util.Map;
import org.apache.commons.lang3.tuple.Pair;

/**
 * The ConfigurationService handles the configuration of the OpenStack Neutron Integration
 * It exposes a set of Configuration variables and helper functions for obtaining node-specific
 * configuration from the Open_vSwitch table of an OVS instance.
 */
public interface ConfigurationService {

    /**
     * Returns the name configured name of the Integration Bridge
     */
    public String getIntegrationBridgeName();

    /**
     * Configures the name of the Integration Bridge
     */
    public void setIntegrationBridgeName(String integrationBridgeName);

    /**
     * Returns the name configured name of the Network Bridge
     */
    public String getNetworkBridgeName();

    /**
     * Configures the name of the Network Bridge
     */
    public void setNetworkBridgeName(String networkBridgeName);

    /**
     * Returns the name configured name of the ExternalBridge
     */
    public String getExternalBridgeName();

    /**
     * Configures the name of the External Bridge
     */
    public void setExternalBridgeName(String externalBridgeName);

    /**
     * Returns the key used to access the Tunnel Endpoint configuration from Open vSwitch
     */
    public String getTunnelEndpointKey();

    /**
     * Sets the key used to access the Tunnel Endpoint configuration from Open vSwitch
     */
    public void setTunnelEndpointKey(String tunnelEndpointKey);

    /**
     * Returns a Map of patch port names where the key is a tuple of source bridge and destination bridge
     */
    public Map<Pair<String, String>, String> getPatchPortNames();

    /**
     * Sets the Map of source/destination bridges to patch port name
     */
    public void setPatchPortNames(Map<Pair<String, String>, String> patchPortNames);

    /**
     * Get the name of a patch port
     * @param portTuple a {@link org.apache.commons.lang3.tuple.Pair} where L
     *                  is the source bridge and R the destination bridge
     * @return the name of the patch port
     */
    public String getPatchPortName(Pair portTuple);

    /**
     * Returns the key used to access the Tunnel Endpoint configuration from Open vSwitch
     */
    public String getProviderMappingsKey();

    /**
     * Sets the key used to access the Tunnel Endpoint configuration from Open vSwitch
     */
    public void setProviderMappingsKey(String providerMappingsKey);

    /**
     * Gets the default provider mapping
     */
    public String getDefaultProviderMapping();

    /**
     * Sets the default provider mapping
     */
    public void setDefaultProviderMapping(String providerMapping);

    /**
     * Gets the tunnel endpoint address for a given Node
     * @param node a {@link Node}
     * @return the tunnel endpoint
     * @see java.net.InetAddress
     */
    public InetAddress getTunnelEndPoint(Node node);

    /**
     * Returns the OpenFlow version to be used by the {@link NetworkingProvider}
     * Default is OpenFlow 1.0. OVS versions greater than 1.10.0 will use OpenFlow 1.3
     * @param node the node to query
     * @return the OpenFlow version to use
     */
    public String getOpenflowVersion(Node node);

    /**
     * Returns the MacAddress to be used for the default gateway by the {@link L3ForwardingProvider}
     * There is no default.
     * @param node the node to query
     * @return the MacAddress to use for the default gateway; or null if none is configured.
     */
    public String getDefaultGatewayMacAddress(Node node);
}