Initializing the JumioClient
JumioClient implements the Builder pattern to make it easy to configure and initialize. It is usually created as a Spring Bean so it can be injected and used as needed in your application.
To configure JumioClient you need to provide:
-
A DataCenter object representing the Jumio datacenter your application will be using. These objects are defined as public static instances in the DataCenters class, and can be accessed by
DataCenters.US
,DataCenters.EU
, orDataCenters.SGP
. -
A UsernamePassword object constructed from your OAuth2 credentials, obtained from the Jumio Portal. See API Credentials.
-
A String with the value you want to use for the User-Agent header in calls to Jumio.
-
(optional) A ClientHttpRequestFactory instance, if you want to use a Spring RestTemplate other than the default.
Example: JumioClient Bean
import com.jumio.sdk.kyx.DataCenters; import com.jumio.sdk.kyx.JumioClient; import com.jumio.sdk.kyx.UsernamePassword; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class JumioClientProvider { @Bean public JumioClient jumioClient() { return JumioClient.builder() .dataCenter(DataCenters.EU) .oauthCredentials(new UsernamePassword("xyz123...", "123xyz...")) .userAgent("MyCompany Test/1.1") .defaultRestTemplate() .build(); } }
Builder Steps
Builder Method | Parameters | Description | Return Type |
---|---|---|---|
|
|
Returns the first builder step. |
BuilderStep1 |
dataCenter()
|
DataCenter accessed as static object from DataCenters. | DataCenters provides static references to pre-defined objects for the Jumio datacenters. | BuilderStep2 |
|
Object containing your OAuth2 user name and password that you can obtain from the Jumio Portal. See API Credentials. |
||
userAgent()
|
String |
The value you want to use as the user-agent header in the underlying REST request. |
BuilderStep4 |
or
|
No parameters or |
Use the default Spring RestTemplate or specify an alternative RestTemplate. | FinalBuilderStep |
|
|
Returns the configured JumioClient. |