8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Copyright (c) 2005 Sun Microsystems Inc. All Rights Reserved
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * The contents of this file are subject to the terms
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * of the Common Development and Distribution License
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * (the License). You may not use this file except in
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * compliance with the License.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * You can obtain a copy of the License at
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * https://opensso.dev.java.net/public/CDDLv1.0.html or
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * See the License for the specific language governing
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * permission and limitations under the License.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * When distributing Covered Code, include this CDDL
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Header Notice in each file and include the License file
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * If applicable, add the following below the CDDL Header,
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * with the fields enclosed by brackets [] replaced by
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * your own identifying information:
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * "Portions Copyrighted [year] [name of copyright owner]"
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * $Id: EventException.java,v 1.3 2008/06/25 05:41:38 qcheng Exp $
8af80418ba1ec431c8027fa9668e5678658d3611Allan Fosterimport com.iplanet.services.ldap.LDAPServiceException;
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Exception occurs while setting an event request or when trigering the
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * "entryChanged()" method after a persistent search results are received from
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * the Directory Server.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Fosterpublic class EventException extends LDAPServiceException {
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Holds the message assocuated with this exception, if present.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Constructs a EventException with no detail message and no nested
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * exception. public EventException() { super(); }
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Constructs a EventException with a detail message.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @param msg
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Message string for the exception
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Constructor with message string and an embedded exception Constructs a
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * EventException with the given detail message and nested exception.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @param msg
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Message string
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * The embedded exception
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster public EventException(String msg, Throwable t) {
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Returns a string representation of this EventException, including the
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * detail message (if present);
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @return a string representation of this EventException, including its
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * detail message, if present.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster return super.toString()
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster + (_message == null ? "" : " [message: " + _message + "]");
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Returns a string representation of the message in the this EventException
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * (if present)
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @return a string representation of the detailed message, if present.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Prints a stack trace for this EventException to System.out;
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Prints a stack trace for this EventException to the given PrintStream;
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @param printStream
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * a PrintStream to print the stack trace out to.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster public void printStackTrace(PrintStream printStream) {
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * Prints a stack trace for this EventException to the given PrintWriter;
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @param printWriter
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * a PrintWriter to print the stack trace out to.
8af80418ba1ec431c8027fa9668e5678658d3611Allan Foster * @supported.api