Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.apache.tapestry.components
Class RenderBlock  view RenderBlock download RenderBlock.java

java.lang.Object
  extended byorg.apache.hivemind.impl.BaseLocatable
      extended byorg.apache.tapestry.AbstractComponent
          extended byorg.apache.tapestry.components.RenderBlock
All Implemented Interfaces:
org.apache.tapestry.IComponent, org.apache.tapestry.IRender, org.apache.hivemind.Locatable, org.apache.hivemind.LocationHolder

public abstract class RenderBlock
extends org.apache.tapestry.AbstractComponent

Renders the text and components wrapped by a Block component. [Component Reference]

It is possible for an RenderBlock to obtain a Block from a page other than the render page. This works, even when the Block contains links, forms and form components. The action and direct services will create URLs that properly address this situation.

However, because the rendering page can't know ahead of time about these foriegn Blocks, org.apache.tapestry.event.PageRenderListener methods (for components and objects of the foriegn page) via RenderBlock will not be executed. This specifically affects the methods of the org.apache.tapestry.event.PageRenderListener interface.

Before rendering its Block, RenderBlock will set itself as the Block's inserter, and will reset the inserter after the Block is rendered. This gives the components contained in the Block access to its inserted environment via the RenderBlock. In particular this allows the contained components to access the informal parameters of the RenderBlock which effectively allows parameters to be passed to the components contained in a Block.


Field Summary
static com.cortexeb.tools.clover.d __CLOVER_69_0
           
 
Fields inherited from class org.apache.tapestry.AbstractComponent
__CLOVER_0_0
 
Fields inherited from class org.apache.hivemind.impl.BaseLocatable
 
Constructor Summary
RenderBlock()
           
 
Method Summary
abstract  Block getBlock()
           
protected  void renderComponent(org.apache.tapestry.IMarkupWriter writer, org.apache.tapestry.IRequestCycle cycle)
          If block is not null, then the block's inserter is set (to this), IComponent.renderBody(IMarkupWriter, IRequestCycle)>IComponent.renderBody(IMarkupWriter, IRequestCycle) 55 is invoked on it, and the Block's inserter is set back to its previous state.
 
Methods inherited from class org.apache.tapestry.AbstractComponent
addAsset, addBody, addComponent, cleanupAfterRender, finishLoad, finishLoad, format, format, format, format, formatString, formatString, formatString, formatString, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getChangeObserver, getComponent, getComponents, getContainer, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, getString, pageEndRender, prepareForRender, render, renderBody, renderInformalParameters, setBinding, setContainer, setId, setNamespace, setPage, setProperty, setSpecification, toString
 
Methods inherited from class org.apache.hivemind.impl.BaseLocatable
getLocation, setLocation
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.apache.hivemind.LocationHolder
setLocation
 
Methods inherited from interface org.apache.hivemind.Locatable
getLocation
 

Field Detail

__CLOVER_69_0

public static com.cortexeb.tools.clover.d __CLOVER_69_0
Constructor Detail

RenderBlock

public RenderBlock()
Method Detail

renderComponent

protected void renderComponent(org.apache.tapestry.IMarkupWriter writer,
                               org.apache.tapestry.IRequestCycle cycle)
If block is not null, then the block's inserter is set (to this), IComponent.renderBody(IMarkupWriter, IRequestCycle)>IComponent.renderBody(IMarkupWriter, IRequestCycle) 55 is invoked on it, and the Block's inserter is set back to its previous state.


getBlock

public abstract Block getBlock()