org.netbeans.spi.queries

Interface SharabilityQueryImplementation2

public interface SharabilityQueryImplementation2

Determine whether files should be shared (for example in a VCS) or are intended to be unshared.

Could be implemented e.g. by project types which know that certain files or folders in a project (e.g. src/) are intended for VCS sharing while others (e.g. build/) are not.

Note that the Project API module registers a default implementation of this query which delegates to the project which owns the queried file, if there is one. This is more efficient than searching instances in global lookup, so use that facility wherever possible.

Threading note: implementors should avoid acquiring locks that might be held by other threads. Generally treat this interface similarly to SPIs in org.openide.filesystems with respect to threading semantics.

Since:

1.27

See Also:

SharabilityQuery, AntProjectHelper.createSharabilityQuery(...)

Method Summary

Modifier and Type	Method and Description
SharabilityQuery.Sharability	getSharability(URI uri) Check whether a file or directory should be shared.

Method Detail

getSharability

SharabilityQuery.Sharability getSharability(URI uri)

Check whether a file or directory should be shared. If it is, it ought to be committed to a VCS if the user is using one. If it is not, it is either a disposable build product, or a per-user private file which is important but should not be shared.

Parameters:

uri - a normalized URI to check for sharability (may or may not yet exist).

Returns:

one of the SharabilityQuery.Sharability's constant