|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.tools.ant.ProjectComponent org.apache.tools.ant.types.DataType org.apache.tools.ant.types.Resource org.apache.tools.ant.types.resources.AbstractClasspathResource
public abstract class AbstractClasspathResource
A Resource representation of anything that is accessed via a Java classloader. The core methods to set/resolve the classpath are provided.
Nested Class Summary | |
---|---|
static class |
AbstractClasspathResource.ClassLoaderWithFlag
|
Field Summary |
---|
Fields inherited from class org.apache.tools.ant.types.Resource |
---|
MAGIC, UNKNOWN_DATETIME, UNKNOWN_SIZE |
Fields inherited from class org.apache.tools.ant.types.DataType |
---|
checked, ref |
Fields inherited from class org.apache.tools.ant.ProjectComponent |
---|
description, location, project |
Constructor Summary | |
---|---|
AbstractClasspathResource()
|
Method Summary | |
---|---|
Path |
createClasspath()
Add a classpath to use when looking up a resource. |
protected void |
dieOnCircularReference(java.util.Stack<java.lang.Object> stk,
Project p)
Check to see whether any DataType we hold references to is included in the Stack (which holds all DataType instances that directly or indirectly reference this instance, including this instance itself). |
protected AbstractClasspathResource.ClassLoaderWithFlag |
getClassLoader()
combines the various ways that could specify a ClassLoader and potentially creates one that needs to be cleaned up when it is no longer needed so that classes can get garbage collected. |
Path |
getClasspath()
get the classpath used by this LoadProperties . |
java.io.InputStream |
getInputStream()
Return an InputStream for reading the contents of this Resource. |
Reference |
getLoader()
Get the loader. |
boolean |
isExists()
Learn whether this resource exists. |
protected abstract java.io.InputStream |
openInputStream(java.lang.ClassLoader cl)
open the input stream from a specific classloader |
void |
setClasspath(Path classpath)
Set the classpath to use when looking up a resource. |
void |
setClasspathRef(Reference r)
Set the classpath to use when looking up a resource, given as reference to a <path> defined elsewhere |
void |
setLoaderRef(Reference r)
Use the reference to locate the loader. |
void |
setParentFirst(boolean b)
Whether to consult the parent classloader first. |
void |
setRefid(Reference r)
Overrides the super version. |
Methods inherited from class org.apache.tools.ant.types.Resource |
---|
as, clone, compareTo, equals, getLastModified, getMagicNumber, getName, getOutputStream, getSize, hashCode, isDirectory, isFilesystemOnly, iterator, setDirectory, setExists, setLastModified, setName, setSize, size, toLongString, toString |
Methods inherited from class org.apache.tools.ant.types.DataType |
---|
checkAttributesAllowed, checkChildrenAllowed, circularReference, dieOnCircularReference, dieOnCircularReference, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getDataTypeName, getRefid, invokeCircularReferenceCheck, isChecked, isReference, noChildrenAllowed, pushAndInvokeCircularReferenceCheck, setChecked, tooManyAttributes |
Methods inherited from class org.apache.tools.ant.ProjectComponent |
---|
getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public AbstractClasspathResource()
Method Detail |
---|
public void setClasspath(Path classpath)
classpath
- to add to any existing classpathpublic Path createClasspath()
public void setClasspathRef(Reference r)
r
- The reference valuepublic Path getClasspath()
LoadProperties
.
public Reference getLoader()
public void setLoaderRef(Reference r)
r
- the reference to locate the loader.public void setParentFirst(boolean b)
Only relevant if a classpath has been specified.
public void setRefid(Reference r)
setRefid
in class Resource
r
- the Reference to set.public boolean isExists()
isExists
in class Resource
public java.io.InputStream getInputStream() throws java.io.IOException
getInputStream
in class Resource
java.io.IOException
- if an error occurs.protected AbstractClasspathResource.ClassLoaderWithFlag getClassLoader()
protected abstract java.io.InputStream openInputStream(java.lang.ClassLoader cl) throws java.io.IOException
cl
- the classloader to use. Will be null if the system classloader is used
java.io.IOException
- if an error occurs.protected void dieOnCircularReference(java.util.Stack<java.lang.Object> stk, Project p)
DataType
If one is included, throw a BuildException created by circularReference
.
This implementation is appropriate only for a DataType that cannot hold other DataTypes as children.
The general contract of this method is that it shouldn't do
anything if
is true and
set it to true on exit.checked
dieOnCircularReference
in class DataType
stk
- the stack of references to check.p
- the project to use to dereference the references.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |