Package org.apache.maven.shared.utils

Class WriterFactory

java.lang.Object

org.apache.maven.shared.utils.WriterFactory

public class WriterFactory
extends Object

Utility to create Writers, with explicit encoding choice: platform default, XML, or specified.

Author:

Hervé Boutemy

See Also:

• Charset
• Supported encodings

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FILE_ENCODING	The file.encoding System Property.
static final String	ISO_8859_1	Deprecated. use java.nio.charset.StandardCharset.ISO_8859_1
static final String	US_ASCII	Deprecated. use java.nio.charset.StandardCharset.US_ASCII
static final String	UTF_16	Deprecated. use java.nio.charset.StandardCharset.UTF_16
static final String	UTF_16BE	Deprecated. use java.nio.charset.StandardCharset.UTF_16BE
static final String	UTF_16LE	Deprecated. use java.nio.charset.StandardCharset.UTF_16LE
static final String	UTF_8	Deprecated. use java.nio.charset.StandardCharset.UTF_8

Constructor Summary

Constructors

Constructor	Description
WriterFactory()

Method Summary

Modifier and Type	Method	Description
static Writer	newPlatformWriter(File file)	Deprecated. always specify an encoding.
static Writer	newPlatformWriter(OutputStream out)	Deprecated. always specify an encoding.
static Writer	newWriter(File file, String encoding)	Create a new Writer with specified encoding.
static Writer	newWriter(OutputStream out, String encoding)	Create a new Writer with specified encoding.
static XmlStreamWriter	newXmlWriter(File file)	Deprecated. use org.apache.commons.io.input.XmlStreamWriter instead
static XmlStreamWriter	newXmlWriter(OutputStream out)	Deprecated. use org.apache.commons.io.input.XmlStreamWriter instead

Methods inherited from class java.lang.Object

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

Field Details

ISO_8859_1

@Deprecated
public static final String ISO_8859_1

Deprecated.

use java.nio.charset.StandardCharset.ISO_8859_1

ISO Latin Alphabet #1, also known as ISO-LATIN-1. Every implementation of the Java platform is required to support this character encoding.

See Also:

• Constant Field Values

US_ASCII

@Deprecated
public static final String US_ASCII

Deprecated.

use java.nio.charset.StandardCharset.US_ASCII

Seven-bit ASCII, also known as ISO646-US, also known as the Basic Latin block of the Unicode character set. Every implementation of the Java platform is required to support this character encoding.

See Also:

• Constant Field Values

UTF_16

@Deprecated
public static final String UTF_16

Deprecated.

use java.nio.charset.StandardCharset.UTF_16

Sixteen-bit Unicode Transformation Format, byte order specified by a mandatory initial byte-order mark (either order accepted on input, big-endian used on output). Every implementation of the Java platform is required to support this character encoding.

See Also:

• Constant Field Values

UTF_16BE

@Deprecated
public static final String UTF_16BE

Deprecated.

use java.nio.charset.StandardCharset.UTF_16BE

Sixteen-bit Unicode Transformation Format, big-endian byte order. Every implementation of the Java platform is required to support this character encoding.

See Also:

• Constant Field Values

UTF_16LE

@Deprecated
public static final String UTF_16LE

Deprecated.

use java.nio.charset.StandardCharset.UTF_16LE

Sixteen-bit Unicode Transformation Format, little-endian byte order. Every implementation of the Java platform is required to support this character encoding.

See Also:

• Constant Field Values

UTF_8

@Deprecated
public static final String UTF_8

Deprecated.

use java.nio.charset.StandardCharset.UTF_8

Eight-bit Unicode Transformation Format. Every implementation of the Java platform is required to support this character encoding.

See Also:

• Constant Field Values

FILE_ENCODING

public static final String FILE_ENCODING

The file.encoding System Property.

Constructor Details

WriterFactory

public WriterFactory()

Method Details

newXmlWriter

@Deprecated
public static XmlStreamWriter newXmlWriter(@Nonnull
 OutputStream out)
                                    throws IOException

Deprecated.

use org.apache.commons.io.input.XmlStreamWriter instead

Create a new Writer with XML encoding detection rules.

Parameters:

out - not null output stream

Returns:

an XML writer instance for the output stream

Throws:

IOException - if any

See Also:

• XmlStreamWriter

newXmlWriter

@Deprecated
public static XmlStreamWriter newXmlWriter(@Nonnull
 File file)
                                    throws IOException

Deprecated.

use org.apache.commons.io.input.XmlStreamWriter instead

Create a new Writer with XML encoding detection rules.

Parameters:

file - not null file

Returns:

an XML writer instance for the output file

Throws:

IOException - if any

See Also:

• XmlStreamWriter

newPlatformWriter

@Deprecated
public static Writer newPlatformWriter(@Nonnull
 OutputStream out)

Deprecated.

always specify an encoding. Do not depend on the default platform character set.

Create a new Writer with default platform encoding.

Parameters:

out - not null output stream

Returns:

a writer instance for the output stream using the default platform charset

newPlatformWriter

@Deprecated
public static Writer newPlatformWriter(@Nonnull
 File file)
                                throws IOException

Deprecated.

always specify an encoding. Do not depend on the default platform character set.

Create a new Writer with default platform encoding.

Parameters:

file - not null file

Returns:

a writer instance for the output file using the default platform charset

Throws:

IOException - if any

newWriter

public static Writer newWriter(@Nonnull
 OutputStream out,
 @Nonnull
 String encoding)
                        throws UnsupportedEncodingException

Create a new Writer with specified encoding.

Parameters:

out - not null output stream

encoding - not null supported encoding

Returns:

a writer instance for the output stream using the given encoding

Throws:

UnsupportedEncodingException - if any

See Also:

• Supported encodings

newWriter

public static Writer newWriter(@Nonnull
 File file,
 @Nonnull
 String encoding)
                        throws UnsupportedEncodingException,
FileNotFoundException

Create a new Writer with specified encoding.

Parameters:

file - not null file

encoding - not null supported encoding

Returns:

a writer instance for the output file using the given encoding

Throws:

UnsupportedEncodingException - if any

FileNotFoundException - if any

See Also:

• Supported encodings