WebView
The authorization process for WebView two steps, in the first we login to SPiD in a WebView and then receives a code. The code is then exchanged for a access token which can be used to make requests against SPiD. Both these steps are done automatically and the client will only have to use the method getAuthorizationWebView method as seen below.
WebView webView = null;
try {
webView = SPiDClient.getInstance().getAuthorizationWebView(context, null, new SPiDExampleWebViewClient(), new LoginListener());
} catch (Exception e) {
// Handle problem encoding url, likely to be a configuration issue
}
If the user should go directly to the registration page the following method can be used.
WebView webView = null;
try {
SPiDClient.getInstance().getRegistrationWebView(context,
null,
new SPiDExampleWebViewClient(),
new LoginListener(context));
} catch (Exception e) {
// Handle problem encoding url, likely to be a configuration issue
}
Or the lost password page.
WebView webView = null;
try {
SPiDClient.getInstance().getLostPasswordWebView(context,
null,
new SPiDExampleWebViewClient(),
new SPiDAuthorizationListener() {
@Override
public void onComplete() {
// Successful login
}
@Override
public void onSPiDException(SPiDException exception) {
// Handle SPiDException (server errors)
}
@Override
public void onIOException(IOException exception) {
// Handle IOException (connection problems)
}
@Override
public void onException(Exception exception) {
// Handle general Exception (fatal errors, should never happen if SPiDClient is correctly configured)
}
});
} catch (Exception e) {
// Handle problem encoding url, likely to be a configuration issue
}
The SPiDWebViewClient can be extended to provide further functionality as seen below.
protected class SPiDExampleWebViewClient extends SPiDWebViewClient {
public void onPageStarted(WebView view, String url, Bitmap favicon) {
super.onPageStarted(view, url, favicon);
// Show loading spinner
}
public void onPageFinished(WebView view, String url) {
super.onPageFinished(view, url);
// Hide loading spinner
}
}
Lastly the application need permission to access internet and phone state, the following lines is needed in AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
After the login has been completed and the completion handler has been executed you can start making API requests.