|
Property (Apache Ant API)
org.apache.tools.ant.taskdefs
|
Field Summary | |
protected Path |
classpath
|
protected java.lang.String |
env
|
protected java.io.File |
file
|
protected java.lang.String |
name
|
protected java.lang.String |
prefix
|
protected Reference |
ref
|
protected java.lang.String |
resource
|
protected boolean |
userProperty
|
protected java.lang.String |
value
|
Fields inherited from class org.apache.tools.ant.Task |
description, location, target, taskName, taskType, wrapper |
Fields inherited from class org.apache.tools.ant.ProjectComponent |
project |
Constructor Summary | |
|
Property()
|
protected |
Property(boolean userProperty)
|
protected |
Property(boolean userProperty,
Project fallback)
|
Method Summary | |
protected void |
addProperties(java.util.Properties props)
iterate through a set of properties, resolve them then assign them |
protected void |
addProperty(java.lang.String n,
java.lang.String v)
add a name value pair to the project property set |
Path |
createClasspath()
The classpath to use when looking up a resource. |
void |
execute()
set the property in the project to the value. |
Path |
getClasspath()
|
java.lang.String |
getEnvironment()
|
java.io.File |
getFile()
|
java.lang.String |
getName()
|
java.lang.String |
getPrefix()
|
Reference |
getRefid()
|
java.lang.String |
getResource()
|
java.lang.String |
getValue()
|
protected void |
loadEnvironment(java.lang.String prefix)
load the environment values |
protected void |
loadFile(java.io.File file)
load properties from a file |
protected void |
loadResource(java.lang.String name)
load properties from a resource in the current classpath |
void |
setClasspath(Path classpath)
The classpath to use when looking up a resource. |
void |
setClasspathRef(Reference r)
the classpath to use when looking up a resource, given as reference to a <path> defined elsewhere |
void |
setEnvironment(java.lang.String env)
the prefix to use when retrieving environment variables. |
void |
setFile(java.io.File file)
the filename of a property file to load. |
void |
setLocation(java.io.File location)
Sets the property to the absolute filename of the given file. |
void |
setName(java.lang.String name)
sets the name of the property to set. |
void |
setPrefix(java.lang.String prefix)
Prefix to apply to properties loaded using file
or resource . |
void |
setRefid(Reference ref)
Sets a reference to an Ant datatype declared elsewhere. |
void |
setResource(java.lang.String resource)
the resource name of a property file to load |
void |
setUserProperty(boolean userProperty)
Deprecated. This was never a supported feature and has been deprecated without replacement |
void |
setValue(java.lang.String value)
Sets the value of the property. |
java.lang.String |
toString()
get the value of this property |
Methods inherited from class org.apache.tools.ant.Task |
getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorOutput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName |
Methods inherited from class org.apache.tools.ant.ProjectComponent |
getProject, setProject |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
protected java.lang.String name
protected java.lang.String value
protected java.io.File file
protected java.lang.String resource
protected Path classpath
protected java.lang.String env
protected Reference ref
protected java.lang.String prefix
protected boolean userProperty
Constructor Detail |
public Property()
protected Property(boolean userProperty)
protected Property(boolean userProperty, Project fallback)
Method Detail |
public void setName(java.lang.String name)
name
- property namepublic java.lang.String getName()
public void setLocation(java.io.File location)
location
- path to setpublic void setValue(java.lang.String value)
value
- value to assignpublic java.lang.String getValue()
public void setFile(java.io.File file)
file
- filenamepublic java.io.File getFile()
public void setPrefix(java.lang.String prefix)
file
or resource
.
A "." is appended to the prefix if not specified.
prefix
- prefix stringpublic java.lang.String getPrefix()
public void setRefid(Reference ref)
ref
- referencepublic Reference getRefid()
public void setResource(java.lang.String resource)
resource
- resource on classpathpublic java.lang.String getResource()
public void setEnvironment(java.lang.String env)
Note that if you supply a property name with a final
"." it will not be doubled. ie environment="myenv." will still
allow access of environment variables through "myenv.PATH" and
"myenv.TERM". This functionality is currently only implemented
on select platforms. Feel free to send patches to increase the number of platforms
this functionality is supported on ;).
Note also that properties are case sensitive, even if the
environment variables on your operating system are not, e.g. it
will be ${env.Path} not ${env.PATH} on Windows 2000.
env
- prefixpublic java.lang.String getEnvironment()
public void setClasspath(Path classpath)
classpath
- to add to any existing classpathpublic Path createClasspath()
public void setClasspathRef(Reference r)
public Path getClasspath()
public void setUserProperty(boolean userProperty)
public java.lang.String toString()
toString
in class java.lang.Object
public void execute() throws BuildException
BuildException
- if something goes wrong with the buildprotected void loadFile(java.io.File file) throws BuildException
file
- file to load
BuildException
protected void loadResource(java.lang.String name)
name
- name of resource to loadprotected void loadEnvironment(java.lang.String prefix)
prefix
- prefix to place before themprotected void addProperties(java.util.Properties props)
protected void addProperty(java.lang.String n, java.lang.String v)
n
- name of propertyv
- value to set
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |