| /* |
| * Copyright (C) 2006 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.text.method; |
| |
| import android.annotation.NonNull; |
| import android.annotation.Nullable; |
| import android.text.InputType; |
| import android.view.KeyEvent; |
| |
| import com.android.internal.annotations.GuardedBy; |
| import com.android.internal.util.ArrayUtils; |
| |
| import java.util.HashMap; |
| import java.util.LinkedHashSet; |
| import java.util.Locale; |
| |
| /** |
| * For entering dates in a text field. |
| * <p></p> |
| * As for all implementations of {@link KeyListener}, this class is only concerned |
| * with hardware keyboards. Software input methods have no obligation to trigger |
| * the methods in this class. |
| */ |
| public class DateKeyListener extends NumberKeyListener |
| { |
| public int getInputType() { |
| if (mNeedsAdvancedInput) { |
| return InputType.TYPE_CLASS_TEXT | InputType.TYPE_TEXT_VARIATION_NORMAL; |
| } else { |
| return InputType.TYPE_CLASS_DATETIME | InputType.TYPE_DATETIME_VARIATION_DATE; |
| } |
| } |
| |
| @Override |
| @NonNull |
| protected char[] getAcceptedChars() { |
| return mCharacters; |
| } |
| |
| /** |
| * @deprecated Use {@link #DateKeyListener(Locale)} instead. |
| */ |
| @Deprecated |
| public DateKeyListener() { |
| this(null); |
| } |
| |
| private static final String SYMBOLS_TO_IGNORE = "yMLd"; |
| private static final String[] SKELETONS = {"yMd", "yM", "Md"}; |
| |
| public DateKeyListener(@Nullable Locale locale) { |
| final LinkedHashSet<Character> chars = new LinkedHashSet<>(); |
| // First add the digits, then add all the non-pattern characters seen in the pattern for |
| // "yMd", which is supposed to only have numerical fields. |
| final boolean success = NumberKeyListener.addDigits(chars, locale) |
| && NumberKeyListener.addFormatCharsFromSkeletons( |
| chars, locale, SKELETONS, SYMBOLS_TO_IGNORE); |
| if (success) { |
| mCharacters = NumberKeyListener.collectionToArray(chars); |
| mNeedsAdvancedInput = !ArrayUtils.containsAll(CHARACTERS, mCharacters); |
| } else { |
| mCharacters = CHARACTERS; |
| mNeedsAdvancedInput = false; |
| } |
| } |
| |
| /** |
| * @deprecated Use {@link #getInstance(Locale)} instead. |
| */ |
| @Deprecated |
| @NonNull |
| public static DateKeyListener getInstance() { |
| return getInstance(null); |
| } |
| |
| /** |
| * Returns an instance of DateKeyListener appropriate for the given locale. |
| */ |
| @NonNull |
| public static DateKeyListener getInstance(@Nullable Locale locale) { |
| DateKeyListener instance; |
| synchronized (sLock) { |
| instance = sInstanceCache.get(locale); |
| if (instance == null) { |
| instance = new DateKeyListener(locale); |
| sInstanceCache.put(locale, instance); |
| } |
| } |
| return instance; |
| } |
| |
| /** |
| * This field used to list the characters that were used. But is now a fixed data |
| * field that is the list of code units used for the deprecated case where the class |
| * is instantiated with null or no input parameter. |
| * |
| * @see KeyEvent#getMatch |
| * @see #getAcceptedChars |
| * |
| * @deprecated Use {@link #getAcceptedChars()} instead. |
| */ |
| @Deprecated |
| public static final char[] CHARACTERS = new char[] { |
| '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', |
| '/', '-', '.' |
| }; |
| |
| private final char[] mCharacters; |
| private final boolean mNeedsAdvancedInput; |
| |
| private static final Object sLock = new Object(); |
| @GuardedBy("sLock") |
| private static final HashMap<Locale, DateKeyListener> sInstanceCache = new HashMap<>(); |
| } |