package org.red5.server;
/*
* RED5 Open Source Flash Server - http://code.google.com/p/red5/
*
* Copyright (c) 2006-2010 by respective authors (see below). All rights reserved.
*
* This library is free software; you can redistribute it and/or modify it under the
* terms of the GNU Lesser General Public License as published by the Free Software
* Foundation; either version 2.1 of the License, or (at your option) any later
* version.
*
* This library is distributed in the hope that it will be useful, but WITHOUT ANY
* WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
* PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License along
* with this library; if not, write to the Free Software Foundation, Inc.,
* 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;
import org.red5.server.api.IAttributeStore;
import org.red5.server.api.ICastingAttributeStore;
public class AttributeStore implements ICastingAttributeStore {
/**
* Map for attributes
*/
protected ConcurrentMap<String, Object> attributes = new ConcurrentHashMap<String, Object>(1);
/**
* Filter <code>null</code> keys and values from given map.
*
* @param values the map to filter
* @return filtered map
*/
protected Map<String, Object> filterNull(Map<String, Object> values) {
Map<String, Object> result = new HashMap<String, Object>();
for (Map.Entry<String, Object> entry : values.entrySet()) {
String key = entry.getKey();
if (key == null) {
continue;
}
Object value = entry.getValue();
if (value == null) {
continue;
}
result.put(key, value);
}
return result;
}
/**
* Creates empty attribute store. Object is not associated with a persistence storage.
*/
public AttributeStore() {
// Nothing to do here
}
/**
* Creates attribute store with initial values. Object is not associated with a persistence storage.
* @param values map
*/
public AttributeStore(Map<String, Object> values) {
setAttributes(values);
}
/**
* Creates attribute store with initial values. Object is not associated with a persistence storage.
* @param values map
*/
public AttributeStore(IAttributeStore values) {
setAttributes(values);
}
/**
* Get the attribute names. The resulting set will be read-only.
*
* @return set containing all attribute names
*/
public Set<String> getAttributeNames() {
return Collections.unmodifiableSet(attributes.keySet());
}
/**
* Get the attributes. The resulting map will be read-only.
*
* @return map containing all attributes
*/
public Map<String, Object> getAttributes() {
return Collections.unmodifiableMap(attributes);
}
/**
* Return the value for a given attribute.
*
* @param name the name of the attribute to get
* @return the attribute value or null if the attribute doesn't exist
*/
public Object getAttribute(String name) {
if (name == null) {
return null;
}
return attributes.get(name);
}
/**
* Return the value for a given attribute and set it if it doesn't exist.
*
* @param name the name of the attribute to get
* @param defaultValue the value of the attribute to set if the attribute doesn't
* exist
* @return the attribute value
*/
public Object getAttribute(String name, Object defaultValue) {
if (name == null) {
return null;
}
if (defaultValue == null) {
throw new NullPointerException("the default value may not be null");
}
Object result = attributes.putIfAbsent(name, defaultValue);
if (result == null) {
// No previous value, the default has been set
result = defaultValue;
}
return result;
}
/**
* Check the object has an attribute.
*
* @param name the name of the attribute to check
* @return true if the attribute exists otherwise false
*/
public boolean hasAttribute(String name) {
if (name == null) {
return false;
}
return attributes.containsKey(name);
}
/**
* Set an attribute on this object.
*
* @param name the name of the attribute to change
* @param value the new value of the attribute
* @return true if the attribute value changed otherwise false
*/
public boolean setAttribute(String name, Object value) {
if (name == null) {
return false;
}
if (value == null) {
// Remove value
return (attributes.remove(name) != null);
} else {
// Update with new value
Object previous = attributes.put(name, value);
return (previous == null || value == previous || !value.equals(previous));
}
}
/**
* Set multiple attributes on this object.
*
* @param values the attributes to set
*/
public void setAttributes(Map<String, Object> values) {
attributes.putAll(filterNull(values));
}
/**
* Set multiple attributes on this object.
*
* @param values the attributes to set
*/
public void setAttributes(IAttributeStore values) {
setAttributes(values.getAttributes());
}
/**
* Remove an attribute.
*
* @param name the name of the attribute to remove
* @return true if the attribute was found and removed otherwise false
*/
public boolean removeAttribute(String name) {
if (name == null) {
return false;
}
return (attributes.remove(name) != null);
}
/**
* Remove all attributes.
*/
public void removeAttributes() {
attributes.clear();
}
/**
* Get Boolean attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Boolean getBoolAttribute(String name) {
return (Boolean) getAttribute(name);
}
/**
* Get Byte attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Byte getByteAttribute(String name) {
return (Byte) getAttribute(name);
}
/**
* Get Double attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Double getDoubleAttribute(String name) {
return (Double) getAttribute(name);
}
/**
* Get Integer attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Integer getIntAttribute(String name) {
return (Integer) getAttribute(name);
}
/**
* Get List attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public List<?> getListAttribute(String name) {
return (List<?>) getAttribute(name);
}
/**
* Get boolean attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Long getLongAttribute(String name) {
return (Long) getAttribute(name);
}
/**
* Get Long attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Map<?, ?> getMapAttribute(String name) {
return (Map<?, ?>) getAttribute(name);
}
/**
* Get Set attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Set<?> getSetAttribute(String name) {
return (Set<?>) getAttribute(name);
}
/**
* Get Short attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public Short getShortAttribute(String name) {
return (Short) getAttribute(name);
}
/**
* Get String attribute by name
*
* @param name Attribute name
* @return Attribute
*/
public String getStringAttribute(String name) {
return (String) getAttribute(name);
}
}