001: /*
002: * Copyright (c) 2001 - 2005 ivata limited.
003: * All rights reserved.
004: * -----------------------------------------------------------------------------
005: * ivata masks may be redistributed under the GNU General Public
006: * License as published by the Free Software Foundation;
007: * version 2 of the License.
008: *
009: * These programs are free software; you can redistribute them and/or
010: * modify them under the terms of the GNU General Public License
011: * as published by the Free Software Foundation; version 2 of the License.
012: *
013: * These programs are distributed in the hope that they will be useful,
014: * but WITHOUT ANY WARRANTY; without even the implied warranty of
015: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
016: *
017: * See the GNU General Public License in the file LICENSE.txt for more
018: * details.
019: *
020: * If you would like a copy of the GNU General Public License write to
021: *
022: * Free Software Foundation, Inc.
023: * 59 Temple Place - Suite 330
024: * Boston, MA 02111-1307, USA.
025: *
026: *
027: * To arrange commercial support and licensing, contact ivata at
028: * http://www.ivata.com/contact.jsp
029: * -----------------------------------------------------------------------------
030: * $Log: FinderException.java,v $
031: * Revision 1.5 2005/09/14 12:51:52 colinmacleod
032: * Added serialVersionUID.
033: *
034: * Revision 1.4 2005/04/09 18:04:15 colinmacleod
035: * Changed copyright text to GPL v2 explicitly.
036: *
037: * Revision 1.3 2005/03/10 10:23:03 colinmacleod
038: * Added new constructor with cause.
039: *
040: * Revision 1.2 2005/01/06 22:13:22 colinmacleod
041: * Moved up a version number.
042: * Changed copyright notices to 2005.
043: * Updated the documentation:
044: * - started working on multiproject:site docu.
045: * - changed the logo.
046: * Added checkstyle and fixed LOADS of style issues.
047: * Added separate thirdparty subproject.
048: * Added struts (in web), util and webgui (in webtheme) from ivata op.
049: *
050: * Revision 1.1 2004/12/29 20:07:08 colinmacleod
051: * Renamed subproject masks to mask.
052: *
053: * Revision 1.1 2004/11/12 15:10:41 colinmacleod
054: * Moved persistence classes from ivata op as a replacement for
055: * ValueObjectLocator.
056: *
057: * Revision 1.1 2004/07/13 19:42:44 colinmacleod
058: * Moved project to POJOs from EJBs.
059: * Applied PicoContainer to services layer (replacing session EJBs).
060: * Applied Hibernate to persistence layer (replacing entity EJBs).
061: * -----------------------------------------------------------------------------
062: */
063: package com.ivata.mask.persistence;
064:
065: import java.util.Arrays;
066:
067: /**
068: * An instance of this class is thrown when we couldn't find what we were
069: * looking for.
070: *
071: * @author Colin MacLeod
072: * <a href='mailto:colin.macleod@ivata.com'>colin.macleod@ivata.com</a>
073: * @since ivata masks 0.3 (2004-03-29)
074: * @version $Revision: 1.5 $
075: */
076: public class FinderException extends PersistenceException {
077: /**
078: * Serialization version (for <code>Serializable</code> interface).
079: */
080: private static final long serialVersionUID = 1L;
081:
082: /**
083: * Create a new persistence exception with the given message and cause.
084: *
085: * @param dOClass
086: * DO class.
087: * @param key
088: * searched for key of the entity which could not be found.
089: * @param cause cause exception from the persistence layer.
090: */
091: public FinderException(final Class dOClass, final Object key,
092: final Throwable cause) {
093: super ("Could not locate " + dOClass.getName() + " with key "
094: + key, cause);
095: }
096:
097: /**
098: * Create a new persistence exception with the given message and cause.
099: *
100: * @param queryName
101: * name of the persistence query which failed.
102: * @param queryArguments
103: * arguments passed to the query which failed.
104: */
105: public FinderException(final String queryName,
106: final Object[] queryArguments) {
107: super ("Could not locate entity for '" + queryName + "' with "
108: + convertArguments(queryArguments), null);
109: }
110:
111: /**
112: * Helper to convert arguments.
113: *
114: * @param queryArguments
115: * arguments passed to a query which failed.
116: * @return string containing all the arguments.
117: */
118: private static String convertArguments(final Object[] queryArguments) {
119: if (queryArguments == null) {
120: return "no arguments";
121: }
122: return "arguments " + Arrays.asList(queryArguments).toString();
123: }
124: }
|