org.apache.tapestry.util
Class PageRenderSupportImpl

java.lang.Object
  org.apache.tapestry.util.PageRenderSupportImpl

All Implemented Interfaces:

Locatable, IScriptProcessor, PageRenderSupport

public class PageRenderSupportImpl
extends Object
implements Locatable, PageRenderSupport

Implementation of PageRenderSupport. The Body component uses an instance of this class.

Since:

4.0

Author:

Howard M. Lewis Ship

Constructor Summary

PageRenderSupportImpl(AssetFactory assetFactory, String namespace, Location location, ResponseBuilder builder)

Method Summary

void	addBodyScript(IComponent target, String script) Adds scripting code to the main body.
void	addBodyScript(String script) Adds scripting code to the main body.
void	addExternalScript(IComponent target, Resource scriptLocation) Adds an external script.
void	addExternalScript(Resource scriptLocation) Adds an external script.
void	addInitializationScript(IComponent target, String script) Adds initialization script.
void	addInitializationScript(String script) Adds initialization script.
Location	getLocation() Returns the location, which may be used in error messages.
String	getPreloadedImageReference(IComponent target, String URL) Sets up the given URL to preload, and returns a reference to the loaded image, in the form of a snippet of JavaScript expression that can be inserted into some larger block of JavaScript as a function parameter, or as a property assignment.
String	getPreloadedImageReference(String URL) Sets up the given URL to preload, and returns a reference to the loaded image, in the form of a snippet of JavaScript expression that can be inserted into some larger block of JavaScript as a function parameter, or as a property assignment.
String	getUniqueString(String baseValue) Ensures that the given string is unique.
void	writeBodyScript(IMarkupWriter writer, IRequestCycle cycle) Writes a single large JavaScript block containing: Any image initializations (via getPreloadedImageReference(IComponent, String)).
void	writeInitializationScript(IMarkupWriter writer) Writes any image initializations; this should be invoked at the end of the render, after all the related HTML will have already been streamed to the client and parsed by the web browser.

Methods inherited from class java.lang.Object

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

Constructor Detail

PageRenderSupportImpl

public PageRenderSupportImpl(AssetFactory assetFactory,
                             String namespace,
                             Location location,
                             ResponseBuilder builder)

Method Detail

getLocation

public Location getLocation()

Returns the location, which may be used in error messages. In practical terms, this is the location of the Body component.

Specified by:

getLocation in interface Locatable

getPreloadedImageReference

public String getPreloadedImageReference(String URL)

Description copied from interface: PageRenderSupport

Sets up the given URL to preload, and returns a reference to the loaded image, in the form of a snippet of JavaScript expression that can be inserted into some larger block of JavaScript as a function parameter, or as a property assignment. A typical return value might be tapestry_preload[7].src.

Specified by:

getPreloadedImageReference in interface PageRenderSupport

getPreloadedImageReference

public String getPreloadedImageReference(IComponent target,
                                         String URL)

Description copied from interface: PageRenderSupport

Sets up the given URL to preload, and returns a reference to the loaded image, in the form of a snippet of JavaScript expression that can be inserted into some larger block of JavaScript as a function parameter, or as a property assignment. A typical return value might be tapestry_preload[7].src.

Specified by:

getPreloadedImageReference in interface PageRenderSupport

Parameters:

target - The component url being loaded for

URL - The asset URL to preload

addBodyScript

public void addBodyScript(String script)

Description copied from interface: IScriptProcessor

Adds scripting code to the main body. During the render, multiple scripts may render multiple bodies; all are concatinated together to form a single block. The Body component will write the body script contents just inside the <body> tag.

Specified by:

addBodyScript in interface IScriptProcessor

See Also:

#addBodyScript(IComponent, String)}

addBodyScript

public void addBodyScript(IComponent target,
                          String script)

Description copied from interface: IScriptProcessor

Adds scripting code to the main body. During the render, multiple scripts may render multiple bodies; all are concatinated together to form a single block. The Body component will write the body script contents just inside the <body> tag.

Specified by:

addBodyScript in interface IScriptProcessor

Parameters:

target - The component this script is being added for.

script - The script to add to the body response.

addInitializationScript

public void addInitializationScript(String script)

Description copied from interface: IScriptProcessor

Adds initialization script. Initialization script is executed once, when the containing page loads. Initialization script content is written only after all HTML content that could be referenced from the script (in effect, just before the </body> tag).

Specified by:

addInitializationScript in interface IScriptProcessor

See Also:

#addInitializationScript(IComponent, String)}

addInitializationScript

public void addInitializationScript(IComponent target,
                                    String script)

Description copied from interface: IScriptProcessor

Adds initialization script. Initialization script is executed once, when the containing page loads. Initialization script content is written only after all HTML content that could be referenced from the script (in effect, just before the </body> tag).

Specified by:

addInitializationScript in interface IScriptProcessor

Parameters:

target - The component the script is being added for.

script - The script to add.

addExternalScript

public void addExternalScript(Resource scriptLocation)

Description copied from interface: IScriptProcessor

Adds an external script. The processor is expected to ensure that external scripts are only loaded a single time per page.

Specified by:

addExternalScript in interface IScriptProcessor

See Also:

#addExternalScript(IComponent, Resource)}

addExternalScript

public void addExternalScript(IComponent target,
                              Resource scriptLocation)

Description copied from interface: IScriptProcessor

Adds an external script. The processor is expected to ensure that external scripts are only loaded a single time per page. The target will be checked to filter the scripts added for those types of responses that require them.

Specified by:

addExternalScript in interface IScriptProcessor

Parameters:

target - The component the script is being added for.

scriptLocation - The external script to add.

getUniqueString

public String getUniqueString(String baseValue)

Description copied from interface: IScriptProcessor

Ensures that the given string is unique. The string is either returned unchanged, or a suffix is appended to ensure uniqueness.

Specified by:

getUniqueString in interface IScriptProcessor

writeBodyScript

public void writeBodyScript(IMarkupWriter writer,
                            IRequestCycle cycle)

Writes a single large JavaScript block containing:

• Any image initializations (via getPreloadedImageReference(IComponent, String)).
• Any included scripts (via addExternalScript(Resource)).
• Any contributions (via addBodyScript(String)).

See Also:

writeInitializationScript(IMarkupWriter)

writeInitializationScript

public void writeInitializationScript(IMarkupWriter writer)

Writes any image initializations; this should be invoked at the end of the render, after all the related HTML will have already been streamed to the client and parsed by the web browser. Earlier versions of Tapestry uses a window.onload event handler.