org.apache.batik.bridge
Class BridgeContext

java.lang.Object
  |
  +--org.apache.batik.bridge.BridgeContext
All Implemented Interfaces:
ErrorConstants

public class BridgeContext
extends java.lang.Object
implements ErrorConstants

This class represents a context used by the various bridges and the builder. A bridge context is associated to a particular document and cannot be reused. The context encapsulates the dynamic bindings between DOM elements and GVT nodes, graphic contexts such as a GraphicsNodeRenderContext, and the different objects required by the GVT builder to interpret a SVG DOM tree such as the current viewport or the user agent.


Field Summary
protected  DocumentLoader documentLoader
          The document loader used to load/create Document.
protected  java.awt.geom.Dimension2D documentSize
          The size of the document.
protected  java.util.HashMap elementNodeMap
          Binding Map: key is an SVG Element - value is a GraphicsNode
protected  java.util.HashMap elementStyleAttMap
          Binding Map: key is style Element - value is a list of styleReference
protected  GVTBuilder gvtBuilder
          The GVT builder that might be used to create a GVT subtree.
protected  InterpreterPool interpreterPool
          The interpreter pool used to handle scripts.
protected  java.util.HashMap namespaceURIMap
          Bridge Map: Keys are namespace URI - values are HashMap (with keys are local name and values are a Bridge instance).
protected  java.util.HashMap nodeElementMap
          Binding Map: key is GraphicsNode - value is a SVG Element.
protected  java.util.HashMap nodeStyleMap
          Binding Map: key is GraphicsNode - value is list of StyleElement.
protected  TextPainter textPainter
          The text painter to use.
protected  UserAgent userAgent
          The user agent.
protected  java.util.Map viewportMap
          The viewports. key is an Element - value is a Viewport
protected  java.util.List viewportStack
          The viewport stack.
 
Fields inherited from interface org.apache.batik.bridge.ErrorConstants
ERR_ATTRIBUTE_MISSING, ERR_ATTRIBUTE_VALUE_MALFORMED, ERR_CSS_LENGTH_NEGATIVE, ERR_CSS_URI_BAD_TARGET, ERR_LENGTH_NEGATIVE, ERR_URI_BAD_TARGET, ERR_URI_IMAGE_INVALID, ERR_URI_IO, ERR_URI_MALFORMED, ERR_URI_REFERENCE_A_DOCUMENT, ERR_XLINK_HREF_CIRCULAR_DEPENDENCIES, MSG_BROKEN_LINK_TITLE
 
Constructor Summary
protected BridgeContext()
          Constructs a new empty bridge context.
  BridgeContext(UserAgent userAgent)
          Constructs a new bridge context.
  BridgeContext(UserAgent userAgent, DocumentLoader loader)
          Constructs a new bridge context.
  BridgeContext(UserAgent userAgent, InterpreterPool interpreterPool, DocumentLoader documentLoader)
          Constructs a new bridge context.
 
Method Summary
 void bind(Element element, GraphicsNode node)
          Binds the specified GraphicsNode to the specified Element.
 void bind(Element element, StyleReference reference)
          Binds a style element to a style reference.
 void closeViewport(Element e)
          Closes the viewport associated to the specified element.
 Bridge getBridge(Element element)
          Returns the bridge associated with the specified element.
 Bridge getBridge(java.lang.String namespaceURI, java.lang.String localName)
          Returns the bridge associated with the element type
static java.util.List getBridgeExtensions()
           
 DocumentLoader getDocumentLoader()
          Returns the document loader used to load external documents.
 java.awt.geom.Dimension2D getDocumentSize()
          Returns the actual size of the document or null if the document has not been built yet.
 Element getElement(GraphicsNode node)
          Returns the Element associated to the specified GraphicsNode or null if any.
 GraphicsNode getGraphicsNode(Element element)
          Returns the GraphicsNode associated to the specified Element or null if any.
 GVTBuilder getGVTBuilder()
          Returns the GVT builder that is currently used to build the GVT tree.
 InterpreterPool getInterpreterPool()
          Returns the interpreter pool used to handle scripts.
 Element getReferencedElement(Element e, java.lang.String uri)
          Returns the element referenced by the specified element by the specified uri.
 java.util.List getStyleReferenceList(Element element)
          Returns an enumeration of all style refence for the specified style element.
 TextPainter getTextPainter()
          Returns the text painter that will be used be text nodes.
 UserAgent getUserAgent()
          Returns the user agent of this bridge context.
 Viewport getViewport(Element e)
          Returns the viewport of the specified element.
 boolean isDynamic()
          Returns true if the bridge should support dynamic SVG content, false otherwise.
 void openViewport(Element e, Viewport viewport)
          Starts a new viewport from the specified element.
 void putBridge(Bridge bridge)
          Associates the specified Bridge object with it's namespace URI and local name.
 void putBridge(java.lang.String namespaceURI, java.lang.String localName, Bridge bridge)
          Associates the specified Bridge object with the specified namespace URI and local name.
static void registerSVGBridges(BridgeContext ctx)
          Registers the bridges to handle SVG 1.0 elements.
 void removeBridge(java.lang.String namespaceURI, java.lang.String localName)
          Removes the Bridge object associated to the specified namespace URI and local name.
protected  void setDocumentLoader(DocumentLoader newDocumentLoader)
          Sets the document loader used to load external documents.
protected  void setDocumentSize(java.awt.geom.Dimension2D d)
          Sets the size of the document to the specified dimension.
protected  void setGVTBuilder(GVTBuilder gvtBuilder)
          Sets the GVT builder that uses this context.
protected  void setInterpreterPool(InterpreterPool interpreterPool)
          Sets the interpreter pool used to handle scripts to the specified interpreter pool.
 void setTextPainter(TextPainter textPainter)
          Sets the text painter that will be used by text nodes.
protected  void setUserAgent(UserAgent userAgent)
          Sets the user agent to the specified user agent.
 void unbind(Element element)
          Removes the binding of the specified Element.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

gvtBuilder

protected GVTBuilder gvtBuilder
The GVT builder that might be used to create a GVT subtree.

viewportMap

protected java.util.Map viewportMap
The viewports. key is an Element - value is a Viewport

viewportStack

protected java.util.List viewportStack
The viewport stack. Used in building time.

userAgent

protected UserAgent userAgent
The user agent.

elementNodeMap

protected java.util.HashMap elementNodeMap
Binding Map: key is an SVG Element - value is a GraphicsNode

nodeElementMap

protected java.util.HashMap nodeElementMap
Binding Map: key is GraphicsNode - value is a SVG Element.

elementStyleAttMap

protected java.util.HashMap elementStyleAttMap
Binding Map: key is style Element - value is a list of styleReference

nodeStyleMap

protected java.util.HashMap nodeStyleMap
Binding Map: key is GraphicsNode - value is list of StyleElement.

namespaceURIMap

protected java.util.HashMap namespaceURIMap
Bridge Map: Keys are namespace URI - values are HashMap (with keys are local name and values are a Bridge instance).

interpreterPool

protected InterpreterPool interpreterPool
The interpreter pool used to handle scripts.

documentLoader

protected DocumentLoader documentLoader
The document loader used to load/create Document.

documentSize

protected java.awt.geom.Dimension2D documentSize
The size of the document.

textPainter

protected TextPainter textPainter
The text painter to use. Typically, you can specify the text painter that will be used be text nodes.
Constructor Detail

BridgeContext

protected BridgeContext()
Constructs a new empty bridge context.

BridgeContext

public BridgeContext(UserAgent userAgent)
Constructs a new bridge context.
Parameters:
userAgent - the user agent

BridgeContext

public BridgeContext(UserAgent userAgent,
                     DocumentLoader loader)
Constructs a new bridge context.
Parameters:
userAgent - the user agent
documentLoader - document loader

BridgeContext

public BridgeContext(UserAgent userAgent,
                     InterpreterPool interpreterPool,
                     DocumentLoader documentLoader)
Constructs a new bridge context.
Parameters:
userAgent - the user agent
interpreterPool - the interpreter pool
documentLoader - document loader
Method Detail

setTextPainter

public void setTextPainter(TextPainter textPainter)
Sets the text painter that will be used by text nodes. This attributes might be used by bridges (especially SVGTextElementBridge) to set the text painter of each TextNode.
Parameters:
textPainter - the text painter for text nodes

getTextPainter

public TextPainter getTextPainter()
Returns the text painter that will be used be text nodes.

getUserAgent

public UserAgent getUserAgent()
Returns the user agent of this bridge context.

setUserAgent

protected void setUserAgent(UserAgent userAgent)
Sets the user agent to the specified user agent.
Parameters:
userAgent - the user agent

setGVTBuilder

protected void setGVTBuilder(GVTBuilder gvtBuilder)
Sets the GVT builder that uses this context.

getGVTBuilder

public GVTBuilder getGVTBuilder()
Returns the GVT builder that is currently used to build the GVT tree.

getInterpreterPool

public InterpreterPool getInterpreterPool()
Returns the interpreter pool used to handle scripts.

setInterpreterPool

protected void setInterpreterPool(InterpreterPool interpreterPool)
Sets the interpreter pool used to handle scripts to the specified interpreter pool.
Parameters:
interpreterPool - the interpreter pool

getDocumentLoader

public DocumentLoader getDocumentLoader()
Returns the document loader used to load external documents.

setDocumentLoader

protected void setDocumentLoader(DocumentLoader newDocumentLoader)
Sets the document loader used to load external documents.
Parameters:
newDocumentLoader - the new document loader

getReferencedElement

public Element getReferencedElement(Element e,
                                    java.lang.String uri)
Returns the element referenced by the specified element by the specified uri. The referenced element can not be a Document.
Parameters:
e - the element referencing
uri - the uri of the referenced element

getDocumentSize

public java.awt.geom.Dimension2D getDocumentSize()
Returns the actual size of the document or null if the document has not been built yet.

setDocumentSize

protected void setDocumentSize(java.awt.geom.Dimension2D d)
Sets the size of the document to the specified dimension.
Parameters:
d - the actual size of the SVG document

getViewport

public Viewport getViewport(Element e)
Returns the viewport of the specified element.
Parameters:
e - the element interested in its viewport

openViewport

public void openViewport(Element e,
                         Viewport viewport)
Starts a new viewport from the specified element.
Parameters:
e - the element that starts the viewport
viewport - the viewport of the element

closeViewport

public void closeViewport(Element e)
Closes the viewport associated to the specified element.
Parameters:
e - the element that closes its viewport

isDynamic

public boolean isDynamic()
Returns true if the bridge should support dynamic SVG content, false otherwise.

bind

public void bind(Element element,
                 GraphicsNode node)
Binds the specified GraphicsNode to the specified Element. This method automatically bind the graphics node to the element and the element to the graphics node.
Parameters:
element - the element to bind to the specified graphics node
node - the graphics node to bind to the specified element

unbind

public void unbind(Element element)
Removes the binding of the specified Element. This method unbinds the specified element to its associated graphics node, remove the binding from the graphics node to the specified element, and all the style references associated to the specified element are also removed.
Parameters:
element - the element to unbind

getGraphicsNode

public GraphicsNode getGraphicsNode(Element element)
Returns the GraphicsNode associated to the specified Element or null if any.
Parameters:
element - the element associated to the graphics node to return

getElement

public Element getElement(GraphicsNode node)
Returns the Element associated to the specified GraphicsNode or null if any.
Parameters:
node - the graphics node associated to the element to return

bind

public void bind(Element element,
                 StyleReference reference)
Binds a style element to a style reference. Several style reference can be bound to the same style element.
Parameters:
element - the element
reference - the style reference

getStyleReferenceList

public java.util.List getStyleReferenceList(Element element)
Returns an enumeration of all style refence for the specified style element.
Parameters:
element - the element

getBridge

public Bridge getBridge(Element element)
Returns the bridge associated with the specified element.
Parameters:
element - the element

getBridge

public Bridge getBridge(java.lang.String namespaceURI,
                        java.lang.String localName)
Returns the bridge associated with the element type
Parameters:
nameSpaceURI - namespace of the requested element
localName - element's local name

putBridge

public void putBridge(java.lang.String namespaceURI,
                      java.lang.String localName,
                      Bridge bridge)
Associates the specified Bridge object with the specified namespace URI and local name.
Parameters:
namespaceURI - the namespace URI
localName - the local name
bridge - the bridge that manages the element

putBridge

public void putBridge(Bridge bridge)
Associates the specified Bridge object with it's namespace URI and local name.
Parameters:
bridge - the bridge that manages the element

removeBridge

public void removeBridge(java.lang.String namespaceURI,
                         java.lang.String localName)
Removes the Bridge object associated to the specified namespace URI and local name.
Parameters:
namespaceURI - the namespace URI
localName - the local name

registerSVGBridges

public static void registerSVGBridges(BridgeContext ctx)
Registers the bridges to handle SVG 1.0 elements.
Parameters:
ctx - the bridge context to initialize

getBridgeExtensions

public static java.util.List getBridgeExtensions()


Copyright © 2001 Apache Software Foundation. All Rights Reserved.