org.hippoecm.frontend.plugins.jquery.upload

Class AbstractFileUploadWidget

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

org.apache.wicket.markup.html.panel.Panel

org.hippoecm.frontend.plugins.jquery.upload.AbstractFileUploadWidget

All Implemented Interfaces:

Serializable, Iterable<org.apache.wicket.Component>, org.apache.wicket.event.IEventSink, org.apache.wicket.event.IEventSource, org.apache.wicket.IConverterLocator, org.apache.wicket.markup.html.IHeaderContributor, org.apache.wicket.request.component.IRequestableComponent, org.apache.wicket.util.IHierarchical<org.apache.wicket.Component>, org.apache.wicket.util.io.IClusterable

Direct Known Subclasses:

FileUploadWidget, SingleFileUploadWidget

public abstract class AbstractFileUploadWidget
extends org.apache.wicket.markup.html.panel.Panel

The abstract file upload widget. When uploading a file, the widget should provide the following events in sequence:

• onBeforeUpload(FileUploadInfo)
• onFileUpload(FileUpload fileUpload)
• onUploadError(FileUploadInfo)
• onAfterUpload(FileItem, FileUploadInfo)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected FileUploadWidgetSettings	settings

Fields inherited from class org.apache.wicket.markup.html.panel.Panel

PANEL

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER

Constructor Summary

Constructors

Constructor and Description
AbstractFileUploadWidget(String id, IPluginConfig pluginConfig, FileUploadValidationService validator)

Method Summary

Modifier and Type	Method and Description
FileUploadWidgetSettings	getSettings()
String	getUploadScript()
protected void	onAfterUpload(org.apache.wicket.util.upload.FileItem file, FileUploadInfo fileUploadInfo) The event is fired after the selecting files has been processed and uploaded.
protected void	onBeforeUpload(FileUploadInfo fileUploadInfo) The event is fired before processing the uploaded file.
protected abstract void	onFileUpload(org.apache.wicket.markup.html.form.upload.FileUpload fileUpload) Override this method to handle uploading files
protected void	onFinished() Deprecated. This method has been replaced by onFinished(AjaxRequestTarget, int, boolean) since version 3.2.0
protected void	onFinished(org.apache.wicket.ajax.AjaxRequestTarget target, int numberOfFiles, boolean error) The event is fired after all files has been uploaded.
protected void	onUploadError(FileUploadInfo fileUploadInfo) The event is fired when there is an error during processing uploaded file.
protected void	process(org.apache.wicket.markup.html.form.upload.FileUpload fileUpload) Validate file upload item against the file upload validation service defined in AbstractFileUploadWidget(String, IPluginConfig, FileUploadValidationService) then call onFileUpload(FileUpload)

Methods inherited from class org.apache.wicket.markup.html.panel.Panel

newMarkupSourcingStrategy

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onComponentTagBody, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, canCallListenerInterface, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onDetach, onEvent, onInitialize, onModelChanged, onModelChanging, onReAdd, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

settings

protected final FileUploadWidgetSettings settings

Constructor Detail

AbstractFileUploadWidget

public AbstractFileUploadWidget(String id,
                                IPluginConfig pluginConfig,
                                FileUploadValidationService validator)

Method Detail

getUploadScript

public String getUploadScript()

process

protected void process(org.apache.wicket.markup.html.form.upload.FileUpload fileUpload)
                throws FileUploadViolationException

Validate file upload item against the file upload validation service defined in AbstractFileUploadWidget(String, IPluginConfig, FileUploadValidationService) then call onFileUpload(FileUpload)

Parameters:

fileUpload -

Throws:

FileUploadViolationException

getSettings

public FileUploadWidgetSettings getSettings()

onBeforeUpload

protected void onBeforeUpload(FileUploadInfo fileUploadInfo)

The event is fired before processing the uploaded file.

onFileUpload

protected abstract void onFileUpload(org.apache.wicket.markup.html.form.upload.FileUpload fileUpload)
                              throws FileUploadViolationException

Override this method to handle uploading files

Parameters:

fileUpload -

Throws:

FileUploadViolationException

onUploadError

protected void onUploadError(FileUploadInfo fileUploadInfo)

The event is fired when there is an error during processing uploaded file.

Parameters:

fileUploadInfo -

onAfterUpload

protected void onAfterUpload(org.apache.wicket.util.upload.FileItem file,
                             FileUploadInfo fileUploadInfo)

The event is fired after the selecting files has been processed and uploaded.

onFinished

@Deprecated
protected void onFinished()

Deprecated. This method has been replaced by onFinished(AjaxRequestTarget, int, boolean) since version 3.2.0

onFinished

protected void onFinished(org.apache.wicket.ajax.AjaxRequestTarget target,
                          int numberOfFiles,
                          boolean error)

The event is fired after all files has been uploaded.

Parameters:

target -

numberOfFiles - number of uploaded files

error - true if there is any error in uploading files