public class RepositoryFormHandler extends GenericFormHandler implements RepositoryFormData, RepositoryFormConstants
This bean has a repositoryId
property which
determines the repository item being operated on by the form
handler. It also has a value
property which is a
dictionary of properties of the current repository item. For
example, if you want to get or set the "author" property of a
repository item with id "/targetedcontent/Example.html," you would
set repositoryId
to "/targetedcontent/Example.html,"
and reference the item's "author" property in the page as
"FormHandler.value.author."
Note that since the value
property contains the
property values corresponding to the repository item with the
current repository id, setting the repositoryId
property also has the effect of removing all entries from the
value
dictionary. The new entries are then added to
the dictionary as the property values are accessed/set for the new
repository item.
This form handler supports the following submit methods:
repositoryId
property, assigning it the property
values currently in the value
dictionary, and adds
the new item to the repository; if repositoryId
is
not set, the new item is created with an id auto-generated by the
repository, assuming requireIdOnCreate
is set to
false (see below)
repositoryId
property, using the property values
currently in the value
dictionary; the update is
committed in the repository
repositoryId
property from the repository
The following properties of the RepositoryFormHandler will typically be set in a properties file for this component:
The RepositoryFormHandler also has a set of properties that are used to control navigation after a form operation (create, update, delete) has been completed. These properties specify the URLs to redirect on certain error and success conditions. If the value for a particular condition is not set, the form is left on the page defined as the action for that form (i.e. no redirect takes place). Each operation has its own SuccessURL and ErrorURL properties. Thus the following properties are available:
<input type=hidden bean="FormHandler.createSuccessURL" value="main.jhtml">
This form handler also supports the editing of hierarchial properties. In other words properties you can edit properties whose values are themselves other items. To edit the properties of your property, simply specify the names of these properties separated by a "." character. For example, if your item has an address item property, you can set its city sub-property with a tag like:
<input type="text" bean="FormHandler.value.address.city" >If you have the id of an address, perhaps as a property of some bean and you want to update your item so that it refers to that new item, you can change the special repositoryId sub-property of the address as in this construct:
<input type="hidden" bean="FormHandler.value.address.repositoryId" value="bean:SomeBean.addressId">If the addressId does not correspond to a valid address, an error with the message code "noRepositoryId" error is added to the list of errors for this request.
Migration history:
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CLASS_VERSION
Class version string
|
static int |
STATUS_ERROR_REDIRECT
Constant used to indicate that the form has errors, and that the
form should perform a redirect.
|
static int |
STATUS_ERROR_STAY
Constant used to indicate that the form has errors, and that the
form should not perform a redirect.
|
static int |
STATUS_SUCCESS
Constant used to indicate that the form has no errors
|
PARAM_DEFER_FORWARD_OR_REDIRECT, PARAM_USE_FORWARDS
SERVICE_INFO_KEY
NULL_SENTINEL, REPOSITORY_ID_PROPERTY_NAME, RESOURCE_BUNDLE_NAME, UPDATE_APPEND, UPDATE_PREPEND, UPDATE_REMOVE, UPDATE_REPLACE
DEFAULT_LOG_TRACE_STATUS
DEFAULT_LOG_DEBUG_STATUS, DEFAULT_LOG_ERROR_STATUS, DEFAULT_LOG_INFO_STATUS, DEFAULT_LOG_WARNING_STATUS
Constructor and Description |
---|
RepositoryFormHandler() |
Modifier and Type | Method and Description |
---|---|
protected int |
checkFormError(java.lang.String pErrorURL,
DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Check to see if there were errors during the submit operation.
|
protected boolean |
checkFormSuccess(java.lang.String pSuccessURL,
DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
If the form was successfully submitted, redirect after processing
the form data if possible.
|
protected void |
checkForRequiredProperties(RepositoryItem pItem)
Makes sure all the required repository item properties have
values submitted in the form.
|
protected void |
deleteItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Deletes the item given by the current repository id from the
repository.
|
boolean |
getCheckForReadOnlyProperties()
Returns whether or not the form handler should throw an exception
when updating item properties and read only properties are in
the value dictionary.
|
boolean |
getCheckForRequiredProperties()
Returns whether or not the form handler should check that all the
required properties are present during the create/update
operations.
|
protected atg.repository.content.ContentPropertyItemDescriptor |
getContentItemDescriptor()
Obtain the content item descriptor
|
java.lang.String |
getContentNameProperty()
Get the contentNameProperty.
|
java.lang.String |
getContentPathProperty()
Get the contentPathProperty.
|
java.lang.String |
getCreateErrorURL()
Returns the URL to redirect to upon a failed item creation.
|
java.lang.String |
getCreateSuccessURL()
Returns the URL to redirect to upon a successful item creation.
|
java.lang.String |
getDeleteErrorURL()
Returns the URL to redirect to upon a failed item deletion.
|
java.lang.String |
getDeleteSuccessURL()
Returns the URL to redirect to upon a successful item deletion.
|
boolean |
getEditMapsAsLists()
Gets the property EditMapsAsLists.
|
atg.repository.servlet.RepositoryEditorErrorHandler |
getErrorHandler()
Return an object responsible for handling form errors
|
boolean |
getExtractDefaultValuesFromItem()
Returns whether or not property values should be extracted from a
repository item if they do not have values specified in the form.
|
java.lang.String |
getFolderIdProperty()
Get the folderIdPropertyName.
|
RepositoryItemDescriptor |
getItemDescriptor()
Returns the repository item descriptor used by this form handler.
|
java.lang.String |
getItemDescriptorName()
Returns the name of the repository item descriptor used by this
form handler (e.g., to create/add items to the repository).
|
protected java.lang.Object |
getItemProperty(java.lang.String pPropertyName)
If the
repositoryId property is set, returns the
value of the corresponding item's property. |
ApplicationLogging |
getLogger()
Return logger
|
java.lang.String |
getMapKeyValueSeparator()
Gets the property MapKeyValueSeparator.
|
boolean |
getRemoveReferencesToDeletedItems() |
MutableRepository |
getRepository()
Returns the repository this form handler operates over.
|
java.lang.String |
getRepositoryId()
Returns the repository id of the item being manipulated.
|
RepositoryItem |
getRepositoryItem()
Returns the repository item (if any) to edit from this form handler
This is retrieved based on the repository, itemDescriptorName, and
repositoryId properties;
|
atg.repository.servlet.RepositoryItemEditor |
getRepositoryItemEditor()
Get the repository item editor
|
java.lang.String |
getRepositoryPathName() |
boolean |
getRequireIdOnCreate()
Returns true if a repository id must be specified when new items
are created, false otherwise.
|
protected java.lang.Object |
getSpecifiedIdPropertyValue()
Return the id property value if it has been specified explicitly,
otherwise return null.
|
protected TransactionDemarcation |
getTransactionDemarcation()
Returns the transaction demaraction for this form handler
|
protected javax.transaction.TransactionManager |
getTransactionManager()
Returns the transaction manager for the repository that we are using
|
java.lang.String[] |
getTrimProperties()
Returns property TrimProperties
|
java.lang.String |
getUpdateErrorURL()
Returns the URL to redirect to upon a failed item update.
|
java.lang.String |
getUpdateSuccessURL()
Returns the URL to redirect to upon a successful item update.
|
java.util.Dictionary |
getValue()
Returns a dictionary that stores the pending property values
associated with an operation on the repository item (e.g.
|
protected java.lang.Object |
getValueProperty(java.lang.String pName)
Returns the value of a property from the
value
Dictionary. |
boolean |
handleCreate(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Takes the current set of property values set as members of the
value property and, if there were no errors in
submitting the form, creates a new repository item, sets these
property values in the new item, and adds the item persistently
to the repository. |
boolean |
handleDelete(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Deletes the item specified by the
repositoryId
property from the repository. |
boolean |
handleUpdate(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Takes the current set of property values set as members of the
value property and, if there were no errors in
submitting the form, modifies the item described by the
repositoryId property with these values. |
boolean |
isClearValueOnSet()
Returns value of ClearValueOnSet property
|
boolean |
isCreateTransientItems()
Returns property CreateTransientItems.
|
boolean |
isRequireMapKeys()
Indicates if the form should require keys for all entries in Map properties.
|
boolean |
isSortRepositoryItemSets()
Indicates if the form should display Sets of RepositoryItems sorted
according to their display names.
|
boolean |
isTrimProperty(java.lang.String pProperty)
Tests whether pProperty should be trimmed or not
|
boolean |
isUpdateItemsInCollection()
Return a flag that indicates if the form should update individual
collection items when updating a collection property.
|
protected void |
postCreateItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
This method is called just after the item creation process is
finished.
|
protected void |
postDeleteItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
This method is called just after the item is deleted from the
repository.
|
protected void |
postUpdateItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
This method is called just after the item is updated.
|
protected void |
postUpdateItemProperties(MutableRepositoryItem pItem)
This method is called just after the updateItemProperties is completed.
|
protected void |
preCreateItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
This method is called just before the item creation process is
started.
|
protected void |
preDeleteItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
This method is called just before the item is deleted from the
repository.
|
protected void |
preUpdateItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
This method is called just before the item is updated.
|
void |
setCheckForReadOnlyProperties(boolean pCheckForReadOnlyProperties)
Sets whether or this form handler should throw an exception
when updating item properties and read only properties are in
the value dictionary.
|
void |
setCheckForRequiredProperties(boolean pCheckForRequiredProperties)
Sets whether or not the form handler should check that all the
required properties are present during the create/update
operations.
|
void |
setClearValueOnSet(boolean pClearValueOnSet)
Sets the clearValueOnSet property
|
void |
setContentNameProperty(java.lang.String pContentNameProperty)
set the contentNameProperty
|
void |
setContentPathProperty(java.lang.String pContentPathProperty)
set the contentPathProperty
|
void |
setCreateErrorURL(java.lang.String pCreateErrorURL)
Sets the URL to redirect to upon a failed item creation.
|
void |
setCreateSuccessURL(java.lang.String pCreateSuccessURL)
Sets the URL to redirect to upon a successful item creation.
|
void |
setCreateTransientItems(boolean pCreateTransientItems)
Sets property CreateTransientItems.
|
void |
setDeleteErrorURL(java.lang.String pDeleteErrorURL)
Sets the URL to redirect to upon a failed item deletion.
|
void |
setDeleteSuccessURL(java.lang.String pDeleteSuccessURL)
Sets the URL to redirect to upon a successful item deletion.
|
void |
setEditMapsAsLists(boolean pEditMapsAsLists)
Sets the property EditMapsAsLists.
|
void |
setExtractDefaultValuesFromItem(boolean pExtractDefaultValuesFromItem)
Sets whether or not property values should be extracted from a
repository item if they do not have values specified in the form.
|
void |
setFolderIdProperty(java.lang.String pFolderIdProperty)
set the folderIdProperty
|
void |
setItemDescriptorName(java.lang.String pItemDescriptorName)
Sets the name of the repository item descriptor used by this form
handler (e.g., to create/add items to the repository).
|
void |
setMapKeyValueSeparator(java.lang.String pMapKeyValueSeparator)
Sets the property MapKeyValueSeparator.
|
void |
setRemoveReferencesToDeletedItems(boolean pRemoveReferencesToDeletedItems)
Sets the property RemoveReferencesToDeletedItems.
|
void |
setRepository(MutableRepository pRepository)
Sets the repository this form handler should operate over.
|
void |
setRepositoryId(java.lang.String pId)
Sets the repository id of the item to be manipulated.
|
void |
setRepositoryItemEditor(atg.repository.servlet.RepositoryItemEditor pRepositoryItemEditor)
Set the repository item editor
|
void |
setRepositoryPathName(java.lang.String pRepositoryPathName)
Sets the property RepositoryPathName.
|
void |
setRequireIdOnCreate(boolean pRequireIdOnCreate)
Sets whether a repository id must be specified when new items are
created.
|
void |
setRequireMapKeys(boolean pRequireMapKeys)
Set a flag that indicates if the form should require keys for all entries
in Map properties.
|
void |
setSortRepositoryItemSets(boolean pSortRepositoryItemSets)
Set a flag that indicates if the form should display Sets of
RepositoryItems sorted according to their display names.
|
void |
setTrimProperties(java.lang.String[] pTrimProperties)
Sets property trimProperties.
|
void |
setUpdateErrorURL(java.lang.String pUpdateErrorURL)
Sets the URL to redirect to upon a failed item update.
|
void |
setUpdateItemsInCollection(boolean pUpdateItemsInCollection)
Set a flag that indicates if the form should update individual
collection items when updating a collection property.
|
void |
setUpdateSuccessURL(java.lang.String pUpdateSuccessURL)
Sets the URL to redirect to upon a successful item update.
|
protected void |
setValueProperty(java.lang.String pName,
java.lang.Object pValue)
Sets the value of a property into the
value
Dictionary. |
static boolean |
testPropertyAttribute(DynamicPropertyDescriptor pDpd,
java.lang.String pAttrName,
java.lang.String pTest)
Test named attribute of specified property descriptor to see if
it is equal to the value specified in pTest
|
protected void |
updateChildItemProperty(RepositoryPropertyDescriptor pDesc,
java.lang.Object pValue,
java.lang.String pKey,
MutableRepositoryItem pItem,
java.lang.String pItemPath)
Update single value property that is repository item
|
protected void |
updateContentItemValues(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Update folder item properties such as path
|
protected void |
updateItem(DynamoHttpServletRequest pRequest,
DynamoHttpServletResponse pResponse)
Updates the repository item given by the current repository id.
|
protected void |
updateItemProperties(MutableRepositoryItem pItem,
java.util.Dictionary pValues,
java.lang.String pItemPath)
Takes the current values of the
value property and
sticks them into the repository item given. |
protected void |
updateListProperty(MutableRepositoryItem pItem,
RepositoryFormList pFormList)
Goes through the set, array, or list property represented by the data
we've collected from the RepositoryFormList object.
|
protected void |
updateMapProperty(MutableRepositoryItem pItem,
RepositoryFormMap pFormMap)
Goes through the map property represented by the data
we've collected from the RepositoryFormList object.
|
addFormException, addUncheckedFormException, afterSet, beforeSet, checkFormRedirect, createFormSubmissionMessage, getCancelURL, getCheckForValidSession, getFormError, getFormExceptions, getFormName, getMessagePort, getMessageSource, getMessageType, getPropertyExceptions, getSendMessages, getUncheckedFormExceptions, handleCancel, handleFormException, handleUncheckedFormException, hasUncheckedFormExceptions, isDeferForwardsAndRedirects, isRestorableForm, isUseForwards, isValidSession, redirectOrForward, resetFormExceptions, setCancelURL, setCheckForValidSession, setDeferForwardsAndRedirects, setFormName, setMessagePort, setMessageSource, setMessageType, setRestorableForm, setSendMessages, setUseForwards
afterGet, beforeGet
addLogListener, createAdminServlet, doStartService, doStopService, getAbsoluteName, getAdminServlet, getAdminServletOutputStreamEncoding, getLoggingForVlogging, getLogListenerCount, getLogListeners, getName, getNameContext, getNucleus, getRoot, getServiceConfiguration, getServiceInfo, isAdminServletUseServletOutputStream, isLoggingDebug, isLoggingError, isLoggingInfo, isLoggingTrace, isLoggingWarning, isRunning, logDebug, logDebug, logDebug, logError, logError, logError, logInfo, logInfo, logInfo, logTrace, logTrace, logTrace, logWarning, logWarning, logWarning, nameContextElementBound, nameContextElementUnbound, removeLogListener, reResolveThis, resolveName, resolveName, resolveName, resolveName, sendLogEvent, setAdminServletOutputStreamEncoding, setAdminServletUseServletOutputStream, setLoggingDebug, setLoggingError, setLoggingInfo, setLoggingTrace, setLoggingWarning, setNucleus, setServiceInfo, startService, stopService
vlogDebug, vlogDebug, vlogDebug, vlogDebug, vlogDebugTrace, vlogError, vlogError, vlogError, vlogError, vlogInfo, vlogInfo, vlogInfo, vlogInfo, vlogTrace, vlogTrace, vlogTrace, vlogTrace, vlogWarning, vlogWarning, vlogWarning, vlogWarning
public static java.lang.String CLASS_VERSION
public static final int STATUS_SUCCESS
public static final int STATUS_ERROR_STAY
public static final int STATUS_ERROR_REDIRECT
public ApplicationLogging getLogger()
getLogger
in interface RepositoryFormData
public atg.repository.servlet.RepositoryEditorErrorHandler getErrorHandler()
RepositoryFormData
getErrorHandler
in interface RepositoryFormData
public atg.repository.servlet.RepositoryItemEditor getRepositoryItemEditor()
getRepositoryItemEditor
in interface RepositoryFormData
public void setRepositoryItemEditor(atg.repository.servlet.RepositoryItemEditor pRepositoryItemEditor)
pRepositoryItemEditor
- the object used to manipulate repository itemspublic void setCreateTransientItems(boolean pCreateTransientItems)
public boolean isCreateTransientItems()
isCreateTransientItems
in interface RepositoryFormData
public void setRequireMapKeys(boolean pRequireMapKeys)
public boolean isRequireMapKeys()
isRequireMapKeys
in interface RepositoryFormData
public void setSortRepositoryItemSets(boolean pSortRepositoryItemSets)
public boolean isSortRepositoryItemSets()
isSortRepositoryItemSets
in interface RepositoryFormData
public void setUpdateItemsInCollection(boolean pUpdateItemsInCollection)
public boolean isUpdateItemsInCollection()
isUpdateItemsInCollection
in interface RepositoryFormData
public MutableRepository getRepository()
getRepository
in interface RepositoryFormData
public void setRepository(MutableRepository pRepository)
public void setRepositoryPathName(java.lang.String pRepositoryPathName)
pRepositoryPathName
- new value to setpublic java.lang.String getRepositoryPathName()
public java.lang.String getItemDescriptorName() throws RepositoryException
RepositoryException
- if there was a repository error
getting the item descriptorpublic void setItemDescriptorName(java.lang.String pItemDescriptorName)
public RepositoryItemDescriptor getItemDescriptor() throws RepositoryException
itemDescriptorName
property is specified,
returns the descriptor given by the item descriptor name.
Otherwise, returns the item descriptor associated with the
repository's default view.getItemDescriptor
in interface RepositoryFormData
RepositoryException
- if there was a repository error
getting the item descriptorpublic java.lang.String getRepositoryId()
getRepositoryId
in interface RepositoryFormData
public void setRepositoryId(java.lang.String pId)
value
dictionary, since the property
values in it correspond to the item with the old repository id.public java.util.Dictionary getValue()
getValue
in interface RepositoryFormData
public boolean getExtractDefaultValuesFromItem()
getExtractDefaultValuesFromItem
in interface RepositoryFormData
public void setExtractDefaultValuesFromItem(boolean pExtractDefaultValuesFromItem)
public boolean getCheckForRequiredProperties()
getCheckForRequiredProperties
in interface RepositoryFormData
public void setCheckForRequiredProperties(boolean pCheckForRequiredProperties)
public boolean getCheckForReadOnlyProperties()
getCheckForReadOnlyProperties
in interface RepositoryFormData
public void setCheckForReadOnlyProperties(boolean pCheckForReadOnlyProperties)
public java.lang.String[] getTrimProperties()
public void setTrimProperties(java.lang.String[] pTrimProperties)
public boolean getRequireIdOnCreate()
public void setRequireIdOnCreate(boolean pRequireIdOnCreate)
public void setRemoveReferencesToDeletedItems(boolean pRemoveReferencesToDeletedItems)
pRemoveReferencesToDeletedItems
- new value to setpublic boolean getRemoveReferencesToDeletedItems()
public java.lang.String getCreateSuccessURL()
public void setCreateSuccessURL(java.lang.String pCreateSuccessURL)
public java.lang.String getCreateErrorURL()
public void setCreateErrorURL(java.lang.String pCreateErrorURL)
public java.lang.String getUpdateSuccessURL()
public void setUpdateSuccessURL(java.lang.String pUpdateSuccessURL)
public java.lang.String getUpdateErrorURL()
public void setUpdateErrorURL(java.lang.String pUpdateErrorURL)
public java.lang.String getDeleteSuccessURL()
public void setDeleteSuccessURL(java.lang.String pDeleteSuccessURL)
public java.lang.String getDeleteErrorURL()
public void setDeleteErrorURL(java.lang.String pDeleteErrorURL)
public boolean isClearValueOnSet()
public void setClearValueOnSet(boolean pClearValueOnSet)
public void setEditMapsAsLists(boolean pEditMapsAsLists)
pEditMapsAsLists
- new value to setpublic boolean getEditMapsAsLists()
getEditMapsAsLists
in interface RepositoryFormData
public void setMapKeyValueSeparator(java.lang.String pMapKeyValueSeparator)
pMapKeyValueSeparator
- new value to setpublic java.lang.String getMapKeyValueSeparator()
getMapKeyValueSeparator
in interface RepositoryFormData
protected int checkFormError(java.lang.String pErrorURL, DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pErrorURL
- the URL to redirect to if there are any form
errorspRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected boolean checkFormSuccess(java.lang.String pSuccessURL, DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pSuccessURL
- the URL to redirect to if the form was
successfully submittedpRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected atg.repository.content.ContentPropertyItemDescriptor getContentItemDescriptor()
public void setContentPathProperty(java.lang.String pContentPathProperty)
public java.lang.String getContentPathProperty()
public void setContentNameProperty(java.lang.String pContentNameProperty)
public java.lang.String getContentNameProperty()
public void setFolderIdProperty(java.lang.String pFolderIdProperty)
public java.lang.String getFolderIdProperty()
protected java.lang.Object getSpecifiedIdPropertyValue() throws RepositoryException
RepositoryException
- if there was an error while
accessing the repositoryprotected void checkForRequiredProperties(RepositoryItem pItem) throws RepositoryException
pItem
- repository item being updated can be null if item is to be createdRepositoryException
- if there was an error while
accessing the repositorypublic boolean isTrimProperty(java.lang.String pProperty)
isTrimProperty
in interface RepositoryFormData
pProperty
- the name of the property to check to be trimmedprotected java.lang.Object getValueProperty(java.lang.String pName)
value
Dictionary.protected void setValueProperty(java.lang.String pName, java.lang.Object pValue)
value
Dictionary. If pValue is null then the property defined by pName
is removed from the value
Dictionary.protected java.lang.Object getItemProperty(java.lang.String pPropertyName)
repositoryId
property is set, returns the
value of the corresponding item's property. Otherwise, tries to
get the default property value from the item descriptor. Returns
null if no property value is found.public RepositoryItem getRepositoryItem()
getRepositoryItem
in interface RepositoryFormData
protected javax.transaction.TransactionManager getTransactionManager()
protected TransactionDemarcation getTransactionDemarcation()
public boolean handleCreate(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
value
property and, if there were no errors in
submitting the form, creates a new repository item, sets these
property values in the new item, and adds the item persistently
to the repository. If the repositoryId
property is
specified in the form, the new item is created with the given
repository id; otherwise, an auto-generated unique id is used.
The repositoryId
is set to point to the repository
id of the newly created item.
If any errors occur in the process, form errors will be added. If there were no errors encountered while submitting the form, we optionally redirect to the value of the property createSuccessURL. Otherwise, we optionally redirect to createErrorURL.
javax.servlet.ServletException
java.io.IOException
protected void preCreateItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void postCreateItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet iopublic boolean handleUpdate(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
value
property and, if there were no errors in
submitting the form, modifies the item described by the
repositoryId
property with these values.
If any errors occur in the process, form errors will be added. If there were no errors encountered while submitting the form, we optionally redirect to the value of the property updateSuccessURL. Otherwise, we optionally redirect to updateErrorURL.
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void preUpdateItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void postUpdateItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void updateItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
value
property are saved into
the repository item. If any errors occur in the process, form
errors will be added.pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void updateContentItemValues(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
javax.servlet.ServletException
java.io.IOException
protected void updateItemProperties(MutableRepositoryItem pItem, java.util.Dictionary pValues, java.lang.String pItemPath) throws RepositoryException
value
property and
sticks them into the repository item given. Adds form errors if
there were any problems.pItem
- the mutable repository item to updatepValues
- the values mappItemPath
- any subitem pathRepositoryException
- if there was an error while
accessing the repositoryjavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void updateChildItemProperty(RepositoryPropertyDescriptor pDesc, java.lang.Object pValue, java.lang.String pKey, MutableRepositoryItem pItem, java.lang.String pItemPath) throws RepositoryException
pDesc
- RepositoryPropertyDescriptor for propertypValue
- values dictionary for child itempKey
- property namepItem
- parent itempItemPath
- where repository item is relative to parent (could be child, grandchild etc)RepositoryException
protected void updateListProperty(MutableRepositoryItem pItem, RepositoryFormList pFormList) throws RepositoryException
RepositoryException
protected void updateMapProperty(MutableRepositoryItem pItem, RepositoryFormMap pFormMap) throws RepositoryException
RepositoryException
protected void postUpdateItemProperties(MutableRepositoryItem pItem) throws javax.servlet.ServletException, java.io.IOException
pItem
- the item being updatedjavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet iopublic boolean handleDelete(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
repositoryId
property from the repository.
If any errors occur in the process, form errors will be added. If there were no errors encountered while submitting the form, we optionally redirect to the value of the property deleteSuccessURL. Otherwise, we optionally redirect to deleteErrorURL.
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void preDeleteItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void postDeleteItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet ioprotected void deleteItem(DynamoHttpServletRequest pRequest, DynamoHttpServletResponse pResponse) throws javax.servlet.ServletException, java.io.IOException
pRequest
- the servlet's requestpResponse
- the servlet's responsejavax.servlet.ServletException
- if there was an error while executing
the codejava.io.IOException
- if there was an error with servlet iopublic static boolean testPropertyAttribute(DynamicPropertyDescriptor pDpd, java.lang.String pAttrName, java.lang.String pTest)
pDpd
- the property descriptorpAttrName
- the name of the property descriptor's attributepTest
- the value to compare