/* * Copyright 2002-2007 the original author or authors. * * 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 org.springframework.beans; import java.io.PrintStream; import java.io.PrintWriter; import org.springframework.util.Assert; /** * Combined exception, composed of individual PropertyAccessException instances. * An object of this class is created at the beginning of the binding * process, and errors added to it as necessary. * * <p>The binding process continues when it encounters application-level * PropertyAccessExceptions, applying those changes that can be applied * and storing rejected changes in an object of this class. * * @author Rod Johnson * @author Juergen Hoeller * @since 18 April 2001 */ public class PropertyBatchUpdateException extends BeansException { /** List of PropertyAccessException objects */ private PropertyAccessException[] propertyAccessExceptions; /** * Create a new PropertyBatchUpdateException. * @param propertyAccessExceptions the List of PropertyAccessExceptions */ public PropertyBatchUpdateException(PropertyAccessException[] propertyAccessExceptions) { super(null); Assert.notEmpty(propertyAccessExceptions, "At least 1 PropertyAccessException required"); this.propertyAccessExceptions = propertyAccessExceptions; } /** * If this returns 0, no errors were encountered during binding. */ public final int getExceptionCount() { return this.propertyAccessExceptions.length; } /** * Return an array of the propertyAccessExceptions stored in this object. * Will return the empty array (not null) if there were no errors. */ public final PropertyAccessException[] getPropertyAccessExceptions() { return this.propertyAccessExceptions; } /** * Return the exception for this field, or <code>null</code> if there isn't one. */ public PropertyAccessException getPropertyAccessException(String propertyName) { for (int i = 0; i < this.propertyAccessExceptions.length; i++) { PropertyAccessException pae = this.propertyAccessExceptions[i]; if (propertyName.equals(pae.getPropertyChangeEvent().getPropertyName())) { return pae; } } return null; } public String getMessage() { StringBuffer sb = new StringBuffer("Failed properties: "); for (int i = 0; i < this.propertyAccessExceptions.length; i++) { sb.append(this.propertyAccessExceptions[i].getMessage()); if (i < this.propertyAccessExceptions.length - 1) { sb.append("; "); } } return sb.toString(); } public String toString() { StringBuffer sb = new StringBuffer(); sb.append(getClass().getName()).append("; nested PropertyAccessExceptions ("); sb.append(getExceptionCount()).append(") are:"); for (int i = 0; i < this.propertyAccessExceptions.length; i++) { sb.append('\n').append("PropertyAccessException ").append(i + 1).append(": "); sb.append(this.propertyAccessExceptions[i]); } return sb.toString(); } public void printStackTrace(PrintStream ps) { synchronized (ps) { ps.println(getClass().getName() + "; nested PropertyAccessException details (" + getExceptionCount() + ") are:"); for (int i = 0; i < this.propertyAccessExceptions.length; i++) { ps.println("PropertyAccessException " + (i + 1) + ":"); this.propertyAccessExceptions[i].printStackTrace(ps); } } } public void printStackTrace(PrintWriter pw) { synchronized (pw) { pw.println(getClass().getName() + "; nested PropertyAccessException details (" + getExceptionCount() + ") are:"); for (int i = 0; i < this.propertyAccessExceptions.length; i++) { pw.println("PropertyAccessException " + (i + 1) + ":"); this.propertyAccessExceptions[i].printStackTrace(pw); } } } public boolean contains(Class exType) { if (exType == null) { return false; } if (exType.isInstance(this)) { return true; } for (int i = 0; i < this.propertyAccessExceptions.length; i++) { PropertyAccessException pae = this.propertyAccessExceptions[i]; if (pae.contains(exType)) { return true; } } return false; } }