Class ThreadBuildContext
java.lang.Object
org.sonatype.plexus.build.incremental.ThreadBuildContext
- All Implemented Interfaces:
BuildContext
BuildContext implementation that delegates actual work to thread-local
build context set using
setThreadBuildContext(BuildContext)
.
DefaultBuildContext
is used if no thread local build context was set.
Note that plexus component metadata is not generated for this implementation.
Apparently, older version of plexus used by maven-filtering and likely
other projects, does not honour "default" role-hint.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final DefaultBuildContext
private static final ThreadLocal
Fields inherited from interface org.sonatype.plexus.build.incremental.BuildContext
SEVERITY_ERROR, SEVERITY_WARNING
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
Deprecated.Use addMessage with severity=SEVERITY_ERROR insteadvoid
addMessage
(File file, int line, int column, String message, int severity, Throwable cause) Adds a message to the build context.void
addWarning
(File file, int line, int column, String message, Throwable cause) Deprecated.Use addMessage with severity=SEVERITY_WARNING insteadstatic BuildContext
Returns value associated withkey
during previous mojo execution.boolean
Returnstrue
if the file has changed since last build or is not under basedir.boolean
Returnstrue
if file or folder identified byrelpath
has changed since last build.boolean
Returnstrue
if any file or folder identified byrelpaths
has changed since last build.boolean
Returnstrue
if this build context is incremental.boolean
isUptodate
(File target, File source) Returns true, if the target file exists and is uptodate compared to the source file.org.codehaus.plexus.util.Scanner
newDeleteScanner
(File basedir) Returned Scanner scansbasedir
for files and directories deleted since last build.newFileOutputStream
(File file) Returns new OutputStream that writes to thefile
.org.codehaus.plexus.util.Scanner
newScanner
(File basedir) Convenience method, fully equal to newScanner(basedir, false)org.codehaus.plexus.util.Scanner
newScanner
(File basedir, boolean ignoreDelta) Returned Scanner scans files and folders underbasedir
.void
Indicates that the file or folder content has been modified during the build.void
removeMessages
(File file) Removes all messages associated with a file or folder during a previous build.static void
setThreadBuildContext
(BuildContext context) void
Associate specifiedkey
with specifiedvalue
in the build context.
-
Field Details
-
threadContext
-
defaultContext
-
-
Constructor Details
-
ThreadBuildContext
public ThreadBuildContext()
-
-
Method Details
-
getContext
-
setThreadBuildContext
-
hasDelta
Description copied from interface:BuildContext
Returnstrue
if file or folder identified byrelpath
has changed since last build.- Specified by:
hasDelta
in interfaceBuildContext
- Parameters:
relPath
- is path relative to build context basedir
-
hasDelta
Description copied from interface:BuildContext
Returnstrue
if the file has changed since last build or is not under basedir.- Specified by:
hasDelta
in interfaceBuildContext
-
hasDelta
Description copied from interface:BuildContext
Returnstrue
if any file or folder identified byrelpaths
has changed since last build.- Specified by:
hasDelta
in interfaceBuildContext
- Parameters:
relPaths
- Listare paths relative to build context basedir
-
newDeleteScanner
Description copied from interface:BuildContext
Returned Scanner scansbasedir
for files and directories deleted since last build. Returns empty Scanner ifbasedir
is not under this build context basedir.- Specified by:
newDeleteScanner
in interfaceBuildContext
-
newFileOutputStream
Description copied from interface:BuildContext
Returns new OutputStream that writes to thefile
. Files changed using OutputStream returned by this method do not need to be explicitly refreshed usingBuildContext.refresh(File)
. As an optional optimisation, OutputStreams created by incremental build context will attempt to avoid writing to the file if file content has not changed.- Specified by:
newFileOutputStream
in interfaceBuildContext
- Throws:
IOException
-
newScanner
Description copied from interface:BuildContext
Convenience method, fully equal to newScanner(basedir, false)- Specified by:
newScanner
in interfaceBuildContext
-
newScanner
Description copied from interface:BuildContext
Returned Scanner scans files and folders underbasedir
. If this is an incremental build context andignoreDelta
isfalse
, the scanner will only "see" files and folders with content changes since last build. IfignoreDelta
istrue
, the scanner will "see" all files and folders. Please beware that ignoreDelta=false does NOT work reliably for operations that copy resources from source to target locations. Returned Scanner only scans changed source resources and it does not consider changed or deleted target resources. This results in missing or stale target resources. Starting with 0.5.0, recommended way to process resources is to use #newScanner(basedir,true) to locate all source resources andBuildContext.isUptodate(File, File)
to optimized processing of uptodate target resources. Returns empty Scanner ifbasedir
is not under this build context basedir.- Specified by:
newScanner
in interfaceBuildContext
-
refresh
Description copied from interface:BuildContext
Indicates that the file or folder content has been modified during the build.- Specified by:
refresh
in interfaceBuildContext
- See Also:
-
getValue
Description copied from interface:BuildContext
Returns value associated withkey
during previous mojo execution. This method always returnsnull
for non-incremental builds (i.e.,BuildContext.isIncremental()
returnsfalse
) and mojos are expected to fall back to full, non-incremental behaviour.- Specified by:
getValue
in interfaceBuildContext
- See Also:
-
isIncremental
public boolean isIncremental()Description copied from interface:BuildContext
Returnstrue
if this build context is incremental. Scanners created byBuildContext.newScanner(File)
of an incremental build context will ignore files and folders that were not changed since last build. Additionally,BuildContext.newDeleteScanner(File)
will scan files and directories deleted since last build.- Specified by:
isIncremental
in interfaceBuildContext
-
setValue
Description copied from interface:BuildContext
Associate specifiedkey
with specifiedvalue
in the build context. Primary (and the only) purpose of this method is to allow preservation of state needed for proper incremental behaviour between consecutive executions of the same mojo needed to. For example, maven-plugin-plugin:descriptor mojo can store collection of extracted MojoDescritpor during first invocation. Then on each consecutive execution maven-plugin-plugin:descriptor will only need to extract MojoDescriptors for changed files.- Specified by:
setValue
in interfaceBuildContext
- See Also:
-
addMessage
public void addMessage(File file, int line, int column, String message, int severity, Throwable cause) Description copied from interface:BuildContext
Adds a message to the build context. The message is associated with a file and a location inside that file.- Specified by:
addMessage
in interfaceBuildContext
- Parameters:
file
- The file or folder with which the message is associated. Should not be null and it is recommended to be an absolute path.line
- The line number inside the file. Use 1 (not 0) for the first line. Use 0 for unknown/unspecified.column
- The column number inside the file. Use 1 (not 0) for the first column. Use 0 for unknown/unspecified.severity
- The severity of the message: SEVERITY_WARNING or SEVERITY_ERROR.cause
- A Throwable object associated with the message. Can be null.
-
removeMessages
Description copied from interface:BuildContext
Removes all messages associated with a file or folder during a previous build. It does not affect the messages added during the current build.- Specified by:
removeMessages
in interfaceBuildContext
-
addWarning
Deprecated.Use addMessage with severity=SEVERITY_WARNING instead- Specified by:
addWarning
in interfaceBuildContext
-
addError
Deprecated.Use addMessage with severity=SEVERITY_ERROR instead- Specified by:
addError
in interfaceBuildContext
-
isUptodate
Description copied from interface:BuildContext
Returns true, if the target file exists and is uptodate compared to the source file. More specifically, this method returns true when both target and source files exist, do not have changes since last incremental build and the target file was last modified later than the source file. Returns false in all other cases.- Specified by:
isUptodate
in interfaceBuildContext
-