/* * Copyright (C) 2017 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.service.autofill; import static android.view.autofill.Helper.sDebug; import android.annotation.NonNull; import android.annotation.Nullable; import android.annotation.TestApi; import android.os.Parcel; import android.os.Parcelable; import android.util.Slog; import android.view.autofill.AutofillValue; import java.util.Objects; import java.util.regex.Matcher; import java.util.regex.Pattern; /** * Sanitizes a text {@link AutofillValue} using a regular expression (regex) substitution. * *
For example, to remove spaces from groups of 4-digits in a credit card: * *
* new TextValueSanitizer(Pattern.compile("^(\\d{4})\\s?(\\d{4})\\s?(\\d{4})\\s?(\\d{4})$"),
* "$1$2$3$4")
*
*/
public final class TextValueSanitizer extends InternalSanitizer implements
Sanitizer, Parcelable {
private static final String TAG = "TextValueSanitizer";
private final Pattern mRegex;
private final String mSubst;
/**
* Default constructor.
*
* @param regex regular expression with groups (delimited by {@code (} and {@code (}) that
* are used to substitute parts of the {@link AutofillValue#getTextValue() text value}.
* @param subst the string that substitutes the matched regex, using {@code $} for
* group substitution ({@code $1} for 1st group match, {@code $2} for 2nd, etc).
*/
public TextValueSanitizer(@NonNull Pattern regex, @NonNull String subst) {
mRegex = Objects.requireNonNull(regex);
mSubst = Objects.requireNonNull(subst);
}
/** @hide */
@Override
@TestApi
@Nullable
public AutofillValue sanitize(@NonNull AutofillValue value) {
if (value == null) {
Slog.w(TAG, "sanitize() called with null value");
return null;
}
if (!value.isText()) {
if (sDebug) Slog.d(TAG, "sanitize() called with non-text value: " + value);
return null;
}
final CharSequence text = value.getTextValue();
try {
final Matcher matcher = mRegex.matcher(text);
if (!matcher.matches()) {
if (sDebug) Slog.d(TAG, "sanitize(): " + mRegex + " failed for " + value);
return null;
}
final CharSequence sanitized = matcher.replaceAll(mSubst);
return AutofillValue.forText(sanitized);
} catch (Exception e) {
Slog.w(TAG, "Exception evaluating " + mRegex + "/" + mSubst + ": " + e);
return null;
}
}
/////////////////////////////////////
// Object "contract" methods. //
/////////////////////////////////////
@Override
public String toString() {
if (!sDebug) return super.toString();
return "TextValueSanitizer: [regex=" + mRegex + ", subst=" + mSubst + "]";
}
/////////////////////////////////////
// Parcelable "contract" methods. //
/////////////////////////////////////
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(Parcel parcel, int flags) {
parcel.writeSerializable(mRegex);
parcel.writeString(mSubst);
}
public static final @android.annotation.NonNull Parcelable.Creator