er.attachment.components
Class ERAttachmentUpload

java.lang.Object
  com.webobjects.appserver.WOElement
      com.webobjects.appserver.WOComponent
          er.attachment.components.ERAttachmentUpload

All Implemented Interfaces:

com.webobjects.appserver.WOActionResults, com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCodingAdditions, com.webobjects.foundation.NSValidation, java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

ERAjaxAttachmentUpload, ERAttachmentFlexibleUpload

public class ERAttachmentUpload
extends com.webobjects.appserver.WOComponent

ERAttachmentUpload provides a very simple wrapper around either a WOFileUpload or an AjaxFileUpload component (depending on the value of the "ajax" binding). When the upload is successfully completed, this component will automatically process the attachment. It is not necessary to use this component -- it's only to make the process slightly easier. If you want to use your own existing file upload setup, in your completion action, you can simply call:

ERAttachment attachment = ERAttachmentProcessor.processorForType(storageType).process(editingContext, fileUploadFinalFilePath, fileUploadFilePath, mimeType, configurationName, ownerID);

Note that for the attachment binding, you do not create the attachment instance and pass it in. The attachment processor inside of ERAttachmentUpload creates an appropriate attachment instance for you (using the editing context you provide) and simply binds it back to you when the upload is complete.

See Also:

Serialized Form

Author:

mschrag

Bindings

attachment	the binding to store the newly created attachment in
editingContext	the editing context to create the attachment in
storageType	the type of attachment to create, i.e. "s3", "db", or "file" -- defaults to "db" (or the value of er.attachment.storageType)
mimeType	(optional) the mime type of the upload (will be guessed by extension if not set)
ajax	(optional) if true, AjaxFileUpload is used, if false WOFileUpload is used
configurationName	(optional) the configuration name for this attachment (see top level documentation)
ownerID	(optional) a string ID of the "owner" of this attachment (Person.primaryKey for instance)
width	(optional) the desired width of the attachment
height	(optional) the desired height of the attachment
others	all AjaxFileUpload bindings are proxied
cleanup	(optional) if true, the old attachment binding value will be deleted
class	(optional) the class attribute of the file input
style	(optional) the style attribute of the file input

Properties

er.attachment.[configurationName].tempFolder	(optional) the temp folder to use for WOFileUploads
er.attachment.tempFolder	(optional) the temp folder to use for WOFileUploads
er.attachment.[configurationName].storageType	er.attachment.[configurationName].storageType
er.attachment.storageType	er.attachment.storageType
er.attachment.[configurationName].width	er.attachment.[configurationName].width
er.attachment.width	er.attachment.width
er.attachment.[configurationName].height	er.attachment.[configurationName].height
er.attachment.height	er.attachment.height

Nested Class Summary

Nested classes/interfaces inherited from class com.webobjects.appserver.WOComponent

com.webobjects.appserver.WOComponent._EventLoggingEnabler, com.webobjects.appserver.WOComponent.Event

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

com.webobjects.foundation.NSKeyValueCodingAdditions.DefaultImplementation, com.webobjects.foundation.NSKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

com.webobjects.foundation.NSKeyValueCoding._BooleanFieldBinding, com.webobjects.foundation.NSKeyValueCoding._BooleanMethodBinding, com.webobjects.foundation.NSKeyValueCoding._FieldBinding, com.webobjects.foundation.NSKeyValueCoding._ForwardingBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding._MethodBinding, com.webobjects.foundation.NSKeyValueCoding._NumberFieldBinding, com.webobjects.foundation.NSKeyValueCoding._NumberMethodBinding, com.webobjects.foundation.NSKeyValueCoding._ReflectionKeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.Null, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSValidation

com.webobjects.foundation.NSValidation._MethodBinding, com.webobjects.foundation.NSValidation._ValidationBinding, com.webobjects.foundation.NSValidation.DefaultImplementation, com.webobjects.foundation.NSValidation.Utility, com.webobjects.foundation.NSValidation.ValidationException

Field Summary

Fields inherited from class com.webobjects.appserver.WOComponent

_Extension, _IsEventLoggingEnabled, _keyAssociations

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding.ErrorHandling

_CLASS

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_CLASS, _KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Fields inherited from interface com.webobjects.foundation.NSValidation

_CLASS

Constructor Summary

ERAttachmentUpload(com.webobjects.appserver.WOContext context)

Method Summary

ERAttachment	_uploadSucceeded()
boolean	ajax()
java.lang.String	filePath()
java.lang.String	finalFilePath()
com.webobjects.appserver.WOActionResults	invokeAction(com.webobjects.appserver.WORequest request, com.webobjects.appserver.WOContext context)
void	setFilePath(java.lang.String filePath)
void	setFinalFilePath(java.lang.String finalFilePath)
boolean	synchronizesVariablesWithBindings()
java.lang.String	tempFilePath()
com.webobjects.appserver.WOActionResults	uploadSucceeded()

Methods inherited from class com.webobjects.appserver.WOComponent

_associationWithName, _awakeInContext, _childTemplate, _componentDefinition, _componentUnroll, _isPage, _setContext, _setIsPage, _setParent, _setSubcomponent, _sleepInContext, _subcomponentForElementWithID, _templateNameForClass, _unroll, appendToResponse, application, awake, baseURL, bindingKeys, canAccessFieldsDirectly, canGetValueForBinding, canSetValueForBinding, clone, context, debugString, descriptionForResponse, ensureAwakeInContext, frameworkName, generateResponse, handleQueryWithUnboundKey, handleTakeValueForUnboundKey, hasBinding, hasSession, isCachingEnabled, isEventLoggingEnabled, isStateless, logString, name, pageWithName, parent, path, pathURL, performParentAction, pullValuesFromParent, pushValuesToParent, reset, session, set_componentUnroll, set_unroll, setCachingEnabled, setValueForBinding, sleep, takeValueForKey, takeValueForKeyPath, takeValuesFromRequest, template, templateWithHTMLString, templateWithName, toString, unableToSetNullForKey, validateTakeValueForKeyPath, validateValueForKey, validationFailedWithException, valueForBinding, valueForKey, valueForKeyPath

Methods inherited from class java.lang.Object

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

Constructor Detail

ERAttachmentUpload

public ERAttachmentUpload(com.webobjects.appserver.WOContext context)

Method Detail

setFilePath

public void setFilePath(java.lang.String filePath)

filePath

public java.lang.String filePath()

setFinalFilePath

public void setFinalFilePath(java.lang.String finalFilePath)

finalFilePath

public java.lang.String finalFilePath()

synchronizesVariablesWithBindings

public boolean synchronizesVariablesWithBindings()

Overrides:

synchronizesVariablesWithBindings in class com.webobjects.appserver.WOComponent

ajax

public boolean ajax()

invokeAction

public com.webobjects.appserver.WOActionResults invokeAction(com.webobjects.appserver.WORequest request,
                                                             com.webobjects.appserver.WOContext context)

Overrides:

invokeAction in class com.webobjects.appserver.WOComponent

tempFilePath

public java.lang.String tempFilePath()
                              throws java.io.IOException

Throws:

java.io.IOException

_uploadSucceeded

public ERAttachment _uploadSucceeded()
                              throws java.io.IOException

Throws:

java.io.IOException

uploadSucceeded

public com.webobjects.appserver.WOActionResults uploadSucceeded()
                                                         throws java.net.MalformedURLException,
                                                                java.io.IOException

Throws:

java.net.MalformedURLException

java.io.IOException