1 /*
2  * Copyright (C) 2017 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 package android.service.autofill;
17 
18 import static android.view.autofill.Helper.sDebug;
19 
20 import android.annotation.NonNull;
21 import android.annotation.TestApi;
22 import android.os.Parcelable;
23 import android.util.Log;
24 import android.util.Pair;
25 import android.widget.RemoteViews;
26 
27 import java.util.ArrayList;
28 
29 /**
30  * Superclass of all transformation the system understands. As this is not public all
31  * subclasses have to implement {@link Transformation} again.
32  *
33  * @hide
34  */
35 @TestApi
36 public abstract class InternalTransformation implements Transformation, Parcelable {
37 
38     private static final String TAG = "InternalTransformation";
39 
40     /**
41      * Applies this transformation to a child view of a {@link android.widget.RemoteViews
42      * presentation template}.
43      *
44      * @param finder object used to find the value of a field in the screen.
45      * @param template the {@link RemoteViews presentation template}.
46      * @param childViewId resource id of the child view inside the template.
47      */
48     @SuppressWarnings("HiddenAbstractMethod")
apply(@onNull ValueFinder finder, @NonNull RemoteViews template, int childViewId)49     abstract void apply(@NonNull ValueFinder finder, @NonNull RemoteViews template,
50             int childViewId) throws Exception;
51 
52     /**
53      * Applies multiple transformations to the children views of a
54      * {@link android.widget.RemoteViews presentation template}.
55      *
56      * @param finder object used to find the value of a field in the screen.
57      * @param template the {@link RemoteViews presentation template}.
58      * @param transformations map of resource id of the child view inside the template to
59      * transformation.
60      */
batchApply(@onNull ValueFinder finder, @NonNull RemoteViews template, @NonNull ArrayList<Pair<Integer, InternalTransformation>> transformations)61     public static boolean batchApply(@NonNull ValueFinder finder, @NonNull RemoteViews template,
62             @NonNull ArrayList<Pair<Integer, InternalTransformation>> transformations) {
63         final int size = transformations.size();
64         if (sDebug) Log.d(TAG, "getPresentation(): applying " + size + " transformations");
65         for (int i = 0; i < size; i++) {
66             final Pair<Integer, InternalTransformation> pair = transformations.get(i);
67             final int id = pair.first;
68             final InternalTransformation transformation = pair.second;
69             if (sDebug) Log.d(TAG, "#" + i + ": " + transformation);
70 
71             try {
72                 transformation.apply(finder, template, id);
73             } catch (Exception e) {
74                 // Do not log full exception to avoid PII leaking
75                 Log.e(TAG, "Could not apply transformation " + transformation + ": "
76                         + e.getClass());
77                 return false;
78             }
79         }
80         return true;
81     }
82 }
83