Package org.apache.maven.it
Class Verifier
java.lang.Object
org.apache.maven.it.Verifier
- Version:
- $Id: Verifier.java 1683864 2015-06-05 20:41:57Z tibordigana $
- Author:
- Jason van Zyl, Brett Porter
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
addCliOption
(String option) void
void
assertArtifactNotPresent
(String org, String name, String version, String ext) void
assertArtifactPresent
(String org, String name, String version, String ext) void
assertFileMatches
(String file, String regex) Check that given file's content matches an regular expression.void
assertFileNotPresent
(String file) void
assertFilePresent
(String file) void
deleteArtifact
(String org, String name, String version, String ext) void
deleteArtifacts
(String gid) Deletes all artifacts in the specified group id from the local repository.void
deleteArtifacts
(String gid, String aid, String version) Deletes all artifacts in the specified g:a:v from the local repository.void
deleteDirectory
(String path) Deletes the specified directory.void
void
executeGoal
(String goal) void
executeGoal
(String goal, Map<String, String> envVars) void
executeGoals
(List<String> goals) void
void
executeHook
(String filename) filterFile
(String srcPath, String dstPath, String fileEncoding, Map<String, String> filterProperties) Filters a text file by replacing some user-defined tokens.filterFile
(String srcPath, String dstPath, String fileEncoding, Properties filterProperties) Deprecated.getArtifactFileNameList
(String org, String name, String version, String ext) getArtifactMetadataPath
(String gid, String aid) Gets the path to the local artifact metadata.getArtifactMetadataPath
(String gid, String aid, String version) Gets the path to the local artifact metadata.getArtifactMetadataPath
(String gid, String aid, String version, String filename) Gets the path to a file in the local artifact directory.getArtifactPath
(String org, String name, String version, String ext) Returns the absolute path to the artifact denoted by groupId, artifactId, version, extension and classifier.Gets the name of the file used to log build output.boolean
boolean
boolean
static void
launchSubversion
(String line, String basedir) Loads the (non-empty) lines of the specified text file.loadProperties
(String filename) static void
Gets a new copy of the default filter properties.void
void
setAutoclean
(boolean autoclean) void
setCliOptions
(List<String> cliOptions) void
setDebug
(boolean debug) void
setDebugJvm
(boolean debugJvm) void
setEnvironmentVariable
(String key, String value) void
setEnvironmentVariables
(Map<String, String> environmentVariables) void
setForkJvm
(boolean forkJvm) void
setLocalRepo
(String localRepo) void
setLocalRepoLayout
(String localRepoLayout) void
setLogFileName
(String logFileName) Sets the name of the file used to log build output.void
setMavenDebug
(boolean mavenDebug) void
setSystemProperties
(Properties systemProperties) void
setSystemProperty
(String key, String value) void
setVerifierProperties
(Properties verifierProperties) void
verify
(boolean chokeOnErrorOutput) void
void
verifyTextInLog
(String text) Throws an exception if the text is not present in the log.void
Writes a text file with the specified contents.
-
Constructor Details
-
Verifier
- Throws:
VerificationException
-
Verifier
- Throws:
VerificationException
-
Verifier
- Throws:
VerificationException
-
Verifier
- Throws:
VerificationException
-
Verifier
public Verifier(String basedir, String settingsFile, boolean debug, String[] defaultCliOptions) throws VerificationException - Throws:
VerificationException
-
Verifier
public Verifier(String basedir, String settingsFile, boolean debug, boolean forkJvm) throws VerificationException - Throws:
VerificationException
-
Verifier
public Verifier(String basedir, String settingsFile, boolean debug, boolean forkJvm, String[] defaultCliOptions) throws VerificationException - Throws:
VerificationException
-
-
Method Details
-
setLocalRepo
-
resetStreams
public void resetStreams() -
displayStreamBuffers
public void displayStreamBuffers() -
verify
- Throws:
VerificationException
-
verifyErrorFreeLog
- Throws:
VerificationException
-
verifyTextInLog
Throws an exception if the text is not present in the log.- Parameters:
text
- the text to assert present- Throws:
VerificationException
-
loadProperties
- Throws:
VerificationException
-
loadLines
Loads the (non-empty) lines of the specified text file.- Parameters:
filename
- The path to the text file to load, relative to the base directory, must not benull
.encoding
- The character encoding of the file, may benull
or empty to use the platform default encoding.- Returns:
- The list of (non-empty) lines from the text file, can be empty but never
null
. - Throws:
IOException
- If the file could not be loaded.- Since:
- 1.2
-
loadFile
public List<String> loadFile(String basedir, String filename, boolean hasCommand) throws VerificationException - Throws:
VerificationException
-
loadFile
- Throws:
VerificationException
-
getArtifactPath
-
getArtifactPath
public String getArtifactPath(String gid, String aid, String version, String ext, String classifier) Returns the absolute path to the artifact denoted by groupId, artifactId, version, extension and classifier.- Parameters:
gid
- The groupId, must not be null.aid
- The artifactId, must not be null.version
- The version, must not be null.ext
- The extension, must not be null.classifier
- The classifier, may be null to be omitted.- Returns:
- the absolute path to the artifact denoted by groupId, artifactId, version, extension and classifier, never null.
-
getArtifactFileNameList
-
getArtifactMetadataPath
Gets the path to the local artifact metadata. Note that the method does not check whether the returned path actually points to existing metadata.- Parameters:
gid
- The group id, must not benull
.aid
- The artifact id, must not benull
.version
- The artifact version, may benull
.- Returns:
- The (absolute) path to the local artifact metadata, never
null
.
-
getArtifactMetadataPath
Gets the path to a file in the local artifact directory. Note that the method does not check whether the returned path actually points to an existing file.- Parameters:
gid
- The group id, must not benull
.aid
- The artifact id, may benull
.version
- The artifact version, may benull
.filename
- The filename to use, must not benull
.- Returns:
- The (absolute) path to the local artifact metadata, never
null
.
-
getArtifactMetadataPath
Gets the path to the local artifact metadata. Note that the method does not check whether the returned path actually points to existing metadata.- Parameters:
gid
- The group id, must not benull
.aid
- The artifact id, must not benull
.- Returns:
- The (absolute) path to the local artifact metadata, never
null
.
-
executeHook
- Throws:
VerificationException
-
launchSubversion
- Throws:
VerificationException
-
deleteArtifact
- Throws:
IOException
-
deleteArtifacts
Deletes all artifacts in the specified group id from the local repository.- Parameters:
gid
- The group id whose artifacts should be deleted, must not benull
.- Throws:
IOException
- If the artifacts could not be deleted.- Since:
- 1.2
-
deleteArtifacts
Deletes all artifacts in the specified g:a:v from the local repository.- Parameters:
gid
- The group id whose artifacts should be deleted, must not benull
.aid
- The artifact id whose artifacts should be deleted, must not benull
.version
- The (base) version whose artifacts should be deleted, must not benull
.- Throws:
IOException
- If the artifacts could not be deleted.- Since:
- 1.3
-
deleteDirectory
Deletes the specified directory.- Parameters:
path
- The path to the directory to delete, relative to the base directory, must not benull
.- Throws:
IOException
- If the directory could not be deleted.- Since:
- 1.2
-
writeFile
Writes a text file with the specified contents. The contents will be encoded using UTF-8.- Parameters:
path
- The path to the file, relative to the base directory, must not benull
.contents
- The contents to write, must not benull
.- Throws:
IOException
- If the file could not be written.- Since:
- 1.2
-
filterFile
public File filterFile(String srcPath, String dstPath, String fileEncoding, Map<String, String> filterProperties) throws IOExceptionFilters a text file by replacing some user-defined tokens.- Parameters:
srcPath
- The path to the input file, relative to the base directory, must not benull
.dstPath
- The path to the output file, relative to the base directory and possibly equal to the input file, must not benull
.fileEncoding
- The file encoding to use, may benull
or empty to use the platform's default encoding.filterProperties
- The mapping from tokens to replacement values, must not benull
.- Returns:
- The path to the filtered output file, never
null
. - Throws:
IOException
- If the file could not be filtered.- Since:
- 1.2
-
filterFile
public File filterFile(String srcPath, String dstPath, String fileEncoding, Properties filterProperties) throws IOException Deprecated.There are 226 references to this method in Maven core ITs. In most (all?) cases it is used together withnewDefaultFilterProperties()
. Need to remove both methods and update all clients eventually/- Throws:
IOException
-
newDefaultFilterProperties
Gets a new copy of the default filter properties. These default filter properties map the tokens "@basedir@" and "@baseurl@" to the test's base directory and its basefile:
URL, respectively.- Returns:
- The (modifiable) map with the default filter properties, never
null
. - Since:
- 1.2
-
assertFilePresent
-
assertFileMatches
Check that given file's content matches an regular expression. Note this method also checks that the file exists and is readable.- Parameters:
file
- the file to check.regex
- a regular expression.- See Also:
-
assertFileNotPresent
-
assertArtifactPresent
-
assertArtifactNotPresent
-
executeGoal
- Throws:
VerificationException
-
executeGoal
- Throws:
VerificationException
-
executeGoals
- Throws:
VerificationException
-
getExecutable
-
executeGoals
public void executeGoals(List<String> goals, Map<String, String> envVars) throws VerificationException- Throws:
VerificationException
-
getMavenVersion
- Throws:
VerificationException
-
main
- Throws:
VerificationException
-
assertArtifactContents
public void assertArtifactContents(String org, String artifact, String version, String type, String contents) throws IOException - Throws:
IOException
-
getCliOptions
-
setCliOptions
-
addCliOption
-
getSystemProperties
-
setSystemProperties
-
setSystemProperty
-
getEnvironmentVariables
-
setEnvironmentVariables
-
setEnvironmentVariable
-
getVerifierProperties
-
setVerifierProperties
-
isAutoclean
public boolean isAutoclean() -
setAutoclean
public void setAutoclean(boolean autoclean) -
getBasedir
-
getLogFileName
Gets the name of the file used to log build output.- Returns:
- The name of the log file, relative to the base directory, never
null
. - Since:
- 1.2
-
setLogFileName
Sets the name of the file used to log build output.- Parameters:
logFileName
- The name of the log file, relative to the base directory, must not be empty ornull
.- Since:
- 1.2
-
setDebug
public void setDebug(boolean debug) -
isMavenDebug
public boolean isMavenDebug() -
setMavenDebug
public void setMavenDebug(boolean mavenDebug) -
setForkJvm
public void setForkJvm(boolean forkJvm) -
isDebugJvm
public boolean isDebugJvm() -
setDebugJvm
public void setDebugJvm(boolean debugJvm) -
getLocalRepoLayout
-
setLocalRepoLayout
-
getLocalRepository
-
filterFile(String, String, String, Map)