com.almende.eve.state.State Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of eve-bundle-full Show documentation
The newest version!
/*
 * Copyright: Almende B.V. (2014), Rotterdam, The Netherlands
 * License: The Apache Software License, Version 2.0
 */
package com.almende.eve.state;

import java.lang.reflect.Type;
import java.util.Set;

import com.almende.eve.capabilities.Capability;
import com.almende.util.TypeUtil;
import com.fasterxml.jackson.databind.JavaType;

/**
 * The Interface State.
 */
public interface State extends Capability {
	/**
	 * Delete this state.
	 */
	void delete();
	
	/**
	 * Gets the state's id.
	 * 
	 * @return the state's id
	 */
	String getId();
	
	/**
	 * Put.
	 * 
	 * @param key
	 *            the key
	 * @param value
	 *            the value
	 * @return the object
	 */
	Object put(String key, Object value);
	
	/**
	 * Removes the.
	 * 
	 * @param key
	 *            the key
	 * @return the object
	 */
	Object remove(String key);
	
	/**
	 * Put if unchanged.
	 * 
	 * @param key
	 *            the key
	 * @param newVal
	 *            the new val
	 * @param oldVal
	 *            the old val
	 * @return true, if successful
	 */
	boolean putIfUnchanged(String key, Object newVal, Object oldVal);
	
	/**
	 * Contains key.
	 * 
	 * @param key
	 *            the key
	 * @return true, if successful
	 */
	boolean containsKey(String key);
	
	/**
	 * Key set.
	 * 
	 * @return the sets the
	 */
	Set keySet();
	
	/**
	 * Clear.
	 */
	void clear();
	
	/**
	 * Size.
	 * 
	 * @return the int
	 */
	int size();
	
	/**
	 * Gets the.
	 * 
	 * @param 
	 *            the generic type
	 * @param key
	 *            the key
	 * @param type
	 *            the type
	 * @return the t
	 */
	 T get(String key, Class type);
	
	/**
	 * Gets the.
	 * 
	 * @param 
	 *            the generic type
	 * @param key
	 *            the key
	 * @param type
	 *            the type
	 * @return the t
	 */
	 T get(String key, Type type);
	
	/**
	 * Gets the.
	 * 
	 * @param 
	 *            the generic type
	 * @param key
	 *            the key
	 * @param type
	 *            the type
	 * @return the t
	 */
	 T get(String key, JavaType type);
	
	/**
	 * Gets the.
	 * 
	 * @param 
	 *            the generic type
	 * @param key
	 *            the key
	 * @param type
	 *            the type
	 * @return the t
	 */
	 T get(String key, TypeUtil type);
	
	/**
	 * Gets the.
	 * 
	 * @param 
	 *            the generic type
	 * @param key
	 *            the key
	 * @return the t
	 */
	 T get(TypedKey key);
	
	/**
	 * Gets the service.
	 *
	 * @return the service
	 */
	StateService getService();
	
}