com.orange.webcom.sdk

Class Webcom

Query

com.orange.webcom.sdk.Webcom

public class Webcom
extends Query

A Webcom object is the entry point to the Webcom Datasync and Authentication services.

Important change over the legacy API: Initialization

Before you can instantiate a class Webcom object, the SDK must have completed its initialization. To do so, you should register a Runnable to be called after the initialization is complete using the Webcom.onReady static method. Once any listener registered through this method has been called, all subsequent calls to the the are safe.

Examples

Java

Webcom.onReady(() -> {
    Webcom ref = new Webcom("");
    (...)
});

Kotlin

Webcom.onReady {
    val ref = Webcom("")
    (...)
}

See Also:

the legacy API, class Webcom, Runnable, Webcom.onReady

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Webcom.Companion

Field Summary

Fields

Modifier and Type	Field and Description
static Webcom.Companion	Companion

Constructor Summary

Constructors

Constructor and Description
Webcom(java.net.URL url, WebcomOptions options) Deprecated.
Webcom(java.net.URL url) Deprecated.
Webcom(java.lang.String url, WebcomOptions options) Deprecated.
Webcom(java.lang.String url) Deprecated.
Webcom(WebcomApp application, WebcomOptions options) Creates a reference that represents the Webcom application.
Webcom(WebcomApp application) Creates a reference that represents the Webcom application.

Method Summary

Modifier and Type	Method and Description
void	addAccount(java.lang.String provider, AuthDetails details, MessageDetails messageDetails, OnAuth callback) Adds a new account to the app referred to by this class Webcom instance. The new account is associated to a new identity with the provider authentication mehtod, whose details (typically msisdn, email or password) are provided by the details parameter. Currently, only 2 authentication methods are available to add an account: "password" (authentication with email and password) or "phone" (authentication with msisdn and one-time-password).
void	addAccount(java.lang.String provider, AuthDetails details, OnAuth callback) Adds a new account to the app referred to by this class Webcom instance. See Webcom.addAccount.
void	authAnonymously(OnAuth callback)
void	authAnonymously()
void	authWithCustomProvider(java.lang.String provider, java.lang.String token, OnAuth callback)
void	authWithCustomProvider(java.lang.String provider, java.lang.String token)
void	authWithOAuth(android.content.Context context, java.lang.String provider, AuthOptions options, OnAuthWithOAuth listener, boolean forcesWebView)
void	authWithOAuth(android.content.Context context, java.lang.String provider, AuthOptions options, OnAuthWithOAuth listener)
void	authWithOAuth(android.content.Context context, java.lang.String provider, AuthOptions options)
void	authWithOAuth(android.content.Context context, java.lang.String provider, OnAuthWithOAuth listener, AuthOptions options)
void	authWithOAuth(android.content.Context context, java.lang.String provider, OnAuthWithOAuth listener)
void	authWithOAuth(android.content.Context context, java.lang.String provider)
void	authWithPassword(java.lang.String email, java.lang.String password, OnAuth callback)
void	authWithPassword(java.lang.String email, java.lang.String password)
void	authWithPhone(java.lang.String id, java.lang.String challenge, java.lang.String password) Authenticates a user using her/his phone number. This method requires sending beforehand a one-time-password (OTP) to the user using the Webcom.sendOtp method. This operation is performed asynchronously. Upon authentication completion or failure, the registered authentication callbacks are called (see Webcom.registerAuthCallback).
void	authWithPhone(java.lang.String id, java.lang.String challenge, java.lang.String password, OnAuth callback) Authenticates a user using her/his phone number. This method requires sending beforehand a one-time-password (OTP) to the user using the Webcom.sendOtp method. This operation is performed asynchronously. Upon authentication completion or failure, the registered authentication callbacks are called (see Webcom.registerAuthCallback).
void	authWithToken(java.lang.String token, OnAuth callback)
void	authWithWassup(AuthOptions options, OnAuth listener)
void	authWithWassup(AuthOptions options)
void	authWithWassup(OnAuth listener)
void	changePassword(java.lang.String email, java.lang.String oldPassword, java.lang.String newPassword, OnAuth callback)
Webcom	child(java.lang.String path) Returns a reference on the data node specified by a path relatively to the data node referred to by this instance.
void	createUser(java.lang.String email, java.lang.String password, OnAuth callback)
java.lang.String	getInternalHostUrl()
void	goOffline() Forces disconnection of the Datasync service associated with this instance from the Webcom back end.
void	goOnline() Forces reconnection of the Datasync service associated with this instance to the Webcom back end.
java.lang.Object	internalRepresentation()
void	logout(OnComplete onComplete)
void	logout()
java.lang.String	name()
OnDisconnect	onDisconnect()
static void	onReady(java.lang.Runnable runnable) Registers the runnable callback to be called as soon as the Webcom SDK has completed its initialization.
Webcom	parent() Returns a reference on the parent data node wrt. to the data node referred to by this instance.
void	persist()
Webcom	push() Returns a reference on a child data node with a unique key.
Webcom	push(java.lang.Object data, OnComplete onComplete) Write some given data under a new child data node with a unique key.
Webcom	push(java.lang.Object data) Write some given data under a new child data node with a unique key.
void	registerAuthCallback(OnAuth onAuth)
void	remove(OnComplete onComplete)
void	remove()
void	removeAccount(OnComplete callback) Removes the Webcom account of the currently authenticated user. Note that all identities attached to this account will also be deleted.
void	removeIdentity(OnComplete callback) Removes the identity of the currently authenticated user from her/his Webcom account. This identity will then be no longer available for authenticating the user. All other identities attached to this account will remain and will still be available for authentication. However, note that if the removed identity is the last attached one to the user account, then the whole account is deleted (otherwise it would result in a "ghost" account with no means of authentication).
void	removeUser(java.lang.String email, java.lang.String password, OnAuth callback)
void	resume()
Webcom	root() Returns a reference on the root data node of the Datasync service associated with this instance.
void	sendConfirmationEmail(java.lang.String email, OnComplete callback)
void	sendOtp(java.lang.String provider, java.lang.String id, MessageDetails messageDetails, OnValue callback) Sends a one time password to a user. Such a temporary password may then be used to authenticate the user using the Webcom.authWithPhone method.
void	sendOtp(java.lang.String provider, java.lang.String id, OnValue callback) Sends a one time password to a user using the default "login" message template.
void	sendPasswordResetCode(java.lang.String provider, java.lang.String id, MessageDetails messageDetails, OnComplete callback)
void	sendPasswordResetCode(java.lang.String provider, java.lang.String id, MessageDetails messageDetails)
void	sendPasswordResetCode(java.lang.String provider, java.lang.String id)
void	sendPasswordResetCode(java.lang.String provider, java.lang.String id, OnComplete callback)
void	sendPasswordResetEmail(java.lang.String email, OnAuth callback)
void	sendVerificationCode(java.lang.String provider, java.lang.String id, MessageDetails messageDetails, OnValue callback)
void	sendVerificationCode(java.lang.String provider, java.lang.String id, OnValue callback)
java.lang.Object	set(java.lang.Object data, OnComplete onComplete)
java.lang.Object	set(java.lang.Object data)
boolean	shouldBeOnline() Returns the working status of the Datasync service associated with this instance wrt. to the network connection.
java.lang.String	toString()
void	transaction(TransactionCallback callbacks, boolean applyLocally)
void	transaction(TransactionCallback callbacks)
void	unregisterAuthCallback(OnAuth onAuth)
void	update(java.lang.Object data, OnComplete onComplete)
void	update(java.lang.Object data)
void	updateEmailPasswordProfile(java.lang.String path, java.lang.Object data, OnComplete callback)
void	updateEmailPasswordProfile(java.lang.Object data, OnComplete callback)
void	updateIdentityProfile(java.lang.String path, java.lang.Object data, OnComplete callback)
void	updateIdentityProfile(java.lang.Object data, OnComplete callback)
void	useCurrentContextForNextAuthOperation()
void	useNewContextForNextAuthOperation()
void	verifyIdentity(java.lang.String provider, java.lang.String id, VerificationData data, OnAuth callback) Verifies the authentication details (typically msisdn or email address) of a newly created identity using the Webcom.addAccount method. If the verification is successful, then the user is automatically authenticated with the verified identity.
static void	waitForReady() Blocks the calling thread until the Webcom SDK has completed its initialization.
void	wakeupSubscribe(java.lang.String id, java.lang.String mode, OnComplete callback)
void	wakeupSubscribe(java.lang.String id, OnComplete callback)
void	wakeupUnsubscribe(java.lang.String id, OnComplete callback)

Methods inherited from class com.orange.webcom.sdk.Query

endAt, endAt, equalTo, finalize, getUid, limit, off, off, off, off, on, on, once, path, queryIdentifier, queryObject, ref, startAt, startAt

Field Detail

Companion

public static Webcom.Companion Companion

Constructor Detail

Webcom

@JvmOverloads
 @Deprecated
public Webcom(@NotNull
                                         java.net.URL url,
                                         @Nullable
                                         WebcomOptions options)

Deprecated.

Webcom

@JvmOverloads
 @Deprecated
public Webcom(@NotNull
                                         java.net.URL url)

Deprecated.

Webcom

@JvmOverloads
 @Deprecated
public Webcom(@NotNull
                                         java.lang.String url,
                                         @Nullable
                                         WebcomOptions options)

Deprecated.

Webcom

@JvmOverloads
 @Deprecated
public Webcom(@NotNull
                                         java.lang.String url)

Deprecated.

Webcom

@JvmOverloads
public Webcom(@NotNull
                            WebcomApp application,
                            @Nullable
                            WebcomOptions options)

Creates a reference that represents the Webcom application.

When specified, the options make it possible to customise some initialisation behaviors.

See Also:

class WebcomOptions

Webcom

@JvmOverloads
public Webcom(@NotNull
                            WebcomApp application)

Creates a reference that represents the Webcom application.

When specified, the options make it possible to customise some initialisation behaviors.

See Also:

class WebcomOptions

Method Detail

getInternalHostUrl

@NotNull
public java.lang.String getInternalHostUrl()

goOnline

public void goOnline()

Forces reconnection of the Datasync service associated with this instance to the Webcom back end.

It makes the shouldBeOnline method return true whatever the network state. If the network is unavailable, then it will reconnect automatically as soon as the network becomes available with a back-off retry policy.

See Also:

shouldBeOnline, goOffline

goOffline

public void goOffline()

Forces disconnection of the Datasync service associated with this instance from the Webcom back end.

It makes the shouldBeOnline method return false whatever the network state and all datasync operations work offline on the client. The reconnection to the back end must be forced by calling the goOnline method.

See Also:

shouldBeOnline, goOnline

root

@NotNull
public Webcom root()

Returns a reference on the root data node of the Datasync service associated with this instance.

child

@NotNull
public Webcom child(@NotNull
                             java.lang.String path)

Returns a reference on the data node specified by a path relatively to the data node referred to by this instance.

The path specification accommodates the following rules:

• It may include several path segments separated by slashes ("/"),

• It is always interpreted relatively to the current data node, even if it starts with a slash,

• Special path segments "." and ".." are interpreted as "same node" and "parent node". Warning: ".." on the root data node returns itself (and not null as the parent method does),

• Special path segments starting with "#" or ".hash." are expanded into 4 level paths that hash the initial segment name, in order to handle very large lists (up to more than 10^15 elements, see Browse data),

• Special path segments starting with ".list." give a hint to the Webcom back end that the corresponding nodes are intended to have many children (as a list) so that it optimises the individual retrieval of their children, preventing retrieving the nodes as a whole when the data of all their children become too big.

See Also:

path, parent, Browse data

parent

@Nullable
public Webcom parent()

Returns a reference on the parent data node wrt. to the data node referred to by this instance.

If this instance points to the root data node of the Datasync service associated with this instance, then this method returns null.

push

@NotNull
public Webcom push()

Returns a reference on a child data node with a unique key.

The key (or name) of the child data node is guaranteed to be unique and lexicographically ordered after any previously generated key by any of the push methods. This method doesn't write anything in the Webcom database and works synchronously.

See Also:

push

push

@JvmOverloads
 @NotNull
public Webcom push(@Nullable
                                           java.lang.Object data,
                                           @Nullable
                                           OnComplete onComplete)

Write some given data under a new child data node with a unique key.

The key (or name) of the child data node where to write the data is guaranteed to be unique and lexicographically ordered after any previously generated key by any of the push methods. The data is written asynchronously, the given onComplete callback object will be called as soon as the write is acknowledged by the back end. However, the method itself returns synchronously a class Webcom reference on the child data node where the write operation will take place.

Returns:

a reference on the new child data node where the data is to be written

See Also:

data, data, push, data, onComplete, class Webcom

push

@JvmOverloads
 @NotNull
public Webcom push(@Nullable
                                           java.lang.Object data)

Write some given data under a new child data node with a unique key.

The key (or name) of the child data node where to write the data is guaranteed to be unique and lexicographically ordered after any previously generated key by any of the push methods. The data is written asynchronously, the given onComplete callback object will be called as soon as the write is acknowledged by the back end. However, the method itself returns synchronously a class Webcom reference on the child data node where the write operation will take place.

Returns:

a reference on the new child data node where the data is to be written

See Also:

data, data, push, data, onComplete, class Webcom

set

@JvmOverloads
 @NotNull
public java.lang.Object set(@Nullable
                                                    java.lang.Object data,
                                                    @Nullable
                                                    OnComplete onComplete)

set

@JvmOverloads
 @NotNull
public java.lang.Object set(@Nullable
                                                    java.lang.Object data)

remove

@JvmOverloads
public void remove(@Nullable
                                 OnComplete onComplete)

remove

@JvmOverloads
public void remove()

update

@JvmOverloads
public void update(@Nullable
                                 java.lang.Object data,
                                 @Nullable
                                 OnComplete onComplete)

update

@JvmOverloads
public void update(@Nullable
                                 java.lang.Object data)

resume

public void resume()

logout

@JvmOverloads
public void logout(@Nullable
                                 OnComplete onComplete)

logout

@JvmOverloads
public void logout()

registerAuthCallback

public void registerAuthCallback(@NotNull
                                 OnAuth onAuth)

unregisterAuthCallback

public void unregisterAuthCallback(@NotNull
                                   OnAuth onAuth)

name

@Nullable
public java.lang.String name()

persist

public void persist()

authWithOAuth

@JvmOverloads
public void authWithOAuth(@NotNull
                                        android.content.Context context,
                                        @NotNull
                                        java.lang.String provider,
                                        @NotNull
                                        AuthOptions options,
                                        @Nullable
                                        OnAuthWithOAuth listener,
                                        boolean forcesWebView)

authWithOAuth

@JvmOverloads
public void authWithOAuth(@NotNull
                                        android.content.Context context,
                                        @NotNull
                                        java.lang.String provider,
                                        @NotNull
                                        AuthOptions options,
                                        @Nullable
                                        OnAuthWithOAuth listener)

authWithOAuth

@JvmOverloads
public void authWithOAuth(@NotNull
                                        android.content.Context context,
                                        @NotNull
                                        java.lang.String provider,
                                        @NotNull
                                        AuthOptions options)

authWithOAuth

@JvmOverloads
public void authWithOAuth(@NotNull
                                        android.content.Context context,
                                        @NotNull
                                        java.lang.String provider,
                                        @Nullable
                                        OnAuthWithOAuth listener,
                                        @NotNull
                                        AuthOptions options)

authWithOAuth

@JvmOverloads
public void authWithOAuth(@NotNull
                                        android.content.Context context,
                                        @NotNull
                                        java.lang.String provider,
                                        @Nullable
                                        OnAuthWithOAuth listener)

authWithOAuth

@JvmOverloads
public void authWithOAuth(@NotNull
                                        android.content.Context context,
                                        @NotNull
                                        java.lang.String provider)

authAnonymously

@JvmOverloads
public void authAnonymously(@Nullable
                                          OnAuth callback)

authAnonymously

@JvmOverloads
public void authAnonymously()

authWithPassword

@JvmOverloads
public void authWithPassword(@NotNull
                                           java.lang.String email,
                                           @NotNull
                                           java.lang.String password,
                                           @Nullable
                                           OnAuth callback)

authWithPassword

@JvmOverloads
public void authWithPassword(@NotNull
                                           java.lang.String email,
                                           @NotNull
                                           java.lang.String password)

authWithCustomProvider

@JvmOverloads
public void authWithCustomProvider(@NotNull
                                                 java.lang.String provider,
                                                 @NotNull
                                                 java.lang.String token,
                                                 @Nullable
                                                 OnAuth callback)

authWithCustomProvider

@JvmOverloads
public void authWithCustomProvider(@NotNull
                                                 java.lang.String provider,
                                                 @NotNull
                                                 java.lang.String token)

authWithToken

public void authWithToken(@NotNull
                          java.lang.String token,
                          @Nullable
                          OnAuth callback)

authWithWassup

@JvmOverloads
public void authWithWassup(@NotNull
                                         AuthOptions options,
                                         @Nullable
                                         OnAuth listener)

authWithWassup

@JvmOverloads
public void authWithWassup(@NotNull
                                         AuthOptions options)

authWithWassup

public void authWithWassup(@Nullable
                           OnAuth listener)

authWithPhone

public void authWithPhone(@NotNull
                          java.lang.String id,
                          @NotNull
                          java.lang.String challenge,
                          @NotNull
                          java.lang.String password)

Authenticates a user using her/his phone number. This method requires sending beforehand a one-time-password (OTP) to the user using the Webcom.sendOtp method. This operation is performed asynchronously. Upon authentication completion or failure, the registered authentication callbacks are called (see Webcom.registerAuthCallback).

Parameters:

id - The MSISDN (without the "+" prefix) of the user to authenticate

challenge - The identifier of the OTP previously sent to the user

password - The OTP received by the user

See Also:

Webcom.sendOtp, Webcom.registerAuthCallback

authWithPhone

public void authWithPhone(@NotNull
                          java.lang.String id,
                          @NotNull
                          java.lang.String challenge,
                          @NotNull
                          java.lang.String password,
                          @Nullable
                          OnAuth callback)

Authenticates a user using her/his phone number. This method requires sending beforehand a one-time-password (OTP) to the user using the Webcom.sendOtp method. This operation is performed asynchronously. Upon authentication completion or failure, the registered authentication callbacks are called (see Webcom.registerAuthCallback).

Parameters:

id - The MSISDN (without the "+" prefix) of the user to authenticate

challenge - The identifier of the OTP previously sent to the user

password - The OTP received by the user

callback - The callback called when the authentication completes or fails. In case of success,OnAuth.onComplete is called with an object representing theauthenticated user

See Also:

Webcom.sendOtp, Webcom.registerAuthCallback

sendOtp

public void sendOtp(@NotNull
                    java.lang.String provider,
                    @NotNull
                    java.lang.String id,
                    @Nullable
                    MessageDetails messageDetails,
                    @NotNull
                    OnValue callback)

Sends a one time password to a user. Such a temporary password may then be used to authenticate the user using the Webcom.authWithPhone method.

Parameters:

provider - The authentication method associated to the OTP to send. Possible values are "password" or "phone"

id - The identifier of the user whom to send the OTP to for the chosen provider. For the"password" provider, it is expected to be an email address, for the "phone"provider, it is expected to be a msisdn

messageDetails - Template of message used to send the OTP (among the messages defined on the Webcom developerconsole)

callback - The callback called when the sending is completed or fails. In case of success, theOnValue.onValue method receives the identifier of the send OTP (orchallenge) as a interface JSONValue. Typically, this challenge is required by theWebcom.authWithPhone method.

See Also:

Webcom.authWithPhone

sendOtp

public void sendOtp(@NotNull
                    java.lang.String provider,
                    @NotNull
                    java.lang.String id,
                    @NotNull
                    OnValue callback)

Sends a one time password to a user using the default "login" message template.

Parameters:

provider - The authentication method associated to the OTP to send. Possible values are "password" or "phone"

id - The identifier of the user whom to send the OTP to for the chosen provider. For the"password" provider, it is expected to be an email address, for the "phone"provider, it is expected to be a msisdn

callback - The callback called when the sending is completed or fails. In case of success, theOnValue.onValue method receives the identifier of the send OTP (orchallenge) as a interface JSONValue. Typically, this challenge is required by theWebcom.authWithPhone method.

See Also:

Webcom.sendOtp

changePassword

public void changePassword(@NotNull
                           java.lang.String email,
                           @NotNull
                           java.lang.String oldPassword,
                           @NotNull
                           java.lang.String newPassword,
                           @Nullable
                           OnAuth callback)

createUser

public void createUser(@NotNull
                       java.lang.String email,
                       @NotNull
                       java.lang.String password,
                       @Nullable
                       OnAuth callback)

removeUser

public void removeUser(@NotNull
                       java.lang.String email,
                       @NotNull
                       java.lang.String password,
                       @Nullable
                       OnAuth callback)

sendConfirmationEmail

public void sendConfirmationEmail(@NotNull
                                  java.lang.String email,
                                  @Nullable
                                  OnComplete callback)

sendVerificationCode

public void sendVerificationCode(@NotNull
                                 java.lang.String provider,
                                 @NotNull
                                 java.lang.String id,
                                 @Nullable
                                 MessageDetails messageDetails,
                                 @Nullable
                                 OnValue callback)

sendVerificationCode

public void sendVerificationCode(@NotNull
                                 java.lang.String provider,
                                 @NotNull
                                 java.lang.String id,
                                 @Nullable
                                 OnValue callback)

sendPasswordResetEmail

public void sendPasswordResetEmail(@NotNull
                                   java.lang.String email,
                                   @Nullable
                                   OnAuth callback)

sendPasswordResetCode

@JvmOverloads
public void sendPasswordResetCode(@NotNull
                                                java.lang.String provider,
                                                @NotNull
                                                java.lang.String id,
                                                @Nullable
                                                MessageDetails messageDetails,
                                                @Nullable
                                                OnComplete callback)

sendPasswordResetCode

@JvmOverloads
public void sendPasswordResetCode(@NotNull
                                                java.lang.String provider,
                                                @NotNull
                                                java.lang.String id,
                                                @Nullable
                                                MessageDetails messageDetails)

sendPasswordResetCode

@JvmOverloads
public void sendPasswordResetCode(@NotNull
                                                java.lang.String provider,
                                                @NotNull
                                                java.lang.String id)

sendPasswordResetCode

public void sendPasswordResetCode(@NotNull
                                  java.lang.String provider,
                                  @NotNull
                                  java.lang.String id,
                                  @Nullable
                                  OnComplete callback)

updateEmailPasswordProfile

public void updateEmailPasswordProfile(@Nullable
                                       java.lang.String path,
                                       @Nullable
                                       java.lang.Object data,
                                       @Nullable
                                       OnComplete callback)

updateEmailPasswordProfile

public void updateEmailPasswordProfile(@Nullable
                                       java.lang.Object data,
                                       @Nullable
                                       OnComplete callback)

updateIdentityProfile

public void updateIdentityProfile(@Nullable
                                  java.lang.String path,
                                  @Nullable
                                  java.lang.Object data,
                                  @Nullable
                                  OnComplete callback)

updateIdentityProfile

public void updateIdentityProfile(@Nullable
                                  java.lang.Object data,
                                  @Nullable
                                  OnComplete callback)

removeAccount

public void removeAccount(@NotNull
                          OnComplete callback)

Removes the Webcom account of the currently authenticated user. Note that all identities attached to this account will also be deleted.

If no user is currently authenticated, then this operation fails. In addition, as this operation is sensible, it also fails if the authentication token of the current user is too old. In this case, the application may ask the user to authenticate afresh.

Parameters:

callback - The callback called when the removal operation completes or fails

See Also:

Webcom.removeIdentity

removeIdentity

public void removeIdentity(@NotNull
                           OnComplete callback)

Removes the identity of the currently authenticated user from her/his Webcom account. This identity will then be no longer available for authenticating the user. All other identities attached to this account will remain and will still be available for authentication. However, note that if the removed identity is the last attached one to the user account, then the whole account is deleted (otherwise it would result in a "ghost" account with no means of authentication).

If no user is currently authenticated, then this operation fails. In addition, as this operation is sensible, it also fails if the authentication token of the current user is too old. In this case, the application may ask the user to authenticate afresh.

Parameters:

callback - The callback called when the removal operation completes or fails

See Also:

Webcom.removeAccount

addAccount

public void addAccount(@NotNull
                       java.lang.String provider,
                       @NotNull
                       AuthDetails details,
                       @Nullable
                       MessageDetails messageDetails,
                       @Nullable
                       OnAuth callback)

Adds a new account to the app referred to by this class Webcom instance. The new account is associated to a new identity with the provider authentication mehtod, whose details (typically msisdn, email or password) are provided by the details parameter. Currently, only 2 authentication methods are available to add an account: "password" (authentication with email and password) or "phone" (authentication with msisdn and one-time-password).

The identity associated to the newly added account is in the unverfied state, so that the actual user cannot authenticate with this identity until it has been verified. To to so, the user receives a verification code or token on the specified msisdn ("phone" method) or email address ("password" method), which must be sent back to the Webcom backend using the Webcom.verifyIdentity method.

Parameters:

provider - The authentication method required by the identity associated to the added account. Possiblevalues are "password" or "phone"

details - The details of the identity associated to the added account (depends on the chosen authenticationmethod)

messageDetails - Settings of the message to be sent to the user to verify her/his identity

callback - The callback notified when:

See Also:

class Webcom, Webcom.verifyIdentity

addAccount

public void addAccount(@NotNull
                       java.lang.String provider,
                       @NotNull
                       AuthDetails details,
                       @NotNull
                       OnAuth callback)

Adds a new account to the app referred to by this class Webcom instance. See Webcom.addAccount.

Parameters:

provider - The authentication method required by the identity associated to the added account. Possiblevalues are "password" or "phone"

details - The details of the identity associated to the added account (depends on the chosen authenticationmethod)

callback - The callback notified when:

See Also:

class Webcom, Webcom.addAccount

verifyIdentity

public void verifyIdentity(@NotNull
                           java.lang.String provider,
                           @NotNull
                           java.lang.String id,
                           @NotNull
                           VerificationData data,
                           @NotNull
                           OnAuth callback)

Verifies the authentication details (typically msisdn or email address) of a newly created identity using the Webcom.addAccount method. If the verification is successful, then the user is automatically authenticated with the verified identity.

Parameters:

provider - The authentication method associated to the identity to verify. Possible values are "password" or "phone"

id - The identifier to use to authenticate a user with the identity to verify (typically an msisdn or anemail address)

data - The verification data needed by the Webcom backend to verify the identity. It must include the codeor token received by the user

callback - The callback notified when:

See Also:

Webcom.addAccount

wakeupSubscribe

public void wakeupSubscribe(@NotNull
                            java.lang.String id,
                            @NotNull
                            java.lang.String mode,
                            @Nullable
                            OnComplete callback)

wakeupSubscribe

public void wakeupSubscribe(@NotNull
                            java.lang.String id,
                            @Nullable
                            OnComplete callback)

wakeupUnsubscribe

public void wakeupUnsubscribe(@NotNull
                              java.lang.String id,
                              @Nullable
                              OnComplete callback)

shouldBeOnline

public boolean shouldBeOnline()

Returns the working status of the Datasync service associated with this instance wrt. to the network connection.

• true means that the Datasync service is either connected to the Webcom backend or is trying to do so as soon as the network connectivity is available.

• false means that the Datasync service is deliberately disconnected from the Webcom backend (even if network connectivity is available).

The working status wrt. the network connection may be switched on or off using the goOnline and goOffline methods.

See Also:

goOnline, goOffline

onDisconnect

@NotNull
public OnDisconnect onDisconnect()

transaction

@JvmOverloads
public void transaction(@NotNull
                                      TransactionCallback callbacks,
                                      boolean applyLocally)

transaction

@JvmOverloads
public void transaction(@NotNull
                                      TransactionCallback callbacks)

useCurrentContextForNextAuthOperation

public void useCurrentContextForNextAuthOperation()

useNewContextForNextAuthOperation

public void useNewContextForNextAuthOperation()

toString

@NotNull
public java.lang.String toString()

internalRepresentation

@Nullable
public java.lang.Object internalRepresentation()

onReady

@JvmStatic
public static void onReady(@NotNull
                                      java.lang.Runnable runnable)

Registers the runnable callback to be called as soon as the Webcom SDK has completed its initialization.

No instance of the class Webcom can be created before the completion of the SDK initialization. Calling any of its constructors is safe as soon as any of the registered callbacks has been called. If the initialization is already complete when calling this method, the given callback is called immediately.

See Also:

runnable, class Webcom, waitForReady

waitForReady

@JvmStatic
public static void waitForReady()

Blocks the calling thread until the Webcom SDK has completed its initialization.

A more convenient way of waiting the SDK initialization is to use the onReady helper.

See Also:

onReady