com.radiusnetworks.proximity.licensing

Class LicenseManager

java.lang.Object

com.radiusnetworks.proximity.licensing.LicenseManager

public class LicenseManager
extends Object

Class used to check to see if the license is valid for the ProximityLibrary. The basic idea is that a call will be made to the server with the user's token and if it gets a valid response, access is granted. However, if the server cannot be reached for some reason, or if the server returns an ambiguous or erroroneous resopnse, the user will be given continued access. Access is only denied if the server gives a deliberate response to the check saying the license is invalid, or if a configured license cannot be found at all.

Currently, the implementation looks for a ProximityKit.properties file on the classpath, and tries to pull out the PKAPIToken field as the license key. The server URL that is checked is the PKKitURL with the hostname replaced with licensing.radiusnetworks.com

This implementation leaves plenty of room for the user to defeat the licensing mechanism, including: 1. disabling internet access for the app

Both of the above will eliminate the ability to access ProximityKit data.

Since:

0.1.0

Constructor Summary

Constructors

Constructor and Description
LicenseManager(Context context)
LicenseManager(Context context, Configuration configuration, String badStandingReason, Date lastLicenseCheck) Deprecated. Not for public use. As of 0.12.0 no replacement.

Method Summary

Modifier and Type	Method and Description
void	clearPartnerId() Clears the partner identifier string for analytics.
String	getAccountId()
Configuration	getConfiguration()
String	getDeviceId()
int	getServerCheckCount() Deprecated. Not for public use. As of 0.12.0 no replacement.
void	reconfigure(Configuration config) Used to change the credentials at runtime.
void	reconfigure(Context context) Deprecated. As of 0.10.0, replaced by LicenseManager.reconfigure(Configuration)
void	reconfigure(String apiUrl, String apiToken) Deprecated. As of 0.10.0, replaced by LicenseManager.reconfigure(Configuration)
void	resetLicenseCheck() Deprecated. Not for public use. As of 0.12.0 no replacement. This method no longer does anything.
void	setPartnerId(String identifier) Sets the partner identifier string for analytics.
void	validateLicense() Deprecated. Not for public use. As of 0.12.0 no replacement. This method no longer does anything.

Methods inherited from class java.lang.Object

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

Constructor Detail

LicenseManager

public LicenseManager(Context context)

LicenseManager

@Deprecated
public LicenseManager(Context context,
                                  Configuration configuration,
                                  String badStandingReason,
                                  Date lastLicenseCheck)

Deprecated. Not for public use. As of 0.12.0 no replacement.

Not for public use.

This constructor is used for unit tests to insert state

Method Detail

reconfigure

@Deprecated
public void reconfigure(Context context)

Deprecated. As of 0.10.0, replaced by LicenseManager.reconfigure(Configuration)

Used to change the credentials at runtime if needed

Parameters:

context -

reconfigure

@Deprecated
public void reconfigure(String apiUrl,
                                    String apiToken)

Deprecated. As of 0.10.0, replaced by LicenseManager.reconfigure(Configuration)

Used to change the credentials at runtime if needed

Parameters:

apiUrl -

apiToken -

reconfigure

public void reconfigure(Configuration config)

Used to change the credentials at runtime.

Not for public use.

Parameters:

config - The new configuration settings for the manager.

getConfiguration

public Configuration getConfiguration()

getAccountId

public String getAccountId()

getServerCheckCount

@Deprecated
public int getServerCheckCount()

Deprecated. Not for public use. As of 0.12.0 no replacement.

Returns:

Always returns 0.

setPartnerId

public void setPartnerId(String identifier)

Sets the partner identifier string for analytics.

Parameters:

identifier - Custom partner identifier used for analytics

Since:

0.7.0

clearPartnerId

public void clearPartnerId()

Clears the partner identifier string for analytics.

Since:

0.7.0

validateLicense

@Deprecated
public void validateLicense()

Deprecated. Not for public use. As of 0.12.0 no replacement. This method no longer does anything.

getDeviceId

public String getDeviceId()

resetLicenseCheck

@Deprecated
public void resetLicenseCheck()

Deprecated. Not for public use. As of 0.12.0 no replacement. This method no longer does anything.