com.thoughtworks.qdox.library

Class SourceLibrary

java.lang.Object

com.thoughtworks.qdox.library.AbstractClassLibrary

com.thoughtworks.qdox.library.SourceLibrary

All Implemented Interfaces:

ClassLibrary, Serializable

Direct Known Subclasses:

SourceFolderLibrary

public class SourceLibrary
extends AbstractClassLibrary

This Library will immediately parse the source and keeps its reference to a private context. Once the superclass explicitly asks for an instance if will be moved to the context f the supoerclass. If there's a request to get a certain JavaModel Object from a SourceLibrary, it will check all ancestor SourceLibraries as well.

Since:

2.0

Author:

Robert Scholte

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SourceLibrary(AbstractClassLibrary parent) Create a new instance of SourceLibrary and chain it to the parent

Method Summary

Modifier and Type	Method and Description
JavaSource	addSource(File file) Add a File containing java code to this library
JavaSource	addSource(InputStream stream) Add an InputStream containing java code to this library
JavaSource	addSource(Reader reader) Add a Reader containing java code to this library
JavaSource	addSource(URL url) Add a URL containing java code to this library
protected boolean	containsClassReference(String name) This method is used to detect if there's a match with this classname.
String	getEncoding()
ErrorHandler	getErrorHandler()
Collection<JavaClass>	getJavaClasses() Get all classes, including those from parent SourceLibraries
Collection<JavaPackage>	getJavaPackages() Get all packages, including those from parent SourceLibraries
Collection<JavaSource>	getJavaSources() Get all sources, including those from parent SourceLibraries
boolean	isDebugLexer()
boolean	isDebugParser()
protected JavaSource	parse(InputStream stream, URL url)
protected JavaSource	parse(Reader reader, URL url)
protected void	registerJavaSource(JavaSource source)
protected JavaClass	resolveJavaClass(String name) The implementation should check it's sources to see if it can build a JavaClass Model If not, just return null; Once found it will be mapped, so there's no need to keep a reference to this object.
protected JavaPackage	resolveJavaPackage(String name)
void	setDebugLexer(boolean debugLexer) Use the Lexer in debug mode
void	setDebugParser(boolean debugParser) Use the Parser in debug mode
void	setEncoding(String encoding) Sets the encoding to use when parsing a URL or InputStreamReader
void	setErrorHandler(ErrorHandler errorHandler)

Methods inherited from class com.thoughtworks.qdox.library.AbstractClassLibrary

getJavaClass, getJavaClass, getJavaClasses, getJavaPackage, getJavaPackages, getJavaSources, getModelBuilder, getModelBuilder, getModelBuilderFactory, getModelWriterFactory, hasClassReference, setModelBuilderFactory, setModelWriterFactory

Methods inherited from class java.lang.Object

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

Constructor Detail

SourceLibrary

public SourceLibrary(AbstractClassLibrary parent)

Create a new instance of SourceLibrary and chain it to the parent

Parameters:

parent -

Method Detail

addSource

public JavaSource addSource(Reader reader)
                     throws ParseException

Add a Reader containing java code to this library

Parameters:

reader - a Reader which should contain java code

Returns:

The constructed JavaSource object of this reader

Throws:

ParseException - if this content couldn't be parsed to a JavaModel

addSource

public JavaSource addSource(InputStream stream)
                     throws ParseException,
                            IOException

Add an InputStream containing java code to this library

Parameters:

stream - an InputStream which should contain java code

Returns:

The constructed JavaSource object of this stream

Throws:

ParseException - if this content couldn't be parsed to a JavaModel

IOException

addSource

public JavaSource addSource(URL url)
                     throws ParseException,
                            IOException

Add a URL containing java code to this library

Parameters:

url - a URL which should contain java code

Returns:

The constructed JavaSource object of this url

Throws:

ParseException - if this content couldn't be parsed to a JavaModel

IOException

addSource

public JavaSource addSource(File file)
                     throws ParseException,
                            IOException

Add a File containing java code to this library

Parameters:

file - a File which should contain java code

Returns:

The constructed JavaSource object of this file

Throws:

ParseException

IOException

parse

protected JavaSource parse(Reader reader,
                           URL url)
                    throws ParseException

Throws:

ParseException

parse

protected JavaSource parse(InputStream stream,
                           URL url)
                    throws ParseException,
                           UnsupportedEncodingException

Throws:

ParseException

UnsupportedEncodingException

resolveJavaClass

protected JavaClass resolveJavaClass(String name)

Description copied from class: AbstractClassLibrary

The implementation should check it's sources to see if it can build a JavaClass Model If not, just return null; Once found it will be mapped, so there's no need to keep a reference to this object.

Specified by:

resolveJavaClass in class AbstractClassLibrary

Parameters:

name - the fully qualified name

Returns:

the resolved JavaClass, otherwise null

resolveJavaPackage

protected JavaPackage resolveJavaPackage(String name)

Specified by:

resolveJavaPackage in class AbstractClassLibrary

registerJavaSource

protected final void registerJavaSource(JavaSource source)

Parameters:

source - the source, might be null

setDebugLexer

public final void setDebugLexer(boolean debugLexer)

Use the Lexer in debug mode

Parameters:

debugLexer -

isDebugLexer

public final boolean isDebugLexer()

setDebugParser

public final void setDebugParser(boolean debugParser)

Use the Parser in debug mode

Parameters:

debugParser -

isDebugParser

public final boolean isDebugParser()

setEncoding

public final void setEncoding(String encoding)

Sets the encoding to use when parsing a URL or InputStreamReader

Parameters:

encoding -

getEncoding

public final String getEncoding()

setErrorHandler

public final void setErrorHandler(ErrorHandler errorHandler)

getErrorHandler

public final ErrorHandler getErrorHandler()

getJavaClasses

public Collection<JavaClass> getJavaClasses()

Get all classes, including those from parent SourceLibraries

Specified by:

getJavaClasses in interface ClassLibrary

Overrides:

getJavaClasses in class AbstractClassLibrary

Returns:

all JavaClasses of this ClassLibrary

getJavaPackages

public Collection<JavaPackage> getJavaPackages()

Get all packages, including those from parent SourceLibraries

Specified by:

getJavaPackages in interface ClassLibrary

Overrides:

getJavaPackages in class AbstractClassLibrary

Returns:

all JavaPackages of this ClassLibrary

getJavaSources

public Collection<JavaSource> getJavaSources()

Get all sources, including those from parent SourceLibraries

Specified by:

getJavaSources in interface ClassLibrary

Overrides:

getJavaSources in class AbstractClassLibrary

Returns:

all JavaSources as a List, never null

containsClassReference

protected boolean containsClassReference(String name)

Description copied from class: AbstractClassLibrary

This method is used to detect if there's a match with this classname. The name could be constructed based on imports and inner class paths.

Specified by:

containsClassReference in class AbstractClassLibrary

Parameters:

name - the fully qualified name of the class

Returns:

true if this ClassLibrary has a reference to this class.