PhoneCallDetailsHelper.java revision 1d1bd0da0b32a5b8cb1c7c5585acccb180b19849
1/* 2 * Copyright (C) 2011 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package com.android.dialer; 18 19import android.content.res.Resources; 20import android.provider.ContactsContract.CommonDataKinds.Phone; 21import android.text.TextUtils; 22import android.text.format.DateUtils; 23import android.view.View; 24import android.widget.TextView; 25 26import com.android.contacts.common.testing.NeededForTesting; 27import com.android.contacts.common.util.PhoneNumberHelper; 28import com.android.dialer.calllog.CallTypeHelper; 29import com.android.dialer.calllog.ContactInfo; 30import com.android.dialer.calllog.PhoneNumberDisplayHelper; 31import com.android.dialer.calllog.PhoneNumberUtilsWrapper; 32 33import com.google.common.collect.Lists; 34 35import java.util.ArrayList; 36 37/** 38 * Helper class to fill in the views in {@link PhoneCallDetailsViews}. 39 */ 40public class PhoneCallDetailsHelper { 41 /** The maximum number of icons will be shown to represent the call types in a group. */ 42 private static final int MAX_CALL_TYPE_ICONS = 3; 43 44 private final Resources mResources; 45 /** The injected current time in milliseconds since the epoch. Used only by tests. */ 46 private Long mCurrentTimeMillisForTest; 47 // Helper classes. 48 private final CallTypeHelper mCallTypeHelper; 49 private final PhoneNumberDisplayHelper mPhoneNumberHelper; 50 private final PhoneNumberUtilsWrapper mPhoneNumberUtilsWrapper; 51 52 /** 53 * List of items to be concatenated together for accessibility descriptions 54 */ 55 private ArrayList<CharSequence> mDescriptionItems = Lists.newArrayList(); 56 57 /** 58 * Creates a new instance of the helper. 59 * <p> 60 * Generally you should have a single instance of this helper in any context. 61 * 62 * @param resources used to look up strings 63 */ 64 public PhoneCallDetailsHelper(Resources resources, CallTypeHelper callTypeHelper, 65 PhoneNumberUtilsWrapper phoneUtils) { 66 mResources = resources; 67 mCallTypeHelper = callTypeHelper; 68 mPhoneNumberUtilsWrapper = phoneUtils; 69 mPhoneNumberHelper = new PhoneNumberDisplayHelper(mPhoneNumberUtilsWrapper, resources); 70 } 71 72 /** Fills the call details views with content. */ 73 public void setPhoneCallDetails(PhoneCallDetailsViews views, PhoneCallDetails details) { 74 // Display up to a given number of icons. 75 views.callTypeIcons.clear(); 76 int count = details.callTypes.length; 77 for (int index = 0; index < count && index < MAX_CALL_TYPE_ICONS; ++index) { 78 views.callTypeIcons.add(details.callTypes[index]); 79 } 80 views.callTypeIcons.requestLayout(); 81 views.callTypeIcons.setVisibility(View.VISIBLE); 82 83 // Show the total call count only if there are more than the maximum number of icons. 84 final Integer callCount; 85 if (count > MAX_CALL_TYPE_ICONS) { 86 callCount = count; 87 } else { 88 callCount = null; 89 } 90 91 CharSequence callLocationAndDate = getCallLocationAndDate(details); 92 93 // Set the call count, location and date. 94 setCallCountAndDate(views, callCount, callLocationAndDate); 95 96 // set the account icon if it exists 97 if (details.accountIcon != null) { 98 views.callAccountIcon.setVisibility(View.VISIBLE); 99 views.callAccountIcon.setImageDrawable(details.accountIcon); 100 } else { 101 views.callAccountIcon.setVisibility(View.GONE); 102 } 103 104 final CharSequence nameText; 105 final CharSequence displayNumber = 106 mPhoneNumberHelper.getDisplayNumber(details.number, 107 details.numberPresentation, details.formattedNumber); 108 if (TextUtils.isEmpty(details.name)) { 109 nameText = displayNumber; 110 // We have a real phone number as "nameView" so make it always LTR 111 views.nameView.setTextDirection(View.TEXT_DIRECTION_LTR); 112 } else { 113 nameText = details.name; 114 } 115 116 views.nameView.setText(nameText); 117 118 // TODO: At the current time the voicemail transcription is not supported. This view 119 // is kept for future expansion when we may wish to show a transcription of voicemail. 120 views.voicemailTranscriptionView.setText(""); 121 views.voicemailTranscriptionView.setVisibility(View.GONE); 122 } 123 124 /** 125 * Builds a string containing the call location and date. 126 * 127 * @param details The call details. 128 * @return The call location and date string. 129 */ 130 private CharSequence getCallLocationAndDate(PhoneCallDetails details) { 131 mDescriptionItems.clear(); 132 133 // Get type of call (ie mobile, home, etc) if known, or the caller's location. 134 CharSequence callTypeOrLocation = getCallTypeOrLocation(details); 135 136 // Only add the call type or location if its not empty. It will be empty for unknown 137 // callers. 138 if (!TextUtils.isEmpty(callTypeOrLocation)) { 139 mDescriptionItems.add(callTypeOrLocation); 140 } 141 // The date of this call, relative to the current time. 142 mDescriptionItems.add(getCallDate(details)); 143 144 // Create a comma separated list from the call type or location, and call date. 145 return TextUtils.join(", " , mDescriptionItems); 146 } 147 148 /** 149 * For a call, if there is an associated contact for the caller, return the known call type 150 * (e.g. mobile, home, work). If there is no associated contact, attempt to use the caller's 151 * location if known. 152 * @param details Call details to use. 153 * @return Type of call (mobile/home) if known, or the location of the caller (if known). 154 */ 155 public CharSequence getCallTypeOrLocation(PhoneCallDetails details) { 156 CharSequence numberFormattedLabel = null; 157 // Only show a label if the number is shown and it is not a SIP address. 158 if (!TextUtils.isEmpty(details.number) 159 && !PhoneNumberHelper.isUriNumber(details.number.toString()) 160 && !mPhoneNumberUtilsWrapper.isVoicemailNumber(details.number)) { 161 162 if (details.numberLabel == ContactInfo.GEOCODE_AS_LABEL) { 163 numberFormattedLabel = details.geocode; 164 } else { 165 numberFormattedLabel = Phone.getTypeLabel(mResources, details.numberType, 166 details.numberLabel); 167 } 168 } 169 170 if (!TextUtils.isEmpty(details.name) && TextUtils.isEmpty(numberFormattedLabel)) { 171 numberFormattedLabel = mPhoneNumberHelper.getDisplayNumber(details.number, 172 details.numberPresentation, details.formattedNumber); 173 } 174 return numberFormattedLabel; 175 } 176 177 /** 178 * Get the call date/time of the call, relative to the current time. 179 * e.g. 3 minutes ago 180 * @param details Call details to use. 181 * @return String representing when the call occurred. 182 */ 183 public CharSequence getCallDate(PhoneCallDetails details) { 184 return DateUtils.getRelativeTimeSpanString(details.date, 185 getCurrentTimeMillis(), 186 DateUtils.MINUTE_IN_MILLIS, 187 DateUtils.FORMAT_ABBREV_RELATIVE); 188 } 189 190 /** Sets the text of the header view for the details page of a phone call. */ 191 @NeededForTesting 192 public void setCallDetailsHeader(TextView nameView, PhoneCallDetails details) { 193 final CharSequence nameText; 194 final CharSequence displayNumber = 195 mPhoneNumberHelper.getDisplayNumber(details.number, details.numberPresentation, 196 mResources.getString(R.string.recentCalls_addToContact)); 197 if (TextUtils.isEmpty(details.name)) { 198 nameText = displayNumber; 199 } else { 200 nameText = details.name; 201 } 202 203 nameView.setText(nameText); 204 } 205 206 @NeededForTesting 207 public void setCurrentTimeForTest(long currentTimeMillis) { 208 mCurrentTimeMillisForTest = currentTimeMillis; 209 } 210 211 /** 212 * Returns the current time in milliseconds since the epoch. 213 * <p> 214 * It can be injected in tests using {@link #setCurrentTimeForTest(long)}. 215 */ 216 private long getCurrentTimeMillis() { 217 if (mCurrentTimeMillisForTest == null) { 218 return System.currentTimeMillis(); 219 } else { 220 return mCurrentTimeMillisForTest; 221 } 222 } 223 224 /** Sets the call count and date. */ 225 private void setCallCountAndDate(PhoneCallDetailsViews views, Integer callCount, 226 CharSequence dateText) { 227 // Combine the count (if present) and the date. 228 final CharSequence text; 229 if (callCount != null) { 230 text = mResources.getString( 231 R.string.call_log_item_count_and_date, callCount.intValue(), dateText); 232 } else { 233 text = dateText; 234 } 235 236 views.callLocationAndDate.setText(text); 237 } 238} 239