testng 7.10.2 · org.testng.xml.TestNGContentHandler

Modifier and Type	Class and Description
private static class	TestNGContentHandler.Include
pack-priv static enum	TestNGContentHandler.Location

Modifier and Type	Field and Description
private boolean	isSuiteFileTag
private XmlClass	m_currentClass
private List<XmlClass>	m_currentClasses
private int	m_currentClassIndex
private Map<String, String>	m_currentClassParameters
private XmlDefine	m_currentDefine
private List<String>	m_currentExcludedMethods
private String	m_currentExpression
private XmlGroups	m_currentGroups
private TestNGContentHandler.Include	m_currentInclude
private ArrayList<XmlInclude>	m_currentIncludedMethods
private int	m_currentIncludeIndex
private String	m_currentLanguage
private XmlPackage	m_currentPackage
private List<XmlPackage>	m_currentPackages
private XmlRun	m_currentRun
private XmlMethodSelector	m_currentSelector
private ArrayList<XmlMethodSelector>	m_currentSelectors
private XmlSuite	m_currentSuite
private Map<String, String>	m_currentSuiteParameters
private XmlTest	m_currentTest
private int	m_currentTestIndex
private Map<String, String>	m_currentTestParameters
private boolean	m_enabledTest
private final String	m_fileName
private boolean	m_hasWarn
private List<String>	m_listeners
private final boolean	m_loadClasses
private final Stack<TestNGContentHandler.Location>	m_locations
private final EntityResolver	m_redirectionAwareResolver
private final List<String>	m_suiteFiles
private final List<XmlSuite>	m_suites
private boolean	m_validate

Access	Constructor and Description
public	TestNGContentHandler(String fileName, boolean loadClasses)

Method Summary

Modifier and Type	Method and Description
private boolean	areWhiteSpaces(char[] ch, int start, int length)
public void	characters(char[] The characters. ch, int The start position in the character array. start, int The number of characters to use from the character array. length) Overrides org.xml.sax.helpers.DefaultHandler.characters. Implements org.xml.sax.ContentHandler.characters. Receive notification of character data inside an element.
public void	endElement(String The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed. uri, String The local name (without prefix), or the empty string if Namespace processing is not being performed. localName, String The qualified name (with prefix), or the empty string if qualified names are not available. qName) Overrides org.xml.sax.helpers.DefaultHandler.endElement. Implements org.xml.sax.ContentHandler.endElement. Receive notification of the end of an element.
public void	error(SAXParseException The error information encoded as an exception. e) Overrides org.xml.sax.helpers.DefaultHandler.error. Implements org.xml.sax.ErrorHandler.error. Receive notification of a recoverable parser error.
private static String	expandValue(String value)
public XmlSuite	getSuite()
private static boolean	isMalformedFileSystemBasedSystemId(String systemId)
private static boolean	isUnsecuredUrl(String str)
private InputStream	loadDtdUsingClassLoader()
private void	popLocation()
private void	pushLocation(TestNGContentHandler.Location l)
public InputSource	resolveEntity(String The public identifier, or null if none is available. publicId, String The system identifier provided in the XML document. systemId) Overrides org.xml.sax.helpers.DefaultHandler.resolveEntity. Implements org.xml.sax.EntityResolver.resolveEntity. Resolve an external entity.
private static boolean	skipConsideringSystemId(String systemId)
public void	startElement(String The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed. uri, String The local name (without prefix), or the empty string if Namespace processing is not being performed. localName, String The qualified name (with prefix), or the empty string if qualified names are not available. qName, Attributes The attributes attached to the element. If there are no attributes, it shall be an empty Attributes object. attributes) Overrides org.xml.sax.helpers.DefaultHandler.startElement. Implements org.xml.sax.ContentHandler.startElement. Note I only invoke xml*methods (e.g. xmlSuite()) if I am acting on both the start and the end of the tag.
private List<Integer>	stringToList(String in)
private static void	warnSinceJUnitDetected()
public void	xmlClasses(boolean start)
private void	xmlDefine(boolean start, Attributes attributes) Parse <define>
private void	xmlExclude(boolean start, Attributes attributes)
public void	xmlGroup(boolean start, Attributes attributes)
public void	xmlGroups(boolean start)
private void	xmlInclude(boolean start, Attributes attributes)
public void	xmlListener(boolean start, Attributes attributes)
public void	xmlListeners(boolean start)
private void	xmlMethod(boolean start)
public void	xmlMethodSelector(boolean start)
public void	xmlMethodSelectors(boolean start)
public void	xmlPackages(boolean start)
public void	xmlRun(boolean start)
private void	xmlScript(boolean start, Attributes attributes) Parse <script>
public void	xmlSelectorClass(boolean start, Attributes attributes)
private void	xmlSuite(boolean start, Attributes attributes) Parse <suite>
private void	xmlSuiteFile(boolean start, Attributes attributes) Parse <suite-file>
private void	xmlTest(boolean start, Attributes attributes) Parse <test>

Inherited from org.xml.sax.helpers.DefaultHandler:: endDocument endPrefixMapping fatalError ignorableWhitespace notationDecl processingInstruction setDocumentLocator skippedEntity startDocument startPrefixMapping unparsedEntityDecl warning

Field Detail

isSuiteFileTag	back to summary
private boolean isSuiteFileTag

m_currentClass	back to summary
private XmlClass m_currentClass

m_currentClasses	back to summary
private List<XmlClass> m_currentClasses

m_currentClassIndex	back to summary
private int m_currentClassIndex

m_currentClassParameters	back to summary
private Map<String, String> m_currentClassParameters

m_currentDefine	back to summary
private XmlDefine m_currentDefine

m_currentExcludedMethods	back to summary
private List<String> m_currentExcludedMethods

m_currentExpression	back to summary
private String m_currentExpression

m_currentGroups	back to summary
private XmlGroups m_currentGroups

m_currentInclude	back to summary
private TestNGContentHandler.Include m_currentInclude

m_currentIncludedMethods	back to summary
private ArrayList<XmlInclude> m_currentIncludedMethods

m_currentIncludeIndex	back to summary
private int m_currentIncludeIndex

m_currentLanguage	back to summary
private String m_currentLanguage

m_currentPackage	back to summary
private XmlPackage m_currentPackage

m_currentPackages	back to summary
private List<XmlPackage> m_currentPackages

m_currentRun	back to summary
private XmlRun m_currentRun

m_currentSelector	back to summary
private XmlMethodSelector m_currentSelector

m_currentSelectors	back to summary
private ArrayList<XmlMethodSelector> m_currentSelectors

m_currentSuite	back to summary
private XmlSuite m_currentSuite

m_currentSuiteParameters	back to summary
private Map<String, String> m_currentSuiteParameters

m_currentTest	back to summary
private XmlTest m_currentTest

m_currentTestIndex	back to summary
private int m_currentTestIndex

m_currentTestParameters	back to summary
private Map<String, String> m_currentTestParameters

m_enabledTest	back to summary
private boolean m_enabledTest

m_fileName	back to summary
private final String m_fileName

m_hasWarn	back to summary
private boolean m_hasWarn

m_listeners	back to summary
private List<String> m_listeners

m_loadClasses	back to summary
private final boolean m_loadClasses

m_locations	back to summary
private final Stack<TestNGContentHandler.Location> m_locations

m_redirectionAwareResolver	back to summary
private final EntityResolver m_redirectionAwareResolver

m_suiteFiles	back to summary
private final List<String> m_suiteFiles

m_suites	back to summary
private final List<XmlSuite> m_suites

m_validate	back to summary
private boolean m_validate

Constructor Detail

TestNGContentHandler	back to summary
public TestNGContentHandler(String fileName, boolean loadClasses)

Method Detail

areWhiteSpaces	back to summary
private boolean areWhiteSpaces(char[] ch, int start, int length)

characters	back to summary
public void characters(char[] ch, int start, int length) Overrides org.xml.sax.helpers.DefaultHandler.characters. Implements org.xml.sax.ContentHandler.characters. Doc from org.xml.sax.helpers.DefaultHandler.characters. Receive notification of character data inside an element. By default, do nothing. Application writers may override this method to take specific actions for each chunk of character data (such as adding the data to a node or buffer, or printing it to a file). Parameters ch:char[] The characters. start:int The start position in the character array. length:int The number of characters to use from the character array. Annotations @Override

characters

back to summary

public void characters(char[] ch, int start, int length)

Overrides org.xml.sax.helpers.DefaultHandler.characters.

Implements org.xml.sax.ContentHandler.characters.

Doc from org.xml.sax.helpers.DefaultHandler.characters.

Receive notification of character data inside an element.

By default, do nothing. Application writers may override this method to take specific actions for each chunk of character data (such as adding the data to a node or buffer, or printing it to a file).

Parameters

ch:char[]: The characters.
start:int: The start position in the character array.
length:int: The number of characters to use from the character array.

Annotations

@Override

endElement	back to summary
public void endElement(String uri, String localName, String qName) Overrides org.xml.sax.helpers.DefaultHandler.endElement. Implements org.xml.sax.ContentHandler.endElement. Doc from org.xml.sax.helpers.DefaultHandler.endElement. Receive notification of the end of an element. By default, do nothing. Application writers may override this method in a subclass to take specific actions at the end of each element (such as finalising a tree node or writing output to a file). Parameters uri:String The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed. localName:String The local name (without prefix), or the empty string if Namespace processing is not being performed. qName:String The qualified name (with prefix), or the empty string if qualified names are not available. Annotations @Override

endElement

back to summary

public void endElement(String uri, String localName, String qName)

Overrides org.xml.sax.helpers.DefaultHandler.endElement.

Implements org.xml.sax.ContentHandler.endElement.

Doc from org.xml.sax.helpers.DefaultHandler.endElement.

Receive notification of the end of an element.

By default, do nothing. Application writers may override this method in a subclass to take specific actions at the end of each element (such as finalising a tree node or writing output to a file).

Parameters

uri:String: The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.
localName:String: The local name (without prefix), or the empty string if Namespace processing is not being performed.
qName:String: The qualified name (with prefix), or the empty string if qualified names are not available.

Annotations

@Override

error	back to summary
public void error(SAXParseException e) throws SAXException Overrides org.xml.sax.helpers.DefaultHandler.error. Implements org.xml.sax.ErrorHandler.error. Doc from org.xml.sax.helpers.DefaultHandler.error. Receive notification of a recoverable parser error. The default implementation does nothing. Application writers may override this method in a subclass to take specific actions for each error, such as inserting the message in a log file or printing it to the console. Parameters e:SAXParseException The error information encoded as an exception. Annotations @Override Exceptions SAXException: Any SAX exception, possibly wrapping another exception.

error

back to summary

public void error(SAXParseException e) throws SAXException

Overrides org.xml.sax.helpers.DefaultHandler.error.

Implements org.xml.sax.ErrorHandler.error.

Doc from org.xml.sax.helpers.DefaultHandler.error.

Receive notification of a recoverable parser error.

The default implementation does nothing. Application writers may override this method in a subclass to take specific actions for each error, such as inserting the message in a log file or printing it to the console.

Parameters

e:SAXParseException: The error information encoded as an exception.

Annotations

@Override

Exceptions

SAXException:: Any SAX exception, possibly wrapping another exception.

expandValue	back to summary
private static String expandValue(String value)

getSuite	back to summary
public XmlSuite getSuite()

isMalformedFileSystemBasedSystemId	back to summary
private static boolean isMalformedFileSystemBasedSystemId(String systemId)

isUnsecuredUrl	back to summary
private static boolean isUnsecuredUrl(String str)

loadDtdUsingClassLoader	back to summary
private InputStream loadDtdUsingClassLoader()

popLocation	back to summary
private void popLocation()

pushLocation	back to summary
private void pushLocation(TestNGContentHandler.Location l)

resolveEntity	back to summary
public InputSource resolveEntity(String publicId, String systemId) throws SAXException, IOException Overrides org.xml.sax.helpers.DefaultHandler.resolveEntity. Implements org.xml.sax.EntityResolver.resolveEntity. Doc from org.xml.sax.helpers.DefaultHandler.resolveEntity. Resolve an external entity. Always return null, so that the parser will use the system identifier provided in the XML document. This method implements the SAX default behaviour: application writers can override it in a subclass to do special translations such as catalog lookups or URI redirection. Parameters publicId:String The public identifier, or null if none is available. systemId:String The system identifier provided in the XML document. Returns:InputSource The new input source, or null to require the default behaviour. Annotations @Override Exceptions SAXException: Any SAX exception, possibly wrapping another exception. IOException: If there is an error setting up the new input source.

resolveEntity

back to summary

public InputSource resolveEntity(String publicId, String systemId) throws SAXException, IOException

Overrides org.xml.sax.helpers.DefaultHandler.resolveEntity.

Implements org.xml.sax.EntityResolver.resolveEntity.

Doc from org.xml.sax.helpers.DefaultHandler.resolveEntity.

Resolve an external entity.

Always return null, so that the parser will use the system identifier provided in the XML document. This method implements the SAX default behaviour: application writers can override it in a subclass to do special translations such as catalog lookups or URI redirection.

Parameters

publicId:String: The public identifier, or null if none is available.
systemId:String: The system identifier provided in the XML document.

Returns:InputSource

The new input source, or null to require the default behaviour.

Annotations

@Override

Exceptions

SAXException:: Any SAX exception, possibly wrapping another exception.
IOException:: If there is an error setting up the new input source.

skipConsideringSystemId	back to summary
private static boolean skipConsideringSystemId(String systemId)

startElement

back to summary

public void startElement(String uri, String localName, String qName, Attributes attributes)

Overrides org.xml.sax.helpers.DefaultHandler.startElement.

Implements org.xml.sax.ContentHandler.startElement.

Note

I only invoke xml*methods (e.g. xmlSuite()) if I am acting on both the start and the end of the tag. This way I can keep the treatment of this tag in one place. If I am only doing something when the tag opens, the code is inlined below in the startElement() method.

Parameters

uri:String

Doc from org.xml.sax.helpers.DefaultHandler.startElement.

The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed.

localName:String

Doc from org.xml.sax.helpers.DefaultHandler.startElement.

The local name (without prefix), or the empty string if Namespace processing is not being performed.

qName:String

Doc from org.xml.sax.helpers.DefaultHandler.startElement.

The qualified name (with prefix), or the empty string if qualified names are not available.

attributes:Attributes

Doc from org.xml.sax.helpers.DefaultHandler.startElement.

The attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

Annotations

@Override

stringToList	back to summary
private List<Integer> stringToList(String in)

warnSinceJUnitDetected	back to summary
private static void warnSinceJUnitDetected()

xmlClasses	back to summary
public void xmlClasses(boolean start)

xmlDefine	back to summary
private void xmlDefine(boolean start, Attributes attributes) Parse

xmlExclude	back to summary
private void xmlExclude(boolean start, Attributes attributes)

xmlGroup	back to summary
public void xmlGroup(boolean start, Attributes attributes)

xmlGroups	back to summary
public void xmlGroups(boolean start)

xmlInclude	back to summary
private void xmlInclude(boolean start, Attributes attributes)

xmlListener	back to summary
public void xmlListener(boolean start, Attributes attributes)

xmlListeners	back to summary
public void xmlListeners(boolean start)

xmlMethod	back to summary
private void xmlMethod(boolean start)

xmlMethodSelector	back to summary
public void xmlMethodSelector(boolean start)

xmlMethodSelectors	back to summary
public void xmlMethodSelectors(boolean start)

xmlPackages	back to summary
public void xmlPackages(boolean start)

xmlRun	back to summary
public void xmlRun(boolean start)

xmlScript	back to summary
private void xmlScript(boolean start, Attributes attributes) Parse

public Class TestNGContentHandler

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail