/**
* Copyright 2016-2017 Linagora, Université Joseph Fourier, Floralis
*
* The present code is developed in the scope of the joint LINAGORA -
* Université Joseph Fourier - Floralis research program and is designated
* as a "Result" pursuant to the terms and conditions of the LINAGORA
* - Université Joseph Fourier - Floralis research program. Each copyright
* holder of Results enumerated here above fully & independently holds complete
* ownership of the complete Intellectual Property rights applicable to the whole
* of said Results, and may freely exploit it in any manner which does not infringe
* the moral rights of the other copyright holders.
*
* 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 net.roboconf.dm.internal.api;
import net.roboconf.core.model.beans.Instance;
import net.roboconf.target.api.TargetHandlerParameters;
/**
* A private API to schedule configurations of remote machines.
* @author Vincent Zurczak - Linagora
*/
public interface ITargetConfigurator {
/**
* Starts the executor.
*/
void start();
/**
* Stops the executor.
*/
void stop();
/**
* Reports a scoped instance that may have to be configured later.
* @param scopedInstance a non-null scoped instance
* @param parameters the target parameters
*/
void reportCandidate( TargetHandlerParameters parameters, Instance scopedInstance );
/**
* Cancels an awaiting configuration for a given scoped instance.
* @param scopedInstance a non-null scoped instance
* @param parameters the target parameters
*/
void cancelCandidate( TargetHandlerParameters parameters, Instance scopedInstance );
/**
* This method verifies if candidates needs and are ready to be configured.
* <p>
* A candidate is ready to be configured by a script if a configuration script exists
* and if its "data" map contains the {@link Instance#READY_FOR_CFG_MARKER} key.
* </p>
* <p>
* The configuration process is added to a queue that is processed
* in a separate thread.
* </p>
*/
void verifyCandidates();
}