br.com.anteros.bean.validation.ValidationResults Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of Anteros-Bean-Validation Show documentation
Show all versions of Anteros-Bean-Validation Show documentation
Anteros Bean Validation for Java.
/*******************************************************************************
* Copyright 2012 Anteros Tecnologia
*
* 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 br.com.anteros.bean.validation;
import java.io.Serializable;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import br.com.anteros.bean.validation.model.ValidationContext;
import br.com.anteros.bean.validation.model.ValidationListener;
/**
* Description: Implements a contains to hold and transport validation results
*/
public class ValidationResults implements ValidationListener, Serializable {
private static final long serialVersionUID = 1L;
private Map> errorsByReason;
private Map>> errorsByOwner;
/**
* API to add an error to the validation results.
*
* @param reason - Features from {@link org.apache.bval.model.Features.Property}
* or custom reason of validation error
* @param context - context information (bean, propertyName, value, ...)
*/
public void addError(String reason, ValidationContext context) {
Error error = createError(reason, context.getBean(), context.getPropertyName());
addError(error, context);
}
/**
* API to add an error to the validation results.
*
* @param error - holding the description of reason and object to describe
* the validation error
* @param context - null or the context to provide additional information
*/
public void addError(Error error, ValidationContext context) {
if (errorsByReason == null) {
initialize();
}
addToReasonBucket(error);
addToOwnerBucket(error);
}
/**
* Old API to add an error to the validation results when no context is available.
*
* @param reason - Features from {@link org.apache.bval.model.Features.Property} or custom validation reason
* @param bean - (optional) owner bean or null
* @param propertyName - (optional) propertyName where valiation error occurred or null
*/
public void addError(String reason, Object bean, String propertyName) {
addError(createError(reason, bean, propertyName), null);
}
/**
* Create an Error object.
* @param reason
* @param owner
* @param propertyName
* @return new {@link Error}
*/
protected Error createError(String reason, Object owner, String propertyName) {
return new Error(reason, owner, propertyName);
}
/**
* initialize the error-buckets now when needed and
* not on instance creation to save memory garbage.
*/
protected void initialize() {
errorsByReason = new LinkedHashMap>();
errorsByOwner = new LinkedHashMap>>();
}
/**
* Add an Error to the set of Errors shared by a particular "reason."
* @param error
* @see {@link Error#getReason()}
*/
protected void addToReasonBucket(Error error) {
if (error.getReason() == null) return;
List errors = errorsByReason.get(error.getReason());
if (errors == null) {
errors = new ArrayList();
errorsByReason.put(error.getReason(), errors);
}
errors.add(error);
}
/**
* Add an Error to the property-keyed map of Errors maintained for this Error's owner.
* @param error
* @see {@link Error#getOwner()}
*/
protected void addToOwnerBucket(Error error) {
if (error.getOwner() == null) return;
Map> errors = errorsByOwner.get(error.getOwner());
if (errors == null) {
errors = new HashMap>();
errorsByOwner.put(error.getOwner(), errors);
}
List list = errors.get(error.getPropertyName());
if (list == null) {
list = new ArrayList();
errors.put(error.getPropertyName(), list);
}
list.add(error);
}
/**
* Get the map of Errors by reason;
* key = reason, value = list of errors for this reason
* @return map
*/
public Map> getErrorsByReason() {
if (errorsByReason == null) return Collections.emptyMap();
return errorsByReason;
}
/**
* Get the map of Errors by owner;
* key = owner, value = map with:
* key = propertyName, value = list of errors for this owner.propertyName
* @return map
*/
public Map>> getErrorsByOwner() {
if (errorsByOwner == null) return Collections.emptyMap();
return errorsByOwner;
}
/**
* Learn whether these results are empty/error-free.
* @return true when there are NO errors in this validation result
*/
public boolean isEmpty() {
if (errorsByReason == null ||
(errorsByReason.isEmpty() && errorsByOwner.isEmpty())) return true;
for (List list : errorsByReason.values()) {
if (!list.isEmpty()) return false;
}
for (Map> map : errorsByOwner.values()) {
for (List list : map.values()) {
if (!list.isEmpty()) return false;
}
}
return true;
}
/**
* Learn whether there is an Error keyed to a specified reason description.
* @param reason
* @return boolean
* @see {@link Error#getReason()}
*/
public boolean hasErrorForReason(String reason) {
if (errorsByReason == null) return false;
List errors = errorsByReason.get(reason);
return errors != null && !errors.isEmpty();
}
/**
* Learn whether bean has any errors keyed to property propertyName.
* @param bean
* @param propertyName - may be null: any property is checked
* OR the name of the property to check
* @return boolean
*/
public boolean hasError(Object bean, String propertyName) {
if (errorsByOwner == null) return false;
Map> errors = errorsByOwner.get(bean);
if (errors == null) return false;
if (propertyName != null) {
List list = errors.get(propertyName);
return list != null && !list.isEmpty();
} else {
for (List list : errors.values()) {
if (!list.isEmpty()) return true;
}
return false;
}
}
/**
* {@inheritDoc}
*/
public String toString() {
return "ValidationResults{" + errorsByOwner + "}";
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy