org.codehaus.cargo.module

Class AbstractDescriptorIo

java.lang.Object

org.codehaus.cargo.module.AbstractDescriptorIo

Direct Known Subclasses:

DocumentMerger, DocumentStreamAdapter, EjbJarXmlIo, IbmEjbJarBndXmiIo, IbmWebBndXmiIo, JBossWebXmlIo, OrionEjbJarXmlIo, OrionWebXmlIo, ResinWebXmlIo, TomcatContextXmlIo, WeblogicEjbJarXmlIo, WeblogicXmlIo, WebXmlIo

public abstract class AbstractDescriptorIo
extends Object

Provides convenience methods for reading and writing web deployment descriptors.

Version:

$Id: AbstractDescriptorIo.java 1160 2006-07-30 20:15:34Z vmassol $

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDescriptorIo() Utility class should not have a public or default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static DocumentBuilder	createDocumentBuilder()
static File[]	writeAll(J2eeDescriptor descriptor, String dir) Writes the WebXml and its associated vendor descriptors to the specified directory.
static void	writeDescriptor(Descriptor descriptor, File file) Writes the specified document to a file.
static void	writeDescriptor(Descriptor descriptor, File file, String encoding) Writes the specified document to a file.
static void	writeDescriptor(Descriptor descriptor, File file, String encoding, boolean isIndent) Writes the specified document to a file.
static void	writeDescriptor(Descriptor descriptor, OutputStream out, String encoding, boolean isIndent) Writes the specified document to an output stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDescriptorIo

protected AbstractDescriptorIo()

Utility class should not have a public or default constructor.

Method Detail

createDocumentBuilder

public static DocumentBuilder createDocumentBuilder()
                                             throws ParserConfigurationException

Returns:

a new non-validating, non-namespace-aware DocumentBuilder instance

Throws:

ParserConfigurationException - in case of error

writeDescriptor

public static void writeDescriptor(Descriptor descriptor,
                   File file)
                            throws IOException

Writes the specified document to a file.

Parameters:

descriptor - The descriptor to serialize

file - The file to write to

Throws:

IOException - If an I/O error occurs

writeDescriptor

public static void writeDescriptor(Descriptor descriptor,
                   File file,
                   String encoding)
                            throws IOException

Writes the specified document to a file.

Parameters:

descriptor - The descriptor to serialize

file - The file to write to

encoding - The character encoding to use

Throws:

IOException - If an I/O error occurs

writeDescriptor

public static void writeDescriptor(Descriptor descriptor,
                   File file,
                   String encoding,
                   boolean isIndent)
                            throws IOException

Writes the specified document to a file.

Parameters:

descriptor - The descriptor to serialize

file - The file to write to

encoding - The character encoding to use

isIndent - Whether the written XML should be indented

Throws:

IOException - If an I/O error occurs

writeDescriptor

public static void writeDescriptor(Descriptor descriptor,
                   OutputStream out,
                   String encoding,
                   boolean isIndent)
                            throws IOException

Writes the specified document to an output stream.

Parameters:

descriptor - The descriptor to serialize

out - The output stream to write to

encoding - The character encoding to use

isIndent - Whether the written XML should be indented

Throws:

IOException - If an I/O error occurs

writeAll

public static File[] writeAll(J2eeDescriptor descriptor,
              String dir)
                       throws IOException

Writes the WebXml and its associated vendor descriptors to the specified directory.

Parameters:

descriptor - The descriptor to serialize

dir - Directory to store the descriptors in

Returns:

Array of files for every created file

Throws:

IOException - if a I/O error occurs