Util

Table of Contents Util FacesUtils

Util

Para facilitar o desenvolvimento, algumas classes utilitárias foram criadas e podem ser usadas quando e onde for necessário. Em sua grande maioria, são classes abstratas com métodos estáticos, simplificando a utilização.

FacesUtils

Classe utilitária para funções rotineiras e comuns com o desenvolvimento com JSF.

Praticamente todos os métodos da FecesUtils foram linkados com atalhos na classe Controller. Desta forma, sua controladora já possuirá todos os facilitadores dessa classe.

Facilidades

/**
 * Retorna a referencia do FacesContext.
 * @return FacesContext
 */
public static FacesContext getContext()

/**
 * Retorna a referencia do ExternalContext.
 * @return ExternalContext
 */
public static ExternalContext getExternalContext()

/**
 * Retorna a referencia para o HttpServletResponse atual.
 * @return HttpServletResponse
 */
public static HttpServletResponse getResponse()

/**
 * Retorna a referencia para o HttpServletRequest atual.
 * @return HttpServletRequest
 */
public static HttpServletRequest getRequest()

/**
 * Retorna a referencia para o Map de request.
 * @return Map<String, Object>
 */
public static Map<String, Object> getRequestMap()

/**
 * Retorna a instancia atual do contexto ServletContext.
 * @return ServletContext
 */
public static ServletContext getServletContext()

/**
 * Retorna um parametro do Request HTTP (HttpServletRequest) sob a chave 'name'.
 * @param name - chave do parametro no Request HTTP
 * @return String - parametro do Request HTTP sob a chave 'name'
 */
public static String getParameter(String name)

/**
 * Retorna a referencia do Map de parametros da Request
 * @return Map<String, String>
 */
public static Map<String, String> getRequestParameterMap()

/**
 * Retorna a referencia para o HttpSession atual.
 * @return HttpSession
 */
public static HttpSession getSession()

/**
 * Retorna a referencia do Map da HttpSession.
 * @return Map<String, Object>
 */
public static Map<String, Object> getSessionMap()
   
/**
 * Retorna o contexto de Flash
 * @return Flash
 */
public static Flash getFlash()

/**
 * Adiciona uma mensagem no facesMessages com severidade info.
 * @param msg
 * @param params
 */
public static void addMsg(String msg, Object ... params)

/**
 * Adiciona uma mensagem no facesMessages com severidade INFO, para o componente 
 * especificado
 * @param compoenentId
 * @param msg
 * @param params
 */
public static void addMsgToComponent(String componenteId, String msg, Object... params)

/**
 * Adiciona uma mensagem no facesMessages com severidade warn.
 * @param msg
 * @param params
 */
public static void addMsgWarn(String msg, Object... params)

/**
 * Adiciona uma mensagem no facesMessages com severidade WARN, para o componente 
 * especificado.
 * @param compoenentId
 * @param msg
 * @param params
 */
public static void addMsgWarnToComponent(String componenteId, String msg, Object... params)

/**
 * Adiciona uma mensagem no facesMessages com severidade error.
 * @param msg
 * @param params
 */
public static void addMsgErro(String msg, Object... params)

/**
 * Adiciona uma mensagem do bundle no facesMessages com severidade error, para o componente 
 * especificado.
 * @param compoenentId
 * @param msg
 * @param params
 */
public static void addMsgErroToComponent(String componenteId, String msg, Object... params)

/**
 * Adiciona uma mensagem do bundle no facesMessages
 * @param severity
 * @param msg
 * @param params
 */
public static void addMsg(Severity severity, String msg, Object... params)

/**
 * Adiciona uma mensagem do bundle no facesMessages, para o componente especificado
 * @param severity
 * @param componentId
 * @param msg
 * @param params
 */
public static void addMsgToComponent(String componentId, Severity severity, String msg, Object... params)

/**
 * Cria uma mensagem com os parametros informados
 * @param severity
 * @param msg
 * @param params
 * @return
 */
public static FacesMessage createMessage(Severity severity, String msg, Object... params)

/**
 * Retorna a mensagem do arquivo properties default ("messages") formatada com os parametros passados.
 * 
 * @param key
 * @param params
 * @return mensagem formatada
 */
public static String getMessageFromDefaultBundle(String key, Object ... params)

/**
 * Retorna o locale do usuario
 * 
 * @return locale
 */
public static Locale getLocale()

/**
 * Retorna a mensagem do arquivo properties, que possui o nome passado como argumento, formatada com os parametros passados.
 * 
 * @param bundleName
 * @param key
 * @param params
 * @return mensagem formatada
 */
public static String getMessageFromBundle(String bundleName, String key, Object ... params)

/**
 * Retorna a mensagem do bundle informado e de acordo com os parametros informados.
 * 
 * @param bundleName
 * @param locale
 * @param key
 * @param params
 * @return mensagem formatada
 */
public static String getMessageFromBundle(String bundleName, Locale locale, String key, Object ... params)