org.apache.myfaces.trinidadinternal.style.BaseStyle Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of trinidad-impl Show documentation
Private implementation of the Apache MyFaces Trinidad project
The newest version!
/*
 *  Licensed to the Apache Software Foundation (ASF) under one
 *  or more contributor license agreements.  See the NOTICE file
 *  distributed with this work for additional information
 *  regarding copyright ownership.  The ASF licenses this file
 *  to you 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 org.apache.myfaces.trinidadinternal.style;

import java.io.Serializable;

import java.util.Collections;
import java.util.Map;

import java.util.concurrent.ConcurrentHashMap;

/**
 * Base class for Style implementations
 * TODO Remove the ParsedProperty code from Trinidad. It is only used for
 * the un-used image generation code.
 * TODO Then remove CoreStyle and implement the public Style object instead.
 * @deprecated
 * @deprecated
 * @version $Name:  $ ($Revision: adfrt/faces/adf-faces-impl/src/main/java/oracle/adfinternal/view/faces/style/BaseStyle.java#0 $) $Date: 10-nov-2005.18:57:54 $
 */
abstract public class BaseStyle extends CoreStyle implements Serializable 
{
  /**
   * Creates an empty BaseStyle. For better performance, 
   * use the Base(Map<String, String>) constructor.
   */
  public BaseStyle()
  {
    _propertiesMap = Collections.emptyMap();
  }

  /**
   * Creates a BaseStyle with the specified properties
   *
   * @param propertiesMap The properties of this style.  The
   *   name and values must be Strings.
   */
  public BaseStyle(Map propertiesMap)
  {
    if ((propertiesMap != null) && (!propertiesMap.isEmpty()))
    {
      // Initialize the propertiesMap with a ConcurrentHashMap.
      // This uses more memory than ArrayMap, but is faster and safer.
      _propertiesMap = new ConcurrentHashMap(propertiesMap.size());
      
      _propertiesMap.putAll(propertiesMap);
    }
    else
      _propertiesMap = Collections.emptyMap();
  }

  /**
   * Returns an UnmodifiableMap
   */
  public Map getProperties()
  {
    return Collections.unmodifiableMap(_propertiesMap);
  }


  /**
   * Returns a parsed Java object corresponding to the specified
   * property key.
   */
  public Object getParsedProperty(ParsedPropertyKey key)
    throws PropertyParseException
  {
    Object value = null;

    // For better or worse, we assume that the key is a ParsedPropertyKey.
    // This isn't part of the public API, but we are in cahoots with the
    // Style interface.  Any other type of key is going to cause a
    // ClassCastException.  Note - we could just make Style.getParsedProperty
    // take a ParsedPropertyKey instead of an Object, but I'm not convinced
    // that the ParsedPropertyKey is the way to go just yet.
    int index = key.getKeyIndex();

    if (_parsedProperties != null)
    {
      value = _parsedProperties[index];

      if (value != null)
      {
        if (value == _NULL_VALUE)
          value = null;

        return value;
      }
    }
    else
    {
      // Just allocate the parsed properties array now, we're going to
      // write to it no matter what at this point
      synchronized (this)
      {
         if (_parsedProperties == null)
           _parsedProperties = new Object[_PARSED_PROPERTIES_COUNT];
      }
    }

    // If we don't have a parsed property value already, try to get it.
    try
    {
      value = parseProperty(key);
    }
    catch (PropertyParseException e)
    {
      _parsedProperties[index] = _NULL_VALUE;
      throw e;
    }

    _parsedProperties[index] = (value == null) ? _NULL_VALUE : value;

    return value;
  }

  /**
   * Sets the specified property value.
   */
  public void setProperty(String name, String value)
  {

    synchronized (this)
    {
      if (_propertiesMap.isEmpty())
      _propertiesMap = new ConcurrentHashMap();
      _propertiesMap.put(name, value);
      
      // We need to reset to parsed properties if our properties change
      // Really, we could just null out the corresponding parsed property
      // value, but what the heck.
      _parsedProperties = null;
    }
  }

  /**
   * Converts the style to a String suitable for use as an inline style
   * attribute value.
   */
  abstract public String toInlineString();

  /**
   * Parses the property for the specified key.
   * Subclasses should implement this method to perform style sheet
   * language-specific parsing.
   */
  abstract protected Object parseProperty(Object key)
    throws PropertyParseException;

  volatile private Map _propertiesMap;
  transient private Object[] _parsedProperties;

  // Count of parsed properties defined by Style
  private static final int _PARSED_PROPERTIES_COUNT = 7;

  // Null value used to indicate that the property has been parsed, but
  // was either invalid or null.  We use this placeholder to avoid re-parsing
  // invalid or null values.
  private static final Object _NULL_VALUE = new Object();
  
  private static final long serialVersionUID = 1L;
}