/* * Copyright (C) 2022 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.safetycenter.config; import static android.os.Build.VERSION_CODES.TIRAMISU; import android.annotation.AnyRes; import android.annotation.NonNull; import android.annotation.Nullable; import android.content.res.Resources; import androidx.annotation.RequiresApi; import java.util.Collection; import java.util.Objects; import java.util.regex.Pattern; @RequiresApi(TIRAMISU) final class BuilderUtils { private BuilderUtils() {} private static void validateAttribute( @Nullable Object attribute, @NonNull String name, boolean required, boolean prohibited, @Nullable Object defaultValue) { if (attribute == null && required) { throwRequiredAttributeMissing(name); } boolean nonDefaultValueProvided = !Objects.equals(attribute, defaultValue); boolean checkProhibited = prohibited && nonDefaultValueProvided; if (attribute != null && checkProhibited) { throwProhibitedAttributePresent(name); } } static void validateAttribute( @Nullable Object attribute, @NonNull String name, boolean required, boolean prohibited) { validateAttribute(attribute, name, required, prohibited, null); } static void validateId( @Nullable String id, @NonNull String name, boolean required, boolean prohibited) { validateAttribute(id, name, required, prohibited, null); if (!Pattern.compile("[0-9a-zA-Z_]+").matcher(id).matches()) { throw new IllegalStateException("Attribute " + name + " invalid"); } } @AnyRes static int validateResId( @Nullable @AnyRes Integer value, @NonNull String name, boolean required, boolean prohibited) { validateAttribute(value, name, required, prohibited, Resources.ID_NULL); if (value == null) { return Resources.ID_NULL; } if (required && value == Resources.ID_NULL) { throwRequiredAttributeInvalid(name); } return value; } static int validateIntDef( @Nullable Integer value, @NonNull String name, boolean required, boolean prohibited, int defaultValue, int... validValues) { validateAttribute(value, name, required, prohibited, defaultValue); if (value == null) { return defaultValue; } boolean found = false; for (int i = 0; i < validValues.length; i++) { found |= (value == validValues[i]); } if (!found) { throw new IllegalStateException("Attribute " + name + " invalid"); } return value; } static int validateInteger( @Nullable Integer value, @NonNull String name, boolean required, boolean prohibited, int defaultValue) { validateAttribute(value, name, required, prohibited, defaultValue); if (value == null) { return defaultValue; } return value; } static boolean validateBoolean( @Nullable Boolean value, @NonNull String name, boolean required, boolean prohibited, boolean defaultValue) { validateAttribute(value, name, required, prohibited, defaultValue); if (value == null) { return defaultValue; } return value; } /** * Validates a collection argument from a builder. * * */ static void validateCollection( @NonNull Collection value, @NonNull String name, boolean required, boolean prohibited) { if (value.isEmpty() && required) { throwRequiredAttributeMissing(name); } if (!value.isEmpty() && prohibited) { throwProhibitedAttributePresent(name); } } static void throwRequiredAttributeMissing(@NonNull String attribute) { throw new IllegalStateException("Required attribute " + attribute + " missing"); } static void throwProhibitedAttributePresent(@NonNull String attribute) { throw new IllegalStateException("Prohibited attribute " + attribute + " present"); } static void throwRequiredAttributeInvalid(@NonNull String attribute) { throw new IllegalStateException("Required attribute " + attribute + " invalid"); } }