All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.onosproject.net.config.NetworkConfigStore Maven / Gradle / Ivy

There is a newer version: 2.7.0
Show newest version
/*
 * Copyright 2015 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.config;

import com.fasterxml.jackson.databind.JsonNode;
import org.onosproject.store.Store;

import java.util.Set;

/**
 * Mechanism for distributing and storing network configuration information.
 */
public interface NetworkConfigStore extends Store {

    /**
     * Adds a new configuration factory.
     *
     * @param configFactory configuration factory to add
     */
    void addConfigFactory(ConfigFactory configFactory);

    /**
     * Removes a configuration factory.
     *
     * @param configFactory configuration factory to remove
     */
    void removeConfigFactory(ConfigFactory configFactory);

    /**
     * Returns the configuration factory for the specified configuration class.
     *
     * @param configClass configuration class
     * @param          type of subject
     * @param          type of configuration
     * @return configuration factory or null
     */
    > ConfigFactory getConfigFactory(Class configClass);

    /**
     * Returns set of subjects of the specified class, which have some
     * network configuration associated with them.
     *
     * @param subjectClass subject class
     * @param           type of subject
     * @return set of subject
     */
     Set getSubjects(Class subjectClass);

    /**
     * Returns set of subjects of the specified class, which have the
     * specified class of network configuration associated with them.
     *
     * @param subjectClass subject class
     * @param configClass  configuration class
     * @param           type of subject
     * @param           type of configuration
     * @return set of subject
     */
    > Set getSubjects(Class subjectClass, Class configClass);

    /**
     * Returns set of configuration classes available for the specified subject.
     *
     * @param subject configuration subject
     * @param      type of subject
     * @return set of configuration classes
     */
     Set>> getConfigClasses(S subject);

    /**
     * Get the configuration of the given class and for the specified subject.
     *
     * @param subject     configuration subject
     * @param configClass configuration class
     * @param          type of subject
     * @param          type of configuration
     * @return configuration object
     */
    > C getConfig(S subject, Class configClass);

    /**
     * Creates a new configuration of the given class for the specified subject.
     *
     * @param subject     configuration subject
     * @param configClass configuration class
     * @param          type of subject
     * @param          type of configuration
     * @return configuration object
     */
    > C createConfig(S subject, Class configClass);

    /**
     * Applies configuration for the specified subject and configuration
     * class using the raw JSON object. If configuration already exists, it
     * will be updated.
     *
     * @param subject     configuration subject
     * @param configClass configuration class
     * @param json        raw JSON node containing the configuration data
     * @param          type of subject
     * @param          type of configuration
     * @return configuration object
     * @throws IllegalArgumentException if the supplied JSON node contains
     *                                  invalid data
     */
    > C applyConfig(S subject, Class configClass,
                                           JsonNode json);

    /**
     * Clears the configuration of the given class for the specified subject.
     *
     * @param subject     configuration subject
     * @param configClass configuration class
     * @param          type of subject
     * @param          type of configuration
     */
    > void clearConfig(S subject, Class configClass);

    /**
     * Queues pending configuration for the specified subject and configuration
     * class using the raw JSON object.
     *
     * @param subject   configuration subject
     * @param configKey configuration key
     * @param json      raw JSON node containing the configuration data
     * @param        type of subject
     * @throws IllegalArgumentException if the supplied JSON node contains
     *                                  invalid data
     */
     void queueConfig(S subject, String configKey, JsonNode json);

    /**
     * Clears the configuration of the given class for the specified subject.
     *
     * @param subject   configuration subject
     * @param configKey configuration key
     * @param        type of subject
     */
     void clearQueuedConfig(S subject, String configKey);

}