001    /**
002     * Copyright (c) 2010, SIB. All rights reserved.
003     * 
004     * SIB (Swiss Institute of Bioinformatics) - http://www.isb-sib.ch Host -
005     * https://sourceforge.net/projects/javaprotlib/
006     * 
007     * Redistribution and use in source and binary forms, with or without
008     * modification, are permitted provided that the following conditions are met:
009     * Redistributions of source code must retain the above copyright notice, this
010     * list of conditions and the following disclaimer. Redistributions in binary
011     * form must reproduce the above copyright notice, this list of conditions and
012     * the following disclaimer in the documentation and/or other materials provided
013     * with the distribution. Neither the name of the SIB/GENEBIO nor the names of
014     * its contributors may be used to endorse or promote products derived from this
015     * software without specific prior written permission.
016     * 
017     * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
018     * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
019     * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
020     * ARE DISCLAIMED. IN NO EVENT SHALL SIB/GENEBIO BE LIABLE FOR ANY DIRECT,
021     * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
022     * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
023     * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
024     * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
025     * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
026     * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
027     */
028    package org.expasy.jpl.commons.base.builder;
029    
030    
031    /**
032     * This exception is thrown by a {@code Builder} when an object cannot been
033     * correctly built.
034     * 
035     * @author nikitin
036     * 
037     * @version 1.0
038     * 
039     */
040    public final class BuilderException extends RuntimeException {
041            
042            private static final long serialVersionUID = 1L;
043            
044            /**
045             * Empty constructor.
046             */
047            public BuilderException() {}
048            
049            /**
050             * Constructs a new {@code BuilderException} object.
051             * 
052             * @param message gives a more precise reason about occurring exception.
053             */
054            public BuilderException(final String message) {
055                    super(message);
056            }
057            
058            /**
059             * @param cause the cause throwing this exception.
060             */
061            public BuilderException(final Throwable cause) {
062                    super(cause);
063            }
064            
065            /**
066             * @param message gives a more precise reason about occurring exception.
067             * @param cause the cause throwing this exception.
068             */
069            public BuilderException(final String message, final Throwable cause) {
070                    super(message, cause);
071            }
072            
073            public String toString() {
074                    if (getCause() != null) {
075                            return "builder exception: " + getCause();
076                    }
077                    return "builder exception: " + getMessage();
078            }
079    }