Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

nextapp.echoservlet
Class HtmlDocument

java.lang.Object
  extended by nextapp.echoservlet.HtmlDocument
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
FCDocument
public class HtmlDocument
extends java.lang.Object
implements java.io.Serializable

A representation of an HTML document. This class functions as the root node for the tree of HTMLElements that make up a renderable document.

See Also:
Serialized Form

Field Summary
protected  java.util.Set cssIncludes
           
static int EVENT_INITIALIZE
          A script event type for "initialization" tasks.
static int EVENT_ONLOAD
          A script event type for "onload" tasks.
static int EVENT_ONUNLOAD
          A script event type for "onunload" tasks.
static StaticText SERVICE_INIT_FRAME_SCRIPT
           
 
Constructor Summary
protected HtmlDocument(Connection conn, Element body)
          Creates a new instance rendered through the specified connection and containing body as its root content element.
 
Method Summary
 void addCssInclude(java.lang.String href)
          Adds a referenced css include.
 void addScript(java.lang.String script)
          Adds a line of JavaScript that will be invoked as the document is rendered.
 void addScript(java.lang.String script, int eventType)
          Adds a line of JavaScript that will be invoked when an event occurs.
 void addScriptInclude(Service service)
          Adds a referenced JavaScript include.
 java.lang.String addStyle(ComponentStyle componentStyle)
          Adds a component style to the document.
static HtmlDocument create(Connection conn)
          Creates a normal document (not a frameset).
static HtmlDocument createFrameSet(Connection conn)
          Creates a frameset document.
 Element getBodyElement()
          Returns the "body" element of the document.
 Element getHeadElement()
          Returns the <head> element of the document.
 boolean isCursorOnNewLine()
          Returns the if the browser's "rendering cursor" is at the beginning of a new line.
 void render(java.io.PrintWriter pw)
          Renders the entire document to the specified PrintWriter.
 void renderFastComponentUpdate(java.io.PrintWriter pw, Connection conn, FCRenderer updateManager, InstancePeer instancePeer)
           
 void setCursorOnNewLine(boolean cursorOnNewLine)
          Sets whether the browser's rendering cursor is on a new line.
 void setScrollBarPositions(int x, int y)
          Sets the intial scroll bar positions of the document.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EVENT_INITIALIZE

public static final int EVENT_INITIALIZE
A script event type for "initialization" tasks. This constant is a suitable value for the eventName parameter of the addScript method. A script added with this event type will be executed once its document's frame's parents have executed their initialization scripts.

See Also:
Constant Field Values

EVENT_ONLOAD

public static final int EVENT_ONLOAD
A script event type for "onload" tasks. This constant is a suitable value for the eventName parameter of the addScript method. A script added with this event type will be executed once its document's frame's child frames have executed their onload scripts.

See Also:
Constant Field Values

EVENT_ONUNLOAD

public static final int EVENT_ONUNLOAD
A script event type for "onunload" tasks. This constant is a suitable value for the evetName parameter of the addScript method. A script added with this event type will be executed when a document is removed from service, such as in the event that its content is changed or its window is closed or reloaded.

See Also:
Constant Field Values

SERVICE_INIT_FRAME_SCRIPT

public static final StaticText SERVICE_INIT_FRAME_SCRIPT

cssIncludes

protected java.util.Set cssIncludes
Constructor Detail

HtmlDocument

protected HtmlDocument(Connection conn,
                       Element body)
Creates a new instance rendered through the specified connection and containing body as its root content element.

Parameters:
conn - The connection for which this document is being put into service.
body - The element that will be used as the root content element of this document (a <body> or <frame> element).
Method Detail

create

public static HtmlDocument create(Connection conn)
Creates a normal document (not a frameset).

Parameters:
conn - The connection to which the document will be rendered.
Returns:
An HTML document that whose body is a <body> tag.

createFrameSet

public static HtmlDocument createFrameSet(Connection conn)
Creates a frameset document.

Parameters:
conn - The connection to which the document will be rendered.
Returns:
An HTML document that whose body is a <frameset> tag.

addScript

public void addScript(java.lang.String script)
Adds a line of JavaScript that will be invoked as the document is rendered. Such scripts may invoked before all resources are available, and thus most script calls should be added using the addScript(script, eventName) method. This method is only useful for adding global script variables to the document body.

Parameters:
script - A line of JavaScript code.

addScript

public void addScript(java.lang.String script,
                      int eventType)
Adds a line of JavaScript that will be invoked when an event occurs. These lines of JavaScript will be executed in the order that they were added.

Parameters:
script - A line of JavaScript code.
eventType - The name of the event, one of the following values:
  • EVENT_INITIALIZE execute the script when all frames have loaded.
  • EVENT_ONLOAD execute the script when all child frames have loaded.
  • EVENT_ONUNLOAD execute the script when the frame unloads.

addScriptInclude

public void addScriptInclude(Service service)
Adds a referenced JavaScript include.

Parameters:
service - The service that renders the JavaScript include.

addCssInclude

public void addCssInclude(java.lang.String href)
Adds a referenced css include.

Parameters:
href - of the css file

addStyle

public java.lang.String addStyle(ComponentStyle componentStyle)
Adds a component style to the document. Returns the name of the style in the document.

Parameters:
componentStyle - The component style to add to the document.
Returns:
The document-specific name of the style. The document-specific name of the style is not necessarily identical to the style's name. The name of the style provided here must be used in all element "class" attributes that use the style to guarantee proper rendering.

getBodyElement

public Element getBodyElement()
Returns the "body" element of the document. This will either be a <body> element in the case of a content-holding document or a <frameset> element in the case of a frameset document.

Returns:
The "body" tag of the document.

getHeadElement

public Element getHeadElement()
Returns the <head> element of the document.

Returns:
The <head> element of the document.

isCursorOnNewLine

public boolean isCursorOnNewLine()
Returns the if the browser's "rendering cursor" is at the beginning of a new line. This is used to inform a component that is being rendered whether the last component will automatically move the browser's rendering cursor to the start of a new line, as is the case after a <br> or closing </table> tag is encountered.

Returns:
True if the cursor is on a new line.

render

public void render(java.io.PrintWriter pw)
Renders the entire document to the specified PrintWriter.

Parameters:
pw - A PrintWriter to render the document to.

renderFastComponentUpdate

public void renderFastComponentUpdate(java.io.PrintWriter pw,
                                      Connection conn,
                                      FCRenderer updateManager,
                                      InstancePeer instancePeer)

setCursorOnNewLine

public void setCursorOnNewLine(boolean cursorOnNewLine)
Sets whether the browser's rendering cursor is on a new line.

Parameters:
cursorOnNewLine - True if the browser's rendering cursor is on a new line.
See Also:
isCursorOnNewLine()

setScrollBarPositions

public void setScrollBarPositions(int x,
                                  int y)
Sets the intial scroll bar positions of the document.

Parameters:
x - The initial horizontal scroll bar position (0 is the default).
y - The initial vertical scroll bar position (0 is the default).
Overview  Package   Class  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD