Class WriterFactory


  • @Deprecated
    public class WriterFactory
    extends java.lang.Object
    Deprecated.
    This class has been deprecated. When writing XML, users can create the XmlStreamWriter instance directly. For other usages, using Files helper methods is recommended.
    Utility to create Writers, with explicit encoding choice: platform default, XML, or specified.
    Since:
    1.4.4
    Author:
    Herve Boutemy
    See Also:
    Charset, Supported encodings
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String FILE_ENCODING
      Deprecated.
      The file.encoding System Property.
      static java.lang.String ISO_8859_1
      Deprecated.
      ISO Latin Alphabet #1, also known as ISO-LATIN-1.
      static java.lang.String US_ASCII
      Deprecated.
      Seven-bit ASCII, also known as ISO646-US, also known as the Basic Latin block of the Unicode character set.
      static java.lang.String UTF_16
      Deprecated.
      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).
      static java.lang.String UTF_16BE
      Deprecated.
      Sixteen-bit Unicode Transformation Format, big-endian byte order.
      static java.lang.String UTF_16LE
      Deprecated.
      Sixteen-bit Unicode Transformation Format, little-endian byte order.
      static java.lang.String UTF_8
      Deprecated.
      Eight-bit Unicode Transformation Format.
    • Constructor Summary

      Constructors 
      Constructor Description
      WriterFactory()
      Deprecated.
       
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static java.io.Writer newPlatformWriter​(java.io.File file)
      Deprecated.
      Create a new Writer with default platform encoding.
      static java.io.Writer newPlatformWriter​(java.io.OutputStream out)
      Deprecated.
      Create a new Writer with default platform encoding.
      static java.io.Writer newWriter​(java.io.File file, java.lang.String encoding)
      Deprecated.
      Create a new Writer with specified encoding.
      static java.io.Writer newWriter​(java.io.OutputStream out, java.lang.String encoding)
      Deprecated.
      Create a new Writer with specified encoding.
      static org.codehaus.plexus.util.xml.XmlStreamWriter newXmlWriter​(java.io.File file)
      Deprecated.
      Create a new Writer with XML encoding detection rules.
      static org.codehaus.plexus.util.xml.XmlStreamWriter newXmlWriter​(java.io.OutputStream out)
      Deprecated.
      Create a new Writer with XML encoding detection rules.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • ISO_8859_1

        public static final java.lang.String ISO_8859_1
        Deprecated.
        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:
        Charset, Constant Field Values
      • US_ASCII

        public static final java.lang.String US_ASCII
        Deprecated.
        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:
        Charset, Constant Field Values
      • UTF_16

        public static final java.lang.String UTF_16
        Deprecated.
        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:
        Charset, Constant Field Values
      • UTF_16BE

        public static final java.lang.String UTF_16BE
        Deprecated.
        Sixteen-bit Unicode Transformation Format, big-endian byte order. Every implementation of the Java platform is required to support this character encoding.
        See Also:
        Charset, Constant Field Values
      • UTF_16LE

        public static final java.lang.String UTF_16LE
        Deprecated.
        Sixteen-bit Unicode Transformation Format, little-endian byte order. Every implementation of the Java platform is required to support this character encoding.
        See Also:
        Charset, Constant Field Values
      • UTF_8

        public static final java.lang.String UTF_8
        Deprecated.
        Eight-bit Unicode Transformation Format. Every implementation of the Java platform is required to support this character encoding.
        See Also:
        Charset, Constant Field Values
      • FILE_ENCODING

        public static final java.lang.String FILE_ENCODING
        Deprecated.
        The file.encoding System Property.
    • Constructor Detail

      • WriterFactory

        public WriterFactory()
        Deprecated.
    • Method Detail

      • newXmlWriter

        public static org.codehaus.plexus.util.xml.XmlStreamWriter newXmlWriter​(java.io.OutputStream out)
                                                                         throws java.io.IOException
        Deprecated.
        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:
        java.io.IOException - if any.
        See Also:
        XmlStreamWriter
      • newXmlWriter

        public static org.codehaus.plexus.util.xml.XmlStreamWriter newXmlWriter​(java.io.File file)
                                                                         throws java.io.IOException
        Deprecated.
        Create a new Writer with XML encoding detection rules.
        Parameters:
        file - not null file.
        Returns:
        an XML writer instance for the output file.
        Throws:
        java.io.IOException - if any.
        See Also:
        XmlStreamWriter
      • newPlatformWriter

        public static java.io.Writer newPlatformWriter​(java.io.OutputStream out)
        Deprecated.
        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.
        See Also:
        Charset.defaultCharset()
      • newPlatformWriter

        public static java.io.Writer newPlatformWriter​(java.io.File file)
                                                throws java.io.IOException
        Deprecated.
        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:
        java.io.IOException - if any.
        See Also:
        Charset.defaultCharset()
      • newWriter

        public static java.io.Writer newWriter​(java.io.OutputStream out,
                                               java.lang.String encoding)
                                        throws java.io.UnsupportedEncodingException
        Deprecated.
        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:
        java.io.UnsupportedEncodingException - if any.
        See Also:
        Supported encodings
      • newWriter

        public static java.io.Writer newWriter​(java.io.File file,
                                               java.lang.String encoding)
                                        throws java.io.IOException
        Deprecated.
        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:
        java.io.IOException - if any.
        See Also:
        Supported encodings