Package org.testng.xml.internal

Class Parser

java.lang.Object

org.testng.xml.internal.Parser

Direct Known Subclasses:

Parser

public class Parser
extends Object

Parser is a parser for a TestNG XML test suite file.

Field Summary

Fields

Modifier and Type	Field	Description
private static final ISuiteParser	DEFAULT_FILE_PARSER
static final String	DEFAULT_FILENAME	The default file name for the TestNG test suite if none is specified (testng.xml).
static final String	HTTPS_TESTNG_DTD_URL
private String	m_fileName	The file name of the xml suite being parsed.
private InputStream	m_inputStream
private boolean	m_loadClasses
private IPostProcessor	m_postProcessor
static final String	OLD_TESTNG_DTD_URL	The URL to the deprecated TestNG DTD.
private static final List<ISuiteParser>	PARSERS
static final String	TESTNG_DTD	The name of the TestNG DTD.
static final String	TESTNG_DTD_URL	The URL to the TestNG DTD.

Constructor Summary

Constructors

Constructor	Description
Parser()	Creates a parser that will try to find the DEFAULT_FILENAME from the jar.
Parser(InputStream is)
Parser(String fileName)	Constructs a Parser to use the inputStream as the source of the xml test suite to parse.

Method Summary

Modifier and Type	Method	Description
static boolean	canParse(String fileName)
private static URI	constructURI(String text)
private static IFileParser	getParser(String fileName)
static boolean	hasFileScheme(String uri)
private void	init(String fileName, InputStream is)
private static Parser	newParser(InputStream is, IPostProcessor processor)
private static Parser	newParser(String path, IPostProcessor processor)
Collection<XmlSuite>	parse()	Parses the TestNG test suite and returns the corresponding XmlSuite, and possibly, other XmlSuite that are pointed to by <suite-files> tags.
static Collection<XmlSuite>	parse(InputStream is, IPostProcessor processor)
static Collection<XmlSuite>	parse(String suite, IPostProcessor processor)
List<XmlSuite>	parseToList()
void	setLoadClasses(boolean loadClasses)
void	setPostProcessor(IPostProcessor processor)

Methods inherited from class java.lang.Object

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

Field Details

TESTNG_DTD

public static final String TESTNG_DTD

The name of the TestNG DTD.

See Also:

• Constant Field Values

OLD_TESTNG_DTD_URL

public static final String OLD_TESTNG_DTD_URL

The URL to the deprecated TestNG DTD.

See Also:

• Constant Field Values

TESTNG_DTD_URL

public static final String TESTNG_DTD_URL

The URL to the TestNG DTD.

See Also:

• Constant Field Values

HTTPS_TESTNG_DTD_URL

public static final String HTTPS_TESTNG_DTD_URL

See Also:

• Constant Field Values

DEFAULT_FILENAME

public static final String DEFAULT_FILENAME

The default file name for the TestNG test suite if none is specified (testng.xml).

See Also:

• Constant Field Values

DEFAULT_FILE_PARSER

private static final ISuiteParser DEFAULT_FILE_PARSER

PARSERS

private static final List<ISuiteParser> PARSERS

m_fileName

private String m_fileName

The file name of the xml suite being parsed. This may be null if the Parser has not been initialized with a file name. TODO CQ This member is never used.

m_inputStream

private InputStream m_inputStream

m_postProcessor

private IPostProcessor m_postProcessor

m_loadClasses

private boolean m_loadClasses

Constructor Details

Parser

public Parser(String fileName)

Constructs a Parser to use the inputStream as the source of the xml test suite to parse.

Parameters:

fileName - the filename corresponding to the inputStream or null if unknown.

Parser

public Parser()

Creates a parser that will try to find the DEFAULT_FILENAME from the jar.

Parser

public Parser(InputStream is)

Method Details

init

private void init(String fileName,
 InputStream is)

setPostProcessor

public void setPostProcessor(IPostProcessor processor)

setLoadClasses

public void setLoadClasses(boolean loadClasses)

Parameters:

loadClasses - If false, don't try to load the classes during the parsing.

getParser

private static IFileParser getParser(String fileName)

parse

public Collection<XmlSuite> parse()
                           throws IOException

Parses the TestNG test suite and returns the corresponding XmlSuite, and possibly, other XmlSuite that are pointed to by <suite-files> tags.

Returns:

the parsed TestNG test suite.

Throws:

IOException - if an I/O error occurs while parsing the test suite file or if the default testng.xml file is not found.

hasFileScheme

public static boolean hasFileScheme(String uri)

Parameters:

uri - - The uri to be verified.

Returns:

- true if the uri has "file:" as its scheme.

parseToList

public List<XmlSuite> parseToList()
                           throws IOException

Throws:

IOException

parse

public static Collection<XmlSuite> parse(String suite,
 IPostProcessor processor)
                                  throws IOException

Throws:

IOException

parse

public static Collection<XmlSuite> parse(InputStream is,
 IPostProcessor processor)
                                  throws IOException

Throws:

IOException

canParse

public static boolean canParse(String fileName)

newParser

private static Parser newParser(String path,
 IPostProcessor processor)

newParser

private static Parser newParser(InputStream is,
 IPostProcessor processor)

constructURI

private static URI constructURI(String text)