Package org.json

Class XML

java.lang.Object

org.json.XML

@Deprecated
public class XML
extends Object

Deprecated.

Use javax.json or other other json libraries instead

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

Field Summary

Fields

Modifier and Type	Field	Description
static Character	AMP	Deprecated. The Character '&'.
static Character	APOS	Deprecated. The Character '''.
static Character	BANG	Deprecated. The Character '!'.
static Character	EQ	Deprecated. The Character '='.
static Character	GT	Deprecated. The Character '>'.
static Character	LT	Deprecated. The Character '<'.
static Character	QUEST	Deprecated. The Character '?'.
static Character	QUOT	Deprecated. The Character '"'.
static Character	SLASH	Deprecated. The Character '/'.

Constructor Summary

Constructors

Constructor	Description
XML()	Deprecated.

Method Summary

Modifier and Type	Method	Description
static String	escape(String string)	Deprecated. Replace special characters with XML escapes:
static void	noSpace(String string)	Deprecated. Throw an exception if the string contains whitespace.
static Object	stringToValue(String string)	Deprecated. This method is the same as JSONObject.stringToValue(String).
static JSONObject	toJSONObject(String string)	Deprecated. Convert a well-formed (but not necessarily valid) XML string into a JSONObject.
static String	toString(Object object)	Deprecated. Convert a JSONObject into a well-formed, element-normal XML string.
static String	toString(Object object, String tagName)	Deprecated. Convert a JSONObject into a well-formed, element-normal XML string.

Methods inherited from class java.lang.Object

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

Field Detail

AMP

public static final Character AMP

Deprecated.

The Character '&'.

APOS

public static final Character APOS

Deprecated.

The Character '''.

BANG

public static final Character BANG

Deprecated.

The Character '!'.

EQ

public static final Character EQ

Deprecated.

The Character '='.

GT

public static final Character GT

Deprecated.

The Character '>'.

LT

public static final Character LT

Deprecated.

The Character '<'.

QUEST

public static final Character QUEST

Deprecated.

The Character '?'.

QUOT

public static final Character QUOT

Deprecated.

The Character '"'.

SLASH

public static final Character SLASH

Deprecated.

The Character '/'.

Constructor Detail

XML

public XML()

Deprecated.

Method Detail

escape

public static String escape(String string)

Deprecated.

Replace special characters with XML escapes:

 & (ampersand) is replaced by &
 < (less than) is replaced by &lt;
 > (greater than) is replaced by &gt;
 " (double quote) is replaced by &quot;
 ' (single quote / apostrophe) is replaced by &apos;
 

Parameters:

string - The string to be escaped.

Returns:

The escaped string.

noSpace

public static void noSpace(String string)
                    throws JSONException

Deprecated.

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

Parameters:

string - A string.

Throws:

JSONException - Thrown if the string contains whitespace or is empty.

stringToValue

public static Object stringToValue(String string)

Deprecated.

This method is the same as JSONObject.stringToValue(String).

Parameters:

string - String to convert

Returns:

JSON value of this string or the string

toJSONObject

public static JSONObject toJSONObject(String string)
                               throws JSONException

Deprecated.

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 - Thrown if there is an errors while parsing the string

toString

public static String toString(Object object)
                       throws JSONException

Deprecated.

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

Parameters:

object - A JSONObject.

Returns:

A string.

Throws:

JSONException - Thrown if there is an error parsing the string

toString

public static String toString(Object object,
                              String tagName)
                       throws JSONException

Deprecated.

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 - Thrown if there is an error parsing the string