javax.faces.validator.MultiFieldValidationUtils Maven / Gradle / Ivy
Show all versions of jboss-jsf-api_2.3_spec Show documentation
/*
* Copyright (c) 1997, 2018 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package javax.faces.validator;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import javax.faces.context.FacesContext;
import static javax.faces.validator.BeanValidator.ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME;
import static javax.faces.validator.BeanValidator.VALIDATOR_ID;
import javax.validation.groups.Default;
class MultiFieldValidationUtils {
static final String MULTI_FIELD_VALIDATION_CANDIDATES =
VALIDATOR_ID + ".MULTI_FIELD_VALIDATION_CANDIDATES";
/**
* Special value to indicate the proposed value
* for a property failed field-level validation. This prevents any attempt
* to perform class level validation.
*/
static final String FAILED_FIELD_LEVEL_VALIDATION = VALIDATOR_ID + ".FAILED_FIELD_LEVEL_VALIDATION";
/*
* Returns a data structure that stores
* the information necessary to perform class-level validation by
* <f:validateWholeBean > components elsewhere in
* the tree. The lifetime of this data structure does not extend
* beyond the current {@code FacesContext}. The data structure must
* conform to the following specification.
*
*
*
*
*
* It is a non-thread-safe {@code Map}.
Keys are CDI bean instances that are referenced by the
* {@code value} attribute of <f:validateWholeBean
* > components.
-
*
*
Values are {@code Map}s that represent the properties to be stored
* on the CDI bean instance that is the current key. The inner {@code Map}
* must conform to the following specification.
*
*
*
* It is a non-thread-safe {@code Map}.
Keys are property names.
Values are {@code Map} instances. In this innermost map, the following keys are supported.
*
* component: Object that is the EditableValueHolder
* value: Object that is the value of the property
*
*
*
*
*
*
*
*
*
*
*
* @param context the {@link FacesContext} for this request
*
* @param create if {@code true}, the data structure must be created if not present.
* If {@code false} the data structure must not be created and {@code Collections.emptyMap()}
* must be returned.
*
* @return the data structure representing the multi-field validation candidates
*
* @since 2.3
*/
static Map>> getMultiFieldValidationCandidates(FacesContext context, boolean create) {
Map attrs = context.getAttributes();
Map>> result;
result = (Map>>) attrs.get(MULTI_FIELD_VALIDATION_CANDIDATES);
if (null == result) {
if (create) {
result = new HashMap<>();
attrs.put(MULTI_FIELD_VALIDATION_CANDIDATES, result);
} else {
result = Collections.emptyMap();
}
}
return result;
}
static boolean wholeBeanValidationEnabled(FacesContext context,
Class [] validationGroupsArray) {
boolean result;
Map attrs = context.getAttributes();
if (!(attrs.containsKey(ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME) &&
(Boolean)attrs.get(ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME))) { // NOPMD
return false;
}
result = !(1 == validationGroupsArray.length && Default.class == validationGroupsArray[0]);
return result;
}
}