tech.paycon.sdk.v5

Class PCLogin

java.lang.Object

tech.paycon.sdk.v5.PCLogin

All Implemented Interfaces:

java.io.Serializable

public class PCLogin
extends java.lang.Object
implements java.io.Serializable

Class to perform all operations to log in with QR-code
The sample algorithm of logging in with QR-code is the following:
1. Scan QR code and extract json containing all required data
2. Call importFromJson(String, GetLoginDataCallback) to construct PCLogin object. Constructed object will be returned as parameter of success() method.
3. Call suggestUsers() on constructed object to get keys which can be used to log in
4. After choosing a key call requestLoginTransaction(PCUser, GetLoginTransactionCallback) with a selected PCUser from one of returned by suggestUsers()
5. After PCLogin.GetLoginTransactionCallback.success(PCTransaction) is invoked, you may show transaction data in the app. Note, that the PCTransaction.getTransactionText() can either return null or text of transaction. Do not try to sign this transaction manually, instead call either confirm(PCGeneralCallback) to finish logging in or decline(PCGeneralCallback) to cancel login operation.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	PCLogin.GetLoginDataCallback Callback for handling results from importFromJson(String, PCLogin.GetLoginDataCallback)
static interface	PCLogin.GetLoginTransactionCallback Callback for handling results from PCLogin.GetLoginTransactionCallback

Method Summary

Modifier and Type	Method and Description
void	confirm(PCGeneralCallback callback) Performs logging in after requestLoginTransaction(PCUser, GetLoginTransactionCallback) is finished with success for a target PCUser
void	confirm(PCKeysProcessor keysProcessor, PCLoginCallback callback) Performs logging in after requestLoginTransaction(PCUser, GetLoginTransactionCallback) is finished with success for a target PCUser
void	decline(PCGeneralCallback callback) Cancels logging in.
void	decline(PCKeysProcessor keysProcessor, PCLoginCallback callback) Cancels logging in.
static void	importFromJson(java.lang.String data, PCLogin.GetLoginDataCallback callback) Creates PCLogin object from JSON which is encoded in QR-code body
void	requestLoginTransaction(PCUser key, PCLogin.GetLoginTransactionCallback callback) Requests transaction for logging in
java.util.List<PCUser>	suggestUsers() Returns array of PCUser objects which can be used to log in with scanned QR
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

importFromJson

public static void importFromJson(java.lang.String data,
                                  PCLogin.GetLoginDataCallback callback)

Creates PCLogin object from JSON which is encoded in QR-code body

Parameters:

data - JSON extracted from QR-code

callback - callback to process results. If JSON is parsed successfully, PCLogin object with all data is passed to success() method

suggestUsers

public java.util.List<PCUser> suggestUsers()

Returns array of PCUser objects which can be used to log in with scanned QR

Returns:

array of PCUser objects

requestLoginTransaction

public void requestLoginTransaction(PCUser key,
                                    PCLogin.GetLoginTransactionCallback callback)

Requests transaction for logging in

Parameters:

key - User to be logged in

callback - Callback to handle results. success() is called when transaction received successfully and confirm(PCGeneralCallback) can be called. PCTransaction is passed to success() so that you can show it's data in the app. Do not try to sign this transaction manually

confirm

public void confirm(PCGeneralCallback callback)

Performs logging in after requestLoginTransaction(PCUser, GetLoginTransactionCallback) is finished with success for a target PCUser

Parameters:

callback - success() is called in case user is logged in successfully. At this step login operation is completed on the client side.

confirm

public void confirm(PCKeysProcessor keysProcessor,
                    PCLoginCallback callback)

Performs logging in after requestLoginTransaction(PCUser, GetLoginTransactionCallback) is finished with success for a target PCUser

Parameters:

keysProcessor - Custom keys processor which implements PCKeysProcessor. To follow default behaviour pass object returned by PCRegularKeysProcessor.getInstance() or simply call confirm(PCGeneralCallback) instead.

callback - success() is called in case user is logged in successfully. At this step login operation is completed on the client side.

decline

public void decline(PCGeneralCallback callback)

Cancels logging in. Can be called only after requestLoginTransaction(PCUser, GetLoginTransactionCallback) is finished with success for a target PCUser

Parameters:

callback - Callback to handle results

decline

public void decline(PCKeysProcessor keysProcessor,
                    PCLoginCallback callback)

Cancels logging in. Can be called only after requestLoginTransaction(PCUser, GetLoginTransactionCallback) is finished with success for a target PCUser

Parameters:

keysProcessor - Custom keys processor which implements PCKeysProcessor. To follow default behaviour pass object returned by PCRegularKeysProcessor.getInstance() or simply call decline(PCGeneralCallback) instead.

callback - Callback to handle results

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object