public class

XML

extends Object
java.lang.Object
   ↳ org.json.XML

Class Overview

This provides static methods to convert an XML text into a JSONObject, and to covert a JSONObject into an XML text.

Summary

Fields
public static final Character AMP The Character '&'.
public static final Character APOS The Character '''.
public static final Character BANG The Character '!'.
public static final Character EQ The Character '='.
public static final Character GT The Character '>'.
public static final Character LT The Character '<'.
public static final Character QUEST The Character '?'.
public static final Character QUOT The Character '"'.
public static final Character SLASH The Character '/'.
Public Constructors
XML()
Public Methods
static String escape(String string)
Replace special characters with XML escapes: 
 & (ampersand) is replaced by &amp;
 < (less than) is replaced by &lt;
 > (greater than) is replaced by &gt;
 " (double quote) is replaced by &quot;
static void noSpace(String string)
Throw an exception if the string contains whitespace.
static Object stringToValue(String string)
Try to convert a string into a number, boolean, or null.
static JSONObject toJSONObject(String string)
Convert a well-formed (but not necessarily valid) XML string into a JSONObject.
static String toString(Object object, String tagName)
Convert a JSONObject into a well-formed, element-normal XML string.
static String toString(Object object)
Convert a JSONObject into a well-formed, element-normal XML string.
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public static final Character AMP

The Character '&'.

public static final Character APOS

The Character '''.

public static final Character BANG

The Character '!'.

public static final Character EQ

The Character '='.

public static final Character GT

The Character '>'.

public static final Character LT

The Character '<'.

public static final Character QUEST

The Character '?'.

public static final Character QUOT

The Character '"'.

public static final Character SLASH

The Character '/'.

Public Constructors

public XML ()

Public Methods

public static String escape (String string)

Replace special characters with XML escapes: 

 & (ampersand) is replaced by &amp;
 < (less than) is replaced by &lt;
 > (greater than) is replaced by &gt;
 " (double quote) is replaced by &quot;

Parameters
string The string to be escaped.
Returns
  • The escaped string.

public static void noSpace (String string)

Throw an exception if the string contains whitespace. Whitespace is not allowed in tagNames and attributes.

Throws
JSONException

public static Object stringToValue (String string)

Try to convert a string into a number, boolean, or null. If the string can't be converted, return the string. This is much less ambitious than JSONObject.stringToValue, especially because it does not attempt to convert plus forms, octal forms, hex forms, or E forms lacking decimal points.

Parameters
string A String.
Returns
  • A simple JSON value.

public static JSONObject toJSONObject (String string)

Convert a well-formed (but not necessarily valid) XML string into a JSONObject. Some information may be lost in this transformation because JSON is a data format and XML is a document format. XML uses elements, attributes, and content text, while JSON uses unordered collections of name/value pairs and arrays of values. JSON does not does not like to distinguish between elements and attributes. Sequences of similar elements are represented as JSONArrays. Content text may be placed in a "content" member. Comments, prologs, DTDs, and <[ [ ]]> are ignored.

Parameters
string The source string.
Returns
  • A JSONObject containing the structured data from the XML string.
Throws
JSONException

public static String toString (Object object, String tagName)

Convert a JSONObject into a well-formed, element-normal XML string.

Parameters
object A JSONObject.
tagName The optional name of the enclosing tag.
Returns
  • A string.
Throws
JSONException

public static String toString (Object object)

Convert a JSONObject into a well-formed, element-normal XML string.

Parameters
object A JSONObject.
Returns
  • A string.
Throws
JSONException