com.highdeal.hci
Class InvalidCreationErrorException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.highdeal.hci.OperationFailureException
              com.highdeal.hci.OperationFailureErrorException
                  com.highdeal.hci.InvalidCreationErrorException

All Implemented Interfaces:

IErrorException, IXMLMarshallable, OperationResult, XMLMarshallable, java.io.Serializable

public class InvalidCreationErrorException
extends OperationFailureErrorException

Generic exception thrown when there was an error in the SAP CC system when attempting to create something that is not valid; The error type specifies the reason.

Implementation in Your Client Application

The connected SAP CC system manages several error categories that determine the error handling that must be implemented in your client application.

Error Handling

• Already existing object
• Invalid object
• Expected prerequisites
• Non compatible configuration in the system
• Current illegal state of the object
• Temporary illegal state of the object

See Also:

Serialized Form

XML API for HCI

The XML APIs specify the following XSD fragment:

XSD Fragment

<xs:element name="invalidCreationError">
   <xs:complexType>
     <xs:sequence>
       <xs:element ref="cause" minOccurs="1" maxOccurs="1"/>
       <xs:element ref="causedBy" minOccurs="0" maxOccurs="unbounded"/>
     </xs:sequence>
     <xs:attribute name="category" type="InvalidCreationCategoryType" use="required"/>
   </xs:complexType>
 </xs:element>

 <xs:simpleType name="InvalidCreationCategoryType">
   <xs:restriction base="xs:string">
     <xs:enumeration value="alreadyExists"/>
     <xs:enumeration value="invalid"/>
     <xs:enumeration value="prerequisiteMissing"/>
     <xs:enumeration value="incompatibleConfiguration"/>
     <xs:enumeration value="illegalState"/>
     <xs:enumeration value="temporaryIllegalState"/>
   </xs:restriction>
 </xs:simpleType>

Nested Class Summary

static class

InvalidCreationErrorException.InvalidCreationCategory This enumeration lists all the categories of errors that may occur during the creation of a master data in the connected SAP CC system: already exists, invalid, incompatible configuration, illegal state, or temporary illegal state.

Field Summary

static java.lang.String

TAG_NAME The XML tag name of the XML representation: "invalidCreationError"

Fields inherited from class com.highdeal.hci.OperationFailureErrorException

CAUSE_TAG_NAME, CAUSED_BY_TAG_NAME, MESSAGE_TAG_NAME

Constructor Summary

InvalidCreationErrorException()
Builds an empty exception.

InvalidCreationErrorException(InvalidCreationErrorException.InvalidCreationCategory category, IError error)
Builds an exception with the error which has triggered it and associated category.

InvalidCreationErrorException(InvalidCreationErrorException.InvalidCreationCategory category, IError error, OperationFailureErrorException exception)
Builds an exception with an error, the Operation Failure which has triggered it and associated category.

InvalidCreationErrorException(InvalidCreationErrorException.InvalidCreationCategory category, IError error, java.lang.Throwable throwable)
Builds an exception with an error, the Throwable which has triggered it and associated category.

Method Summary

void	addCharacterData(java.lang.String cData) Adds character data to the content element.
InvalidCreationErrorException.InvalidCreationCategory	getCategory() Gets the failure category of this exception.
java.lang.String	getTagName() Gets the XML tag name of the HCI model.
void	marshalAttributes(XMLOutputter output) Gives an XML representation of the attributes of an object.
void	setAttributes(XMLAttributes atts) Sets the attributes of the XML representation of the element being processed.

Methods inherited from class com.highdeal.hci.OperationFailureErrorException

addChild, getError, getMessage, marshal, marshalChildren, marshalIError, setError, unmarshalIError

Methods inherited from class com.highdeal.hci.OperationFailureException

getOperandReference

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

TAG_NAME

public static final java.lang.String TAG_NAME

The XML tag name of the XML representation: "invalidCreationError"

See Also:

Constant Field Values

Constructor Detail

InvalidCreationErrorException

public InvalidCreationErrorException()

Builds an empty exception.

InvalidCreationErrorException

public InvalidCreationErrorException(InvalidCreationErrorException.InvalidCreationCategory category,
                                     IError error)

Builds an exception with the error which has triggered it and associated category.

Parameters:

category - The error category

error - The error which has triggered the exception

InvalidCreationErrorException

public InvalidCreationErrorException(InvalidCreationErrorException.InvalidCreationCategory category,
                                     IError error,
                                     OperationFailureErrorException exception)

Builds an exception with an error, the Operation Failure which has triggered it and associated category.

Parameters:

category - The error category

error - The error of the exception

exception - The exception which has triggered the current one

InvalidCreationErrorException

public InvalidCreationErrorException(InvalidCreationErrorException.InvalidCreationCategory category,
                                     IError error,
                                     java.lang.Throwable throwable)

Builds an exception with an error, the Throwable which has triggered it and associated category.

Parameters:

category - The error category

error - The error of the exception

throwable - The throwable which has triggered the current one

Method Detail

getCategory

public InvalidCreationErrorException.InvalidCreationCategory getCategory()

Gets the failure category of this exception.

Returns:

The failure category of this exception

setAttributes

public void setAttributes(XMLAttributes atts)

Description copied from interface: XMLMarshallable

Sets the attributes of the XML representation of the element being processed.

Parameters:

atts - The XML attributes of the current element

addCharacterData

public void addCharacterData(java.lang.String cData)

Description copied from interface: XMLMarshallable

Adds character data to the content element.

Parameters:

cData - The character data to be added

getTagName

public java.lang.String getTagName()

Description copied from class: OperationFailureErrorException

Gets the XML tag name of the HCI model.

Specified by:

getTagName in class OperationFailureErrorException

Returns:

The XML tag name

marshalAttributes

public void marshalAttributes(XMLOutputter output)

Description copied from interface: IXMLMarshallable

Gives an XML representation of the attributes of an object.

Parameters:

output - The XML output to marshal the object attributes into