com.vaadin.v7.ui

Class Upload

java.lang.Object

com.vaadin.server.AbstractClientConnector

com.vaadin.ui.AbstractComponent

com.vaadin.v7.ui.AbstractLegacyComponent

com.vaadin.v7.ui.Upload

All Implemented Interfaces:

ConnectorEventListener, ContextClickEvent.ContextClickNotifier, MethodEventSource, SerializableEventListener, ClientConnector, Sizeable, VariableOwner, com.vaadin.shared.Connector, Component, Component.Focusable, LegacyComponent, Serializable, EventListener

Deprecated.

As of 8.0 replaced by Upload that is by default in immediate mode.

@Deprecated
public class Upload
extends AbstractLegacyComponent
implements Component.Focusable, LegacyComponent

Component for uploading files from client to server.

The visible component consists of a file name input box and a browse button and an upload submit button to start uploading.

The Upload component needs a java.io.OutputStream to write the uploaded data. You need to implement the Upload.Receiver interface and return the output stream in the receiveUpload() method.

You can get an event regarding starting (StartedEvent), progress (ProgressEvent), and finishing (FinishedEvent) of upload by implementing StartedListener, ProgressListener, and FinishedListener, respectively. The FinishedListener is called for both failed and succeeded uploads. If you wish to separate between these two cases, you can use SucceededListener (SucceededEvenet) and FailedListener (FailedEvent).

The upload component does not itself show upload progress, but you can use the ProgressIndicator for providing progress feedback by implementing ProgressListener and updating the indicator in updateProgress().

Setting upload component immediate initiates the upload as soon as a file is selected, instead of the common pattern of file selection field and upload button.

Note! Because of browser dependent implementations of element, setting size for Upload component is not supported. For some browsers setting size may work to some extend.

Since:

3.0

Author:

Vaadin Ltd.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Upload.ChangeEvent Deprecated.
static interface	Upload.ChangeListener Deprecated.
static class	Upload.FailedEvent Deprecated.
static interface	Upload.FailedListener Deprecated.
static class	Upload.FinishedEvent Deprecated.
static interface	Upload.FinishedListener Deprecated.
static class	Upload.NoInputStreamEvent Deprecated.
static class	Upload.NoOutputStreamEvent Deprecated.
static interface	Upload.ProgressListener Deprecated.
static interface	Upload.Receiver Deprecated.
static class	Upload.StartedEvent Deprecated.
static interface	Upload.StartedListener Deprecated.
static class	Upload.SucceededEvent Deprecated.
static interface	Upload.SucceededListener Deprecated.

Nested classes/interfaces inherited from interface com.vaadin.ui.Component

Component.ErrorEvent, Component.Event, Component.Focusable, Component.Listener

Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector

ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener

Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable

Sizeable.Unit

Field Summary

Fields inherited from class com.vaadin.ui.AbstractComponent

DESIGN_ATTR_PLAIN_TEXT

Fields inherited from interface com.vaadin.server.Sizeable

SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS

Constructor Summary

Constructors

Constructor and Description
Upload() Deprecated. Creates a new instance of Upload.
Upload(String caption, Upload.Receiver uploadReceiver) Deprecated.

Method Summary

Modifier and Type	Method and Description
void	addChangeListener(Upload.ChangeListener listener) Deprecated. Adds a filename change event listener.
void	addFailedListener(Upload.FailedListener listener) Deprecated. Adds the upload interrupted event listener.
void	addFinishedListener(Upload.FinishedListener listener) Deprecated. Adds the upload received event listener.
void	addListener(Upload.FailedListener listener) Deprecated. As of 7.0, replaced by addFailedListener(FailedListener)
void	addListener(Upload.FinishedListener listener) Deprecated. As of 7.0, replaced by addFinishedListener(FinishedListener)
void	addListener(Upload.ProgressListener listener) Deprecated. As of 7.0, replaced by addProgressListener(ProgressListener)
void	addListener(Upload.StartedListener listener) Deprecated. As of 7.0, replaced by addStartedListener(StartedListener)
void	addListener(Upload.SucceededListener listener) Deprecated. As of 7.0, replaced by addSucceededListener(SucceededListener)
void	addProgressListener(Upload.ProgressListener listener) Deprecated. Adds the upload progress event listener.
void	addStartedListener(Upload.StartedListener listener) Deprecated. Adds the upload started event listener.
void	addSucceededListener(Upload.SucceededListener listener) Deprecated. Adds the upload success event listener.
void	changeVariables(Object source, Map<String,Object> variables) Deprecated. Invoked when the value of a variable has changed.
protected void	fireNoInputStream(String filename, String mimeType, long length) Deprecated.
protected void	fireNoOutputStream(String filename, String mimeType, long length) Deprecated.
protected void	fireStarted(String filename, String mimeType) Deprecated. Emit upload received event.
protected void	fireUpdateProgress(long totalBytes, long contentLength) Deprecated. Emits the progress event.
protected void	fireUploadInterrupted(String filename, String mimeType, long length) Deprecated. Emits the upload failed event.
protected void	fireUploadInterrupted(String filename, String mimeType, long length, Exception e) Deprecated.
protected void	fireUploadSuccess(String filename, String mimeType, long length) Deprecated. Emits the upload success event.
void	focus() Deprecated.
String	getButtonCaption() Deprecated.
long	getBytesRead() Deprecated. Gets read bytes of the file currently being uploaded.
Collection<?>	getListeners(Class<?> eventType) Deprecated.
Upload.Receiver	getReceiver() Deprecated. Returns the current receiver.
protected UploadState	getState() Deprecated.
protected StreamVariable	getStreamVariable() Deprecated.
int	getTabIndex() Deprecated. Gets the Tabulator index of this Focusable component.
long	getUploadSize() Deprecated. Returns size of file currently being uploaded.
void	interruptUpload() Deprecated. Interrupts the upload currently being received.
boolean	isImmediate() Deprecated. Returns the immediate mode of the component.
boolean	isUploading() Deprecated.
void	markAsDirty() Deprecated.
void	paintContent(PaintTarget target) Deprecated. Paints the content of this component.
void	removeChangeListener(Upload.ChangeListener listener) Deprecated. Removes a filename change event listener.
void	removeFailedListener(Upload.FailedListener listener) Deprecated. Removes the upload interrupted event listener.
void	removeFinishedListener(Upload.FinishedListener listener) Deprecated. Removes the upload received event listener.
void	removeListener(Upload.FailedListener listener) Deprecated. As of 7.0, replaced by removeFailedListener(FailedListener)
void	removeListener(Upload.FinishedListener listener) Deprecated. As of 7.0, replaced by removeFinishedListener(FinishedListener)
void	removeListener(Upload.ProgressListener listener) Deprecated. As of 7.0, replaced by removeProgressListener(ProgressListener)
void	removeListener(Upload.StartedListener listener) Deprecated. As of 7.0, replaced by removeStartedListener(StartedListener)
void	removeListener(Upload.SucceededListener listener) Deprecated. As of 7.0, replaced by removeSucceededListener(SucceededListener)
void	removeProgressListener(Upload.ProgressListener listener) Deprecated. Removes the upload progress event listener.
void	removeStartedListener(Upload.StartedListener listener) Deprecated. Removes the upload started event listener.
void	removeSucceededListener(Upload.SucceededListener listener) Deprecated. Removes the upload success event listener.
void	setButtonCaption(String buttonCaption) Deprecated. In addition to the actual file chooser, upload components have button that starts actual upload progress.
void	setReceiver(Upload.Receiver receiver) Deprecated. Sets the receiver.
void	setTabIndex(int tabIndex) Deprecated. Sets the Tabulator index of this Focusable component.
void	startUpload() Deprecated. Go into upload state.
void	submitUpload() Deprecated. Forces the upload the send selected file to the server.

Methods inherited from class com.vaadin.v7.ui.AbstractLegacyComponent

beforeClientResponse, getExplicitImmediateValue, getState, isReadOnly, readDesign, setImmediate, setReadOnly, writeDesign

Methods inherited from class com.vaadin.ui.AbstractComponent

addContextClickListener, addListener, addShortcutListener, addStyleName, attach, detach, findAncestor, fireComponentErrorEvent, fireComponentEvent, getActionManager, getCaption, getComponentError, getCustomAttributes, getData, getDebugId, getDescription, getErrorMessage, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getWidth, getWidthUnits, isCaptionAsHtml, isConnectorEnabled, isEnabled, isOrHasAncestor, isRequiredIndicatorVisible, isResponsive, isVisible, removeContextClickListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setCaptionAsHtml, setComponentError, setData, setDebugId, setDescription, setDescription, setEnabled, setHeight, setHeight, setHeightUndefined, setIcon, setId, setLocale, setParent, setPrimaryStyleName, setRequiredIndicatorVisible, setResponsive, setSizeFull, setSizeUndefined, setStyleName, setVisible, setWidth, setWidth, setWidthUndefined

Methods inherited from class com.vaadin.server.AbstractClientConnector

addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addMethodInvocationToQueue, createState, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isThis, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource, updateDiffstate

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.vaadin.server.VariableOwner

isEnabled

Methods inherited from interface com.vaadin.ui.Component

addListener, addStyleName, addStyleNames, attach, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isVisible, readDesign, removeListener, removeStyleName, removeStyleNames, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setStyleName, setStyleName, setVisible, writeDesign

Methods inherited from interface com.vaadin.server.ClientConnector

addAttachListener, addDetachListener, beforeClientResponse, detach, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler

Methods inherited from interface com.vaadin.shared.Connector

getConnectorId

Methods inherited from interface com.vaadin.server.Sizeable

getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthUndefined

Constructor Detail

Upload

public Upload()

Deprecated.

Creates a new instance of Upload. The receiver must be set before performing an upload.

Upload

public Upload(String caption,
              Upload.Receiver uploadReceiver)

Deprecated.

Method Detail

changeVariables

public void changeVariables(Object source,
                            Map<String,Object> variables)

Deprecated.

Invoked when the value of a variable has changed.

Specified by:

changeVariables in interface VariableOwner

See Also:

com.vaadin.ui.AbstractComponent#changeVariables(java.lang.Object, java.util.Map)

paintContent

public void paintContent(PaintTarget target)
                  throws PaintException

Deprecated.

Paints the content of this component.

Specified by:

paintContent in interface LegacyComponent

Parameters:

target - Target to paint the content on.

Throws:

PaintException - if the paint operation failed.

addStartedListener

public void addStartedListener(Upload.StartedListener listener)

Deprecated.

Adds the upload started event listener.

Parameters:

listener - the Listener to be added, not null

addListener

@Deprecated
public void addListener(Upload.StartedListener listener)

Deprecated. As of 7.0, replaced by addStartedListener(StartedListener)

removeStartedListener

public void removeStartedListener(Upload.StartedListener listener)

Deprecated.

Removes the upload started event listener.

Parameters:

listener - the Listener to be removed.

removeListener

@Deprecated
public void removeListener(Upload.StartedListener listener)

Deprecated. As of 7.0, replaced by removeStartedListener(StartedListener)

addFinishedListener

public void addFinishedListener(Upload.FinishedListener listener)

Deprecated.

Adds the upload received event listener.

Parameters:

listener - the Listener to be added, not null

addListener

@Deprecated
public void addListener(Upload.FinishedListener listener)

Deprecated. As of 7.0, replaced by addFinishedListener(FinishedListener)

removeFinishedListener

public void removeFinishedListener(Upload.FinishedListener listener)

Deprecated.

Removes the upload received event listener.

Parameters:

listener - the Listener to be removed.

removeListener

@Deprecated
public void removeListener(Upload.FinishedListener listener)

Deprecated. As of 7.0, replaced by removeFinishedListener(FinishedListener)

addFailedListener

public void addFailedListener(Upload.FailedListener listener)

Deprecated.

Adds the upload interrupted event listener.

Parameters:

listener - the Listener to be added, not null

addListener

@Deprecated
public void addListener(Upload.FailedListener listener)

Deprecated. As of 7.0, replaced by addFailedListener(FailedListener)

removeFailedListener

public void removeFailedListener(Upload.FailedListener listener)

Deprecated.

Removes the upload interrupted event listener.

Parameters:

listener - the Listener to be removed.

removeListener

@Deprecated
public void removeListener(Upload.FailedListener listener)

Deprecated. As of 7.0, replaced by removeFailedListener(FailedListener)

addSucceededListener

public void addSucceededListener(Upload.SucceededListener listener)

Deprecated.

Adds the upload success event listener.

Parameters:

listener - the Listener to be added, not null

addListener

@Deprecated
public void addListener(Upload.SucceededListener listener)

Deprecated. As of 7.0, replaced by addSucceededListener(SucceededListener)

removeSucceededListener

public void removeSucceededListener(Upload.SucceededListener listener)

Deprecated.

Removes the upload success event listener.

Parameters:

listener - the Listener to be removed.

removeListener

@Deprecated
public void removeListener(Upload.SucceededListener listener)

Deprecated. As of 7.0, replaced by removeSucceededListener(SucceededListener)

addProgressListener

public void addProgressListener(Upload.ProgressListener listener)

Deprecated.

Adds the upload progress event listener.

Parameters:

listener - the progress listener to be added

addListener

@Deprecated
public void addListener(Upload.ProgressListener listener)

Deprecated. As of 7.0, replaced by addProgressListener(ProgressListener)

removeProgressListener

public void removeProgressListener(Upload.ProgressListener listener)

Deprecated.

Removes the upload progress event listener.

Parameters:

listener - the progress listener to be removed

addChangeListener

public void addChangeListener(Upload.ChangeListener listener)

Deprecated.

Adds a filename change event listener.

Parameters:

listener - the Listener to add, not null

removeChangeListener

public void removeChangeListener(Upload.ChangeListener listener)

Deprecated.

Removes a filename change event listener.

Parameters:

listener - the listener to be removed

removeListener

@Deprecated
public void removeListener(Upload.ProgressListener listener)

Deprecated. As of 7.0, replaced by removeProgressListener(ProgressListener)

fireStarted

protected void fireStarted(String filename,
                           String mimeType)

Deprecated.

Emit upload received event.

Parameters:

filename -

mimeType -

length -

fireUploadInterrupted

protected void fireUploadInterrupted(String filename,
                                     String mimeType,
                                     long length)

Deprecated.

Emits the upload failed event.

Parameters:

filename -

mimeType -

length -

fireNoInputStream

protected void fireNoInputStream(String filename,
                                 String mimeType,
                                 long length)

Deprecated.

fireNoOutputStream

protected void fireNoOutputStream(String filename,
                                  String mimeType,
                                  long length)

Deprecated.

fireUploadInterrupted

protected void fireUploadInterrupted(String filename,
                                     String mimeType,
                                     long length,
                                     Exception e)

Deprecated.

fireUploadSuccess

protected void fireUploadSuccess(String filename,
                                 String mimeType,
                                 long length)

Deprecated.

Emits the upload success event.

Parameters:

filename -

mimeType -

length -

fireUpdateProgress

protected void fireUpdateProgress(long totalBytes,
                                  long contentLength)

Deprecated.

Emits the progress event.

Parameters:

totalBytes - bytes received so far

contentLength - actual size of the file being uploaded, if known

getReceiver

public Upload.Receiver getReceiver()

Deprecated.

Returns the current receiver.

Returns:

the StreamVariable.

setReceiver

public void setReceiver(Upload.Receiver receiver)

Deprecated.

Sets the receiver.

Parameters:

receiver - the receiver to set.

focus

public void focus()

Deprecated.

Specified by:

focus in interface Component.Focusable

Overrides:

focus in class AbstractComponent

getTabIndex

public int getTabIndex()

Deprecated.

Gets the Tabulator index of this Focusable component.

Specified by:

getTabIndex in interface Component.Focusable

See Also:

Component.Focusable.getTabIndex()

setTabIndex

public void setTabIndex(int tabIndex)

Deprecated.

Sets the Tabulator index of this Focusable component.

Specified by:

setTabIndex in interface Component.Focusable

See Also:

Component.Focusable.setTabIndex(int)

startUpload

public void startUpload()

Deprecated.

Go into upload state. This is to prevent double uploading on same component. Warning: this is an internal method used by the framework and should not be used by user of the Upload component. Using it results in the Upload component going in wrong state and not working. It is currently public because it is used by another class.

interruptUpload

public void interruptUpload()

Deprecated.

Interrupts the upload currently being received. The interruption will be done by the receiving thread so this method will return immediately and the actual interrupt will happen a bit later.

isUploading

public boolean isUploading()

Deprecated.

getBytesRead

public long getBytesRead()

Deprecated.

Gets read bytes of the file currently being uploaded.

Returns:

bytes

getUploadSize

public long getUploadSize()

Deprecated.

Returns size of file currently being uploaded. Value sane only during upload.

Returns:

size in bytes

getButtonCaption

public String getButtonCaption()

Deprecated.

Returns:

String to be rendered into button that fires uploading

setButtonCaption

public void setButtonCaption(String buttonCaption)

Deprecated.

In addition to the actual file chooser, upload components have button that starts actual upload progress. This method is used to set text in that button.

In case the button text is set to null, the button is hidden. In this case developer must explicitly initiate the upload process with submitUpload().

In case the Upload is used in immediate mode using AbstractLegacyComponent.setImmediate(boolean), the file choose (html input with type "file") is hidden and only the button with this text is shown.

Note the string given is set as is to the button. HTML formatting is not stripped. Be sure to properly validate your value according to your needs.

Parameters:

buttonCaption - text for upload components button.

submitUpload

public void submitUpload()

Deprecated.

Forces the upload the send selected file to the server.

In case developer wants to use this feature, he/she will most probably want to hide the uploads internal submit button by setting its caption to null with setButtonCaption(String) method.

Note, that the upload runs asynchronous. Developer should use normal upload listeners to trac the process of upload. If the field is empty uploaded the file name will be empty string and file length 0 in the upload finished event.

Also note, that the developer should not remove or modify the upload in the same user transaction where the upload submit is requested. The upload may safely be hidden or removed once the upload started event is fired.

markAsDirty

public void markAsDirty()

Deprecated.

Specified by:

markAsDirty in interface ClientConnector

Specified by:

markAsDirty in interface LegacyComponent

Overrides:

markAsDirty in class AbstractClientConnector

getStreamVariable

protected StreamVariable getStreamVariable()

Deprecated.

getListeners

public Collection<?> getListeners(Class<?> eventType)

Deprecated.

Overrides:

getListeners in class AbstractClientConnector

isImmediate

public boolean isImmediate()

Deprecated.

Returns the immediate mode of the component.

An immediate mode Upload component displays the browser file choosing button immediately, whereas a non-immediate upload only shows a Vaadin button.

The default mode of an Upload component is non-immediate.

Overrides:

isImmediate in class AbstractLegacyComponent

Returns:

true if the component is in immediate mode, false if the component if not in immediate mode

getState

protected UploadState getState()

Deprecated.

Overrides:

getState in class AbstractLegacyComponent