org.apache.myfaces.trinidadinternal.util.MessageUtils 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.util;

import java.util.Iterator;

import javax.faces.application.FacesMessage;
import javax.faces.application.FacesMessage.Severity;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;

import org.apache.myfaces.trinidad.component.core.output.CoreMessage;
import org.apache.myfaces.trinidad.context.RenderingContext;
import org.apache.myfaces.trinidad.render.RenderUtils;
import org.apache.myfaces.trinidad.util.FastMessageFormat;

import org.apache.myfaces.trinidadinternal.ui.UIXRenderingContext;
import org.apache.myfaces.trinidadinternal.ui.laf.base.BaseLafRenderer;
import org.apache.myfaces.trinidadinternal.ui.laf.base.desktop.MessageWrapper;

/**
 * Utility functions used for messaging.
 * 
 * @version $Name:  $ ($Revision: adfrt/faces/adf-faces-impl/src/main/java/oracle/adfinternal/view/faces/util/MessageUtils.java#0 $) $Date: 10-nov-2005.18:49:11 $
 */
public class MessageUtils
{
  private MessageUtils(){}

  @SuppressWarnings("unchecked")
  public static FacesMessage getFacesMessage(
    FacesContext context,
    String       clientId)
  {
    if (clientId != null)
    {
      Iterator messages = context.getMessages(clientId);
      if (messages.hasNext())
      {
        return messages.next();
      }
    }

    return null;
  }

  /**
   * Returns a string constant message type for the severity
   * of a message.
   */
  public static String getMessageTypeFromSeverity(
   FacesMessage.Severity severity)
  {
    if (severity == FacesMessage.SEVERITY_INFO)
      return CoreMessage.MESSAGE_TYPE_INFO;
    else if (severity == FacesMessage.SEVERITY_WARN)
      return CoreMessage.MESSAGE_TYPE_WARNING;
    else
      return CoreMessage.MESSAGE_TYPE_ERROR;
  }

  /**
   * @todo Check algorithm used in RI for the "for" attribute
   *  on ;  use the same algorithm.
   * @todo This method is getting called a lot;  cache something somewhere?
   */
  public static String getClientIdFor(
    FacesContext context,
    UIComponent  from,
    String       forParam)
  {
    return RenderUtils.getRelativeId(context, from, forParam);
  }
  
  /**
   * Returns true if there is more than one FacesMessage queued.
   * @param context
   * @param globalOnly Count only global messages
   * @return true if multiple messages queued.
   */
  @SuppressWarnings("unchecked")
  public static boolean multipleMessagesQueued(
      FacesContext context,
      boolean globalOnly)
  {
    Iterator msgIter = null;
    if (globalOnly)
      // All messages without id's
      msgIter = context.getMessages(null);
    else
      // All messages, inc those without id's
      msgIter = context.getMessages();
    
    if (msgIter.hasNext())
    {
      // At least one message
      msgIter.next();

      if (msgIter.hasNext())
      {
        // At least two messages
        return true;
      }
    }
    return false;
  }
  
  /**
   * @todo right now I'm just appending '_msgAnc_' to the front of the
   * client id for the anchor.
   * @todo in ie6 if you don't use an anchor,
   * but rather link to the id of the input,
   * it will put the focus in the input, so maybe we shouldn't
   * return an anchor on ie6.
   */
  public static String getAnchor(
    String clientID)
  {
    if (clientID == null)
      return null;

    return "_msgAnc_" + clientID;
  }

  @Deprecated
  public static String getGlobalMessage(
      UIXRenderingContext context,
      String summary,
      String detail)
  {
     if ((summary != null) && summary.equals(detail))
       return summary;

     String[] parameters = new String[] { summary, detail };
     String pattern = BaseLafRenderer.getTranslatedString(context,
                                                       _GLOBAL_FORMAT_KEY);

    return (new FastMessageFormat(pattern)).format(parameters);
  }

  public static String getGlobalMessage(
      RenderingContext arc,
      String summary,
      String detail)
  {
    if ((summary != null) && summary.equals(detail))
      return summary;

    String[] parameters = new String[] { summary, detail };
    String pattern = arc.getTranslatedString(_GLOBAL_FORMAT_KEY);

    return (new FastMessageFormat(pattern)).format(parameters);
  }

  public static String getClientMessage(
      RenderingContext arc,
      String summary,
      String detail)
  {

    String[] parameters = new String[] { summary };
    String pattern = arc.getTranslatedString(_MESSAGE_BOX_LIST_FORMAT_KEY);

    return (new FastMessageFormat(pattern)).format(parameters);
  }

  static private final String _GLOBAL_FORMAT_KEY =
    "af_messages.GLOBAL_MESSAGE_FORMAT";
  static private final String _MESSAGE_BOX_LIST_FORMAT_KEY =
    "af_messages.LIST_FORMAT_private";
  
}