org.codehaus.cargo.module.webapp
Class WebXmlIo

java.lang.Object
  org.codehaus.cargo.module.AbstractDescriptorIo
      org.codehaus.cargo.module.webapp.WebXmlIo

All Implemented Interfaces:

DescriptorIo

public final class WebXmlIo
extends AbstractDescriptorIo

Provides convenience methods for reading and writing web deployment descriptors.

Version:

$Id: WebXmlIo.java 1705 2008-09-02 13:14:55Z adriana $

Constructor Summary

WebXmlIo(DescriptorType type)
Constructor.

Method Summary

protected org.xml.sax.EntityResolver	getEntityResolver() Get the default entity resolver for this type.
static WebXml	newWebXml(WebXmlVersion theVersion) Creates a new empty deployment descriptor.
static WebXml	parseWebXml(java.io.InputStream theInput, org.xml.sax.EntityResolver theEntityResolver) Parses a deployment descriptor provided as input stream.
static WebXml	parseWebXmlFromFile(java.io.File theFile, org.xml.sax.EntityResolver theEntityResolver) Parses a deployment descriptor stored in a regular file.

Methods inherited from class org.codehaus.cargo.module.AbstractDescriptorIo

createDocumentBuilder, createDocumentBuilder, parseXml, parseXml, writeAll, writeDescriptor, writeDescriptor, writeDescriptor, writeDescriptor

Methods inherited from class java.lang.Object

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

Constructor Detail

WebXmlIo

public WebXmlIo(DescriptorType type)

Constructor.

Parameters:

type - descriptor type

Method Detail

getEntityResolver

protected org.xml.sax.EntityResolver getEntityResolver()

Description copied from class: AbstractDescriptorIo

Get the default entity resolver for this type.

Overrides:

getEntityResolver in class AbstractDescriptorIo

Returns:

the configured entity resolver

newWebXml

public static WebXml newWebXml(WebXmlVersion theVersion)

Creates a new empty deployment descriptor.

Parameters:

theVersion - The version of the descriptor to create

Returns:

The new descriptor

parseWebXmlFromFile

public static WebXml parseWebXmlFromFile(java.io.File theFile,
                                         org.xml.sax.EntityResolver theEntityResolver)
                                  throws java.io.IOException,
                                         org.jdom.JDOMException

Parses a deployment descriptor stored in a regular file.

Parameters:

theFile - The file to parse

theEntityResolver - A SAX entity resolver, or null to use the default

Returns:

The parsed descriptor

Throws:

org.jdom.JDOMException - If the file could not be parsed

java.io.IOException - If an I/O error occurs

parseWebXml

public static WebXml parseWebXml(java.io.InputStream theInput,
                                 org.xml.sax.EntityResolver theEntityResolver)
                          throws java.io.IOException,
                                 org.jdom.JDOMException

Parses a deployment descriptor provided as input stream.

Parameters:

theInput - The input stream

theEntityResolver - A SAX entity resolver, or null to use the default

Returns:

The parsed descriptor

Throws:

java.io.IOException - If an I/O error occurs

org.jdom.JDOMException - If the input could not be parsed