com.ibm.commerce.catalogattachment.commands

Class CatalogEntryAttachmentUpdateCmdImpl

java.lang.Object

com.ibm.websphere.command.TargetableCommandImpl

com.ibm.websphere.command.CacheableCommandImpl

com.ibm.commerce.command.MeasuredCacheableCommandImpl

com.ibm.commerce.command.AbstractECTargetableCommand

com.ibm.commerce.command.ControllerCommandImpl

com.ibm.commerce.attachment.commands.AttachmentRelationBaseUpdateCmdImpl

com.ibm.commerce.catalogattachment.commands.CatalogEntryAttachmentUpdateCmdImpl

All Implemented Interfaces:

AttachmentRelationBaseUpdateCmd, CatalogEntryAttachmentUpdateCmd, AccCommand, ControllerCommand, ECCommand, ECTargetableCommand, Protectable, com.ibm.websphere.cache.Sizeable, com.ibm.websphere.command.CacheableCommand, com.ibm.websphere.command.Command, com.ibm.websphere.command.CommandCaller, com.ibm.websphere.command.TargetableCommand, java.io.Serializable

public class CatalogEntryAttachmentUpdateCmdImpl
extends AttachmentRelationBaseUpdateCmdImpl
implements CatalogEntryAttachmentUpdateCmd

The CatalogEntryAttachmentUpdateCmd is a URL and controller command that:

• Updates a new attachment relation for the specified catalog entry.
• Updates the description for the attachment relation.

To obtain the Catalog Entry ID:

• Catalog Entry ID can be specified in the parameter.
• If Catalog Entry ID is not specified, part number can be specified. Part number is used together with the member ID to obtain the Catalog Entry ID. The member ID is obtained as the owner of the store where the command is called.
• If the part number is not specified, then the attachment relation ID must be specified. The attachment relation is checked to see if it is a catalog entry attachment relation. The object ID found in the attachment relation is used as the catalog entry ID.

If the attachment relation ID is specified, then the attachment relation will be updated. If the command is called as URL. Only one description can be created or updated. Otherwise, multiple descriptions can be updated by setting the vector of AttachmentRelationDescriptionDataBean.

When updating the attachment relation, the command will change the parameters set by the command. However, the behaviour in updating the attachment relation description is different. Its behaviour will depend on whether the command was called as a URL or as a command.

• When creating the vector of AttachmentRelationDescriptionDataBean, the attachment relation ID from the databean will not be used. The attachment relation ID will be obtained from the command itself. Either user specified the attachment relation ID or it is obtained from the attachment relation just created by the command. Make sure that all the name, short description, and long description are set in the databean even if they are not changed. The command will take these name and descriptions as they are and update the attachment relation description.
• However, when the command is executed as URL, it will only update the parameters set by the caller. If the name is set but the long description is not set, then only the name will be updated. The long description will remain unchanged.

By default, the option to create the missing attachment relation and its description is set to True. If the option is set to false but the attachment relation is not found, an exception will be thrown. An exception will also be thrown if any of the attachment relation descriptions are not found. Parameters:

• Catalog Entry ID or part number of the Catalog Entry
• Attachment Relation ID
• Attachment Target ID
• Attachment Relation Usage ID
• Sequence
• Relation Name
• Relation Description Language ID
• Relation Short Description
• Relation Long Description
• Vector of AttachmentRelationDescriptionDataBean

Access Beans and Data Beans:

• CatalogEntryAccessBean
• AttachmentRelationAccessBean
• AttachmentRelationDescriptionAccessBean
• AttachmentRelationDescriptionDataBean

Task Commands:

• AddAttachmentRelationCmd
,
• UpdateAttachmentRelationCmd
,

Utilities and Helpers:

• AttachmentRelationHelper

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CLASSNAME Define the CLASSNAME.
static java.lang.String	COPYRIGHT The internal copyright field.

Fields inherited from class com.ibm.websphere.command.TargetableCommandImpl

LOCAL

Fields inherited from interface com.ibm.commerce.command.ECCommand

defaultCommandClassName

Fields inherited from interface com.ibm.websphere.command.Command

serialVersionUID

Constructor Summary

Constructors

Constructor and Description
CatalogEntryAttachmentUpdateCmdImpl()

Method Summary

Modifier and Type	Method and Description
java.lang.Long	getCatentryId() Gets the Catalog Entry ID.
java.lang.String	getPartNumber() Gets the part number.
AccessVector	getResources() Gets the access vector accessed by this command.
void	performExecute() Calls the super class to do the work.
void	reset() Resets the variables used.
void	setCatentryId(java.lang.Long anCatalogEntryId) Sets the Catalog Entry ID.
void	setPartnumber(java.lang.String astrPartnumber) Sets the part number of the catalog entry.
void	setRequestProperties(TypedProperty reqParms) Sets the request properties.
void	validateParameters() Validate the parameters.

Methods inherited from class com.ibm.commerce.attachment.commands.AttachmentRelationBaseUpdateCmdImpl

getAttachmentObjectId, getAttachmentObjectTypeId, getAttachmentRelationDescriptions, getAttachmentRelationId, getAttachmentRelationUsageId, getAttachmentTargetId, getSequence, getURL, setAttachmentObjectId, setAttachmentObjectTypeId, setAttachmentRelationDescriptions, setAttachmentRelationId, setAttachmentRelationUsageId, setAttachmentTargetId, setCreateMissing, setSequence, setURL

Methods inherited from class com.ibm.commerce.command.ControllerCommandImpl

checkPermission, fulfills, getForUserId, getGeneric, getOwner, getRequestProperties, getResolvedRequestProperties, getResourceOwners, getResponseProperties, getRetriable, getViewInputProperties, isGeneric, isRetriable, mergeProperties, setForUserId, setGeneric, setOwner, setResponseProperties, setRetriable, setViewInputProperties

Methods inherited from class com.ibm.commerce.command.AbstractECTargetableCommand

accessControlCheck, checkIsAllowed, checkResourcePermission, createCommandExecutionEvent, execute, getAccCheck, getCommandContext, getCommandIfName, getCommandName, getCommandStoreId, getDefaultProperties, getExceptionInvokeParameters, getObjectSize, getPostInvokeParameters, getPreInvokeParameters, getStoreId, getUser, getUserId, isReadyToCallExecute, setAccCheck, setCommandContext, setCommandIfName, setCommandStoreId, setDefaultProperties

Methods inherited from class com.ibm.websphere.command.CacheableCommandImpl

executeFromCache, getCaller, getEntryInfo, getId, getSharingPolicy, postExecute, preExecute, setCaller, setObjectSize, unionDependencies, updateCache

Methods inherited from class com.ibm.websphere.command.TargetableCommandImpl

getCommandTarget, getCommandTargetName, getTargetPolicy, hasOutputProperties, setCommandTarget, setCommandTargetName, setHasOutputProperties, setOutputProperties, setTargetPolicy

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.ibm.commerce.attachment.commands.AttachmentRelationBaseUpdateCmd

getAttachmentObjectId, getAttachmentRelationDescriptions, getAttachmentRelationId, getAttachmentRelationUsageId, getAttachmentTargetId, getSequence, getURL, setAttachmentObjectId, setAttachmentRelationDescriptions, setAttachmentRelationId, setAttachmentRelationUsageId, setAttachmentTargetId, setCreateMissing, setSequence, setURL

Methods inherited from interface com.ibm.commerce.command.ControllerCommand

checkPermission, execute, getGeneric, getRequestProperties, getResolvedRequestProperties, getResponseProperties, getRetriable, getViewInputProperties, isGeneric, isRetriable, mergeProperties, setGeneric, setRetriable, setViewInputProperties

Methods inherited from interface com.ibm.websphere.command.CacheableCommand

executeFromCache, getCaller, getEntryInfo, getId, getSharingPolicy, postExecute, preExecute, setCaller, updateCache

Methods inherited from interface com.ibm.websphere.command.TargetableCommand

getCommandTarget, getCommandTargetName, hasOutputProperties, setCommandTarget, setCommandTargetName, setOutputProperties

Methods inherited from interface com.ibm.websphere.command.CommandCaller

unionDependencies

Methods inherited from interface com.ibm.commerce.command.AccCommand

accessControlCheck, getAccCheck, getForUserId, getResourceOwners, setAccCheck, setForUserId, setOwner

Methods inherited from interface com.ibm.commerce.command.ECCommand

checkIsAllowed, checkResourcePermission, createCommandExecutionEvent, getCommandContext, getCommandIfName, getCommandName, getCommandStoreId, getDefaultProperties, getExceptionInvokeParameters, getPostInvokeParameters, getPreInvokeParameters, getStoreId, getUser, getUserId, setCommandContext, setCommandIfName, setCommandStoreId, setDefaultProperties

Methods inherited from interface com.ibm.websphere.command.Command

isReadyToCallExecute

Methods inherited from interface com.ibm.commerce.security.Protectable

fulfills, getOwner

Field Detail

COPYRIGHT

public static final java.lang.String COPYRIGHT

The internal copyright field.

See Also:

Constant Field Values

CLASSNAME

public static final java.lang.String CLASSNAME

Define the CLASSNAME.

See Also:

Constant Field Values

Constructor Detail

CatalogEntryAttachmentUpdateCmdImpl

public CatalogEntryAttachmentUpdateCmdImpl()

Method Detail

getCatentryId

public java.lang.Long getCatentryId()

Gets the Catalog Entry ID.

Specified by:

getCatentryId in interface CatalogEntryAttachmentUpdateCmd

Returns:

The Catalog Entry ID

getPartNumber

public java.lang.String getPartNumber()

Gets the part number.

Specified by:

getPartNumber in interface CatalogEntryAttachmentUpdateCmd

Returns:

The part number

getResources

public AccessVector getResources()
                          throws ECException

Gets the access vector accessed by this command. The access vector consists of a CatalogEntryAccessBean. which is the owner of the attachment relation.

Specified by:

getResources in interface ECCommand

Overrides:

getResources in class AbstractECTargetableCommand

Returns:

AccessVector - a vector of a CatalogEntryAccessBean.

Throws:

ECException

performExecute

public void performExecute()
                    throws ECException

Calls the super class to do the work. Assumes that the superclass calls preSetParamters() to load the object

Specified by:

performExecute in interface ECCommand

Specified by:

performExecute in interface com.ibm.websphere.command.TargetableCommand

Overrides:

performExecute in class AttachmentRelationBaseUpdateCmdImpl

Throws:

ECException

reset

public void reset()

Resets the variables used.

Specified by:

reset in interface com.ibm.websphere.command.Command

Overrides:

reset in class AttachmentRelationBaseUpdateCmdImpl

setCatentryId

public void setCatentryId(java.lang.Long anCatalogEntryId)

Sets the Catalog Entry ID.

Specified by:

setCatentryId in interface CatalogEntryAttachmentUpdateCmd

Parameters:

anCatalogEntryId - The Catalog Entry ID

setPartnumber

public void setPartnumber(java.lang.String astrPartnumber)

Sets the part number of the catalog entry.

Specified by:

setPartnumber in interface CatalogEntryAttachmentUpdateCmd

Parameters:

astrPartnumber - The part number of the Catalog Entry

setRequestProperties

public void setRequestProperties(TypedProperty reqParms)
                          throws ECApplicationException

Sets the request properties.

Specified by:

setRequestProperties in interface ControllerCommand

Overrides:

setRequestProperties in class AttachmentRelationBaseUpdateCmdImpl

Parameters:

reqParms - The request properties

Throws:

ECApplicationException

validateParameters

public void validateParameters()
                        throws ECException

Validate the parameters.

Specified by:

validateParameters in interface ECCommand

Overrides:

validateParameters in class AbstractECTargetableCommand

Throws:

ECException