Subversion Repositories bacoAlunos

package genson;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import static com.owlike.genson.Operations.checkNotNull;

/**
 * The context class is intended to be a statefull class shared across a single execution. Its main
 * purpose is to hold local data and to pass it to others contributors of the
 * serialization/deserialization chain.
 * <p/>
 * For example if you have computed in a first serializer a value and you need it later in another
 * one, you can put it in the context by using {@link Context#store(String, Object)} method and
 * later retrieve it with {@link #get(String, Class)} or remove it with {@link #remove(String, Class)}.
 * <p/>
 * You can achieve the same thing with {@link ThreadLocalHolder} that stores the data in a thread
 * local map but it is cleaner to use this Context class as you wont have to worry about removing
 * values from it. Indeed java web servers reuse created threads, so if you store data in a thread
 * local variable and don't remove it, it will still be present when another request comes in and is
 * bound to that thread! This can also lead to memory leaks! Don't forget the
 * try-store-finally-remove block if you stick with ThreadLocalHolder.
 * <p/>
 * <p/>
 * This class stores also the views present in the current context, those views will be applied to
 * the matching objects during serialization and deserialization.
 *
 * @author eugen
 * @see genson.BeanView BeanView
 * @see genson.convert.BeanViewConverter BeanViewConverter
 * @see ThreadLocalHolder ThreadLocalHolder
 */
public class 5+0%2Fdocs%2Fapi+Context">Context {
  public final genson.Genson genson;
  private List<Class<? extends genson.BeanView<?>>> views;
  private Map<String, Object> _ctxData = new HashMap<String, Object>();

  public 5+0%2Fdocs%2Fapi+Context">Context(genson.Genson genson) {
    this(genson, null);
  }

  public 5+0%2Fdocs%2Fapi+Context">Context(genson.Genson genson, List<Class<? extends genson.BeanView<?>>> views) {
    checkNotNull(genson);
    this.genson = genson;
    this.views = views;
  }

  public boolean hasViews() {
    return views != null && !views.isEmpty();
  }

  public 5+0%2Fdocs%2Fapi+Context">Context withView(Class<? extends genson.BeanView<?>> view) {
    if (views == null) views = new ArrayList<Class<? extends genson.BeanView<?>>>();
    views.add(view);
    return this;
  }

  public List<Class<? extends genson.BeanView<?>>> views() {
    return views;
  }

  /**
   * Puts the object o in the current context indexed by key.
   *
   * @param key must be not null
   * @param o
   * @return the old object associated with that key or null.
   */
  public 5+0%2Fdocs%2Fapi+Object">Object store(1.5.0/docs/api/java/lang/String.html">String key, 5+0%2Fdocs%2Fapi+Object">Object o) {
    checkNotNull(key);
    5+0%2Fdocs%2Fapi+Object">Object old = _ctxData.get(key);
    _ctxData.put(key, o);
    return old;
  }

  /**
   * Returns the value mapped to key in this context or null. If the value is not of type
   * valueType then an exception is thrown.
   *
   * @param key       must be not null
   * @param valueType the type of the value, null not allowed
   * @return the mapping for key or null
   * @throws ClassCastException if the value mapped to key is not of type valueType.
   */
  public <T> T get(1.5.0/docs/api/java/lang/String.html">String key, Class<T> valueType) {
    checkNotNull(key, valueType);
    return valueType.cast(_ctxData.get(key));
  }

  /**
   * Removes the mapping for this key from the context. If there is no mapping for that key, null
   * is returned. If the value mapped to key is not of type valueType an ClassCastException is
   * thrown and the mapping is not removed.
   *
   * @param key       must be not null
   * @param valueType the type of the value, null not allowed
   * @return the value associated to this key
   * @throws ClassCastException if the value mapped to key is not of type valueType.
   * @see Context#get(String, Class)
   */
  public <T> T remove(1.5.0/docs/api/java/lang/String.html">String key, Class<T> valueType) {
    checkNotNull(key, valueType);
    T value = valueType.cast(_ctxData.get(key));
    _ctxData.remove(key);
    return value;
  }
}