com.sun.faces.util
public class Util extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
private static java.lang.String |
CDI_AVAILABLE_PER_APP_KEY |
private static java.lang.String |
FACES_CONTEXT_ATTRIBUTES_DOCTYPE_KEY |
private static java.lang.String |
FACES_CONTEXT_ATTRIBUTES_XMLDECL_KEY |
private static java.util.logging.Logger |
LOGGER |
private static java.lang.String |
patternCacheKey
RegEx patterns
|
private static boolean |
unitTestModeEnabled
Flag that, when true, enables special behavior in the RI to enable
unit testing.
|
Modifier | Constructor and Description |
---|---|
private |
Util() |
Modifier and Type | Method and Description |
---|---|
static void |
checkIdUniqueness(javax.faces.context.FacesContext context,
javax.faces.component.UIComponent component,
java.util.Set<java.lang.String> componentIds)
Utility method to validate ID uniqueness for the tree represented
by
component . |
static boolean |
componentIsDisabled(javax.faces.component.UIComponent component) |
static boolean |
componentIsDisabledOrReadonly(javax.faces.component.UIComponent component) |
static javax.xml.parsers.DocumentBuilderFactory |
createDocumentBuilderFactory() |
static javax.xml.parsers.SAXParserFactory |
createSAXParserFactory() |
static javax.xml.validation.SchemaFactory |
createSchemaFactory(java.lang.String uri) |
static javax.xml.transform.TransformerFactory |
createTransformerFactory() |
static java.lang.String |
getContentTypeFromResponse(java.lang.Object response)
PRECONDITION: argument
response is non-null and
has a method called getContentType that takes no
arguments and returns a String, with no side-effects. |
private static java.lang.ClassLoader |
getContextClassLoader() |
static javax.faces.convert.Converter |
getConverterForClass(java.lang.Class converterClass,
javax.faces.context.FacesContext context) |
static javax.faces.convert.Converter |
getConverterForIdentifer(java.lang.String converterId,
javax.faces.context.FacesContext context) |
static java.lang.ClassLoader |
getCurrentLoader(java.lang.Object fallbackClass) |
static java.lang.String |
getDOCTYPEFromFacesContextAttributes(javax.faces.context.FacesContext context) |
static java.lang.String |
getFacesMapping(javax.faces.context.FacesContext context)
Returns the URL pattern of the
FacesServlet that
is executing the current request. |
static java.beans.FeatureDescriptor |
getFeatureDescriptor(java.lang.String name,
java.lang.String displayName,
java.lang.String desc,
boolean expert,
boolean hidden,
boolean preferred,
java.lang.Object type,
java.lang.Boolean designTime) |
static long |
getLastModified(java.net.URL url) |
static java.lang.Object |
getListenerInstance(javax.el.ValueExpression type,
javax.el.ValueExpression binding)
Factory method for creating the varius JSF listener
instances that may be referenced by
type
or binding . |
static java.util.Locale |
getLocaleFromContextOrSystem(javax.faces.context.FacesContext context) |
static java.util.Locale |
getLocaleFromString(java.lang.String localeStr) |
static java.util.Locale |
getLocaleFromStringWithLanguageTag(java.lang.String localeStr) |
static java.util.Locale |
getLocaleFromStringWithoutLanguageTag(java.lang.String localeStr) |
private static java.lang.String |
getMappingForRequest(java.lang.String servletPath,
java.lang.String pathInfo)
Return the appropriate
FacesServlet mapping
based on the servlet path of the current request. |
private static java.util.Map<java.lang.String,java.util.regex.Pattern> |
getPatternCache(java.util.Map<java.lang.String,java.lang.Object> appMap) |
private static java.util.Map<java.lang.String,java.util.regex.Pattern> |
getPatternCache(javax.servlet.ServletContext sc) |
static java.lang.String |
getStackTraceString(java.lang.Throwable e)
Leverage the Throwable.getStackTrace() method to produce a String
version of the stack trace, with a "\n" before each line.
|
static javax.faces.application.StateManager |
getStateManager(javax.faces.context.FacesContext context) |
static java.lang.Class |
getTypeFromString(java.lang.String type) |
static javax.faces.application.ViewHandler |
getViewHandler(javax.faces.context.FacesContext context) |
static java.lang.String |
getXMLDECLFromFacesContextAttributes(javax.faces.context.FacesContext context) |
static int |
indexOfSet(java.lang.String str,
char[] set,
int fromIndex) |
static boolean |
isCDIAvailable(javax.servlet.ServletContext sc) |
static boolean |
isPortletRequest(javax.faces.context.FacesContext context)
Convenience method for determining if the request associated
with the specified
FacesContext is a PortletRequest
submitted by the JSR-301 bridge. |
static boolean |
isPrefixMapped(java.lang.String mapping)
Returns true if the provided
url-mapping is
a prefix path mapping (starts with / ). |
static boolean |
isSpecialAttributeName(java.lang.String name) |
static boolean |
isUnitTestModeEnabled() |
static boolean |
isViewPopulated(javax.faces.context.FacesContext ctx,
javax.faces.component.UIViewRoot viewToRender) |
static java.lang.Class |
loadClass(java.lang.String name,
java.lang.Object fallbackClass) |
static void |
notNull(java.lang.String varname,
java.lang.Object var) |
static void |
saveDOCTYPEToFacesContextAttributes(java.lang.String DOCTYPE) |
static void |
saveXMLDECLToFacesContextAttributes(java.lang.String XMLDECL) |
static void |
setCDIAvailable(javax.servlet.ServletContext sc,
java.lang.Object beanManager) |
static void |
setUnitTestModeEnabled(boolean enabled) |
static void |
setViewPopulated(javax.faces.context.FacesContext ctx,
javax.faces.component.UIViewRoot viewToRender)
Flag the specified
UIViewRoot as populated. |
static java.lang.String[] |
split(java.util.Map<java.lang.String,java.lang.Object> appMap,
java.lang.String toSplit,
java.lang.String regex)
A slightly more efficient version of
String.split() which caches
the Pattern s in an LRUMap instead of
creating a new Pattern on each
invocation. |
static java.lang.String[] |
split(javax.servlet.ServletContext sc,
java.lang.String toSplit,
java.lang.String regex) |
private static final java.util.logging.Logger LOGGER
private static boolean unitTestModeEnabled
private static final java.lang.String patternCacheKey
private static final java.lang.String CDI_AVAILABLE_PER_APP_KEY
private static final java.lang.String FACES_CONTEXT_ATTRIBUTES_DOCTYPE_KEY
private static final java.lang.String FACES_CONTEXT_ATTRIBUTES_XMLDECL_KEY
private static java.util.Map<java.lang.String,java.util.regex.Pattern> getPatternCache(java.util.Map<java.lang.String,java.lang.Object> appMap)
private static java.util.Map<java.lang.String,java.util.regex.Pattern> getPatternCache(javax.servlet.ServletContext sc)
public static boolean isCDIAvailable(javax.servlet.ServletContext sc)
public static void setCDIAvailable(javax.servlet.ServletContext sc, java.lang.Object beanManager)
public static boolean isPortletRequest(javax.faces.context.FacesContext context)
Convenience method for determining if the request associated
with the specified FacesContext
is a PortletRequest
submitted by the JSR-301 bridge.
context
- the FacesContext
associated with
the request.public static java.lang.Object getListenerInstance(javax.el.ValueExpression type, javax.el.ValueExpression binding)
Factory method for creating the varius JSF listener
instances that may be referenced by type
or binding
.
If binding
is not null
and the evaluation result is not null
return
that instance. Otherwise try to instantiate an instances
based on type
.
type
- the Listener
typebinding
- a ValueExpression
which resolves
to a Listener
instanceListener
instance based off the provided
type
and public static void setUnitTestModeEnabled(boolean enabled)
public static boolean isUnitTestModeEnabled()
public static javax.xml.transform.TransformerFactory createTransformerFactory()
public static javax.xml.parsers.SAXParserFactory createSAXParserFactory()
public static javax.xml.parsers.DocumentBuilderFactory createDocumentBuilderFactory()
public static javax.xml.validation.SchemaFactory createSchemaFactory(java.lang.String uri)
public static java.lang.Class loadClass(java.lang.String name, java.lang.Object fallbackClass) throws java.lang.ClassNotFoundException
java.lang.ClassNotFoundException
public static java.lang.ClassLoader getCurrentLoader(java.lang.Object fallbackClass)
private static java.lang.ClassLoader getContextClassLoader()
public static void notNull(java.lang.String varname, java.lang.Object var)
public static java.util.Locale getLocaleFromContextOrSystem(javax.faces.context.FacesContext context)
context
- the FacesContext
for the current requestpublic static javax.faces.convert.Converter getConverterForClass(java.lang.Class converterClass, javax.faces.context.FacesContext context)
public static javax.faces.convert.Converter getConverterForIdentifer(java.lang.String converterId, javax.faces.context.FacesContext context)
public static javax.faces.application.StateManager getStateManager(javax.faces.context.FacesContext context) throws javax.faces.FacesException
javax.faces.FacesException
public static java.lang.Class getTypeFromString(java.lang.String type) throws java.lang.ClassNotFoundException
java.lang.ClassNotFoundException
public static javax.faces.application.ViewHandler getViewHandler(javax.faces.context.FacesContext context) throws javax.faces.FacesException
javax.faces.FacesException
public static boolean componentIsDisabled(javax.faces.component.UIComponent component)
public static boolean componentIsDisabledOrReadonly(javax.faces.component.UIComponent component)
public static java.util.Locale getLocaleFromString(java.lang.String localeStr) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException
public static java.util.Locale getLocaleFromStringWithLanguageTag(java.lang.String localeStr) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException
public static java.util.Locale getLocaleFromStringWithoutLanguageTag(java.lang.String localeStr) throws java.lang.IllegalArgumentException
java.lang.IllegalArgumentException
public static int indexOfSet(java.lang.String str, char[] set, int fromIndex)
str
- local stringset
- the substringfromIndex
- starting indexfromIndex
, the index of the
first occurrence of any substring from set
in
toSearch
, or -1 if no such match is foundpublic static java.lang.String getStackTraceString(java.lang.Throwable e)
Leverage the Throwable.getStackTrace() method to produce a String version of the stack trace, with a "\n" before each line.
e
- the Throwable to obtain the stacktrace frompublic static java.lang.String getContentTypeFromResponse(java.lang.Object response)
PRECONDITION: argument response
is non-null and
has a method called getContentType
that takes no
arguments and returns a String, with no side-effects.
This method allows us to get the contentType in both the servlet and portlet cases, without introducing a compile-time dependency on the portlet api.
response
- the current responsepublic static java.beans.FeatureDescriptor getFeatureDescriptor(java.lang.String name, java.lang.String displayName, java.lang.String desc, boolean expert, boolean hidden, boolean preferred, java.lang.Object type, java.lang.Boolean designTime)
public static java.lang.String[] split(java.util.Map<java.lang.String,java.lang.Object> appMap, java.lang.String toSplit, java.lang.String regex)
A slightly more efficient version of
String.split()
which caches
the Pattern
s in an LRUMap instead of
creating a new Pattern
on each
invocation.
appMap
- the Application MaptoSplit
- the string to splitregex
- the regex used for splittingPattern.spit(String, int)
public static java.lang.String[] split(javax.servlet.ServletContext sc, java.lang.String toSplit, java.lang.String regex)
public static java.lang.String getFacesMapping(javax.faces.context.FacesContext context)
Returns the URL pattern of the
FacesServlet
that
is executing the current request. If there are multiple
URL patterns, the value returned by
HttpServletRequest.getServletPath()
and
HttpServletRequest.getPathInfo()
is
used to determine which mapping to return.
FacesServlet
.context
- the FacesContext
of the current requestFacesServlet
or null
if no mapping can be determinedjava.lang.NullPointerException
- if context
is nullprivate static java.lang.String getMappingForRequest(java.lang.String servletPath, java.lang.String pathInfo)
Return the appropriate FacesServlet
mapping
based on the servlet path of the current request.
servletPath
- the servlet path of the requestpathInfo
- the path info of the requestHttpServletRequest.getServletPath()
public static boolean isPrefixMapped(java.lang.String mapping)
Returns true if the provided url-mapping
is
a prefix path mapping (starts with /
).
mapping
- a url-pattern
/
public static boolean isSpecialAttributeName(java.lang.String name)
public static boolean isViewPopulated(javax.faces.context.FacesContext ctx, javax.faces.component.UIViewRoot viewToRender)
ctx
- the FacesContext
for the current requestviewToRender
- the UIViewRoot
to checktrue
if the FacesContext
attributes map
contains a reference to the UIViewRoot
's view IDpublic static void setViewPopulated(javax.faces.context.FacesContext ctx, javax.faces.component.UIViewRoot viewToRender)
Flag the specified UIViewRoot
as populated.
ctx
- the FacesContext
for the current requestviewToRender
- the UIViewRoot
to mark as populatedpublic static void checkIdUniqueness(javax.faces.context.FacesContext context, javax.faces.component.UIComponent component, java.util.Set<java.lang.String> componentIds)
component
.public static void saveDOCTYPEToFacesContextAttributes(java.lang.String DOCTYPE)
public static java.lang.String getDOCTYPEFromFacesContextAttributes(javax.faces.context.FacesContext context)
public static void saveXMLDECLToFacesContextAttributes(java.lang.String XMLDECL)
public static java.lang.String getXMLDECLFromFacesContextAttributes(javax.faces.context.FacesContext context)
public static long getLastModified(java.net.URL url)
Copyright © 2002-2010 Oracle America, Inc. All Rights Reserved.