com.ibm.commerce.catalogmanagement.commands

Class AttributeValueUpdateCmdImpl

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.catalogmanagement.commands.AttributeValueUpdateCmdImpl

All Implemented Interfaces:

AttributeValueUpdateCmd, 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 AttributeValueUpdateCmdImpl
extends ControllerCommandImpl
implements AttributeValueUpdateCmd

The AttributeValueUpdateCmd is a URL and controller command that updates an existing attribute value.
Note that a parent attribute value is an attribute value with a store default language ID. A child attribute value is an attribute value with a language ID other than the store default language ID. A product attribute value is an attribute value where the catalog entry ID = 0. An item attribute value is an attribute value where the catalog entry ID = the catalog entry ID of an item.
As a controller command, the caller can use the setProductAttributeValue(value) to find the parent product attribute value ID. For example, the command will find the attribute value ID with the specified attribute ID, catalog entry ID = 0, language ID = store default language ID, and value of the attribute value. The attribute value ID will be assigned and passed back into the command. This option is not available to the URL command.

• Update a parent product attribute value. All the item attribute values will be updated. The item attribute values will have the same attribute ID, language ID, and attribute values (depending on the attribute value type, the value can be string, float, or integer) as the parent product attribute value.
• Update a parent item attribute value:
  • If the parent item attribute value does not exist, it will be created.
  • If the parent item attribute value exists, then:
    • If the unique index is being updated:
      • Recreate the attribute value, use the new key (attribute value ID), and create the rest of the attribute values in other supported languages. Then delete the old attribute value of all languages. A common case is changing the existing attribute value of an item from "Red" to another existing attribute value such as "Blue". The command will change the attribute value in all languages (from "fr_Red" to "fr_Blue").
    • If the unique index is not being changed:
      • Update the item attribute value (such as the noncritical fields).
• Update a child product attribute value:
  • If the child product attribute value does not exist, it will be created.
  • If the child product attribute value exists, then update it. All the changes will be reflected in the child item attribute value.
• Update a child item attribute value:
  • If the child item attribute value does not exists, it will be created.
  • If the child item attribute value exists:
    • If the parent item attribute value does not exists, it will be created.

Parameters:

• Most fields in the ATTRVALUE table except for Market Place Edition related columns and IBM internal use columns.

Tables:

• AttributeValue

Task Commands: UpdateAttributeValueCmd
Other Controller Commands: None
Mandatory Parameters: attrvalueId, or attributeId + catentryId + name
Additional Parameters: none
Optional Parameters: field1, field2, field3, image1, image2, seq, value (or floatValue, integerValue, stringValue), descLangId, URL
Default Value: descLangId = language ID from command contact. name = value

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CLASSNAME The name of this interface is "com.ibm.commerce.catalogmanagement.commands.AttributeValueUpdateCmdImpl".
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
AttributeValueUpdateCmdImpl()

Method Summary

Modifier and Type	Method and Description
java.lang.Long	getAttributeId() Get the attribute Id
java.lang.Long	getAttrvalueId() Get the attribute value Id
java.lang.Long	getCatentryId() Get the catalog entry Id
java.lang.Integer	getDescLanguage() Get the description language
java.lang.Integer	getField1() Get field 1 of the attribute value
java.lang.String	getField2() Get field 2 of the attribute value
java.lang.String	getField3() Get field 3 of the attribute value
java.lang.Double	getFloatvalue() Get the float value of the attribute value
java.lang.String	getImage1() Get image 1 of the attribute value
java.lang.String	getImage2() Get image 2 of the attribute value
java.lang.Integer	getIntegervalue() Get the integer value of the attribute value
java.lang.String	getName() Get the attribute value name
java.lang.String	getOID() Get the object identifier
java.lang.Double	getSequence() Get sequence number
java.lang.String	getStringvalue() Get the string value of the attribute value
java.lang.String	getURL() Get the redirect URL
java.lang.String	getValue() Get value of the attribute value If value is get, then there is no need to use getFloatvalue, getIntegervalue, getStringvalue.
void	performExecute() The main program for AttributeValueUpdate command.
void	reset() This method reset all the variables used in AttributeValueUpdate command.
void	setAttributeId(java.lang.Long anAttributeId) Set the attribute Id
void	setAttrvalueId(java.lang.Long anAttrvalueId) Set the attribute value Id
void	setCatentryId(java.lang.Long anCatentryId) Set a catalog entry Id
void	setDescLanguage(java.lang.Integer anDescLanguage) Set language Id of the attribute value
void	setField1(java.lang.Integer anField1) Set field 1 of the attribute value
void	setField2(java.lang.String astrField2) Set field 2 of the attribute value
void	setField3(java.lang.String astrField3) Set field 3 of the attribute value
void	setFloatvalue(java.lang.Double adFloatvalue) Set the float value of the attribute value
void	setImage1(java.lang.String astrImage1) Set image 1 of the attribute value
void	setImage2(java.lang.String astrImage2) Set image 2 of the attribute value
void	setIntegervalue(java.lang.Integer anIntegervalue) Set the integer value of the attribute value
void	setName(java.lang.String astrName) Set the attribute value name
void	setOID(java.lang.String astrOID) Set the object identifier of the attribute value
void	setProductAttributeValue(java.lang.String astrProductAttributeValue) Set the value of the product attribute value It is used to determine the attribute value ID if it is not given by the user.
void	setRequestProperties(TypedProperty reqParms) This method obtains the input parameters for AttributeValueUpdate command.
void	setSequence(java.lang.Double adSequence) Set the sequence number
void	setStringvalue(java.lang.String astrStringvalue) Set the string value of the attribute value
void	setURL(java.lang.String astrURL) Set a redirect URL
void	setValue(java.lang.String astrValue) Set the value of the attribute value.
void	validateParameters() This method validates the parameters for AttributeValueAdd command

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, getResources, 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.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, getResources, 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

The name of this interface is "com.ibm.commerce.catalogmanagement.commands.AttributeValueUpdateCmdImpl".

See Also:

Constant Field Values

Constructor Detail

AttributeValueUpdateCmdImpl

public AttributeValueUpdateCmdImpl()

Method Detail

getAttributeId

public java.lang.Long getAttributeId()

Get the attribute Id

Specified by:

getAttributeId in interface AttributeValueUpdateCmd

Returns:

java.lang.Long

getAttrvalueId

public java.lang.Long getAttrvalueId()

Get the attribute value Id

Specified by:

getAttrvalueId in interface AttributeValueUpdateCmd

Returns:

java.lang.Long

getCatentryId

public java.lang.Long getCatentryId()

Get the catalog entry Id

Specified by:

getCatentryId in interface AttributeValueUpdateCmd

Returns:

java.lang.Long

getDescLanguage

public java.lang.Integer getDescLanguage()

Get the description language

Returns:

java.lang.Integer

getField1

public java.lang.Integer getField1()

Get field 1 of the attribute value

Returns:

java.lang.Integer

getField2

public java.lang.String getField2()

Get field 2 of the attribute value

Returns:

java.lang.String

getField3

public java.lang.String getField3()

Get field 3 of the attribute value

Returns:

java.lang.String

getFloatvalue

public java.lang.Double getFloatvalue()

Get the float value of the attribute value

Returns:

java.lang.Double

getImage1

public java.lang.String getImage1()

Get image 1 of the attribute value

Returns:

java.lang.String

getImage2

public java.lang.String getImage2()

Get image 2 of the attribute value

Returns:

java.lang.String

getIntegervalue

public java.lang.Integer getIntegervalue()

Get the integer value of the attribute value

Returns:

java.lang.Integer

getName

public java.lang.String getName()

Get the attribute value name

Returns:

java.lang.String

getOID

public java.lang.String getOID()

Get the object identifier

Returns:

java.lang.String

getSequence

public java.lang.Double getSequence()

Get sequence number

Returns:

java.lang.Double

getStringvalue

public java.lang.String getStringvalue()

Get the string value of the attribute value

Returns:

java.lang.String

getURL

public java.lang.String getURL()

Get the redirect URL

Returns:

java.lang.String

getValue

public java.lang.String getValue()

Get value of the attribute value If value is get, then there is no need to use getFloatvalue, getIntegervalue, getStringvalue. Depending on what attribute type the attribute value is, the value will set the corresponding type.

Returns:

java.lang.String

performExecute

public void performExecute()
                    throws ECException

The main program for AttributeValueUpdate command. This method calls the UpdateAttributeValueCmd task command and then sets attribute value ID, attribute ID, catalog entry ID, and description language in the response properties.

Specified by:

performExecute in interface ECCommand

Specified by:

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

Overrides:

performExecute in class AbstractECTargetableCommand

Throws:

ECException

reset

public void reset()

This method reset all the variables used in AttributeValueUpdate command.

Specified by:

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

Overrides:

reset in class AbstractECTargetableCommand

setAttributeId

public void setAttributeId(java.lang.Long anAttributeId)

Set the attribute Id

Specified by:

setAttributeId in interface AttributeValueUpdateCmd

Parameters:

anAttributeId - java.lang.Long

setAttrvalueId

public void setAttrvalueId(java.lang.Long anAttrvalueId)

Set the attribute value Id

Specified by:

setAttrvalueId in interface AttributeValueUpdateCmd

Parameters:

anAttrvalueId - java.lang.Long

setCatentryId

public void setCatentryId(java.lang.Long anCatentryId)

Set a catalog entry Id

Specified by:

setCatentryId in interface AttributeValueUpdateCmd

Parameters:

anCatentryId - java.lang.Long

setDescLanguage

public void setDescLanguage(java.lang.Integer anDescLanguage)

Set language Id of the attribute value

Specified by:

setDescLanguage in interface AttributeValueUpdateCmd

Parameters:

anDescLanguage - java.lang.Integer

setField1

public void setField1(java.lang.Integer anField1)

Set field 1 of the attribute value

Specified by:

setField1 in interface AttributeValueUpdateCmd

Parameters:

anField1 - java.lang.Integer

setField2

public void setField2(java.lang.String astrField2)

Set field 2 of the attribute value

Specified by:

setField2 in interface AttributeValueUpdateCmd

Parameters:

astrField2 - java.lang.String

setField3

public void setField3(java.lang.String astrField3)

Set field 3 of the attribute value

Specified by:

setField3 in interface AttributeValueUpdateCmd

Parameters:

astrField3 - java.lang.String

setFloatvalue

public void setFloatvalue(java.lang.Double adFloatvalue)

Set the float value of the attribute value

Specified by:

setFloatvalue in interface AttributeValueUpdateCmd

Parameters:

adFloatvalue - java.lang.Double

setImage1

public void setImage1(java.lang.String astrImage1)

Set image 1 of the attribute value

Specified by:

setImage1 in interface AttributeValueUpdateCmd

Parameters:

astrImage1 - java.lang.String

setImage2

public void setImage2(java.lang.String astrImage2)

Set image 2 of the attribute value

Specified by:

setImage2 in interface AttributeValueUpdateCmd

Parameters:

astrImage2 - java.lang.String

setIntegervalue

public void setIntegervalue(java.lang.Integer anIntegervalue)

Set the integer value of the attribute value

Specified by:

setIntegervalue in interface AttributeValueUpdateCmd

Parameters:

anIntegervalue - java.lang.Integer

setName

public void setName(java.lang.String astrName)

Set the attribute value name

Specified by:

setName in interface AttributeValueUpdateCmd

Parameters:

astrName - java.lang.String

setOID

public void setOID(java.lang.String astrOID)

Set the object identifier of the attribute value

Specified by:

setOID in interface AttributeValueUpdateCmd

Parameters:

astrOID - java.lang.String

setProductAttributeValue

public void setProductAttributeValue(java.lang.String astrProductAttributeValue)

Set the value of the product attribute value It is used to determine the attribute value ID if it is not given by the user.

Specified by:

setProductAttributeValue in interface AttributeValueUpdateCmd

Parameters:

astrProductAttributeValue - java.lang.String

setRequestProperties

public void setRequestProperties(TypedProperty reqParms)
                          throws ECApplicationException

This method obtains the input parameters for AttributeValueUpdate command.

Specified by:

setRequestProperties in interface ControllerCommand

Overrides:

setRequestProperties in class ControllerCommandImpl

Parameters:

reqParms - This is an object that represents the request properties.

Throws:

ECApplicationException

setSequence

public void setSequence(java.lang.Double adSequence)

Set the sequence number

Specified by:

setSequence in interface AttributeValueUpdateCmd

Parameters:

adSequence - java.lang.Double

setStringvalue

public void setStringvalue(java.lang.String astrStringvalue)

Set the string value of the attribute value

Specified by:

setStringvalue in interface AttributeValueUpdateCmd

Parameters:

astrStringvalue - java.lang.String

setURL

public void setURL(java.lang.String astrURL)

Set a redirect URL

Specified by:

setURL in interface AttributeValueUpdateCmd

Parameters:

astrURL - java.lang.String

setValue

public void setValue(java.lang.String astrValue)

Set the value of the attribute value. If value is set, then there is no need to use setFloatvalue, setIntegervalue, setStringvalue. Depending on what attribute type the attribute value is, the value will set the corresponding type.

Specified by:

setValue in interface AttributeValueUpdateCmd

Parameters:

astrValue - java.lang.String

validateParameters

public void validateParameters()
                        throws ECException

This method validates the parameters for AttributeValueAdd command

Specified by:

validateParameters in interface ECCommand

Overrides:

validateParameters in class AbstractECTargetableCommand

Throws:

ECException