/*
 * Copyright (c) 2013 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.controller.config.manager.impl;

import java.util.List;

import javax.management.InstanceAlreadyExistsException;
import javax.management.ObjectName;

import org.opendaylight.controller.config.api.ModuleIdentifier;
import org.opendaylight.controller.config.api.ValidationException;

/**
 * Defines contract between {@link ConfigTransactionControllerImpl} (producer)
 * and {@link ConfigRegistryImpl} (consumer).
 */
interface ConfigTransactionControllerInternal extends
        ConfigTransactionControllerImplMXBean {

    /**
     * Copy already committed module to current transaction.
     */
    void copyExistingModule(ModuleInternalInfo oldConfigBeanInfo)
            throws InstanceAlreadyExistsException;

    /**
     * Call {@link org.opendaylight.controller.config.spi.Module#validate()} on
     * all beans in transaction. Lock transaction after successful validation.
     * This method can be called multiple times if validation fails, but cannot
     * be called after it did not throw exception.
     *
     * @throws {@link RuntimeException} if validation fails. It is safe to run
     *         this method in future
     * @return CommitInfo
     */
    CommitInfo validateBeforeCommitAndLockTransaction()
            throws ValidationException;

    /**
     * Call {@link org.opendaylight.controller.config.spi.Module#getInstance()}
     * on all beans in transaction. This method can be only called once.
     *
     * @throws {@link RuntimeException} commit fails, indicates bug in config
     *         bean
     * @return ordered list of module identifiers that respects dependency
     *         order.
     */
    List<ModuleIdentifier> secondPhaseCommit();

    /**
     * @return ObjectName of this transaction controller
     */
    ObjectName getControllerObjectName();

    /**
     * @return true iif transaction was committed or aborted.
     */
    boolean isClosed();

}