com.highdeal.pnr.hci

Class AcquisitionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.highdeal.hci.OperationFailureException

com.highdeal.pnr.hci.AcquisitionException

All Implemented Interfaces:

OperationResult, XMLMarshallable, java.io.Serializable

public class AcquisitionException
extends OperationFailureException

Exception thrown to your client application when a direct batch acquisition operation of a collection of chargeable items fails in the connected SAP CC Core Server system; Batch acquisition is an operation available in the Offline Charging Services (OFCS) provided by SAP Convergent Charging.

Important Note

This exception is specified in a Java package of HCI but it is only available in the Message TCP technical interface of SAP Convergent Charging.

Related Business Operations

Your charging client has triggered one of the following batch operations:

Async. Comm.	Sync. Comm.
acquire(..) operation specified in the AsyncBatchServiceClient class	acquire(..) operation specified in the BatchServiceClient class

Reasons

See all the available reasons detailed in this Java enum.

Example

Failure	Reason Code	Customizing and Integration	Troubleshooting (Next Steps)
Acquisition not allowed	7 ACQUISITION_NOT_ALLOWED	Note To design the exception and error handling functions (automated treatments, logging and manual treatments), see the Constant Detail section. Refer to the information available in the Customizing subsection of each failure to develop your integration code.	Note For troubleshooting investigations, see the Constant Detail section. Refer to the information available in the Next Steps subsection of each failure.

Consider the detailed information in the Constant Detail section in the AcquisitionException.AcquisitionExceptionReason enum.

Implementation in your Client Application

The SAP CC system includes this exception in an Acquisition Operation result. The exception contains a reason and a message that describe the error which occurred during the acquisition.

Exception and Error Handling

Depending on your business requirements design and develop the handling functions in your client application.

For each exception reason, you determine the expected treatments in your charging client.

Similar Exception

See the Batch Charge exception in this Java API Reference documentation.

See Also:

AcquisitionResult, BatchServiceClient.acquire(java.util.List), AcquisitionListener.onResult(java.util.List), Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AcquisitionException.AcquisitionExceptionReason This enumeration defines the possible reasons for the failure of a direct acquisition operation of chargeable items.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EXCEPTION_NAME The XML tag name of this exception: "acquisitionFault"

Constructor Summary

Constructors

Constructor and Description
AcquisitionException(AcquisitionException.AcquisitionExceptionReason reason, java.lang.String message) Creates an AcquisitionException from a reason and a message.
AcquisitionException(int reasonCode, java.lang.String message) Creates an AcquisitionException from a numeric reason code and a message.

Method Summary

Modifier and Type	Method and Description
void	addCharacterData(java.lang.String cData) Adds character data to the content element.
void	addChild(java.lang.String tagName, XMLMarshallable child) Adds a child to the object, the child representing the marshallable object which must be added to the element.
java.lang.String	getMessage()
AcquisitionException.AcquisitionExceptionReason	getReason() Gets the enumerated reason for this exception.
void	marshal(XMLOutputter output) Gives an XML representation of this object, including its children.
void	setAttributes(XMLAttributes atts) Sets the attributes of the XML representation of the element being processed.

Methods inherited from class com.highdeal.hci.OperationFailureException

getOperandReference

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Field Detail

EXCEPTION_NAME

public static final java.lang.String EXCEPTION_NAME

The XML tag name of this exception: "acquisitionFault"

See Also:

Constant Field Values

Constructor Detail

AcquisitionException

public AcquisitionException(int reasonCode,
                            java.lang.String message)

Creates an AcquisitionException from a numeric reason code and a message.

Parameters:

reasonCode - The numeric code of the reason of the exception

message - The message of the exception

AcquisitionException

public AcquisitionException(AcquisitionException.AcquisitionExceptionReason reason,
                            java.lang.String message)

Creates an AcquisitionException from a reason and a message.

Parameters:

reason - The reason of the exception

message - The message of the exception

Method Detail

getReason

public AcquisitionException.AcquisitionExceptionReason getReason()

Gets the enumerated reason for this exception.

Returns:

The failure reason of this exception

getMessage

public java.lang.String getMessage()

Overrides:

getMessage in class java.lang.Throwable

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

addChild

public void addChild(java.lang.String tagName,
                     XMLMarshallable child)

Description copied from interface: XMLMarshallable

Adds a child to the object, the child representing the marshallable object which must be added to the element.

Parameters:

tagName - The name of tag for the child

child - The child to be added

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

marshal

public void marshal(XMLOutputter output)

Description copied from interface: XMLMarshallable

Gives an XML representation of this object, including its children.

Parameters:

output - The XML output to marshal the object into