oracle.wireless.billing
Class BillingController

java.lang.Object
  |
  +--oracle.wireless.billing.BillingController

public class BillingController

extends java.lang.Object

Billing controller handles the billing system interaction for the components

Method Summary

BillingResult	cancelService(BillingContext context, java.lang.String referenceId) Called to inform the billing system of cancellation of the service request
BillingResult	cancelService(ServiceDetailRecord sdr) Called to inform the billing system of cancellation of the service request
BillingTransaction	getCurrentTransaction() The transaction could be set by the driver or collector or application
static BillingController	getInstance()
boolean	isBillingEnabled() returns true/false config parameter to indicate that billing is enabled
BillingResult	postService(BillingContext context) Called to inform the billing system after the service request This call is made to create SDR.
BillingResult	postService(BillingContext context, java.lang.String referenceId) Called to inform the billing system after the service request This call is made to create SDR and set the reference id.
BillingResult	postService(ServiceDetailRecord sdr) Called to inform the billing system after the service request The service detail record passed here is the one returned during the the preService() The SDR is logged to the database before contacting the billing system
BillingResult	preService(BillingContext context) Called to inform the billing system before the service request
void	setCurrentTransaction(BillingTransaction transaction)
void	setRegisterMessagingStatusListener(StatusListener statusListener) Registers a messaging status listener with the messaging server to getting message status callbacks

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static BillingController getInstance()

isBillingEnabled

public boolean isBillingEnabled()

returns true/false config parameter to indicate that billing is enabled

Returns:

true if billing is enabled

getCurrentTransaction

public BillingTransaction getCurrentTransaction()

The transaction could be set by the driver or collector or application

Returns:

BillingTransaction returns the current trasaction

setCurrentTransaction

public void setCurrentTransaction(BillingTransaction transaction)

postService

public BillingResult postService(ServiceDetailRecord sdr)
                          throws BillingException

Called to inform the billing system after the service request The service detail record passed here is the one returned during the the preService() The SDR is logged to the database before contacting the billing system

Parameters:

sdr - The service detail record created during the preService() call. If the component doesn't have the SDR created during preService - the overloaded api can be used

Returns:

BillingResult the billing result containing the SDR passed to the billing system and the billing status. A null is permitted to allow integrators to bypass billing for a particular component or service.

Throws:

BillingException - Incase of any failure

postService

public BillingResult postService(BillingContext context)
                          throws BillingException

Called to inform the billing system after the service request This call is made to create SDR. If the SDR returned from the preService() is available then use the api which accepts the SDR as parameter The SDR is logged to the database before contacting the billing system

Parameters:

context - The billing context passed to create the service detail record

Returns:

BillingResult the billing result containing the SDR passed to the billing system and the billing status. A null is permitted to allow integrators to bypass billing for a particular component or service.

Throws:

BillingException - Incase of any failure

postService

public BillingResult postService(BillingContext context,
                                 java.lang.String referenceId)
                          throws BillingException

Called to inform the billing system after the service request This call is made to create SDR and set the reference id. If the SDR returned from the preService() is available then use the api which accepts the SDR as parameter The SDR is logged to the database before contacting the billing system

Parameters:

context - The billing context passed to create the service detail record

referenceId - The billing reference id returned by billling system during preService

Returns:

BillingResult the billing result containing the SDR passed to the billing system and the billing status. A null is permitted to allow integrators to bypass billing for a particular component or service.

Throws:

BillingException - Incase of any failure

preService

public BillingResult preService(BillingContext context)
                         throws BillingException

Called to inform the billing system before the service request

Parameters:

context - The billing context passed to create the service detail record

Returns:

BillingResult the billing result containing the SDR passed to the billing system and the billing status. A null is permitted to allow integrators to bypass billing for a particular component or service.

Throws:

BillingException - Incase of any failure

cancelService

public BillingResult cancelService(BillingContext context,
                                   java.lang.String referenceId)
                            throws BillingException

Called to inform the billing system of cancellation of the service request

Parameters:

context - The billing context passed to create the service detail record

Returns:

BillingResult the billing result containing the SDR passed to the billing system and the billing status. A null is permitted to allow integrators to bypass billing for a particular component or service.

Throws:

BillingException - Incase of any failure

cancelService

public BillingResult cancelService(ServiceDetailRecord sdr)
                            throws BillingException

Called to inform the billing system of cancellation of the service request

Returns:

BillingResult the billing result containing the SDR passed to the billing system and the billing status. A null is permitted to allow integrators to bypass billing for a particular component or service.

Throws:

BillingException - Incase of any failure

setRegisterMessagingStatusListener

public void setRegisterMessagingStatusListener(StatusListener statusListener)

Registers a messaging status listener with the messaging server to getting message status callbacks

Parameters:

statusListener - the status listener object which implements the StatusListener interface