org.apache.cocoon.forms.formmodel
Class Upload

java.lang.Object
  org.apache.cocoon.forms.formmodel.AbstractWidget
      org.apache.cocoon.forms.formmodel.Upload

All Implemented Interfaces:

ValueChangedListenerEnabled, Widget, ValidationErrorAware, Locatable

public class Upload
extends AbstractWidget
implements ValidationErrorAware, ValueChangedListenerEnabled

A file-uploading Widget. This widget gives access via Cocoon Forms, to Cocoon's file upload functionality.

This widget accepts value-changed listeners, but the event raised does not hold the previous value, as uploads are heavyweight resources that must be released as soon as possible.

Version:

$Id: Upload.html 1304258 2012-03-23 10:09:27Z ilgrosso $

Field Summary

Fields inherited from class org.apache.cocoon.forms.formmodel.AbstractWidget

wasValid

Fields inherited from interface org.apache.cocoon.forms.formmodel.Widget

PATH_SEPARATOR

Constructor Summary

Upload(UploadDefinition uploadDefinition)

Method Summary

void	addValueChangedListener(ValueChangedListener listener) Adds a ValueChangedListener to this widget instance.
void	broadcastEvent(WidgetEvent event) Broadcast an event previously queued by this widget to its event listeners.
void	generateItemSaxFragment(ContentHandler contentHandler, Locale locale) Generates nested additional content nested inside the main element for this widget which is generated by AbstractWidget.generateSaxFragment(ContentHandler, Locale) The implementation on the AbstractWidget level inserts no additional XML.
WidgetDefinition	getDefinition() Concrete subclasses should allow access to their underlaying Definition through this method.
UploadDefinition	getUploadDefinition()
ValidationError	getValidationError() Returns the validation error, if any.
Object	getValue() Get the value of a widget.
AttributesImpl	getXMLElementAttributes() Adds attributes @required, @mime-types
String	getXMLElementName() The XML element name used in AbstractWidget.generateSaxFragment(ContentHandler, Locale) to produce the wrapping element for all the XML-instance-content of this Widget.
boolean	hasValueChangedListeners()
void	readFromRequest(FormContext formContext) Lets this widget read its data from a request.
void	removeValueChangedListener(ValueChangedListener listener)
void	setValidationError(ValidationError error) Set a validation error on this field.
void	setValue(Object object) Sets the value of this widget.
boolean	validate() Validates this widget and returns the outcome.

Methods inherited from class org.apache.cocoon.forms.formmodel.AbstractWidget

addValidator, generateDisplayData, generateLabel, generateSaxFragment, getAttribute, getChild, getCombinedState, getForm, getFullName, getId, getLocation, getName, getParent, getRequestParameterName, getState, getWidget, initialize, isRequired, isValid, lookupWidget, removeAttribute, removeValidator, setAttribute, setParent, setState, toString, widgetNameChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

Upload

public Upload(UploadDefinition uploadDefinition)

Method Detail

getDefinition

public WidgetDefinition getDefinition()

Description copied from class: AbstractWidget

Concrete subclasses should allow access to their underlaying Definition through this method. If subclasses decide to return null they should also organize own implementations of AbstractWidget.getId(), AbstractWidget.getLocation(), AbstractWidget.validate(), AbstractWidget.generateLabel(ContentHandler) and AbstractWidget.generateDisplayData(ContentHandler) to avoid NPE's.

Specified by:

getDefinition in interface Widget

Specified by:

getDefinition in class AbstractWidget

Returns:

the widgetDefinition from which this widget was instantiated. (See WidgetDefinition.createInstance())

getUploadDefinition

public UploadDefinition getUploadDefinition()

getValue

public Object getValue()

Description copied from interface: Widget

Get the value of a widget.

Not all widgets do have a value (notably ContainerWidgets, but this method is provided here as a convenience to ease writing and avoiding casts.

Specified by:

getValue in interface Widget

Overrides:

getValue in class AbstractWidget

Returns:

the value of the widget.

setValue

public void setValue(Object object)

Description copied from interface: Widget

Sets the value of this widget.

Not all widgets do have a value (notably ContainerWidgets, but this method is provided here as a convenience to ease writing and avoiding casts.

Specified by:

setValue in interface Widget

Overrides:

setValue in class AbstractWidget

Parameters:

object - the new widget's value.

readFromRequest

public void readFromRequest(FormContext formContext)

Description copied from interface: Widget

Lets this widget read its data from a request. At this point the Widget may try to convert the request parameter to its native datatype (if it is not a string), but it should not yet generate any validation errors.

Specified by:

readFromRequest in interface Widget

validate

public boolean validate()

Description copied from interface: Widget

Validates this widget and returns the outcome. Possible error messages are remembered by the widget itself and will be part of the XML produced by this widget in its Widget.generateSaxFragment(ContentHandler, Locale) method.

Specified by:

validate in interface Widget

Overrides:

validate in class AbstractWidget

Returns:

true to indicate all validations were ok, false otherwise

See Also:

Widget.validate()

getValidationError

public ValidationError getValidationError()

Returns the validation error, if any. There will always be a validation error in case the validate() method returned false.

Specified by:

getValidationError in interface ValidationErrorAware

setValidationError

public void setValidationError(ValidationError error)

Set a validation error on this field. This allows fields to be externally marked as invalid by application logic.

Specified by:

setValidationError in interface ValidationErrorAware

Parameters:

error - the validation error

addValueChangedListener

public void addValueChangedListener(ValueChangedListener listener)

Adds a ValueChangedListener to this widget instance. Listeners defined on the widget instance will be executed in addtion to any listeners that might have been defined in the widget definition.

Specified by:

addValueChangedListener in interface ValueChangedListenerEnabled

removeValueChangedListener

public void removeValueChangedListener(ValueChangedListener listener)

Specified by:

removeValueChangedListener in interface ValueChangedListenerEnabled

hasValueChangedListeners

public boolean hasValueChangedListeners()

Specified by:

hasValueChangedListeners in interface ValueChangedListenerEnabled

broadcastEvent

public void broadcastEvent(WidgetEvent event)

Description copied from class: AbstractWidget

Broadcast an event previously queued by this widget to its event listeners. Abstract implementation throws a UnsupportedOperationException. Concrete subclass widgets need to override when supporting event broadcasting.

Specified by:

broadcastEvent in interface Widget

Overrides:

broadcastEvent in class AbstractWidget

getXMLElementName

public String getXMLElementName()

Description copied from class: AbstractWidget

The XML element name used in AbstractWidget.generateSaxFragment(ContentHandler, Locale) to produce the wrapping element for all the XML-instance-content of this Widget.

Specified by:

getXMLElementName in class AbstractWidget

Returns:

"upload"

getXMLElementAttributes

public AttributesImpl getXMLElementAttributes()

Adds attributes @required, @mime-types

Overrides:

getXMLElementAttributes in class AbstractWidget

Returns:

the attributes for the main element for this widget's sax-fragment.

generateItemSaxFragment

public void generateItemSaxFragment(ContentHandler contentHandler,
                                    Locale locale)
                             throws SAXException

Description copied from class: AbstractWidget

Generates nested additional content nested inside the main element for this widget which is generated by AbstractWidget.generateSaxFragment(ContentHandler, Locale) The implementation on the AbstractWidget level inserts no additional XML. Subclasses need to override to insert widget specific content.

Overrides:

generateItemSaxFragment in class AbstractWidget

Parameters:

contentHandler - to send the SAX events to

locale - in which context potential content needs to be put.

Throws:

SAXException