ai.api

Class AIDataService

java.lang.Object

ai.api.AIDataService

public class AIDataService
extends java.lang.Object

Do simple requests to the AI Service

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	TAG

Constructor Summary

Constructors

Constructor and Description
AIDataService(android.content.Context context, AIConfiguration config)

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	doSoundRequest(java.io.InputStream voiceStream, java.lang.String queryData)
protected java.lang.String	doSoundRequest(java.io.InputStream voiceStream, java.lang.String queryData, java.util.Map<java.lang.String,java.lang.String> additionalHeaders) Method extracted for testing purposes
protected java.lang.String	doTextRequest(java.lang.String requestJson)
protected java.lang.String	doTextRequest(java.lang.String endpoint, java.lang.String requestJson)
protected java.lang.String	doTextRequest(java.lang.String endpoint, java.lang.String requestJson, java.util.Map<java.lang.String,java.lang.String> additionalHeaders)
AIResponse	request(AIRequest request)
AIResponse	request(AIRequest request, RequestExtras requestExtras) Make request to the ai service.
boolean	resetContexts() Forget all old contexts
AIResponse	uploadUserEntities(java.util.Collection<Entity> userEntities)
AIResponse	uploadUserEntity(Entity userEntity)
AIResponse	voiceRequest(java.io.InputStream voiceStream) Make requests to the ai service with voice data.
AIResponse	voiceRequest(java.io.InputStream voiceStream, java.util.List<AIContext> aiContexts) Make requests to the ai service with voice data.
AIResponse	voiceRequest(java.io.InputStream voiceStream, RequestExtras requestExtras) Make requests to the ai service with voice data.

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

Constructor Detail

AIDataService

public AIDataService(@NonNull
                     android.content.Context context,
                     @NonNull
                     AIConfiguration config)

Method Detail

request

public AIResponse request(@NonNull
                          AIRequest request)
                   throws AIServiceException

Throws:

AIServiceException

request

@NonNull
public AIResponse request(@NonNull
                                   AIRequest request,
                                   @Nullable
                                   RequestExtras requestExtras)
                            throws AIServiceException

Make request to the ai service. This method must not be called in the UI Thread

Parameters:

request - request object to the service

Returns:

response object from service

Throws:

AIServiceException

voiceRequest

@NonNull
public AIResponse voiceRequest(@NonNull
                                        java.io.InputStream voiceStream)
                                 throws AIServiceException

Make requests to the ai service with voice data. This method must not be called in the UI Thread.

Parameters:

voiceStream - voice data stream for recognition

Returns:

response object from service

Throws:

AIServiceException

voiceRequest

@NonNull
public AIResponse voiceRequest(@NonNull
                                        java.io.InputStream voiceStream,
                                        @Nullable
                                        java.util.List<AIContext> aiContexts)
                                 throws AIServiceException

Make requests to the ai service with voice data. This method must not be called in the UI Thread.

Parameters:

voiceStream - voice data stream for recognition

aiContexts - additional contexts for request

Returns:

response object from service

Throws:

AIServiceException

voiceRequest

@NonNull
public AIResponse voiceRequest(@NonNull
                                        java.io.InputStream voiceStream,
                                        @Nullable
                                        RequestExtras requestExtras)
                                 throws AIServiceException

Make requests to the ai service with voice data. This method must not be called in the UI Thread.

Parameters:

voiceStream - voice data stream for recognition

requestExtras - object that can hold additional contexts and entities

Returns:

response object from service

Throws:

AIServiceException

resetContexts

public boolean resetContexts()

Forget all old contexts

Returns:

true if operation succeed, false otherwise

uploadUserEntity

public AIResponse uploadUserEntity(Entity userEntity)
                            throws AIServiceException

Throws:

AIServiceException

uploadUserEntities

public AIResponse uploadUserEntities(java.util.Collection<Entity> userEntities)
                              throws AIServiceException

Throws:

AIServiceException

doTextRequest

protected java.lang.String doTextRequest(java.lang.String requestJson)
                                  throws java.net.MalformedURLException,
                                         AIServiceException

Throws:

java.net.MalformedURLException

AIServiceException

doTextRequest

protected java.lang.String doTextRequest(java.lang.String endpoint,
                                         java.lang.String requestJson)
                                  throws java.net.MalformedURLException,
                                         AIServiceException

Throws:

java.net.MalformedURLException

AIServiceException

doTextRequest

protected java.lang.String doTextRequest(@NonNull
                                         java.lang.String endpoint,
                                         @NonNull
                                         java.lang.String requestJson,
                                         @Nullable
                                         java.util.Map<java.lang.String,java.lang.String> additionalHeaders)
                                  throws java.net.MalformedURLException,
                                         AIServiceException

Throws:

java.net.MalformedURLException

AIServiceException

doSoundRequest

protected java.lang.String doSoundRequest(@NonNull
                                          java.io.InputStream voiceStream,
                                          @NonNull
                                          java.lang.String queryData)
                                   throws java.net.MalformedURLException,
                                          AIServiceException

Throws:

java.net.MalformedURLException

AIServiceException

doSoundRequest

protected java.lang.String doSoundRequest(@NonNull
                                          java.io.InputStream voiceStream,
                                          @NonNull
                                          java.lang.String queryData,
                                          @Nullable
                                          java.util.Map<java.lang.String,java.lang.String> additionalHeaders)
                                   throws java.net.MalformedURLException,
                                          AIServiceException

Method extracted for testing purposes

Throws:

java.net.MalformedURLException

AIServiceException