public final class FileBuiltQuery extends Object
|Modifier and Type||Class and Description|
Result of getting built status for a file.
|Modifier and Type||Method and Description|
Check whether a (source) file has been somehow built or processed.
public static FileBuiltQuery.Status getStatus(FileObject file)
This would typically mean that at least its syntax has been validated by a build system, some conventional output file exists and is at least as new as the source file, etc. For example, for a Foo.java source file, this could check whether Foo.class exists (in the appropriate build directory) with at least as new a timestamp.
Implementation note: the current implementation of this
method does not react to changes in lookup results for
FileBuiltQueryImplementation. For example, if there is initially
no provider for a given file, the return value may be null, and a client
will not be see the change if a provider is later installed dynamically.
Similarly, removal of a provider will not automatically invalidate an
FileBuiltQuery.Status object; and a change in the provider responsible
for a given file will not produce updates in an existing
A future implementation may however be enhanced to return proxy statuses
which react to changes in the provider responsible for the file and always
delegate to the current provider, if there is one.
file- a source file which can be built to a direct product