packages_apps_Messaging/src/com/android/messaging/ui/VCardDetailFragment.java

/*
 * Copyright (C) 2015 The Android Open Source Project
 * Copyright (C) 2024 The LineageOS 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 com.android.messaging.ui;

import android.content.ActivityNotFoundException;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.os.Handler;
import android.os.Looper;
import android.view.LayoutInflater;
import android.view.Menu;
import android.view.MenuInflater;
import android.view.MenuItem;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ExpandableListAdapter;
import android.widget.ExpandableListView;

import androidx.annotation.NonNull;
import androidx.fragment.app.Fragment;

import com.android.messaging.R;
import com.android.messaging.datamodel.DataModel;
import com.android.messaging.datamodel.MediaScratchFileProvider;
import com.android.messaging.datamodel.binding.Binding;
import com.android.messaging.datamodel.binding.BindingBase;
import com.android.messaging.datamodel.data.PersonItemData;
import com.android.messaging.datamodel.data.VCardContactItemData;
import com.android.messaging.datamodel.data.PersonItemData.PersonItemDataListener;
import com.android.messaging.util.Assert;
import com.android.messaging.util.UiUtils;
import com.android.messaging.util.UriUtil;

import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;

/**
 * A fragment that shows the content of a VCard that contains one or more contacts.
 */
public class VCardDetailFragment extends Fragment implements PersonItemDataListener {
    private final Binding<VCardContactItemData> mBinding =
            BindingBase.createBinding(this);
    private ExpandableListView mListView;
    private VCardDetailAdapter mAdapter;
    private Uri mVCardUri;

    /**
     * We need to persist the VCard in the scratch directory before letting the user view it.
     * We save this Uri locally, so that if the user cancels the action and re-perform the add
     * to contacts action we don't have to persist it again.
     */
    private Uri mScratchSpaceUri;

    @Override
    public void onCreate(final Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setHasOptionsMenu(true);
    }

    @Override
    public View onCreateView(final LayoutInflater inflater, final ViewGroup container,
            final Bundle savedInstanceState) {
        Assert.notNull(mVCardUri);
        final View view = inflater.inflate(R.layout.vcard_detail_fragment, container, false);
        mListView = view.findViewById(R.id.list);
        mListView.addOnLayoutChangeListener((v, left, top, right, bottom, oldLeft, oldTop, oldRight,
                                             oldBottom) -> {
            mListView.setIndicatorBounds(mListView.getWidth() - getResources().
                            getDimensionPixelSize(R.dimen.vcard_detail_group_indicator_width),
                    mListView.getWidth());
        });
        mListView.setOnChildClickListener((expandableListView, clickedView, groupPosition,
                                           childPosition, childId) -> {
            if (!(clickedView instanceof PersonItemView)) {
                return false;
            }
            final Intent intent = ((PersonItemView) clickedView).getClickIntent();
            if (intent != null) {
                try {
                    startActivity(intent);
                } catch (ActivityNotFoundException e) {
                    return false;
                }
                return true;
            }
            return false;
        });
        mBinding.bind(DataModel.get().createVCardContactItemData(getActivity(), mVCardUri));
        mBinding.getData().setListener(this);
        return view;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        if (mBinding.isBound()) {
            mBinding.unbind();
        }
        mListView.setAdapter((ExpandableListAdapter) null);
    }

    private boolean shouldShowAddToContactsItem() {
        return mBinding.isBound() && mBinding.getData().hasValidVCard();
    }

    @Override
    public void onCreateOptionsMenu(@NonNull final Menu menu,
                                    @NonNull final MenuInflater inflater) {
        super.onCreateOptionsMenu(menu, inflater);
        inflater.inflate(R.menu.vcard_detail_fragment_menu, menu);
        final MenuItem addToContactsItem = menu.findItem(R.id.action_add_contact);
        addToContactsItem.setVisible(shouldShowAddToContactsItem());
    }

    @Override
    public boolean onOptionsItemSelected(final MenuItem item) {
        if (item.getItemId() == R.id.action_add_contact) {
            mBinding.ensureBound();
            final Uri vCardUri = mBinding.getData().getVCardUri();

            // We have to do things in the background in case we need to copy the vcard data.
            ExecutorService executor = Executors.newSingleThreadExecutor();
            Handler handler = new Handler(Looper.getMainLooper());

            executor.execute(() -> {
                // We can't delete the persisted vCard file because we don't know when to
                // delete it, since the app that uses it (contacts, dialer) may start or
                // shut down at any point. Therefore, we rely on the system to clean up
                // the cache directory for us.
                Uri result = mScratchSpaceUri != null ? mScratchSpaceUri :
                        UriUtil.persistContentToScratchSpace(vCardUri);

                handler.post(() -> {
                    if (result != null) {
                        mScratchSpaceUri = result;
                        if (getActivity() != null) {
                            MediaScratchFileProvider.addUriToDisplayNameEntry(
                                    result, mBinding.getData().getDisplayName());
                            UIIntents.get().launchSaveVCardToContactsActivity(getActivity(),
                                    result);
                        }
                    }
                });
            });
            return true;
        }
        return super.onOptionsItemSelected(item);
    }

    public void setVCardUri(final Uri vCardUri) {
        Assert.isTrue(!mBinding.isBound());
        mVCardUri = vCardUri;
    }

    @Override
    public void onPersonDataUpdated(final PersonItemData data) {
        Assert.isTrue(data instanceof VCardContactItemData);
        mBinding.ensureBound();
        final VCardContactItemData vCardData = (VCardContactItemData) data;
        Assert.isTrue(vCardData.hasValidVCard());
        mAdapter = new VCardDetailAdapter(getActivity(), vCardData.getVCardResource().getVCards());
        mListView.setAdapter(mAdapter);

        // Expand the contact card if there's only one contact.
        if (mAdapter.getGroupCount() == 1) {
            mListView.expandGroup(0);
        }
        getActivity().invalidateOptionsMenu();
    }

    @Override
    public void onPersonDataFailed(final PersonItemData data, final Exception exception) {
        mBinding.ensureBound();
        UiUtils.showToastAtBottom(R.string.failed_loading_vcard);
        getActivity().finish();
    }
}