Package org.linphone.core

Interface AccountCreator

public interface AccountCreator

The object used to configure an account on a server via XML-RPC, see
https://wiki.linphone.org/xwiki/wiki/public/view/Lib/Features/Override%20account%20creator%20request/.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	AccountCreator.ActivationCodeStatus
static class	AccountCreator.DomainStatus
static class	AccountCreator.EmailStatus
static class	AccountCreator.LanguageStatus
static class	AccountCreator.PasswordStatus
static class	AccountCreator.PhoneNumberStatus
static class	AccountCreator.Status
static class	AccountCreator.TransportStatus
static class	AccountCreator.UsernameStatus

Method Summary

Modifier and Type	Method	Description
AccountCreator.Status	activateAccount()	Send a request to activate an account on server.
AccountCreator.Status	activateAlias()	Send a request to activate an alias.
void	addListener(AccountCreatorListener listener)
AccountCreator	create(Core core)	Create a AccountCreator and set Linphone Request callbacks.
AccountCreator.Status	createAccount()	Send a request to create an account on server.
Account	createAccountInCore()	Create and configure a Account and a AuthInfo from informations set in the AccountCreator.
ProxyConfig	createProxyConfig()	Deprecated. 05/05/2023 Use createAccountInCore() instead.
java.lang.String	getAccountCreationRequestToken()	Get the account creation request token received to be used to check user validation.
java.lang.String	getActivationCode()	Get the activation code.
java.lang.String	getAlgorithm()	Get the algorithm configured in the account creator.
java.lang.String	getDisplayName()	Get the display name.
java.lang.String	getDomain()	Get the domain.
java.lang.String	getEmail()	Get the email.
java.lang.String	getHa1()	Get the ha1.
java.lang.String	getLanguage()	Get the language use in email of SMS.
long	getNativePointer()	Gets the native pointer used by this class to make native method calls.
java.lang.String	getPassword()	Get the password.
java.lang.String	getPhoneCountryCode()	Get the international prefix.
java.lang.String	getPhoneNumber()	Get the RFC 3966 normalized phone number.
java.lang.String	getPnParam()	Get the param to be used by the backend to send the push notification to the device asking for an auth token.
java.lang.String	getPnPrid()	Get the prid to be used by the backend to send the push notification to the device asking for an auth token.
java.lang.String	getPnProvider()	Get the provider to be used by the backend to send the push notification to the device asking for an auth token.
java.lang.String	getRoute()	Get the route.
boolean	getSetAsDefault()	Get the set_as_default property.
java.lang.String	getToken()	Get the authentication token set (if any) to be used to authenticate next queries, if required.
TransportType	getTransport()	Get Transport.
java.lang.Object	getUserData()	Gets the object stored in this object user's data
java.lang.String	getUsername()	Get the username.
AccountCreator.Status	isAccountActivated()	Send a request to know if an account is activated on server.
AccountCreator.Status	isAccountExist()	Send a request to know the existence of account on server.
AccountCreator.Status	isAccountLinked()	Send a request to know if an account is linked.
AccountCreator.Status	isAliasUsed()	Send a request to know if an alias is used.
AccountCreator.Status	linkAccount()	Send a request to link an account to an alias.
AccountCreator.Status	loginLinphoneAccount()	Send a request to get the password & algorithm of an account using the confirmation key.
AccountCreator.Status	recoverAccount()	Send a request to recover an account.
void	removeListener(AccountCreatorListener listener)
AccountCreator.Status	requestAccountCreationRequestToken()	Request an account creation "request_token" to be used on account creations.
AccountCreator.Status	requestAccountCreationTokenUsingRequestToken()	Send a request to get a token to be used for account creation from a request_token.
AccountCreator.Status	requestAuthToken()	Request an auth token to be send by the backend by push notification.
void	reset()	Reset the account creator entries like username, password, phone number...
void	setAccountCreationRequestToken(java.lang.String token)	Set the account creation request token received to be used to check user validation.
AccountCreator.ActivationCodeStatus	setActivationCode(java.lang.String activationCode)	Set the activation code.
AccountCreatorAlgoStatus	setAlgorithm(java.lang.String algorithm)	Set the supported algorithm.
AccountCreator.Status	setAsDefault(boolean setAsDefault)	Set the set_as_default property.
AccountCreator.UsernameStatus	setDisplayName(java.lang.String displayName)	Set the display name.
AccountCreator.DomainStatus	setDomain(java.lang.String domain)	Set the domain.
AccountCreator.EmailStatus	setEmail(java.lang.String email)	Set the email.
AccountCreator.PasswordStatus	setHa1(java.lang.String ha1)	Set the ha1.
AccountCreator.LanguageStatus	setLanguage(java.lang.String lang)	Set the language to use in email or SMS if supported.
AccountCreator.PasswordStatus	setPassword(java.lang.String password)	Set the password.
int	setPhoneNumber(java.lang.String phoneNumber, java.lang.String countryCode)	Set the phone number normalized.
void	setPnParam(java.lang.String pnParam)	Set the param to be used by the backend to send the push notification to the device asking for an auth token.
void	setPnPrid(java.lang.String pnPrid)	Set the prid to be used by the backend to send the push notification to the device asking for an auth token.
void	setPnProvider(java.lang.String pnProvider)	Set the provider to be used by the backend to send the push notification to the device asking for an auth token.
void	setProxyConfig(ProxyConfig cfg)	Assign a proxy config pointer to the LinphoneAccountCreator.
AccountCreator.Status	setRoute(java.lang.String route)	Set the route.
void	setToken(java.lang.String token)	Set the authentication token received by push notification to be used to authenticate next queries, if required.
AccountCreator.TransportStatus	setTransport(TransportType transport)	Set Transport.
void	setUserData(java.lang.Object data)	Sets the object to store in this object user's data
AccountCreator.UsernameStatus	setUsername(java.lang.String username)	Set the username.
java.lang.String	toString()
AccountCreator.Status	updateAccount()	Send a request to update an account.
void	useTestAdminAccount()	Require the account creator to use special "test admin account".

Method Detail

getAccountCreationRequestToken

@Nullable
java.lang.String getAccountCreationRequestToken()

Get the account creation request token received to be used to check user
validation.

Returns:

The token set, if any

setAccountCreationRequestToken

void setAccountCreationRequestToken(@Nullable
                                    java.lang.String token)

Set the account creation request token received to be used to check user
validation.

Parameters:

token - The token to set

getActivationCode

@Nullable
java.lang.String getActivationCode()

Get the activation code.

Returns:

The activation code of the AccountCreator.

setActivationCode

AccountCreator.ActivationCodeStatus setActivationCode(@Nullable
                                                      java.lang.String activationCode)

Set the activation code.

Parameters:

activationCode - The activation code to set

Returns:

AccountCreator.ActivationCodeStatus.Ok if everything is OK, or a specific
error otherwise.

getAlgorithm

@Nullable
java.lang.String getAlgorithm()

Get the algorithm configured in the account creator.

Returns:

The algorithm of the AccountCreator.

setAlgorithm

AccountCreatorAlgoStatus setAlgorithm(@Nullable
                                      java.lang.String algorithm)

Set the supported algorithm.

Parameters:

algorithm - The algorithm to use

Returns:

LinphoneAccountCreatorAlgoStatusOk if everything is OK, or a specific
error otherwise.

setAsDefault

AccountCreator.Status setAsDefault(boolean setAsDefault)

Set the set_as_default property.

Parameters:

setAsDefault - true for the created proxy config to be set as default in
Core, false otherwise

Returns:

AccountCreator.Status.RequestOk if everything is OK, or a specific error
otherwise.

getDisplayName

@Nullable
java.lang.String getDisplayName()

Get the display name.

Returns:

The display name of the AccountCreator.

setDisplayName

AccountCreator.UsernameStatus setDisplayName(@Nullable
                                             java.lang.String displayName)

Set the display name.

Parameters:

displayName - The display name to set

Returns:

AccountCreator.UsernameStatus.Ok if everything is OK, or a specific error
otherwise.

getDomain

@Nullable
java.lang.String getDomain()

Get the domain.

Returns:

The domain of the AccountCreator.

setDomain

AccountCreator.DomainStatus setDomain(@Nullable
                                      java.lang.String domain)

Set the domain.

Parameters:

domain - The domain to set

Returns:

AccountCreator.DomainStatus.Ok if everything is OK, or a specific error
otherwise.

getEmail

@Nullable
java.lang.String getEmail()

Get the email.

Returns:

The email of the AccountCreator.

setEmail

AccountCreator.EmailStatus setEmail(@Nullable
                                    java.lang.String email)

Set the email.

Parameters:

email - The email to set

Returns:

AccountCreator.EmailStatus.Ok if everything is OK, or a specific error
otherwise.

getHa1

@Nullable
java.lang.String getHa1()

Get the ha1.

Returns:

The ha1 of the AccountCreator.

setHa1

AccountCreator.PasswordStatus setHa1(@Nullable
                                     java.lang.String ha1)

Set the ha1.

Parameters:

ha1 - The ha1 to set

Returns:

AccountCreator.PasswordStatus.Ok if everything is OK, or a specific error
otherwise.

getLanguage

@Nullable
java.lang.String getLanguage()

Get the language use in email of SMS.

Returns:

The language of the AccountCreator.

setLanguage

AccountCreator.LanguageStatus setLanguage(@Nullable
                                          java.lang.String lang)

Set the language to use in email or SMS if supported.

Parameters:

lang - The language to use

Returns:

AccountCreator.LanguageStatus.Ok if everything is OK, or a specific error
otherwise.

getPassword

@Nullable
java.lang.String getPassword()

Get the password.

Returns:

The password of the AccountCreator.

setPassword

AccountCreator.PasswordStatus setPassword(@Nullable
                                          java.lang.String password)

Set the password.

Parameters:

password - The password to set

Returns:

AccountCreator.PasswordStatus.Ok if everything is OK, or specific(s) error(s)
otherwise.

getPhoneCountryCode

@Nullable
java.lang.String getPhoneCountryCode()

Get the international prefix.

Returns:

The international prefix (or phone country code) of the AccountCreator
.

getPhoneNumber

@Nullable
java.lang.String getPhoneNumber()

Get the RFC 3966 normalized phone number.

Returns:

The phone number of the AccountCreator.

getPnParam

@Nullable
java.lang.String getPnParam()

Get the param to be used by the backend to send the push notification to the
device asking for an auth token.

Returns:

The pn_param set, if any

setPnParam

void setPnParam(@Nullable
                java.lang.String pnParam)

Set the param to be used by the backend to send the push notification to the
device asking for an auth token.

Parameters:

pnParam - The pn_param to set

getPnPrid

@Nullable
java.lang.String getPnPrid()

Get the prid to be used by the backend to send the push notification to the
device asking for an auth token.

Returns:

The pn_prid set, if any

setPnPrid

void setPnPrid(@Nullable
               java.lang.String pnPrid)

Set the prid to be used by the backend to send the push notification to the
device asking for an auth token.

Parameters:

pnPrid - The pn_prid to set

getPnProvider

@Nullable
java.lang.String getPnProvider()

Get the provider to be used by the backend to send the push notification to the
device asking for an auth token.

Returns:

The pn_provider set, if any

setPnProvider

void setPnProvider(@Nullable
                   java.lang.String pnProvider)

Set the provider to be used by the backend to send the push notification to the
device asking for an auth token.

Parameters:

pnProvider - The pn_provider to set

setProxyConfig

void setProxyConfig(@Nullable
                    ProxyConfig cfg)

Assign a proxy config pointer to the LinphoneAccountCreator.

Parameters:

cfg - The LinphoneProxyConfig to associate with the
LinphoneAccountCreator.

getRoute

@Nullable
java.lang.String getRoute()

Get the route.

Returns:

The route of the AccountCreator.

setRoute

AccountCreator.Status setRoute(@Nullable
                               java.lang.String route)

Set the route.

Parameters:

route - The route to set

Returns:

AccountCreator.Status.RequestOk if everything is OK, or a specific error
otherwise.

getSetAsDefault

boolean getSetAsDefault()

Get the set_as_default property.

Returns:

true if account will be set as default, false otherwise.

getToken

@Nullable
java.lang.String getToken()

Get the authentication token set (if any) to be used to authenticate next
queries, if required.

Returns:

The token set, if any

setToken

void setToken(@Nullable
              java.lang.String token)

Set the authentication token received by push notification to be used to
authenticate next queries, if required.

Parameters:

token - The token to set

getTransport

TransportType getTransport()

Get Transport.

Returns:

The TransportType of the creator.

setTransport

AccountCreator.TransportStatus setTransport(TransportType transport)

Set Transport.

Parameters:

transport - The TransportType to set

Returns:

AccountCreator.TransportStatus.Ok if everything is OK, or a specific error
otherwise.

getUsername

@Nullable
java.lang.String getUsername()

Get the username.

Returns:

The username of the AccountCreator.

setUsername

AccountCreator.UsernameStatus setUsername(@Nullable
                                          java.lang.String username)

Set the username.

Parameters:

username - The username to set

Returns:

AccountCreator.UsernameStatus.Ok if everything is OK, or a specific error
otherwise.

activateAccount

AccountCreator.Status activateAccount()

Send a request to activate an account on server.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

activateAlias

AccountCreator.Status activateAlias()

Send a request to activate an alias.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

createAccount

AccountCreator.Status createAccount()

Send a request to create an account on server.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

createAccountInCore

@Nullable
Account createAccountInCore()

Create and configure a Account and a AuthInfo from informations
set in the AccountCreator.

Returns:

A Account object if successful, null otherwise.

createProxyConfig

@Deprecated
@Nullable
ProxyConfig createProxyConfig()

Deprecated. 05/05/2023 Use createAccountInCore() instead.

Create and configure a proxy config and a authentication info for an account
creator.

Returns:

A ProxyConfig object if successful, null otherwise.

isAccountActivated

AccountCreator.Status isAccountActivated()

Send a request to know if an account is activated on server.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

isAccountExist

AccountCreator.Status isAccountExist()

Send a request to know the existence of account on server.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

isAccountLinked

AccountCreator.Status isAccountLinked()

Send a request to know if an account is linked.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

isAliasUsed

AccountCreator.Status isAliasUsed()

Send a request to know if an alias is used.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

linkAccount

AccountCreator.Status linkAccount()

Send a request to link an account to an alias.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

loginLinphoneAccount

AccountCreator.Status loginLinphoneAccount()

Send a request to get the password & algorithm of an account using the
confirmation key.

Returns:

AccountCreator.Status.RequestOk if everything is OK, or a specific error
otherwise.

recoverAccount

AccountCreator.Status recoverAccount()

Send a request to recover an account.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

requestAccountCreationRequestToken

AccountCreator.Status requestAccountCreationRequestToken()

Request an account creation "request_token" to be used on account creations.

The request_token is retrieved from the callback
linphone_account_creator_cbs_get_account_creation_request_token

Returns:

AccountCreator.Status.RequestOk if everything is OK, or a specific error
otherwise.

requestAccountCreationTokenUsingRequestToken

AccountCreator.Status requestAccountCreationTokenUsingRequestToken()

Send a request to get a token to be used for account creation from a
request_token.

The token is retrieved from the callback
linphone_account_creator_cbs_get_account_creation_token_using_request_token

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

requestAuthToken

AccountCreator.Status requestAuthToken()

Request an auth token to be send by the backend by push notification.

Returns:

AccountCreator.Status.RequestOk if everything is OK, or a specific error
otherwise.

reset

void reset()

Reset the account creator entries like username, password, phone number...

setPhoneNumber

int setPhoneNumber(@Nullable
                   java.lang.String phoneNumber,
                   @Nullable
                   java.lang.String countryCode)

Set the phone number normalized.

Parameters:

phoneNumber - The phone number to set

countryCode - Country code to associate phone number with

Returns:

AccountCreator.PhoneNumberStatus.Ok if everything is OK, or specific(s)
error(s) otherwise.

updateAccount

AccountCreator.Status updateAccount()

Send a request to update an account.

Returns:

AccountCreator.Status.RequestOk if the request has been sent, AccountCreator.Status.RequestFailed
otherwise

useTestAdminAccount

void useTestAdminAccount()

Require the account creator to use special "test admin account".

warning: The "test admin account" is a special feature required for automated
test, and requires the APP_EVERYONE_IS_ADMIN property to be enabled on the
remote Flexisip Account Manager (FlexiAPI). This feature must never be turned
on for a production-stage app.

create

@NonNull
AccountCreator create(@NonNull
                      Core core)

Create a AccountCreator and set Linphone Request callbacks.

Parameters:

core - The Core used for the XML-RPC communication

Returns:

The new AccountCreator object.

addListener

void addListener(AccountCreatorListener listener)

removeListener

void removeListener(AccountCreatorListener listener)

setUserData

void setUserData(java.lang.Object data)

Sets the object to store in this object user's data

Parameters:

data - the object to store

getUserData

java.lang.Object getUserData()

Gets the object stored in this object user's data

Returns:

the object store if any, null otherwise

getNativePointer

long getNativePointer()

Gets the native pointer used by this class to make native method calls.

Returns:

the nativer pointer, as long

toString

java.lang.String toString()

Overrides:

toString in class java.lang.Object