com.esri.adf.web.faces.renderkit.xml.ajax
Class AJAXUtil

java.lang.Object
  com.esri.adf.web.faces.renderkit.xml.ajax.AJAXUtil

public class AJAXUtil
extends java.lang.Object

Utility class.

Constructor Summary

AJAXUtil()

Method Summary

static org.w3c.dom.Element	appendViewState(javax.faces.context.FacesContext facesContext, org.w3c.dom.Document doc, org.w3c.dom.Element parent) Gets the current serialized view ID and add to the document as a element.
static org.w3c.dom.Document	createErrorResponse(java.lang.String message) Renders an XML document with a root error tag.
static java.lang.String	serializeView(javax.faces.context.FacesContext facesContext) Serializes the view of the faces context in server side.
static void	writeResponse(javax.faces.context.FacesContext facesContext, org.w3c.dom.Document doc) This method is the preferred way to render AJAX XML responses to be returned to the client.
static void	writeResponse(javax.faces.context.FacesContext facesContext, org.w3c.dom.Document doc, java.util.Properties outputFormat) This method is the preferred way to render AJAX XML responses to be returned to the client.

Methods inherited from class java.lang.Object

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

Constructor Detail

AJAXUtil

public AJAXUtil()

Method Detail

writeResponse

public static void writeResponse(javax.faces.context.FacesContext facesContext,
                                 org.w3c.dom.Document doc)
                          throws java.io.IOException

This method is the preferred way to render AJAX XML responses to be returned to the client.

   Document doc = XMLUtil.newDocument();
   ... add content to xml document ...
   AJAXUtil.writeResponse(facesContext, doc);
   facesContext.responseComplete();
 

This method gets the current response object from the external context, writes the response and then closes the response writer.

Parameters:

facesContext - Current FacesContext instance

doc - XML Document with content to be returned to client

Throws:

java.io.IOException

writeResponse

public static void writeResponse(javax.faces.context.FacesContext facesContext,
                                 org.w3c.dom.Document doc,
                                 java.util.Properties outputFormat)
                          throws java.io.IOException

This method is the preferred way to render AJAX XML responses to be returned to the client.

   Document doc = XMLUtil.newDocument();
   ... add content to xml document ...
   AJAXUtil.writeResponse(facesContext, doc);
   facesContext.responseComplete();
 

This method gets the current response object from the external context, writes the response and then closes the response writer.

Parameters:

facesContext - Current FacesContext instance

doc - XML Document with content to be returned to client

outputFormat - the output properties that used for transformation

Throws:

java.io.IOException

See Also:

Transformer.setOutputProperties(Properties)

createErrorResponse

public static org.w3c.dom.Document createErrorResponse(java.lang.String message)

Renders an XML document with a root error tag.


Some error message to display


Parameters:

message - to be rendered within tag

serializeView

public static java.lang.String serializeView(javax.faces.context.FacesContext facesContext)
                                      throws java.lang.Exception

Serializes the view of the faces context in server side.

Parameters:

facesContext -

Returns:

the state structure.

Throws:

java.lang.Exception

appendViewState

public static org.w3c.dom.Element appendViewState(javax.faces.context.FacesContext facesContext,
                                                  org.w3c.dom.Document doc,
                                                  org.w3c.dom.Element parent)

Gets the current serialized view ID and add to the document as a element.

Parameters:

facesContext - the current faces-context

doc - the doc to add the element

parent - the new "com.sun.faces.VIEW" will be appended to the given parent element.

Returns:

the "com.sun.faces.VIEW" element.