AsyncStatefulServiceClientCtrl (SAP CC 4.0 Core

Overview

Package

Class

Tree

Deprecated

Index

Help

SAP Convergent Charging

Core APIs (Java and XML)

BART APIs (Java and XML)

IEC APIs (Java)

Java and XML APIs (Core)

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.highdeal.cnd.message
Class AsyncStatefulServiceClientCtrl

java.lang.Object
  com.highdeal.cnd.message.AsyncStatefulServiceClientCtrl

All Implemented Interfaces:: ClientOpEventListener

public class AsyncStatefulServiceClientCtrl
extends java.lang.Object
implements ClientOpEventListener
extends java.lang.Object
implements ClientOpEventListener

This class represents a client operation event listener able to supervise the activity of the instances of the SAP CC Core Server system by limiting the number of operations in the server instances.
It is possible to enable the average latency controller. But the expected latency cannot be lower than the system's minimum. This can decrease the charging operation throughput.

Performance Management

You can fine tune the behavior of your client application for processing real-time charging services. The following advanced options are available:

maxQueueSizeToWait: This is the maximum number of requests to be sent that the AsyncStatefulServiceClient will hold at a given point of time. This is used to avoid potential overflow of the connected SAP CC system. Asking the AsyncStatefulServiceClient to send additional requests beyond this parameter value will cause the client to wait before sending the extra requests.
queueSizeToNotify: This is the maximum number of requests the AsyncStatefulServiceClient is awaiting a response for before it can send more requests to the connected SAP CC system. This is used to avoid potential overflow of the connected SAP CC system. Technically, if the number of requests already sent and not having received a response yet is greater than queueSizeToNotify, then no more additional requests will be sent by AsyncStatefulServiceClient. When the number of requests without a response drops below queueSizeToNotify, then the pending requests in the sending queue are sent.
- The value of queueSizeToNotify must be strictly less than maxQueueSizeToWait. It must be a non-null value.

Recommendation

During the implementation project phase:

You set up the maximum queue size to wait (maxQueueSizeToWait) with the value of the STATEFUL_SERVICE_QUEUE_SIZE system parameter defined in the dispatcher instances of the SAP CC system. The dispatcher instances are the public endpoints of the Message TCP technical interface
- In case multiple charging clients are used, the sum of all the queue sizes for all the clients shall be equal to the value of the STATEFUL_SERVICE_QUEUE_SIZE system parameter defined in the dispatcher instances of the connected SAP CC system.
You set up the queue size to notify (queueSizeToNotify) with around 90% of the value maxQueueSizeToWait.

Refer to the SAP CC System Parameter Reference for more information about this system parameter.

Implementation in Your Client Application

Code Snippet

Here is an example of use:

      AsyncStatefulServiceClient client = new AsyncStatefulServiceClient();
      client.setClientOpEventListener(ClientOpEventTopic.DEFAULT, new AsyncStatefulServiceClientCtrl());

Notes on SAP CC Implementation

This fine-tuning depends on the fine-tuning of the connected SAP CC system. This system may be customized during the implementation project phase. Consider the values of the STATEFUL_SERVICE_QUEUE_SIZE system parameter. Consult the SAP CC System Parameter Reference for more information.

Field Summary
`static int`	`MIN_QUEUE_SIZE_TO_NOTIFY_VALUE`
`static int`	`MIN_QUEUE_SIZE_TO_WAIT_VALUE`
`static int`	`QUEUE_SIZE_TO_NOTIFY_DEFAULT_VALUE`
`static int`	`QUEUE_SIZE_TO_WAIT_DEFAULT_VALUE`

Constructor Summary
`AsyncStatefulServiceClientCtrl()` This is an equivalent of AsyncStatefulServiceClientCtrl(AsyncStatefulServiceClientCtrl.QUEUE_SIZE_TO_WAIT_DEFAULT_VALUE, AsyncStatefulServiceClientCtrl.MIN_QUEUE_SIZE_TO_NOTIFY_VALUE)
`AsyncStatefulServiceClientCtrl(int queueSizeToWait, int queueSizeToNotify)` The queueSizeToWait is the maximum number of waiting requests to be executed by the servers.

Method Summary
`void`	`onLookupException(ClientOpEventInformation clientOpInfo)` Called if an exception is raised during the guiding lookup before giving a response to the client.
`void`	`onLookupResult(ClientOpEventInformation clientOpInfo)` Called when the guiding lookup result is received.
`ClientOpEventInformation`	`onLookupStart(ClientOpEventTopic topic)` Called before the guiding lookup only if the the guiding lookup is the first action of the client operation.
`void`	`onOpException(ClientOpEventInformation clientOpInfo)` Called if an exception is raised during the operation execution before giving a response to the client.
`void`	`onOpResult(ClientOpEventInformation clientOpInfo)` Called when the operation result is received.
`ClientOpEventInformation`	`onOpStart(ClientOpEventTopic topic)` Called when an operation start only if the first operation is not a guiding lookup.
`void`	`onOpStartAnotherOperation(ClientOpEventInformation clientOpInfo)` Called when a failed operation implies to call another operation.
`void`	`setClientQueueListenerSize(int maxQueueSizeToWait, int minQueueSizeToWait, int queueSizeToNotify, long spotLatency)` The queueSizeToWait is the maximum number of waiting requests to be executed by the servers; Additional requests make the client waiting.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

QUEUE_SIZE_TO_WAIT_DEFAULT_VALUE

public static final int QUEUE_SIZE_TO_WAIT_DEFAULT_VALUE

See Also:: Constant Field Values

QUEUE_SIZE_TO_NOTIFY_DEFAULT_VALUE

public static final int QUEUE_SIZE_TO_NOTIFY_DEFAULT_VALUE

See Also:: Constant Field Values

MIN_QUEUE_SIZE_TO_WAIT_VALUE

public static final int MIN_QUEUE_SIZE_TO_WAIT_VALUE

See Also:: Constant Field Values

MIN_QUEUE_SIZE_TO_NOTIFY_VALUE

public static final int MIN_QUEUE_SIZE_TO_NOTIFY_VALUE

See Also:: Constant Field Values

Constructor Detail

AsyncStatefulServiceClientCtrl

public AsyncStatefulServiceClientCtrl()

This is an equivalent of AsyncStatefulServiceClientCtrl(AsyncStatefulServiceClientCtrl.QUEUE_SIZE_TO_WAIT_DEFAULT_VALUE, AsyncStatefulServiceClientCtrl.MIN_QUEUE_SIZE_TO_NOTIFY_VALUE)

AsyncStatefulServiceClientCtrl

public AsyncStatefulServiceClientCtrl(int queueSizeToWait,
                                      int queueSizeToNotify)

The queueSizeToWait is the maximum number of waiting requests to be executed by the servers. Additional requests make the client waiting. When the number of waiting requests get lower or equal to queueSizeToNotify and at least one client waits, all the clients are woke up.

Parameters:: queueSizeToWait - The queueSizeToWait value, the minimal value is MIN_QUEUE_SIZE_TO_WAIT_VALUE.; queueSizeToNotify - The queueSizeToNotify value, the minimal value is MIN_QUEUE_SIZE_TO_NOTIFY_VALUE and the maximal value is the value of queueListenerSizeToWait parameter minus one.

Method Detail

setClientQueueListenerSize

public void setClientQueueListenerSize(int maxQueueSizeToWait,
                                       int minQueueSizeToWait,
                                       int queueSizeToNotify,
                                       long spotLatency)

The queueSizeToWait is the maximum number of waiting requests to be executed by the servers; Additional requests make the client waiting. The minQueueSizeToWait, maxQueueSizeToWait is couple of minimal, maximum values used to adapt queueSizeToWait according to expected latency. When the number of waiting requests get lower or equal to queueSizeToNotify and at least one client waits, all the clients are woke up.

Parameters:: maxQueueSizeToWait - The maxQueueSizeToWait value, the minimal value is MIN_QUEUE_SIZE_TO_WAIT_VALUE.; minQueueSizeToWait - The minQueueSizeToWait value, the minimal value is MIN_QUEUE_SIZE_TO_WAIT_VALUE.; queueSizeToNotify - The queueListenerSizeToNotify value, the minimal value is MIN_QUEUE_SIZE_TO_NOTIFY_VALUE and the maximal value is the value of queueListenerSizeToWait parameter minus one.; spotLatency - The expected average latency. The minimal value is 1 to enable the average latency controller.