org.apache.flex.compiler.internal.css.codegen

Class CSSReducer

java.lang.Object

org.apache.flex.compiler.internal.css.codegen.CSSReducer

All Implemented Interfaces:

ICSSCodeGenResult

public class CSSReducer
extends Object
implements ICSSCodeGenResult

This reducer generates a valid CSS file from a CSS model tree. The target code has two main parts - an array of selector data and an object literal with function closures to set the style properties.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DATA_ARRAY The base name of CSS data array.
static String	FACTORY_FUNCTIONS The base name of CSS Factory Functions.
static String	FONTFACE_ARRAY The base name of CSS FontFace list.
static String	INHERITING_STYLES The base name of CSS Inheriting Styles.
static Name	NAME_DATA_ARRAY AET name for var data:Array.
static Name	NAME_FACTORY_FUNCTIONS ABC Name for public static var factoryFunctions:Object = generateFactoryFunctions();
static Name	NAME_FONTFACE_ARRAY AET name for var data:Array.

Constructor Summary

Constructors

Constructor and Description
CSSReducer(IFlexProject project, ICSSDocument cssDocument, IABCVisitor abcVisitor, CSSCompilationSession session, boolean isDefaultFactory, int styleTagIndex) Create a CSS reducer.

Method Summary

Methods

Modifier and Type	Method and Description
InstructionList	getClassInitializationInstructions()
Set<ICompilerProblem>	getProblems()
Pair.PairOfInstructionLists	reduceDocument(ICSSNode site, Pair.PairOfInstructionLists namespaceList, Pair.PairOfInstructionLists ruleList) Root reduction rule.
Pair.PairOfInstructionLists	reduceFontFace(ICSSNode site)
Pair.PairOfInstructionLists	reduceFontFaceList(ICSSNode site, List<Pair.PairOfInstructionLists> fontFaces)
Pair.PairOfInstructionLists	reduceMediaQuery(ICSSNode site, List<Pair.PairOfInstructionLists> conditions)
Pair.PairOfInstructionLists	reduceMediaQueryCondition(ICSSNode site)
Pair.PairOfInstructionLists	reduceNamespaceDefinition(ICSSNode site) Namespace node does not generate code.
Pair.PairOfInstructionLists	reduceNamespaceList(ICSSNode site, List<Pair.PairOfInstructionLists> namespaces) Namespace list node does not generate code.
Pair.PairOfInstructionLists	reduceProperty(ICSSNode site) Reduce a CSS property.
Pair.PairOfInstructionLists	reducePropertyList(ICSSNode site, List<Pair.PairOfInstructionLists> properties) Reduce a property list node.
Pair.InstructionListAndClosure	reduceRule(ICSSNode site, Pair.InstructionListAndClosure selector, Pair.PairOfInstructionLists propertyList) Reduce CSS rule node.
Pair.PairOfInstructionLists	reduceRuleList(ICSSNode site, List<Pair.InstructionListAndClosure> rules) Reduce rule list node.
Pair.InstructionListAndString	reduceSelector(ICSSNode site) Reduce a "selector" node.
Pair.InstructionListAndClosure	reduceSelectorGroup(ICSSNode site, List<Pair.InstructionListAndString> selectors) Reduce instructions for selector group.
void	visitClassTraits(ITraitsVisitor classTraitsVisitor) Add generated data slots for generated data structures to the specified ITraitsVisitor.

Methods inherited from class java.lang.Object

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

Field Detail

FONTFACE_ARRAY

public static final String FONTFACE_ARRAY

The base name of CSS FontFace list.

See Also:

Constant Field Values

FACTORY_FUNCTIONS

public static final String FACTORY_FUNCTIONS

The base name of CSS Factory Functions.

See Also:

Constant Field Values

INHERITING_STYLES

public static final String INHERITING_STYLES

The base name of CSS Inheriting Styles.

See Also:

Constant Field Values

DATA_ARRAY

public static final String DATA_ARRAY

The base name of CSS data array.

See Also:

Constant Field Values

NAME_DATA_ARRAY

public static final Name NAME_DATA_ARRAY

AET name for var data:Array.

NAME_FONTFACE_ARRAY

public static final Name NAME_FONTFACE_ARRAY

AET name for var data:Array.

NAME_FACTORY_FUNCTIONS

public static final Name NAME_FACTORY_FUNCTIONS

ABC Name for
public static var factoryFunctions:Object = generateFactoryFunctions();

Constructor Detail

CSSReducer

public CSSReducer(IFlexProject project,
          ICSSDocument cssDocument,
          IABCVisitor abcVisitor,
          CSSCompilationSession session,
          boolean isDefaultFactory,
          int styleTagIndex)

Create a CSS reducer.

Parameters:

project - Owner project.

cssDocument - CSS DOM tree.

abcVisitor - IABCVisitor to which generated ABC constructs are added.

session - CSS compilation session data.

isDefaultFactory - If true, the generated code will register the styles with ICSSRuntimeConstants.DEFAULT_FACTORY.

Method Detail

reduceDocument

public Pair.PairOfInstructionLists reduceDocument(ICSSNode site,
                                         Pair.PairOfInstructionLists namespaceList,
                                         Pair.PairOfInstructionLists ruleList)

Root reduction rule. It aggregates all the instructions and emit ABC code of StyleDateClass.

Parameters:

site - ICSSDocument node.

namespaceList - Instructions to create array and closure for namespace declarations.

ruleList - Instructions to create array and closure for rules.

Returns:

Instructions to create array and closure for the CSS document.

getClassInitializationInstructions

public InstructionList getClassInitializationInstructions()

Specified by:

getClassInitializationInstructions in interface ICSSCodeGenResult

Returns:

The InstructionList containing instructions for initializing the CSS data structures. This method does not append returnvoid instructions to the end of the instruction list.

visitClassTraits

public void visitClassTraits(ITraitsVisitor classTraitsVisitor)

Description copied from interface: ICSSCodeGenResult

Add generated data slots for generated data structures to the specified ITraitsVisitor.

Specified by:

visitClassTraits in interface ICSSCodeGenResult

Parameters:

classTraitsVisitor - ITraitsVisitor to which traits for the css data structures are added.

reduceNamespaceDefinition

public Pair.PairOfInstructionLists reduceNamespaceDefinition(ICSSNode site)

Namespace node does not generate code.

reduceNamespaceList

public Pair.PairOfInstructionLists reduceNamespaceList(ICSSNode site,
                                              List<Pair.PairOfInstructionLists> namespaces)

Namespace list node does not generate code.

reduceProperty

public Pair.PairOfInstructionLists reduceProperty(ICSSNode site)

Reduce a CSS property.

For example: fontSize : 12; will be translated into ActionScript:
this.fontSize = 12;
The ABC instructions for this statement are:

 getlocal0
 pushint 12
 setproperty fontSize
 

getlocal0 will put "this" on the stack, then the property value is put on the stack. Finally, setproperty will assign "12" to "fontSize".

The code generation is based on the assumption that the CSS DOM tree has been semantically checked, so that the validity of the property name and type is not re-checked in the BURM.

reducePropertyList

public Pair.PairOfInstructionLists reducePropertyList(ICSSNode site,
                                             List<Pair.PairOfInstructionLists> properties)

Reduce a property list node. This method aggregates all the instructions to set property values. It also add instructions to setup the stack frame for this function closure.

reduceRule

public Pair.InstructionListAndClosure reduceRule(ICSSNode site,
                                        Pair.InstructionListAndClosure selector,
                                        Pair.PairOfInstructionLists propertyList)

Reduce CSS rule node. The ABC method for the closures are generated here by merging the instructions from propertyList into the selector's closure map.

Parameters:

site - ICSSRule node.

selector - Instructions to construct the array data, and a map of named closures.

propertyList - Instructions to create array and closure that set the properties.

Returns:

Instructions for array data and a map of closures.

reduceSelector

public Pair.InstructionListAndString reduceSelector(ICSSNode site)

Reduce a "selector" node. The node can have zero or more ascendant selectors.

reduceRuleList

public Pair.PairOfInstructionLists reduceRuleList(ICSSNode site,
                                         List<Pair.InstructionListAndClosure> rules)

Reduce rule list node.

reduceSelectorGroup

public Pair.InstructionListAndClosure reduceSelectorGroup(ICSSNode site,
                                                 List<Pair.InstructionListAndString> selectors)

Reduce instructions for selector group.

The array reduction is instruction list. The closure reduction is a map. The keys in the map are the resolved selector names that will be used as names for the generated closures. The values in the map are all null. They will be populated in the parent tree, because the MethodInfo for the closure bodies come from a sibling "properties" tree.

reduceFontFaceList

public Pair.PairOfInstructionLists reduceFontFaceList(ICSSNode site,
                                             List<Pair.PairOfInstructionLists> fontFaces)

reduceFontFace

public Pair.PairOfInstructionLists reduceFontFace(ICSSNode site)

reduceMediaQuery

public Pair.PairOfInstructionLists reduceMediaQuery(ICSSNode site,
                                           List<Pair.PairOfInstructionLists> conditions)

reduceMediaQueryCondition

public Pair.PairOfInstructionLists reduceMediaQueryCondition(ICSSNode site)

getProblems

public Set<ICompilerProblem> getProblems()

Returns:

CSS reduction problems.