KSTransport
Class used to send synchronous requests to KeepSolid servers.
Once sign-in request is successful, the instance of manages the created session internally.
If you use the standard authorization routine with method KSAuthorizer.authorizeWithLogin(String, String), KSTransport silently re-authorizes if the session is expired. But if you implement non-standard authorization methods (like authorizing with social networks), it is impossible to re-authorize without calling the third-party code. In this case you must implement KSAuthDelegate and pass the delegate instance to KSAuthDataSource via setAuthDelegate(KSAuthDelegate) before any usage of this class.
Once sign-in request is successful, the instance of manages the created session internally.
If you use the standard authorization routine with method KSAuthorizer.authorizeWithLogin(String, String), KSTransport silently re-authorizes if the session is expired. But if you implement non-standard authorization methods (like authorizing with social networks), it is impossible to re-authorize without calling the third-party code. In this case you must implement KSAuthDelegate and pass the delegate instance to KSAuthDataSource via setAuthDelegate(KSAuthDelegate) before any usage of this class.
Package: com.keepsolid.androidkeepsolidcommon.commonsdk.api.transport
Class Methods
sendRequest
KSResponse sendRequest(KSRequest request) throws KSException
Sends the specified request synchronously.
This method sends a previously created instance of KSRequest synchronously and waits for the response. It blocks a calling thread.
This method shouldn't be called from main thread.
Parameters
- request
- The constructed request object. Cannot be null.
Return value
An KSResponse object which represents a server response if no error has occured.
Throws:
sendImageRequest
KSImageResponse sendImageRequest(KSImageRequest userRequest) throws KSException
Sends the specified request synchronously.
This method sends a previously created instance of KSRequest synchronously and waits for the response. It blocks a calling thread.
This method shouldn't be called from main thread.
Parameters
- userRequest
- The constructed image request object. Cannot be null.
Return value
An KSResponse object which represents a server response with image accessed via KSImageResponse.getBitmap() if no error has occured.
Throws:
getLocalizedException
KSException getLocalizedException(int errorCode)
Returns sdk exception from error codes
Parameters
- errorCode
- VPNU error code. If code is not recognized, returns KSResponse.KS_ERROR_UNKNOWN
Return value
sdk exception from error codes
setRequestBuilder
void setRequestBuilder(KSRequestBuilder requestBuilder)
Setter for Request Factory
Parameters
- requestBuilder
- instance of KSRequestBuilder
setProxyManager
void setProxyManager(KSProxyManager proxyManager)
Setter for proxy handling
Parameters
- proxyManager
- instance of KSProxyManager
setLocalizedResponseProvider
void setLocalizedResponseProvider(LocalizedResponseProvider localizedResponseProvider)
Setter for localized responses, provided by KSResponse
Parameters
- localizedResponseProvider
- instance of KSDefaultLocalizedResponseProvider
setAuthDelegate
void setAuthDelegate(KSAuthDelegate authDelegate)
Setter for KSAuthDelegate implementation of non-standard authorization (like authorizing with social networks)
Parameters
- authDelegate
- KSAuthDelegate implementation of non-standard authorization