hudson.model
Class FileParameterValue

java.lang.Object
  hudson.model.ParameterValue
      hudson.model.FileParameterValue

All Implemented Interfaces:

Serializable

public class FileParameterValue
extends ParameterValue

ParameterValue for FileParameterDefinition.

Persistence

DiskFileItem is persistable via serialization, (although the data may get very large in XML) so this object as a whole is persistable.

Author:

Kohsuke Kawaguchi

See Also:

Serialized Form

Nested Class Summary

static class

FileParameterValue.FileItemImpl Default implementation from File.

Field Summary

Fields inherited from class hudson.model.ParameterValue

name

Constructor Summary

	FileParameterValue(String name, org.apache.commons.fileupload.FileItem file)
protected	FileParameterValue(String name, org.apache.commons.fileupload.FileItem file, String originalFileName)
	FileParameterValue(String name, File file, String originalFileName)

Method Summary

void	buildEnvVars(AbstractBuild<?,?> build, EnvVars env) Exposes the originalFileName as an environment variable.
BuildWrapper	createBuildWrapper(AbstractBuild<?,?> build) Called at the beginning of a build (but after SCM operations have taken place) to let a ParameterValue contributes a BuildWrapper to the build.
VariableResolver<String>	createVariableResolver(AbstractBuild<?,?> build) Returns a VariableResolver so that other components like Builders can perform variable substitution to reflect parameter values into the build process.
void	doDynamic(org.kohsuke.stapler.StaplerRequest request, org.kohsuke.stapler.StaplerResponse response) Serve this file parameter in response to a StaplerRequest.
boolean	equals(Object obj) In practice this will always be false, since location should be unique.
org.apache.commons.fileupload.FileItem	getFile()
String	getLocation()
String	getOriginalFileName() Get the name of the originally uploaded file.
String	getShortDescription() Computes a human-readable possible-localized one-line description of the parameter value.
int	hashCode()
protected void	setLocation(String location)
String	toString()

Methods inherited from class hudson.model.ParameterValue

buildEnvVars, getAssignedLabel, getDefinition, getDescription, getName, isSensitive, setDescription

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

FileParameterValue

@DataBoundConstructor
public FileParameterValue(String name,
                                               org.apache.commons.fileupload.FileItem file)

FileParameterValue

public FileParameterValue(String name,
                          File file,
                          String originalFileName)

FileParameterValue

protected FileParameterValue(String name,
                             org.apache.commons.fileupload.FileItem file,
                             String originalFileName)

Method Detail

setLocation

protected void setLocation(String location)

getLocation

public String getLocation()

buildEnvVars

public void buildEnvVars(AbstractBuild<?,?> build,
                         EnvVars env)

Exposes the originalFileName as an environment variable.

Overrides:

buildEnvVars in class ParameterValue

Parameters:

build - The build for which this parameter is being used. Never null.

env - never null.

createVariableResolver

public VariableResolver<String> createVariableResolver(AbstractBuild<?,?> build)

Description copied from class: ParameterValue

Returns a VariableResolver so that other components like Builders can perform variable substitution to reflect parameter values into the build process. ParameterValue can influence a build.

Overrides:

createVariableResolver in class ParameterValue

Parameters:

build - The build for which this parameter is being used. Never null.

Returns:

if the parameter value is not interested in participating to the variable replacement process, return VariableResolver.NONE.

getOriginalFileName

public String getOriginalFileName()

Get the name of the originally uploaded file. If this FileParameterValue was created prior to 1.362, this method will return null.

Returns:

the name of the originally uploaded file

getFile

public org.apache.commons.fileupload.FileItem getFile()

createBuildWrapper

public BuildWrapper createBuildWrapper(AbstractBuild<?,?> build)

Description copied from class: ParameterValue

Called at the beginning of a build (but after SCM operations have taken place) to let a ParameterValue contributes a BuildWrapper to the build.

This provides a means for a parameter to perform more extensive set up / tear down during a build.

Overrides:

createBuildWrapper in class ParameterValue

Parameters:

build - The build for which this parameter is being used. Never null.

Returns:

null if the parameter has no BuildWrapper to contribute to.

hashCode

public int hashCode()

Overrides:

hashCode in class ParameterValue

equals

public boolean equals(Object obj)

In practice this will always be false, since location should be unique.

Overrides:

equals in class ParameterValue

toString

public String toString()

Overrides:

toString in class Object

getShortDescription

public String getShortDescription()

Description copied from class: ParameterValue

Computes a human-readable possible-localized one-line description of the parameter value.

This message is used as a tooltip to describe jobs in the queue. The text should be one line without new line. No HTML allowed (the caller will perform necessary HTML escapes, so any text can be returend.)

Overrides:

getShortDescription in class ParameterValue

doDynamic

public void doDynamic(org.kohsuke.stapler.StaplerRequest request,
                      org.kohsuke.stapler.StaplerResponse response)
               throws javax.servlet.ServletException,
                      IOException

Serve this file parameter in response to a StaplerRequest.

Parameters:

request -

response -

Throws:

javax.servlet.ServletException

IOException