org.seedstack.business.data.DataManager Maven / Gradle / Ivy

Go to download
/*
 * Copyright © 2013-2024, The SeedStack authors 
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
package org.seedstack.business.data;

import java.io.InputStream;
import java.io.OutputStream;

/**
 * The data manager provides data import and export facilities.
 */
public interface DataManager {

    /**
     * Export all data of the application as a stream.
     *
     * @param outputStream the stream to output data to.
     */
    void exportData(OutputStream outputStream);

    /**
     * Export data from one specified group as a stream.
     *
     * @param outputStream the stream to output data to.
     * @param group        the data group.
     */
    void exportData(OutputStream outputStream, String group);

    /**
     * Export a specified data set as a stream.
     *
     * @param outputStream the stream to output data to.
     * @param group        the data group.
     * @param name         the data name.
     */
    void exportData(OutputStream outputStream, String group, String name);

    /**
     * Import data in the application from a stream.
     *
     * @param inputStream the stream to read data from.
     */
    void importData(InputStream inputStream);

    /**
     * Import data from one specified group, ignoring other data.
     *
     * @param inputStream the stream to read data from.
     * @param group       the data group.
     */
    void importData(InputStream inputStream, String group);

    /**
     * Import data from the specified data set, ignoring other data.
     *
     * @param inputStream the stream to read data from.
     * @param group       the data group.
     * @param name        the data name.
     */
    void importData(InputStream inputStream, String group, String name);

    /**
     * Returns if a particular data set is already initialized in the application. This method is used
     * to know if it must automatically load initialization data.
     *
     * @param group the data group.
     * @param name  the data name.
     * @return true if already initialized, false otherwise.
     */
    boolean isInitialized(String group, String name);
}