tech.paycon.sdk.v5.utils

Interface PCProcessOperationCallback

All Superinterfaces:

PCTaskCallback

public interface PCProcessOperationCallback
extends PCTaskCallback

Callback for handling results from PCOperationsManager.processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback) and related methods. While processing an operation one of the following scenarios may appear:

1. Some crucial error occurred even before interacting with server: error(PCAbstractError) is invoked. The error is type of PCError or if custom keys processor is used, the type of error may be one produced by that keys processor.
2. A crucial error occurred when interacting with the server (e.g. connection timeout exceeded, authorization failed etc.): error(PCAbstractError) is invoked and the error is type of PCNetError.
3. Generally, the operation has been processed, but not all transactions have been processed successfully: result(PCOperation, List, List) is invoked. Analyse each PCConfirmationResult and PCDeclinationResult to find out if there were any errors.
4. The whole set of passed transactions has been successfully processed: result(PCOperation, List, List) is also invoked. You also have to analyse each PCConfirmationResult and PCDeclinationResult to find out if there were any errors.
   The quickest way to check if all transactions have been processed is to verify that the size of PCOperation.getTransactions() was reduced by the number of transactions intended to be processed.

See Also:

PCOperationsManager.processOperation(PCUser, PCOperation, List, List, PCProcessOperationCallback)

Method Summary

Modifier and Type	Method and Description
void	error(PCAbstractError error) An error which may occur: Before processing the operation (e.g.
void	result(PCOperation operation, java.util.List<PCConfirmationResult> confirmationResults, java.util.List<PCDeclinationResult> declinationResults) This method is called when there was no fatal error preventing the operation processing.

Methods inherited from interface tech.paycon.sdk.v5.utils.PCTaskCallback

onTaskCancelled, onTaskCreated

Method Detail

result

void result(PCOperation operation,
            java.util.List<PCConfirmationResult> confirmationResults,
            java.util.List<PCDeclinationResult> declinationResults)

This method is called when there was no fatal error preventing the operation processing. In a completely successful case, this method returns the operation with unprocessed transactions (or the empty operation, if all the transactions were to be processed) and for each confirmation adn declination results methods PCActionResult.getError() and PCActionResult.getError() return null (i.e., there were no errors). If some transactions were ot processed PCActionResult.getError() and PCActionResult.getError() will return an error describing the reason.
Although the each transaction might be failed to process due to a unique reason, commonly you will get the one reason for all failed transactions (like confirmation code was wrong because of transaction data is corrupted).

Parameters:

operation - The processed operation with rest of transactions which remain to be confirmed or declined. If all transactions were processed, the operation with an empty list of transactions is returned.

confirmationResults - List of results for transactions to be confirmed. If PCActionResult.getError() returns null, it is the evidence that the transaction returned by PCActionResult.getTransaction() was confirmed successfully, otherwise it is the evidence that something went wrong and the transaction has not been confirmed.

declinationResults - List of results for transactions to be declined. If PCActionResult.getError() returns null, it is the evidence that the transaction returned by PCActionResult.getTransaction() was declined successfully, otherwise it is the evidence that something went wrong and the transaction has not been declined.

error

void error(PCAbstractError error)

An error which may occur:

1. Before processing the operation (e.g. password is not submitted). Normally, the error of type PCError is returned but if the non-default keys processor is used, the error may also be of some type produced by this keys processor.
2. While processing the operation when the request to the server is unsuccessful, e.g. the network connection is lost or the server responds an error.

Parameters:

error - An error which prevents the processing of the whole operation

See Also:

PCRegularKeysProcessor