org.jenkinsci.plugins.envinject.service

Class EnvInjectEnvVars

java.lang.Object

org.jenkinsci.plugins.envinject.service.EnvInjectEnvVars

All Implemented Interfaces:

Serializable

public class EnvInjectEnvVars
extends Object
implements Serializable

Author:

Gregory Boissinot

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EnvInjectEnvVars(org.jenkinsci.lib.envinject.EnvInjectLogger logger)

Method Summary

Modifier and Type	Method and Description
Map<String,String>	executeAndGetMapGroovyScript(org.jenkinsci.lib.envinject.EnvInjectLogger logger, String scriptContent, Map<String,String> envVars) Deprecated. use executeGroovyScript(EnvInjectLogger, SecureGroovyScript, Map) instead.
Map<String,String>	executeGroovyScript(org.jenkinsci.lib.envinject.EnvInjectLogger logger, org.jenkinsci.plugins.scriptsecurity.sandbox.groovy.SecureGroovyScript script, Map<String,String> envVars) Executes the SecureGroovyScript and returns a map generated by the script/
int	executeScript(boolean loadFromMaster, String scriptContent, FilePath scriptExecutionRoot, String scriptFilePath, Map<String,String> infraEnvVarsMaster, Map<String,String> infraEnvVarsNode, Launcher launcher, BuildListener listener)
int	executeScript(String scriptContent, FilePath scriptExecutionRoot, String scriptFilePath, Map<String,String> envVars, Launcher launcher, BuildListener listener)
Map<String,String>	getEnvVarsFileProperty(FilePath rootPath, org.jenkinsci.lib.envinject.EnvInjectLogger logger, String propertiesFilePath, Map<String,String> propertiesContent, Map<String,String> currentEnvVars)
Map<String,String>	getEnvVarsPropertiesJobProperty(FilePath rootPath, org.jenkinsci.lib.envinject.EnvInjectLogger logger, boolean loadFilesFromMaster, String propertiesFilePath, Map<String,String> propertiesContent, Map<String,String> infraEnvVarsMaster, Map<String,String> infraEnvVarsNode)
Map<String,String>	getMergedVariables(Map<String,String> infraEnvVars, Map<String,String> propertiesEnvVars)
Map<String,String>	getMergedVariables(Map<String,String> infraEnvVars, Map<String,String> propertiesEnvVars, Map<String,String> groovyMapEnvVars, Map<String,String> contribEnvVars)
Map<String,String>	removeUnsetVars(Map<String,String> envVars)
void	resolveVars(Map<String,String> variables, Map<String,String> env)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EnvInjectEnvVars

public EnvInjectEnvVars(@Nonnull
                        org.jenkinsci.lib.envinject.EnvInjectLogger logger)

Method Detail

getEnvVarsPropertiesJobProperty

public Map<String,String> getEnvVarsPropertiesJobProperty(@Nonnull
                                                          FilePath rootPath,
                                                          @Nonnull
                                                          org.jenkinsci.lib.envinject.EnvInjectLogger logger,
                                                          boolean loadFilesFromMaster,
                                                          @CheckForNull
                                                          String propertiesFilePath,
                                                          @CheckForNull
                                                          Map<String,String> propertiesContent,
                                                          @Nonnull
                                                          Map<String,String> infraEnvVarsMaster,
                                                          @Nonnull
                                                          Map<String,String> infraEnvVarsNode)
                                                   throws org.jenkinsci.lib.envinject.EnvInjectException

Throws:

org.jenkinsci.lib.envinject.EnvInjectException

getEnvVarsFileProperty

@Nonnull
public Map<String,String> getEnvVarsFileProperty(@Nonnull
                                                           FilePath rootPath,
                                                           @Nonnull
                                                           org.jenkinsci.lib.envinject.EnvInjectLogger logger,
                                                           @CheckForNull
                                                           String propertiesFilePath,
                                                           @CheckForNull
                                                           Map<String,String> propertiesContent,
                                                           @Nonnull
                                                           Map<String,String> currentEnvVars)
                                                    throws org.jenkinsci.lib.envinject.EnvInjectException

Throws:

org.jenkinsci.lib.envinject.EnvInjectException

executeScript

public int executeScript(boolean loadFromMaster,
                         @CheckForNull
                         String scriptContent,
                         @CheckForNull
                         FilePath scriptExecutionRoot,
                         @CheckForNull
                         String scriptFilePath,
                         @Nonnull
                         Map<String,String> infraEnvVarsMaster,
                         @Nonnull
                         Map<String,String> infraEnvVarsNode,
                         @Nonnull
                         Launcher launcher,
                         @Nonnull
                         BuildListener listener)
                  throws org.jenkinsci.lib.envinject.EnvInjectException

Throws:

org.jenkinsci.lib.envinject.EnvInjectException

executeAndGetMapGroovyScript

@Deprecated
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @RestrictedSince(value="2.0")
public Map<String,String> executeAndGetMapGroovyScript(@Nonnull
                                                                                                                                                                             org.jenkinsci.lib.envinject.EnvInjectLogger logger,
                                                                                                                                                                             @CheckForNull
                                                                                                                                                                             String scriptContent,
                                                                                                                                                                             @Nonnull
                                                                                                                                                                             Map<String,String> envVars)
                                                                                                                                                                      throws org.jenkinsci.lib.envinject.EnvInjectException,
                                                                                                                                                                             AbortException

Deprecated. use executeGroovyScript(EnvInjectLogger, SecureGroovyScript, Map) instead.

Executes a groovy script and returns the result as a map. The script will be executed in a SecureGroovyScript without the sandbox, so chances are low that it will succeed unless an exact copy has already been approved.

Parameters:

logger - the logger

scriptContent - the script

envVars - variables to bind to the script

Returns:

the result as a map

Throws:

org.jenkinsci.lib.envinject.EnvInjectException - if so

AbortException - if so

Since:

1.38 - Initial implementation, 2.0 - Uses Secure Groovy Script. It will require approvals for non-admin users It is also restricted.

See Also:

executeGroovyScript(EnvInjectLogger, SecureGroovyScript, Map)

executeGroovyScript

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Map<String,String> executeGroovyScript(@Nonnull
                                                                                                                                 org.jenkinsci.lib.envinject.EnvInjectLogger logger,
                                                                                                                                 @CheckForNull
                                                                                                                                 org.jenkinsci.plugins.scriptsecurity.sandbox.groovy.SecureGroovyScript script,
                                                                                                                                 @Nonnull
                                                                                                                                 Map<String,String> envVars)
                                                                                                                          throws org.jenkinsci.lib.envinject.EnvInjectException,
                                                                                                                                 AbortException

Executes the SecureGroovyScript and returns a map generated by the script/

Parameters:

logger - a logger

script - the script

envVars - any variables to bind to the script's context

Returns:

the map

Throws:

org.jenkinsci.lib.envinject.EnvInjectException - for any exceptions generated by the script execution

AbortException - if something is badly wrong.

Since:

2.0

executeScript

public int executeScript(@CheckForNull
                         String scriptContent,
                         @CheckForNull
                         FilePath scriptExecutionRoot,
                         @CheckForNull
                         String scriptFilePath,
                         @Nonnull
                         Map<String,String> envVars,
                         @Nonnull
                         Launcher launcher,
                         @Nonnull
                         BuildListener listener)
                  throws org.jenkinsci.lib.envinject.EnvInjectException

Throws:

org.jenkinsci.lib.envinject.EnvInjectException

getMergedVariables

@Nonnull
public Map<String,String> getMergedVariables(@Nonnull
                                                       Map<String,String> infraEnvVars,
                                                       @Nonnull
                                                       Map<String,String> propertiesEnvVars)

getMergedVariables

@Nonnull
public Map<String,String> getMergedVariables(@Nonnull
                                                       Map<String,String> infraEnvVars,
                                                       @Nonnull
                                                       Map<String,String> propertiesEnvVars,
                                                       @Nonnull
                                                       Map<String,String> groovyMapEnvVars,
                                                       @Nonnull
                                                       Map<String,String> contribEnvVars)

resolveVars

public void resolveVars(@Nonnull
                        Map<String,String> variables,
                        @Nonnull
                        Map<String,String> env)

removeUnsetVars

@Nonnull
public Map<String,String> removeUnsetVars(@Nonnull
                                                    Map<String,String> envVars)