Java Doc for AntProjectHelper.java in  » IDE-Netbeans » project.ant » org » netbeans » spi » project » support » ant » Java Source Code / Java DocumentationJava Source Code and Java Documentation

The project directory itself is automatically included in the list of sharable directories so you need not explicitly specify it. Similarly, the nbproject/private subdirectory is automatically excluded from VCS, so you do not need to explicitly specify it.

Any file (or directory) mentioned (explicitly or implicity) in the source directory list but not in any of the build directory lists, and not containing any build directories inside it, will be given as sharable.

Acquires write access from ProjectManager.mutex .

Acquires write access from ProjectManager.mutex .

Thread-safe.
Parameters:
  listener - a listener to add

It is intended to be placed in org.netbeans.api.project.Project.getLookup .

It will return status objects for any files in the project matching a source glob pattern - this must include exactly one asterisk (*) representing a variable portion of a source file path (always slash-separated and relative to the project directory) and may include some Ant property references which will be resolved as per the property evaluator. A file is considered out of date if there is no file represented by the matching target pattern (which has the same format), or the target file is older than the source file, or the source file is modified as per org.openide.loaders.DataObject.isModified . An attempt is made to fire changes from the status object whenever the result should change from one call to the next.

The (evaluated) source and target patterns may be relative, resolved against the project directory (perhaps going outside it), or absolute.

The project directory itself is automatically included in the list of sharable directories so you need not explicitly specify it. Similarly, the nbproject/private subdirectory is automatically excluded from VCS, so you do not need to explicitly specify it.

Any file (or directory) mentioned (explicitly or implicity) in the source directory list but not in any of the build directory lists, and not containing any build directories inside it, will be given as sharable. If a directory itself is sharable but some directory inside it is not, it will be given as mixed. A file or directory inside some build directory will be listed as not sharable. A file or directory matching neither the source list nor the build directory list will be treated as of unknown status, but in practice such a file should never have been passed to this implementation anyway - org.netbeans.api.queries.SharabilityQuery will normally only call an implementation in project lookup if the file is owned by that project.

Each entry in either list should be a string evaluated first for Ant property escapes (if any), then treated as a file path relative to the project directory (or it may be absolute).

It is permitted, and harmless, to include items that overlap others. For example, you can have both a directory and one of its children in the include list.

Whether or not you use this method, all files named *-private.properties outside the project are marked unsharable, as are such files inside the project if currently referenced as project libraries. (See AntProjectHelper.getProjectLibrariesPropertyProvider .)

 helper.createSharabilityQuery(helper.getStandardPropertyEvaluator(),
 new String[] {"${src.dir}", "${test.src.dir}"},
 new String[] {"${build.dir}", "${dist.dir}"})
 

Acquires write access from ProjectManager.mutex . However, you are well advised to explicitly enclose a complete operation within write access, starting with AntProjectHelper.getPrimaryConfigurationData , to prevent race conditions.
Parameters:
  data - the desired new configuration data
Parameters:
  shared - if true, refers to project.xml, else refers toprivate.xml
throws:
  IllegalArgumentException - if the element is not correctly named

Acquires write access from ProjectManager.mutex . However, you are well advised to explicitly enclose a complete operation within write access, starting with AntProjectHelper.getProperties , to prevent race conditions.
Parameters:
  path - a relative URI in the project directory, e.g.AntProjectHelper.PROJECT_PROPERTIES_PATH or AntProjectHelper.PRIVATE_PROPERTIES_PATH
Parameters:
  props - a set of properties to store, or null to delete any existing properties file there

Thread-safe.
Parameters:
  listener - a listener to remove