Skip to content

Validating User Login

Description

The login operation provides a way to persist the user-token on the client side so it can be used when the application is restarted. This helps in streamlining the user experience since the user of the application does not need to login again. However, when the application restarts, it needs to check if the underlying user token, and hence the user session is still valid. This can be accomplished with the API below:

Method

-(void)isValidUserTokenWithResponseHandler:^(BOOL)responseHandler errorHandler:^(Fault *)errorHandler;
func isValidUserToken(responseHandler: ((Bool) -> Void)!, errorHandler: ((Fault) -> Void)!)

where:

Argument                Description
responseHandler Handles successful result of an asynchronous call.
errorHandler Handles fault result of an asynchronous call.

Return Value

true if the current user session(user token) is valid. Otherwise, returns false.

Example

To validate the user session, the user must be logged in first, make sure to set the stayLoggedIn argument to true to persist the information about the login for the use by subsequent starts/sessions of the application. For more information refer to the Login topic.

The example below checks if the current session is valid.

[Backendless.shared.userService isValidUserTokenWithResponseHandler:^(BOOL isValid) {
    NSLog(@"User token is valid: %i", isValid);
} errorHandler:^(Fault *fault) {
    NSLog(@"Error: %@", fault.message);
}];
Backendless.shared.userService.isValidUserToken(responseHandler: { isValid in
    print("User token is valid: \(isValid)")
}, errorHandler: { fault in
    print("Error: \(fault.message ?? "")")
})

Codeless Reference

user_service_codeless_is_valid_user_session

Returns true if the current user session(user token) is valid. Otherwise, returns false.

Consider the following record in the Users data table:
user_service_codeless_example_remove_user_3

The example below logs in as "alice@yourmail.com". The stay logged in parameter must be set to true to establish a persistent session. Then the session is validated by using the Is Valid User Session Codeless block.

user_service_codeless_example_is_valid_user_session