Package org.apache.tools.ant.types
Class PropertySet
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.types.DataType
org.apache.tools.ant.types.PropertySet
- All Implemented Interfaces:
- Cloneable,- Iterable<Resource>,- ResourceCollection
A set of properties.
- Since:
- Ant 1.6
- 
Nested Class SummaryNested ClassesModifier and TypeClassDescriptionstatic classUsed for propertyref's builtin attribute.static classThis is a nested class containing a reference to some properties and optionally a source of properties.
- 
Field SummaryFields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidadd(FileNameMapper fileNameMapper) Add a nested FileNameMapper.voidAdd a property reference (nested element) to the references to be used.voidAdd another property set to this set.voidAllow builtin (all, system or commandline) properties in the set.voidappendName(String name) Allow properties of a particular name in the set.voidappendPrefix(String prefix) Allow properties whose names start with a prefix in the set.voidappendRegex(String regex) Allow properties whose names match a regex in the set.protected final voidEnsures this data type is not a reference.Create a mapper to map the property names.protected voiddieOnCircularReference(Stack<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).booleanGet the dynamic attribute.Get the mapper attribute.This is the operation to get the existing or recalculated properties.protected PropertySetgetRef()Performs the check for circular references and returns the referenced PropertySet.booleanFulfill the ResourceCollection contract.iterator()Fulfill the ResourceCollection interface.voidsetDynamic(boolean dynamic) Set whether to reevaluate the set every time the set is used.voidSet a mapper to change property names.voidsetNegate(boolean negate) Set whether to negate results.final voidSets the value of the refid attribute.intsize()Fulfill the ResourceCollection contract.toString()A debug toString.Methods inherited from class org.apache.tools.ant.types.DataTypecheckAttributesAllowed, checkChildrenAllowed, circularReference, clone, dieOnCircularReference, dieOnCircularReference, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getCheckedRef, getDataTypeName, getRefid, invokeCircularReferenceCheck, isChecked, isReference, noChildrenAllowed, pushAndInvokeCircularReferenceCheck, setChecked, tooManyAttributesMethods inherited from class org.apache.tools.ant.ProjectComponentgetDescription, getLocation, getProject, log, log, setDescription, setLocation, setProjectMethods inherited from class java.lang.Objectequals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface java.lang.IterableforEach, spliteratorMethods inherited from interface org.apache.tools.ant.types.ResourceCollectionisEmpty, stream
- 
Constructor Details- 
PropertySetpublic PropertySet()
 
- 
- 
Method Details- 
appendNameAllow properties of a particular name in the set.- Parameters:
- name- the property name to allow.
 
- 
appendRegexAllow properties whose names match a regex in the set.- Parameters:
- regex- the regular expression to use.
 
- 
appendPrefixAllow properties whose names start with a prefix in the set.- Parameters:
- prefix- the prefix to use.
 
- 
appendBuiltinAllow builtin (all, system or commandline) properties in the set.- Parameters:
- b- the type of builtin properties.
 
- 
setMapper
- 
addPropertyrefAdd a property reference (nested element) to the references to be used.- Parameters:
- ref- a property reference.
 
- 
addPropertysetAdd another property set to this set.- Parameters:
- ref- another property set.
 
- 
createMapperCreate a mapper to map the property names.- Returns:
- a mapper to be configured.
 
- 
addAdd a nested FileNameMapper.- Parameters:
- fileNameMapper- the mapper to add.
- Since:
- Ant 1.6.3
 
- 
setDynamicpublic void setDynamic(boolean dynamic) Set whether to reevaluate the set every time the set is used. Default is true.- Parameters:
- dynamic- if true, reevaluate the property set each time the set is used. if false cache the property set the first time and use the cached set on subsequent occasions.
 
- 
setNegatepublic void setNegate(boolean negate) Set whether to negate results. If "true", all properties not selected by nested elements will be returned. Default is "false".- Parameters:
- negate- if true, negate the selection criteria.
 
- 
getDynamicpublic boolean getDynamic()Get the dynamic attribute.- Returns:
- true if the property set is to be evaluated each time it is used.
 
- 
getMapper
- 
getPropertiesThis is the operation to get the existing or recalculated properties.- Returns:
- the properties for this propertyset.
 
- 
getRefPerforms the check for circular references and returns the referenced PropertySet.- Returns:
- the referenced PropertySet.
 
- 
setRefidSets the value of the refid attribute.- Overrides:
- setRefidin class- DataType
- Parameters:
- r- the reference this datatype should point to.
- Throws:
- BuildException- if another attribute was set, since refid and all other attributes are mutually exclusive.
 
- 
assertNotReferenceprotected final void assertNotReference()Ensures this data type is not a reference.Calling this method as the first line of every bean method of this data type (setXyz, addXyz, createXyz) ensure proper handling of the refid attribute. - Throws:
- BuildException- if the refid attribute was already set, since refid and all other attributes are mutually exclusive.
 
- 
toString
- 
iterator
- 
sizepublic int size()Fulfill the ResourceCollection contract.- Specified by:
- sizein interface- ResourceCollection
- Returns:
- the size of this ResourceCollection.
 
- 
isFilesystemOnlypublic boolean isFilesystemOnly()Fulfill the ResourceCollection contract.- Specified by:
- isFilesystemOnlyin interface- ResourceCollection
- Returns:
- whether this is a filesystem-only resource collection.
 
- 
dieOnCircularReferenceDescription copied from class:DataTypeCheck 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).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 DataType.checkedis true and set it to true on exit.- Overrides:
- dieOnCircularReferencein class- DataType
- Parameters:
- stk- the stack of references to check.
- p- the project to use to dereference the references.
- Throws:
- BuildException- on error.
 
 
-