bd.com.ipay.sdk

Class SDKUtils

java.lang.Object

bd.com.ipay.sdk.SDKUtils

public final class SDKUtils
extends java.lang.Object

This class designed for getting information and validating various case to check whether the system is perfect to run the SDK or not.

A number of the methods in this class are for debugging or informational purposes. Most of the methods may not be needed to call by the developers.

Since:

1.0.0-SNAPSHOT

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	IPAY_COM_BD Checkout Url host name.

Constructor Summary

Constructors

Constructor and Description
SDKUtils()

Method Summary

Modifier and Type	Method and Description
protected static android.content.pm.ActivityInfo	getActivityInfo(android.content.Context context, java.lang.String className)
static boolean	hasInternetPermissions(android.content.Context context, boolean shouldThrow) Checks whether Added to the AndroidManifest or not.
static boolean	hasIPayCheckoutActivity(android.content.Context context, boolean shouldThrow)
protected static boolean	hasIPayCheckoutActivity(android.content.Context context, IPaySDK.InitializeCallback initializeCallback, boolean shouldThrow)
static boolean	isChromeInstalled(android.content.Context context) Checks if Chrome is installed or not.
static boolean	isIPayAppInstalled(android.content.Context context, boolean shouldThrow) Checks if iPay is installed or not.
static boolean	isValidCheckoutCallbackActionUrls(CheckoutCallbackActionUrls checkoutCallbackActionUrls)
static boolean	isValidIPayCheckoutUrl(java.lang.String checkoutUrl)
static boolean	isValidUrlSchemeAdded(android.content.Context context, boolean shouldThrow) Checks if the callback deeplink url is a valid one or not.
protected static boolean	isValidUrlSchemeAdded(android.content.Context context, IPaySDK.InitializeCallback initializeCallback, boolean shouldThrow) Checks if the callback deeplink url is a valid one or not.
static boolean	notNull(java.lang.Object arg, java.lang.String name) Validation method to check, whether the variable is null or not.
protected static boolean	notNull(java.lang.Object arg, java.lang.String name, IPaySDK.InitializeCallback initializeCallback) Validation method to check, whether the variable is null or not.
static void	openIPayInPlayStore(android.content.Context context) Opens the play store to install iPay.
protected static void	printSomeFancyIPaySDK() Just fancy artwork.

Methods inherited from class java.lang.Object

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

Field Detail

IPAY_COM_BD

public static final java.lang.String IPAY_COM_BD

Checkout Url host name.

See Also:

Constant Field Values

Constructor Detail

SDKUtils

public SDKUtils()

Method Detail

isValidIPayCheckoutUrl

public static boolean isValidIPayCheckoutUrl(java.lang.String checkoutUrl)

Parameters:

checkoutUrl - Url to validate

Returns:

true if the url is a valid url to checkout through ipay, if not then false.

notNull

public static boolean notNull(java.lang.Object arg,
                              java.lang.String name)

Validation method to check, whether the variable is null or not. Use case of This method is to throw NullPointerException with a proper message.

Parameters:

arg - Validating argument

name - Validation variable name

Returns:

true if not null. else throws exception.(This method will never return false as a result)

Throws:

IPaySDKException - Wraps NullPointerException. If the argument is null when the param initializeCallback is also null.

notNull

protected static boolean notNull(java.lang.Object arg,
                                 java.lang.String name,
                                 IPaySDK.InitializeCallback initializeCallback)

Validation method to check, whether the variable is null or not. Use case of This method is to throw NullPointerException with a proper message, if the argument initializeCallback is null otherwise it will return true or false. N.B.: This method is for internal use only.

Parameters:

arg - Validating argument

name - Validation variable name

initializeCallback - Callback instance to return exception as initialize fallback

Returns:

If the param initializeCallback is not null, then true if the param arg is not null. otherwise false and a failure callback will be done. If the param initializeCallback is null then true if the param arg is not null but throws exception for arg null case and will never return false as a result.

Throws:

IPaySDKException - Wraps NullPointerException. If the argument is null when the param initializeCallback is also null.

hasIPayCheckoutActivity

public static boolean hasIPayCheckoutActivity(android.content.Context context,
                                              boolean shouldThrow)

Parameters:

context - An android context

shouldThrow - Should the method throw an exception for error or not

Returns:

True when the IPayCheckoutActivity is declared in AndroidManifest.xml otherwise false.

Throws:

IPaySDKInitializeException - If the param shouldThrow is true method will throw the exception when the IPayCheckoutActivity is not declared in AndroidManifest.xml or present.

hasIPayCheckoutActivity

protected static boolean hasIPayCheckoutActivity(android.content.Context context,
                                                 IPaySDK.InitializeCallback initializeCallback,
                                                 boolean shouldThrow)

Parameters:

context - An android context

initializeCallback - Callback instance to return exception as initialize fallback

shouldThrow - should the method throw an exception for error or not

Returns:

True when the IPayCheckoutActivity is declared in AndroidManifest.xml otherwise false.

Throws:

IPaySDKInitializeException - If the param shouldThrow is true method will throw the exception when the IPayCheckoutActivity is not declared in AndroidManifest.xml or present.

getActivityInfo

protected static android.content.pm.ActivityInfo getActivityInfo(android.content.Context context,
                                                                 java.lang.String className)
                                                          throws android.content.pm.PackageManager.NameNotFoundException,
                                                                 java.lang.NullPointerException

Parameters:

context - An android context

className - name of the android activity class

Returns:

ActivityInfo of the given activity name.

Throws:

android.content.pm.PackageManager.NameNotFoundException

java.lang.NullPointerException

isIPayAppInstalled

public static boolean isIPayAppInstalled(android.content.Context context,
                                         boolean shouldThrow)

Checks if iPay is installed or not.

In case of iPay app isn't install it is recommended that prompt user to install iPay app. To perform install iPay app via Play Store please see/use openIPayInPlayStore(Context)

Parameters:

context - An android context

shouldThrow - should the method throw an exception for error or not

Returns:

whether iPay App is installed or not.

isChromeInstalled

public static boolean isChromeInstalled(android.content.Context context)

Checks if Chrome is installed or not.

Parameters:

context - An android context

Returns:

whether Chrome App is installed or not.

hasInternetPermissions

public static boolean hasInternetPermissions(android.content.Context context,
                                             boolean shouldThrow)

Checks whether Added to the AndroidManifest or not.

Parameters:

context - An android context

shouldThrow - Should the method throw an exception for error or not

Returns:

If the application has the network access permission or not.

isValidUrlSchemeAdded

public static boolean isValidUrlSchemeAdded(android.content.Context context,
                                            boolean shouldThrow)

Checks if the callback deeplink url is a valid one or not. This method will also check if the url was also provided by the developers or not.

Parameters:

context - An android context

shouldThrow - Should the method throw an exception for error or not

Returns:

If the deeplink url was provided or not. also checks provided url scheme is valid or not.

Throws:

IPaySDKInitializeException - If the param shouldThrow is true method will throw the exception for an invalid url callback scheme.

isValidUrlSchemeAdded

protected static boolean isValidUrlSchemeAdded(android.content.Context context,
                                               IPaySDK.InitializeCallback initializeCallback,
                                               boolean shouldThrow)

Checks if the callback deeplink url is a valid one or not. This method will also check if the url was also provided by the developers or not.

Parameters:

context - An android context

initializeCallback - Callback instance to return exception as initialize fallback

shouldThrow - Should the method throw an exception for error or not

Returns:

If the deeplink url was provided or not. also checks provided url scheme is valid or not.

Throws:

IPaySDKInitializeException - If the param shouldThrow is true method will throw the exception for an invalid url callback scheme.

openIPayInPlayStore

public static void openIPayInPlayStore(android.content.Context context)

Opens the play store to install iPay.

Parameters:

context - An android context

isValidCheckoutCallbackActionUrls

public static boolean isValidCheckoutCallbackActionUrls(CheckoutCallbackActionUrls checkoutCallbackActionUrls)

printSomeFancyIPaySDK

protected static void printSomeFancyIPaySDK()

Just fancy artwork. :)