com.opensymphony.util

Class MultipartException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.opensymphony.util.MultipartException

All Implemented Interfaces:

java.io.Serializable

public class MultipartException
extends java.lang.Exception

Exception to encapsulate many exceptions.

Very conceptual example

 class MyException extends MultipartException {
   // No class body needed as overrides default constructor.
 }

 public void doStuff() {
   try {
     checkEverything();
     println("Everything went fine.");
   }
   catch (MultipartException error) {
     Iterator i = error.list();
     println("Failed:");
     while(i.hasNext()) {
       println(" - " + (String)i.next() );
     }
   }
 }

 private void checkEverything() throws MyException {
   MyException m = new MyException;
   // add some exceptions if methods don't check out.
   if ( !verifySomething() ) m.add("Something not verified");
   if ( !verifySomethingElse() ) m.add("Something else not verified");
   // also (just for fun), add an exception if another exception is called.
   try {
     someMethodThatThrowsAnException()
   }
   catch(SomeWeirdException e) {
     m.add(e)
   }
   // check if any exceptions have been added and re-throw in one go if they have.
   if (m.hasErrors()) throw m;
 }

 

Version:

$Revision: 1.1.1.1 $

Author:

Joe Walnes

See Also:

Exception, List, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List	errors List used internally to store Strings of error messages.

Constructor Summary

Constructors

Constructor and Description
MultipartException() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(java.lang.String msg) Add an error message to the Exception.
void	add(java.lang.Throwable exception) Add an Exception's error message to the Exception.
java.lang.String[]	getArray() Return error msgs as String array.
java.util.Iterator	getIterator() Return Iterator of String error msgs.
java.util.List	getList() Return error msgs as List of Strings.
boolean	hasErrors() Check whether any errors have been added.
java.util.Iterator	list() Deprecated. Use getIterator() instead.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

errors

protected java.util.List errors

List used internally to store Strings of error messages.

Constructor Detail

MultipartException

public MultipartException()

Default constructor. Initialises internal list.

Method Detail

getArray

public java.lang.String[] getArray()

Return error msgs as String array.

getIterator

public java.util.Iterator getIterator()

Return Iterator of String error msgs.

getList

public java.util.List getList()

Return error msgs as List of Strings.

add

public void add(java.lang.String msg)

Add an error message to the Exception.

Parameters:

msg - Error message.

add

public void add(java.lang.Throwable exception)

Add an Exception's error message to the Exception.

Parameters:

exception - Exception of which getMessage() is called to add the message.

hasErrors

public boolean hasErrors()

Check whether any errors have been added.

list

public java.util.Iterator list()

Deprecated. Use getIterator() instead.

Return Iterator of error msgs.

Returns:

Iterator of String representations of error message.