All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.myfaces.trinidadinternal.ui.laf.LookAndFeelManager Maven / Gradle / Ivy

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.ui.laf;

import java.util.ArrayList;

import org.apache.myfaces.trinidadinternal.ui.UIXRenderingContext;
import org.apache.myfaces.trinidadinternal.ui.UIExtension;
import org.apache.myfaces.trinidadinternal.ui.laf.base.desktop.BaseDesktopUtils;
import org.apache.myfaces.trinidadinternal.ui.laf.simple.desktop.SimpleDesktopUtils;
import org.apache.myfaces.trinidadinternal.ui.laf.simple.pda.SimplePdaUtils;
import org.apache.myfaces.trinidad.logging.TrinidadLogger;

/**
 * Manages the set of LookAndFeel instances.  LookAndFeel instances can
 * be registered per-Agent basis.
 *
 * @see LookAndFeel
 *
 * @version $Name:  $ ($Revision: adfrt/faces/adf-faces-impl/src/main/java/oracle/adfinternal/view/faces/ui/laf/LookAndFeelManager.java#1 $) $Date: 07-dec-2005.15:27:47 $
 * @deprecated This class comes from the old Java 1.2 UIX codebase and should not be used anymore.
 */
@Deprecated
public class LookAndFeelManager
{
  /**
   * Returns the shared instanceof of LookAndFeelManager.
   */
  static public LookAndFeelManager getDefaultLookAndFeelManager()
  {
    if (_sDefaultInstance == null)
      _sDefaultInstance = createDefaultLookAndFeelManager();

    return _sDefaultInstance;
  }

  /**
   * Creates a LookAndFeelManager with default LookAndFeels registered.
   */
  static public LookAndFeelManager createDefaultLookAndFeelManager()
  {
    LookAndFeelManager manager = new LookAndFeelManager();

    /* =-=AEW DO NOT register the external look-and-feels;  these
       class names are UIX 2.2 look-and-feels, which won't (and can't)
       work in UIX 3, given the different class names.  Only uncomment
       if and when such classes are ported to UIX 3.
    // support requests from iasWireless if laf can be found
    _registerExternalLookAndFeel(manager, iaswLaf, _IASW_SCORER);

    // register OA's Text LAF if laf can be found
    _registerExternalLookAndFeel(manager, _OA_TEXT_LAF, _OA_TEXT_SCORER);
    */

    // Base lafs
    BaseDesktopUtils.registerLookAndFeel(manager);

    SimpleDesktopUtils.registerLookAndFeel(manager);
    SimplePdaUtils.registerLookAndFeel(manager);

    return manager;
  }


  /**
   * Gets the LookAndFeel for the specified RenderingContext.
   */
  public LookAndFeel getLookAndFeel(
    UIXRenderingContext context
    )
  {
    synchronized (_scorersAndLafs)
    {
      int entryCount = _scorersAndLafs.size();

      int maxEntryIndex = -1;

      // Start off with at least NO_MATCH + 1 so that we
      // only match LAFs which score greater than NO_MATCH
      int maxEntryScore = LookAndFeelScorer.NO_MATCH + 1;

      String lafName = "minimal"; 
      for (int i = 0; i < entryCount; i += 2)
      {
        LookAndFeelScorer currScorer = (LookAndFeelScorer)
                                       _scorersAndLafs.get(i);

        int currScore = _score(context, lafName, currScorer);

        // keep the laf with the highest scores, with ties going to the
        // last registered laf
        if (currScore >= maxEntryScore)
        {
          maxEntryScore = currScore;
          maxEntryIndex = i;
        }
      }

      if (maxEntryIndex < 0)
      {
        //
        // try again with no lafname
        //
        for (int i = 0; i < entryCount; i += 2)
        {
          LookAndFeelScorer currScorer = (LookAndFeelScorer)
                                         _scorersAndLafs.get(i);

          int currScore = _score(context, null, currScorer);

          // keep the laf with the highest scores, with ties going to the
          // last registered laf
          if (currScore >= maxEntryScore)
          {
            maxEntryScore = currScore;
            maxEntryIndex = i;
          }
        }
      }

      // return the entry with the highest score
      if (maxEntryIndex >= 0)
      {
        return (LookAndFeel)_scorersAndLafs.get(maxEntryIndex + 1);
      }
      else
      {
        return null;
      }
    }
  }

  /**
   * Returns the LookAndFeel instance with the specified id.
   * If no LookAndFeel with the specified id has been registered
   * with the LookAndFeelManager, returns null.
   *
   * @param id A non-null string which represents the id of a LookAndFeel
   * @see org.apache.myfaces.trinidadinternal.ui.laf.LookAndFeel#getId
   */
  public LookAndFeel getLookAndFeelById(String id)
  {
    if (id == null) 
    {
      throw new NullPointerException(_LOG.getMessage(
        "NULL_ID"));
    }

    synchronized (_scorersAndLafs)
    {
      int entryCount = _scorersAndLafs.size();

      for (int i = 1; i < entryCount; i += 2)
      {
        LookAndFeel laf = (LookAndFeel)_scorersAndLafs.get(i);
        if (id.equals(laf.getId()))
          return laf;
      }
    }

    return null;
  }

  /**
   * Returns the LookAndFeelScorer for the specified LookAndFeel.
   */
  public LookAndFeelScorer getLookAndFeelScorer(LookAndFeel laf)
  {
    synchronized (_scorersAndLafs)
    {
      int entryCount = _scorersAndLafs.size();

      for (int i = 0; i < entryCount; i += 2)
      {
        Object currLaf = _scorersAndLafs.get(i + 1);

        if (currLaf == laf)
          return (LookAndFeelScorer)_scorersAndLafs.get(i);
      }
    }

    return null;
  }

  /**
   * Registers the specified LookAndFeel to be used with the specified
   * scorer.
   */
  public void registerLookAndFeel(
    LookAndFeelScorer scorer,
    LookAndFeel       laf
    )
  {
    if ((scorer == null) || (laf == null))
      throw new IllegalArgumentException();

    synchronized(_scorersAndLafs)
    {
      _scorersAndLafs.add(scorer);
      _scorersAndLafs.add(laf);

      if (!_lafs.contains(laf))
        _lafs.add(laf);

      // Register all extensions
      int extensionCount = _extensions.size();
      for (int i = 0; i < extensionCount; i++)
      {
        UIExtension extension = _extensions.get(i);
        extension.registerSelf(laf);
      }
    }
  }

  /**
   * Unregisters the LookAndFeel for the specified scorer.
   */
  public void unregisterLookAndFeel(
    LookAndFeelScorer scorer
    )
  {
    synchronized(_scorersAndLafs)
    {
      int index = _scorersAndLafs.indexOf(scorer);

      if (index >= 0)
      {
        _scorersAndLafs.remove(index + 1);
        _scorersAndLafs.remove(index);
      }
    }
  }


  /**
   * Adds a UIExtension to this manager.  The extension will automatically
   * be registered with all LookAndFeels associated with this manager.
   */
  public void registerUIExtension(UIExtension extension)
  {
    synchronized (_scorersAndLafs)
    {
      if (!_extensions.contains(extension))
      {
        _extensions.add(extension);

        // Register the extension on all existing LookAndFeels
        int lafCount = _lafs.size();

        for (int i = 0; i < lafCount; i++)
        {
          LookAndFeel laf = _lafs.get(i);
          extension.registerSelf(laf);
        }
      }
    }
  }


  // Computes the total score
  static private int _score(
    UIXRenderingContext  context,
    String            lafName,
    LookAndFeelScorer scorer
    )
  {
    Score score = scorer.scoreLookAndFeel(context, lafName);

    // First, check for any NO_MATCH scores.
    int nameScore = score.getNameScore();
    int agentTypeScore = score.getAgentTypeScore();
    int agentApplicationScore = score.getAgentApplicationScore();
    int agentVersionScore = score.getAgentVersionScore();
    int agentOSScore = score.getAgentOSScore();
    int discriminantScore = score.getDiscriminantScore();

    // If any of the component scores are NO_MATCH, then we
    // don't have a match - return NO_MATCH.
    if ((nameScore == Score.NO_MATCH)             ||
        (agentTypeScore == Score.NO_MATCH)        ||
        (agentApplicationScore == Score.NO_MATCH) ||
        (agentVersionScore == Score.NO_MATCH)     ||
        (agentOSScore == Score.NO_MATCH)          ||
        (discriminantScore == Score.NO_MATCH))
    {
      return Score.NO_MATCH;
    }

    return (nameScore             +
            agentTypeScore        +
            agentApplicationScore +
            agentVersionScore     +
            agentOSScore          +
            discriminantScore);
  }

  // Keep this private for now
  private LookAndFeelManager() {}

  private ArrayList      _scorersAndLafs = new ArrayList(20);
  private ArrayList _extensions     = new ArrayList();

  // A list (really, a set, but there's no ArraySet) of look-and-feels;
  // this does not contain duplicates, while _scorersAndLafs may
  private ArrayList _lafs           = new ArrayList();

  private static LookAndFeelManager _sDefaultInstance;
  private static final TrinidadLogger _LOG = TrinidadLogger.createTrinidadLogger(
    LookAndFeelManager.class);
}