cz.vutbr.web.css

Class CSSFactory

java.lang.Object

cz.vutbr.web.css.CSSFactory

public final class CSSFactory
extends Object

This class is abstract factory for other factories used during CSS parsing. Use it, for example, to retrieve current(default) TermFactory, current(default) SupportedCSS implementation and so on. Factories need to be registered first. By default, CSSFactory uses automatically for implementations: cz.vutbr.web.csskit.TermFactoryImpl cz.vutbr.web.domassign.SupportedCSS3 cz.vutbr.web.csskit.RuleFactoryImpl cz.vutbr.web.domassign.SingleMapNodeData Other usage of this factory is to parse either string or file into StyleSheet. Whole conversion between DOM tree and mapping of CSS to DOM tree elements could be done by invoking method assignDOM()

Author:

kapy

Constructor Summary

Constructors

Constructor and Description
CSSFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static StyleMap	assignDOM(Document doc, String encoding, URL base, String media, boolean useInheritance) Goes through a DOM tree and assigns the CSS declarations to the DOM elements.
static StyleMap	assignDOM(Document doc, URL base, String media, boolean useInheritance) Goes through a DOM tree and assigns the CSS declarations to the DOM elements.
static NodeData	createNodeData() Creates instance of NodeData
static DeclarationTransformer	getDeclarationTransformer() Returns the registered DeclarationTransformer
static MatchCondition	getDefaultMatchCondition() Obtains the default match condition to be used for matching the elements and selector parts.
static boolean	getImplyPixelLength() Says whether to allow lengths with no units and interpret them as pixels.
static RuleFactory	getRuleFactory() Returns registered RuleFactory
static SupportedCSS	getSupportedCSS() Returns registered SupportedCSS
static TermFactory	getTermFactory() Returns TermFactory registered in step above
static StyleSheet	getUsedStyles(Document doc, String encoding, URL base, String media) Loads all the style sheets used from the specified DOM tree.
static StyleSheet	getUsedStyles(Document doc, URL base, String media) Loads all the style sheets used from the specified DOM tree.
static StyleSheet	parse(String css) Parses text into StyleSheet
static StyleSheet	parse(String fileName, String encoding) Parses file into StyleSheet.
static StyleSheet	parse(URL url, String encoding) Parses URL into StyleSheet
static void	registerDeclarationTransformer(DeclarationTransformer newDeclarationTransformer) Registers new DeclarationTransformer
static void	registerDefaultMatchCondition(MatchCondition newMatchCondition) Registers a new default match condition to be used for matching the elements and selector parts.
static void	registerNodeDataInstance(Class<? extends NodeData> clazz) Registers node data instance.
static void	registerRuleFactory(RuleFactory newRuleFactory) Registers new RuleFactory
static void	registerSupportedCSS(SupportedCSS newCSS) Registers new SupportedCSS instance
static void	registerTermFactory(TermFactory newFactory) Registers new TermFactory instance
static void	setImplyPixelLength(boolean b) Sets whether to allow lengths with no units and interpret them as pixels.

Methods inherited from class java.lang.Object

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

Constructor Detail

CSSFactory

public CSSFactory()

Method Detail

setImplyPixelLength

public static final void setImplyPixelLength(boolean b)

Sets whether to allow lengths with no units and interpret them as pixels.

Parameters:

b -

getImplyPixelLength

public static final boolean getImplyPixelLength()

Says whether to allow lengths with no units and interpret them as pixels.

Returns:

registerTermFactory

public static final void registerTermFactory(TermFactory newFactory)

Registers new TermFactory instance

Parameters:

newFactory - New TermFactory

getTermFactory

public static final TermFactory getTermFactory()

Returns TermFactory registered in step above

Returns:

TermFactory registered

registerSupportedCSS

public static final void registerSupportedCSS(SupportedCSS newCSS)

Registers new SupportedCSS instance

Parameters:

newCSS - new SupportedCSS

getSupportedCSS

public static final SupportedCSS getSupportedCSS()

Returns registered SupportedCSS

Returns:

SupportedCSS instance

registerRuleFactory

public static final void registerRuleFactory(RuleFactory newRuleFactory)

Registers new RuleFactory

Parameters:

newRuleFactory - New RuleFactory instance

getRuleFactory

public static final RuleFactory getRuleFactory()

Returns registered RuleFactory

Returns:

RuleFactory instance

registerDeclarationTransformer

public static final void registerDeclarationTransformer(DeclarationTransformer newDeclarationTransformer)

Registers new DeclarationTransformer

Parameters:

newDeclarationTransformer - New DeclarationTransformer instance

getDeclarationTransformer

public static final DeclarationTransformer getDeclarationTransformer()

Returns the registered DeclarationTransformer

Returns:

DeclarationTransformer instance

registerDefaultMatchCondition

public static final void registerDefaultMatchCondition(MatchCondition newMatchCondition)

Registers a new default match condition to be used for matching the elements and selector parts.

Parameters:

newMatchCondition - the new match condition

getDefaultMatchCondition

public static final MatchCondition getDefaultMatchCondition()

Obtains the default match condition to be used for matching the elements and selector parts.

Returns:

the default match condition used by this factory.

registerNodeDataInstance

public static final void registerNodeDataInstance(Class<? extends NodeData> clazz)

Registers node data instance. Instance must provide no-argument Constructor

Parameters:

clazz - Instance class

createNodeData

public static final NodeData createNodeData()

Creates instance of NodeData

Returns:

Instance of NodeData

parse

public static final StyleSheet parse(URL url,
               String encoding)
                              throws CSSException,
                                     IOException

Parses URL into StyleSheet

Parameters:

url - URL of file to be parsed

encoding - Encoding of file

Returns:

Parsed StyleSheet

Throws:

CSSException - When exception during parse occurs

IOException - When file not found

parse

public static final StyleSheet parse(String fileName,
               String encoding)
                              throws CSSException,
                                     IOException

Parses file into StyleSheet. Internally transforms file to URL

Parameters:

fileName - Name of file

encoding - Encoding used to parse input

Returns:

Parsed style sheet

Throws:

CSSException - In case that parsing error occurs

IOException - If file is not found or not readable

parse

public static final StyleSheet parse(String css)
                              throws IOException,
                                     CSSException

Parses text into StyleSheet

Parameters:

css - Text with CSS declarations

Returns:

Parsed StyleSheet

Throws:

IOException - When exception during read occurs

CSSException - When exception during parse occurs

getUsedStyles

public static final StyleSheet getUsedStyles(Document doc,
                       URL base,
                       String media)

Loads all the style sheets used from the specified DOM tree. The following style specifications are evaluated:

• The style sheets included using the link and style tags.
• Inline styles specified using the style element attribute.
• Proprietary extension: Default styles defined using the XDefaultStyle element attribute. These styles behave the same way as the inline styles but they have the lowest priority (the values are used only when not redefined by any other way)

This method does not allow specifying the default style sheet character encoding. The current system encoding is used by default. It is recommended to use the getUsedStyles(Document, String, URL, String) method in order to specify the encoding correctly.

Parameters:

doc - DOM tree

base - Base URL against which all files are searched

media - Selected media for style sheet

Returns:

the rules of all the style sheets used in the document including the inline styles

getUsedStyles

public static final StyleSheet getUsedStyles(Document doc,
                       String encoding,
                       URL base,
                       String media)

Loads all the style sheets used from the specified DOM tree. The following style specifications are evaluated:

• The style sheets included using the link and style tags.
• Inline styles specified using the style element attribute.
• Proprietary extension: Default styles defined using the XDefaultStyle element attribute. These styles behave the same way as the inline styles but they have the lowest priority (the values are used only when not redefined by any other way)

Parameters:

doc - DOM tree

encoding - The default encoding used for the referenced style sheets

base - Base URL against which all files are searched

media - Selected media for style sheet

Returns:

the rules of all the style sheets used in the document including the inline styles

assignDOM

public static final StyleMap assignDOM(Document doc,
                 URL base,
                 String media,
                 boolean useInheritance)

Goes through a DOM tree and assigns the CSS declarations to the DOM elements. The following style specifications are evaluated:

• The style sheets included using the link and style tags.
• Inline styles specified using the style element attribute.
• Proprietary extension: Default styles defined using the XDefaultStyle element attribute. These styles behave the same way as the inline styles but they have the lowest priority (the values are used only when not redefined by any other way)

This method does not allow specifying the default style sheet character encoding. The current system encoding is used by default. It is recommended to use the assignDOM(Document, String, URL, String, boolean) method in order to specify the encoding correctly.

Parameters:

doc - DOM tree

base - Base URL against which all files are searched

media - Selected media for style sheet

useInheritance - Whether inheritance will be used to determine values

Returns:

Map between DOM element nodes and data structure containing CSS information

assignDOM

public static final StyleMap assignDOM(Document doc,
                 String encoding,
                 URL base,
                 String media,
                 boolean useInheritance)

Goes through a DOM tree and assigns the CSS declarations to the DOM elements. The following style specifications are evaluated:

• The style sheets included using the link and style tags.
• Inline styles specified using the style element attribute.
• Proprietary extension: Default styles defined using the XDefaultStyle element attribute. These styles behave the same way as the inline styles but they have the lowest priority (the values are used only when not redefined by any other way)

Parameters:

doc - DOM tree

encoding - The default encoding used for the referenced style sheets

base - Base URL against which all files are searched

media - Selected media for style sheet

useInheritance - Whether inheritance will be used to determine values

Returns:

Map between DOM element nodes and data structure containing CSS information