com.mageddo.featureswitch.FeatureManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of feature-switch Show documentation
Simplify Consumer And Producer Configuration
The newest version!
package com.mageddo.featureswitch;

import com.mageddo.featureswitch.repository.FeatureRepository;

import java.util.Map;

public interface FeatureManager {

	FeatureRepository repository();

	FeatureMetadataProvider metadataProvider();

	/**
	 * Just activate feature, should keep original feature parameters
	 * @see FeatureKeys
	 */
	void activate(Feature feature);

	/**
	 * Activate feature and set value parameter, keep original parameters untouched
	 * @see FeatureKeys
	 */
	void activate(Feature feature, String value);

	/**
	 * Set feature as restricted then activate for user, keep original parameters untouched
	 * @see FeatureKeys
	 */
	void userActivate(Feature feature, String user);

	/**
	 * Set feature as restricted then activate for user with specified value, keep original parameters untouched
	 * @see FeatureKeys
	 */
	void userActivate(Feature feature, String user, String value);

	/**
	 * Deactivate feature, should keep original feature parameters
	 * @see FeatureKeys
	 */
	void deactivate(Feature feature);

	/**
	 * Deactivate feature to user, should keep original feature parameters
	 * @see FeatureKeys
	 */
	void userDeactivate(Feature feature, String user);

	/**
	 * Retrieve feature metadata from Repository or the default metadata if
	 */
	FeatureMetadata metadata(Feature feature);

	void updateMetadata(Feature feature, Map parameters);

	/**
	 * Merge especified parameters to the already existing
	 * @param feature
	 * @param user
	 * @param parameters
	 */
	void updateMetadata(Feature feature, String user, Map parameters);

	/**
	 * Retrieve feature metadata for the specified user from Repository or the default metadata.
	 * 
	 * If Feature is active must return metadata from the feature not the user feature
	 * If Feature is restricted must return metadata from the user feature even if it have not any
	 * If Feature is inactive must return null
	 * If there is no default or Repository feature data then must return null
	 * 
	 */
	FeatureMetadata metadata(Feature feature, String user);

	/**
	 * Check if feature is active
	 */
	boolean isActive(Feature feature);

	/**
	 *
	 * Check if feature is active for user, if no user is passed then will check if the feature itself is active
	 */
	boolean isActive(Feature feature, String user);

	String value(Feature feature);

	String value(Feature feature, String user);
}