core/tests/coretests/src/android/view/textclassifier/intent/LabeledIntentTest.java

/*
 * Copyright (C) 2019 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.view.textclassifier.intent;

import static com.google.common.truth.Truth.assertThat;

import static org.testng.Assert.assertThrows;

import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.textclassifier.FakeContextBuilder;
import android.view.textclassifier.TextClassifier;

import androidx.test.filters.SmallTest;
import androidx.test.runner.AndroidJUnit4;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;

@SmallTest
@RunWith(AndroidJUnit4.class)
public final class LabeledIntentTest {
    private static final String TITLE_WITHOUT_ENTITY = "Map";
    private static final String TITLE_WITH_ENTITY = "Map NW14D1";
    private static final String DESCRIPTION = "Check the map";
    private static final String DESCRIPTION_WITH_APP_NAME = "Use %1$s to open map";
    private static final Intent INTENT =
            new Intent(Intent.ACTION_VIEW).setDataAndNormalize(Uri.parse("http://www.android.com"));
    private static final int REQUEST_CODE = 42;
    private static final Bundle TEXT_LANGUAGES_BUNDLE = Bundle.EMPTY;
    private static final String APP_LABEL = "fake";

    private Context mContext;

    @Before
    public void setup() {
        final ComponentName component = FakeContextBuilder.DEFAULT_COMPONENT;
        mContext = new FakeContextBuilder()
                .setIntentComponent(Intent.ACTION_VIEW, component)
                .setAppLabel(component.getPackageName(), APP_LABEL)
                .build();
    }

    @Test
    public void resolve_preferTitleWithEntity() {
        LabeledIntent labeledIntent = new LabeledIntent(
                TITLE_WITHOUT_ENTITY,
                TITLE_WITH_ENTITY,
                DESCRIPTION,
                null,
                INTENT,
                REQUEST_CODE
        );

        LabeledIntent.Result result = labeledIntent.resolve(
                mContext, /*titleChooser*/ null, TEXT_LANGUAGES_BUNDLE);

        assertThat(result).isNotNull();
        assertThat(result.remoteAction.getTitle()).isEqualTo(TITLE_WITH_ENTITY);
        assertThat(result.remoteAction.getContentDescription()).isEqualTo(DESCRIPTION);
        Intent intent = result.resolvedIntent;
        assertThat(intent.getAction()).isEqualTo(intent.getAction());
        assertThat(intent.getComponent()).isNotNull();
        assertThat(intent.hasExtra(TextClassifier.EXTRA_FROM_TEXT_CLASSIFIER)).isTrue();
    }

    @Test
    public void resolve_useAvailableTitle() {
        LabeledIntent labeledIntent = new LabeledIntent(
                TITLE_WITHOUT_ENTITY,
                null,
                DESCRIPTION,
                null,
                INTENT,
                REQUEST_CODE
        );

        LabeledIntent.Result result = labeledIntent.resolve(
                mContext, /*titleChooser*/ null, TEXT_LANGUAGES_BUNDLE);

        assertThat(result).isNotNull();
        assertThat(result.remoteAction.getTitle()).isEqualTo(TITLE_WITHOUT_ENTITY);
        assertThat(result.remoteAction.getContentDescription()).isEqualTo(DESCRIPTION);
        Intent intent = result.resolvedIntent;
        assertThat(intent.getAction()).isEqualTo(intent.getAction());
        assertThat(intent.getComponent()).isNotNull();
    }

    @Test
    public void resolve_titleChooser() {
        LabeledIntent labeledIntent = new LabeledIntent(
                TITLE_WITHOUT_ENTITY,
                null,
                DESCRIPTION,
                null,
                INTENT,
                REQUEST_CODE
        );

        LabeledIntent.Result result = labeledIntent.resolve(
                mContext, (labeledIntent1, resolveInfo) -> "chooser", TEXT_LANGUAGES_BUNDLE);

        assertThat(result).isNotNull();
        assertThat(result.remoteAction.getTitle()).isEqualTo("chooser");
        assertThat(result.remoteAction.getContentDescription()).isEqualTo(DESCRIPTION);
        Intent intent = result.resolvedIntent;
        assertThat(intent.getAction()).isEqualTo(intent.getAction());
        assertThat(intent.getComponent()).isNotNull();
    }

    @Test
    public void resolve_titleChooserReturnsNull() {
        LabeledIntent labeledIntent = new LabeledIntent(
                TITLE_WITHOUT_ENTITY,
                null,
                DESCRIPTION,
                null,
                INTENT,
                REQUEST_CODE
        );

        LabeledIntent.Result result = labeledIntent.resolve(
                mContext, (labeledIntent1, resolveInfo) -> null, TEXT_LANGUAGES_BUNDLE);

        assertThat(result).isNotNull();
        assertThat(result.remoteAction.getTitle()).isEqualTo(TITLE_WITHOUT_ENTITY);
        assertThat(result.remoteAction.getContentDescription()).isEqualTo(DESCRIPTION);
        Intent intent = result.resolvedIntent;
        assertThat(intent.getAction()).isEqualTo(intent.getAction());
        assertThat(intent.getComponent()).isNotNull();
    }

    @Test
    public void resolve_missingTitle() {
        assertThrows(
                IllegalArgumentException.class,
                () ->
                        new LabeledIntent(
                                null,
                                null,
                                DESCRIPTION,
                                null,
                                INTENT,
                                REQUEST_CODE
                        ));
    }

    @Test
    public void resolve_noIntentHandler() {
        // See setup(). mContext can only resolve Intent.ACTION_VIEW.
        Intent unresolvableIntent = new Intent(Intent.ACTION_TRANSLATE);
        LabeledIntent labeledIntent = new LabeledIntent(
                TITLE_WITHOUT_ENTITY,
                null,
                DESCRIPTION,
                null,
                unresolvableIntent,
                REQUEST_CODE);

        LabeledIntent.Result result = labeledIntent.resolve(mContext, null, null);

        assertThat(result).isNull();
    }

    @Test
    public void resolve_descriptionWithAppName() {
        LabeledIntent labeledIntent = new LabeledIntent(
                TITLE_WITHOUT_ENTITY,
                TITLE_WITH_ENTITY,
                DESCRIPTION,
                DESCRIPTION_WITH_APP_NAME,
                INTENT,
                REQUEST_CODE
        );

        LabeledIntent.Result result = labeledIntent.resolve(
                mContext, /*titleChooser*/ null, TEXT_LANGUAGES_BUNDLE);

        assertThat(result).isNotNull();
        assertThat(result.remoteAction.getContentDescription()).isEqualTo("Use fake to open map");
    }
}