modificationexception.java

非常接近C/S操作方式的Java Ajax框架－ZK 用ZK框架使你的B/S应用程序更漂亮更易操作。 官网：www.zkoss.org

/* ModificationException.java

{{IS_NOTE
	Purpose:
		
	Description:
		
	History:
		Thu Aug  8 19:59:53  2002, Created by tomyeh
}}IS_NOTE

Copyright (C) 2002 Potix Corporation. All Rights Reserved.

{{IS_RIGHT
	This program is distributed under GPL Version 2.0 in the hope that
	it will be useful, but WITHOUT ANY WARRANTY.
}}IS_RIGHT
*/
package org.zkoss.util;

import org.zkoss.lang.CommonException;
import org.zkoss.lang.Exceptions;
import org.zkoss.lang.Expectable;

/**
 * Denotes a modification fails. It is considered as
 * a program bug, while {@link InvalidValueException} is considered as
 * an operational error of user.
 *
 * <p>The create, remove and setter method of peristent beans (i3pb) must
 * declare this exception. Besides this exception and,
 * {@link InvalidValueException},
 * org.zkoss.i3.pb.RemoveException and org.zkoss.i3.pb.CreateException,
 * who derive from this class, might be thrown
 *
 * @author tomyeh
 */
public class ModificationException extends CommonException {
	/** Utilities.
	 *
	 * <p>The reason to use a class to hold static utilities is we can
	 * override the method's return type later.
	 */
	public static class Aide {
		/** Converts an exception to ModificationException or InvalidValueException
		 * depending on whether t implements {@link Expectable}.
		 * @see Exceptions#wrap
		 */
		public static ModificationException wrap(Throwable t) {
			t = Exceptions.unwrap(t);
			if (t instanceof Expectable)
				return (InvalidValueException)
					Exceptions.wrap(t, InvalidValueException.class);
			return (ModificationException)
				Exceptions.wrap(t, ModificationException.class);
		}
		/** Converts an exception to ModificationException or InvalidValueException
		 * depending on whether t implements {@link Expectable}.
		 * @see Exceptions#wrap
		 */
		public static ModificationException wrap(Throwable t, String msg) {
			t = Exceptions.unwrap(t);
			if (t instanceof Expectable)
				return (InvalidValueException)
					Exceptions.wrap(t, InvalidValueException.class, msg);
			return (ModificationException)
				Exceptions.wrap(t, ModificationException.class, msg);
		}
		/** Converts an exception to ModificationException or InvalidValueException
		 * depending on whether t implements {@link Expectable}.
		 * @see Exceptions#wrap
		 */
		public static ModificationException wrap(Throwable t, int code, Object[] fmtArgs) {
			t = Exceptions.unwrap(t);
			if (t instanceof Expectable)
				return (InvalidValueException)
					Exceptions.wrap(t, InvalidValueException.class, code, fmtArgs);
			return (ModificationException)
				Exceptions.wrap(t, ModificationException.class, code, fmtArgs);
		}
		/** Converts an exception to ModificationException or InvalidValueException
		 * depending on whether t implements {@link Expectable}.
		 * @see Exceptions#wrap
		 */
		public static ModificationException wrap(Throwable t, int code, Object fmtArg) {
			t = Exceptions.unwrap(t);
			if (t instanceof Expectable)
				return (InvalidValueException)
					Exceptions.wrap(t, InvalidValueException.class, code, fmtArg);
			return (ModificationException)
				Exceptions.wrap(t, ModificationException.class, code, fmtArg);
		}
		/** Converts an exception to ModificationException or InvalidValueException
		 * depending on whether t implements {@link Expectable}.
		 * @see Exceptions#wrap
		 */
		public static ModificationException wrap(Throwable t, int code) {
			t = Exceptions.unwrap(t);
			if (t instanceof Expectable)
				return (InvalidValueException)
					Exceptions.wrap(t, InvalidValueException.class, code);
			return (ModificationException)
				Exceptions.wrap(t, ModificationException.class, code);
		}
	}

	public ModificationException(String msg, Throwable cause) {
		super(msg, cause);
	}
	public ModificationException(String s) {
		super(s);
	}
	public ModificationException(Throwable cause) {
		super(cause);
	}
	public ModificationException() {
	}

	public ModificationException(int code, Object[] fmtArgs, Throwable cause) {
		super(code, fmtArgs, cause);
	}
	public ModificationException(int code, Object fmtArg, Throwable cause) {
		super(code, fmtArg, cause);
	}
	public ModificationException(int code, Object[] fmtArgs) {
		super(code, fmtArgs);
	}
	public ModificationException(int code, Object fmtArg) {
		super(code, fmtArg);
	}
	public ModificationException(int code, Throwable cause) {
		super(code, cause);
	}
	public ModificationException(int code) {
		super(code);
	}
}