com.microsoft.azure.cognitiveservices.language.textanalytics.TextAnalyticsManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of azure-cognitiveservices-textanalytics Show documentation
This package contains Microsoft Cognitive Service Text Analytics SDK.
There is a newer version: 1.0.2-beta
Show newest version
/**
 * Copyright (c) Microsoft Corporation. All rights reserved.
 * Licensed under the MIT License. See License.txt in the project root for
 * license information.
 */

package com.microsoft.azure.cognitiveservices.language.textanalytics;

import com.microsoft.azure.cognitiveservices.language.textanalytics.implementation.TextAnalyticsAPIImpl;
import com.microsoft.azure.cognitiveservices.language.textanalytics.models.AzureRegions;
import com.microsoft.rest.RestClient;
import com.microsoft.rest.credentials.ServiceClientCredentials;
import okhttp3.Interceptor;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

import java.io.IOException;

/**
 * Entry point to Azure Cognitive Services Text Analytics manager.
 */
public class TextAnalyticsManager {
    /**
     * Initializes an instance of Text Analytics API client.
     *
     * @param region Supported Azure regions for Cognitive Services endpoints.
     * @param subscriptionKey the Text Analytics API key
     * @return the Text Analytics API client
     */
    public static TextAnalyticsAPI authenticate(AzureRegions region, String subscriptionKey) {
        return authenticate("https://{AzureRegion}.api.cognitive.microsoft.com/text/analytics/", subscriptionKey)
                .withAzureRegion(region);
    }

    /**
     * Initializes an instance of Text Analytics API client.
     *
     * @param baseUrl the base URL of the service
     * @param subscriptionKey the Text Analytics API key
     * @return the Text Analytics API client
     */
    public static TextAnalyticsAPI authenticate(String baseUrl, final String subscriptionKey) {
        ServiceClientCredentials serviceClientCredentials = new ServiceClientCredentials() {
            @Override
            public void applyCredentialsFilter(OkHttpClient.Builder builder) {
                builder.addNetworkInterceptor(
                        new Interceptor() {
                            @Override
                            public Response intercept(Chain chain) throws IOException {
                                Request request = null;
                                Request original = chain.request();
                                // Request customization: add request headers
                                Request.Builder requestBuilder = original.newBuilder()
                                        .addHeader("Ocp-Apim-Subscription-Key", subscriptionKey);
                                request = requestBuilder.build();
                                return chain.proceed(request);
                            }
                        });
            }
        };
        return authenticate(baseUrl, serviceClientCredentials);
    }

    /**
     * Initializes an instance of Text Analytics API client.
     *
     * @param region Supported Azure regions for Cognitive Services endpoints.
     * @param credentials the management credentials for Azure
     * @return the Text Analytics API client
     */
    public static TextAnalyticsAPI authenticate(AzureRegions region, ServiceClientCredentials credentials) {
        return authenticate("https://{AzureRegion}.api.cognitive.microsoft.com/text/analytics/", credentials)
                .withAzureRegion(region);
    }

    /**
     * Initializes an instance of Text Analytics API client.
     *
     * @param baseUrl the base URL of the service
     * @param credentials the management credentials for Azure
     * @return the Text Analytics API client
     */
    public static TextAnalyticsAPI authenticate(String baseUrl, ServiceClientCredentials credentials) {
        return new TextAnalyticsAPIImpl(baseUrl, credentials);
    }

    /**
     * Initializes an instance of Text Analytics API client.
     *
     * @param restClient the REST client to connect to Azure.
     * @return the Text Analytics API client
     */
    public static TextAnalyticsAPI authenticate(RestClient restClient) {
        return new TextAnalyticsAPIImpl(restClient);
    }
}