com.sun.faces.generate

Class AttributeManagerGenerator

java.lang.Object

com.sun.faces.generate.AbstractGenerator

com.sun.faces.generate.AttributeManagerGenerator

All Implemented Interfaces:

Generator

public class AttributeManagerGenerator
extends AbstractGenerator

This class is used to generate the AttributeManager, which is used by mainly Renderers to render passthrough attribues (via RenderKitUtils#renderPassThruAttributes)

The AttributeManager mainly holds a [component name/attributes] map, and the code to create that map is the main things this generator generates. Prior to this generator, Mojarra maintained a static list of passthrough attributes that would be applied to all components when rendered. The main problem with doing this is that some components have a very small list of passthrough attributes and so we'd waste cycles processing the generic list. To alleviate this issue:

 1.  Added a new code generator, AttributeManagerGenerator, which will
     leverage the xml metadata in jsf-api/doc to generate a class which
     has knowledge of which components have which pass through attributes.
     This generated class will expose a method that will allow renderers
     to lookup the set of passthrough attributes appropriate to the component
     they handle.
  2. Update all renderers that render passthrough attributes to store
     the attribute lookup result in a static variable
  3. Remove the RenderKitUtil.renderPassThruAttributes() methods containing
     excludes.  Rely on the generator to provide the correct attributes.
  4. Remove all the logic (sorting, verifying) associated with the excludes
  5. Update the RenderKitUtils.shouldRenderAttribute() logic to check
     if the value to be rendered is a String (as most are).  If it is, return
     true and bypass the remainder of the checks.

After profiling RenderKitUtils.renderPassThruAttributes has dropped quite in terms of cpu usage compared to the previous implementation.

The following shows an example of this generated Map:

 private static Map<String,Attribute[]> ATTRIBUTE_LOOKUP=CollectionsUtils.<String,Attribute[]>map()
      .add("CommandButton",ar(
          attr("accesskey")
          ,attr("alt")
          ,attr("dir")
          ,attr("lang")
          ,attr("onblur","blur")
          ...
 

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.faces.generate.AbstractGenerator

AbstractGenerator.CodeWriter

Field Summary

Fields inherited from class com.sun.faces.generate.AbstractGenerator

JAVA_KEYWORDS, TYPE_DEFAULTS

Constructor Summary

Constructors

Constructor and Description
AttributeManagerGenerator(PropertyManager manager)

Method Summary

Modifier and Type	Method and Description
void	generate(FacesConfigBean configBean) Perform whatever generation tasks are necessary using the provided FacesConfigBean as the model.
static void	main(String[] args)

Methods inherited from class com.sun.faces.generate.AbstractGenerator

capitalize, mangle, options, primitive, shortName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AttributeManagerGenerator

public AttributeManagerGenerator(PropertyManager manager)

Method Detail

generate

public void generate(FacesConfigBean configBean)

Description copied from interface: Generator

Perform whatever generation tasks are necessary using the provided FacesConfigBean as the model.

Parameters:

configBean - model data

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception