weka.core.xml

## Class XStream

- java.lang.Object
- - weka.core.xml.XStream

- All Implemented Interfaces:
    RevisionHandler

      public class XStream
      extends java.lang.Object
      implements RevisionHandler

  This class is a helper class for XML serialization using XStream . XStream does not need to be present, since the class-calls are done generically via Reflection.
  Version:
    $Revision: 10203 $
  Author:
    Mark Hall (mhall{[at]}pentaho{[dot]}org)

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static java.lang.String` | `FILE_EXTENSION` the extension for XStream files (including '.')

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `XStream()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `static java.lang.Object` | `deSerialize(java.lang.String xmlString)` Deserializes an object from the supplied XML string
    `java.lang.String` | `getRevision()` Returns the revision string.
    `static boolean` | `isPresent()` returns whether XStream is present or not, i.e.
    `static java.lang.Object` | `read(java.io.File file)` reads the XML-serialized object from the given file
    `static java.lang.Object` | `read(java.io.InputStream stream)` reads the XML-serialized object from the given input stream
    `static java.lang.Object` | `read(java.io.Reader r)` reads the XML-serialized object from the given Reader
    `static java.lang.Object` | `read(java.lang.String filename)` reads the XML-serialized object from the given file
    `static java.lang.String` | `serialize(java.lang.Object toSerialize)` Serializes the supplied object xml
    `static boolean` | `write(java.io.File file, java.lang.Object o)` write the XML-serialized object to the given file
    `static boolean` | `write(java.io.OutputStream stream, java.lang.Object o)` writes the XML-serialized object to the given output stream
    `static boolean` | `write(java.lang.String filename, java.lang.Object o)` writes the XML-serialized object to the given file
    `static boolean` | `write(java.io.Writer writer, java.lang.Object toSerialize)` writes the XML-serialized object to the given Writer.

    - ### Methods inherited from class java.lang.Object

      `equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Field Detail

    - #### FILE_EXTENSION

          public static final java.lang.String FILE_EXTENSION

      the extension for XStream files (including '.')
      See Also:
        Constant Field Values

  - ### Constructor Detail

    - #### XStream

          public XStream()

  - ### Method Detail

    - #### isPresent

          public static boolean isPresent()

      returns whether XStream is present or not, i.e. whether the classes are in the classpath or not
      Returns:
        whether XStream is available

    - #### serialize

          public static java.lang.String serialize(java.lang.Object toSerialize)
                                            throws java.lang.Exception

      Serializes the supplied object xml
      Parameters:
        `toSerialize` - the object to serialize
      Returns:
        the serialized object as an XML string
      Throws:
        `java.lang.Exception` - if something goes wrong

    - #### write

          public static boolean write(java.lang.String filename,
                      java.lang.Object o)
                               throws java.lang.Exception

      writes the XML-serialized object to the given file
      Parameters:
        `filename` - the file to serialize the object to
        `o` - the object to write to the file
      Returns:
        whether writing was successful or not
      Throws:
        `java.lang.Exception` - if something goes wrong while writing to the file

    - #### write

          public static boolean write(java.io.File file,
                      java.lang.Object o)
                               throws java.lang.Exception

      write the XML-serialized object to the given file
      Parameters:
        `file` - the file to serialize the object to
        `o` - the object to write to the file
      Returns:
        whether writing was successful or not
      Throws:
        `java.lang.Exception` - if something goes wrong while writing to the file

    - #### write

          public static boolean write(java.io.OutputStream stream,
                      java.lang.Object o)
                               throws java.lang.Exception

      writes the XML-serialized object to the given output stream
      Parameters:
        `stream` - the output stream
        `o` - the object to write
      Returns:
        true if everything goes ok
      Throws:
        `java.lang.Exception`

    - #### write

          public static boolean write(java.io.Writer writer,
                      java.lang.Object toSerialize)
                               throws java.lang.Exception

      writes the XML-serialized object to the given Writer.
      Parameters:
        `writer` - the Writer
        `toSerialize` - the object to write
      Returns:
        true if everything goes ok
      Throws:
        `java.lang.Exception` - if something goes wrong

    - #### read

          public static java.lang.Object read(java.lang.String filename)
                                       throws java.lang.Exception

      reads the XML-serialized object from the given file
      Parameters:
        `filename` - the file to deserialize the object from
      Returns:
        the deserialized object
      Throws:
        `java.lang.Exception` - if something goes wrong while reading from the file

    - #### read

          public static java.lang.Object read(java.io.File file)
                                       throws java.lang.Exception

      reads the XML-serialized object from the given file
      Parameters:
        `file` - the file to deserialize the object from
      Returns:
        the deserialized object
      Throws:
        `java.lang.Exception` - if something goes wrong while reading from the file

    - #### read

          public static java.lang.Object read(java.io.InputStream stream)
                                       throws java.lang.Exception

      reads the XML-serialized object from the given input stream
      Parameters:
        `stream` - the input stream
      Returns:
        the deserialized object
      Throws:
        `java.lang.Exception` - if something goes wrong while reading from stream

    - #### read

          public static java.lang.Object read(java.io.Reader r)
                                       throws java.lang.Exception

      reads the XML-serialized object from the given Reader
      Parameters:
        `r` - the reader
      Returns:
        the deserialized object
      Throws:
        `java.lang.Exception` - if something goes wrong while reading from stream

    - #### deSerialize

          public static java.lang.Object deSerialize(java.lang.String xmlString)
                                              throws java.lang.Exception

      Deserializes an object from the supplied XML string
      Parameters:
        `xmlString` - the XML to deserialize from
      Returns:
        the deserialized object
      Throws:
        `java.lang.Exception` - if something goes wrong

    - #### getRevision

          public java.lang.String getRevision()

      Returns the revision string.
      Specified by:
        `getRevision` in interface `RevisionHandler`
      Returns:
        the revision