com.ibm.watson.developer_cloud.service

Class WatsonService

java.lang.Object

com.ibm.watson.developer_cloud.service.WatsonService

Direct Known Subclasses:

AlchemyService, ConversationService, DialogService, DocumentConversion, LanguageTranslation, NaturalLanguageClassifier, PersonalityInsights, RetrieveAndRank, SpeechToText, TextToSpeech, ToneAnalyzer, TradeoffAnalytics, VisualRecognition

public abstract class WatsonService
extends Object

Watson service abstract common functionality of various Watson Services. It handle authentication and default url

See Also:

IBM Watson Developer Cloud

Field Summary

Fields

Modifier and Type	Field and Description
protected okhttp3.Headers	defaultHeaders The default headers.
protected static String	MESSAGE_CODE The Constant MESSAGE_CODE.
protected static String	MESSAGE_ERROR The Constant MESSAGE_ERROR.
protected boolean	skipAuthentication The skip authentication.
protected static String	VERSION The Constant VERSION.

Constructor Summary

Constructors

Constructor and Description
WatsonService(String name) Instantiates a new Watson service.

Method Summary

Modifier and Type	Method and Description
protected okhttp3.OkHttpClient	configureHttpClient() Configures the HTTP client.
protected <T> ServiceCall<T>	createServiceCall(okhttp3.Request request, ResponseConverter<T> converter) Creates the service call.
protected String	getApiKey() Gets the API key.
String	getEndPoint() Gets the API end point.
String	getName() Gets the name.
ServiceCall<String>	getToken() Gets an authorization token that can be use to authorize API calls.
protected <T> T	processServiceCall(ResponseConverter<T> converter, okhttp3.Response response) Process service call.
void	setApiKey(String apiKey) Sets the API key.
protected void	setAuthentication(okhttp3.Request.Builder builder) Sets the authentication.
void	setDefaultHeaders(Map<String,String> headers) Set the default headers to be used on every HTTP request.
void	setEndPoint(String endPoint) Sets the end point.
void	setSkipAuthentication(boolean skipAuthentication) Sets the skip authentication.
void	setUsernameAndPassword(String username, String password) Sets the username and password.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

defaultHeaders

protected okhttp3.Headers defaultHeaders

The default headers.

skipAuthentication

protected boolean skipAuthentication

The skip authentication.

MESSAGE_CODE

protected static final String MESSAGE_CODE

The Constant MESSAGE_CODE.

See Also:

Constant Field Values

MESSAGE_ERROR

protected static final String MESSAGE_ERROR

The Constant MESSAGE_ERROR.

See Also:

Constant Field Values

VERSION

protected static final String VERSION

The Constant VERSION.

See Also:

Constant Field Values

Constructor Detail

WatsonService

public WatsonService(String name)

Instantiates a new Watson service.

Parameters:

name - the service name

Method Detail

configureHttpClient

protected okhttp3.OkHttpClient configureHttpClient()

Configures the HTTP client.

Returns:

the HTTP client

createServiceCall

protected final <T> ServiceCall<T> createServiceCall(okhttp3.Request request,
                                                     ResponseConverter<T> converter)

Creates the service call.

Type Parameters:

T - the generic type

Parameters:

request - the request

converter - the converter

Returns:

the service call

getApiKey

protected String getApiKey()

Gets the API key.

Returns:

the API key

getEndPoint

public String getEndPoint()

Gets the API end point.

Returns:

the API end point

getToken

public ServiceCall<String> getToken()

Gets an authorization token that can be use to authorize API calls.

Returns:

the token

getName

public String getName()

Gets the name.

Returns:

the name

setApiKey

public void setApiKey(String apiKey)

Sets the API key.

Parameters:

apiKey - the new API key

setAuthentication

protected void setAuthentication(okhttp3.Request.Builder builder)

Sets the authentication. Okhttp3 compliant.

Parameters:

builder - the new authentication

setEndPoint

public void setEndPoint(String endPoint)

Sets the end point.

Parameters:

endPoint - the new end point

setUsernameAndPassword

public void setUsernameAndPassword(String username,
                                   String password)

Sets the username and password.

Parameters:

username - the username

password - the password

setDefaultHeaders

public void setDefaultHeaders(Map<String,String> headers)

Set the default headers to be used on every HTTP request.

Parameters:

headers - name value pairs of headers

toString

public String toString()

Overrides:

toString in class Object

processServiceCall

protected <T> T processServiceCall(ResponseConverter<T> converter,
                                   okhttp3.Response response)

Process service call.

Type Parameters:

T - the generic type

Parameters:

converter - the converter

response - the response

Returns:

the t

setSkipAuthentication

public void setSkipAuthentication(boolean skipAuthentication)

Sets the skip authentication.

Parameters:

skipAuthentication - the new skip authentication