001: /*
002: * Copyright (c) 2001 - 2004 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: CatalogSession.java,v $
031: * Revision 1.9 2005/10/11 18:52:03 colinmacleod
032: * Fixed some checkstyle and javadoc issues.
033: *
034: * Revision 1.8 2005/10/03 10:17:24 colinmacleod
035: * Fixed some style and javadoc issues.
036: *
037: * Revision 1.7 2005/09/14 12:41:33 colinmacleod
038: * Added serialVersionUID.
039: *
040: * Revision 1.6 2005/04/09 18:04:13 colinmacleod
041: * Changed copyright text to GPL v2 explicitly.
042: *
043: * Revision 1.5 2005/03/10 10:17:13 colinmacleod
044: * Added cancel method.
045: *
046: * Revision 1.4 2005/01/19 12:15:55 colinmacleod
047: * Added new methods for system-specific session.
048: * (Required by ivata groupware 0.10.)
049: *
050: * Revision 1.3 2005/01/07 09:13:02 colinmacleod
051: * Added newline to end of file.
052: *
053: * Revision 1.2 2005/01/07 08:08:17 colinmacleod
054: * Moved up a version number.
055: * Changed copyright notices to 2005.
056: * Updated the documentation:
057: * - started working on multiproject:site docu.
058: * - changed the logo.
059: * Added checkstyle and fixed LOADS of style issues.
060: * Added separate thirdparty subproject.
061: * Added struts (in web), util and webgui (in webtheme) from ivata op.
062: *
063: * Revision 1.1 2004/11/12 15:10:40 colinmacleod
064: * Moved persistence classes from ivata op as a replacement for
065: ValueObjectLocator.
066: * -----------------------------------------------------------------------------
067: */
068: package com.ivata.mask.web.demo.catalog;
069:
070: import java.sql.Connection;
071: import com.ivata.mask.persistence.PersistenceException;
072: import com.ivata.mask.persistence.PersistenceSession;
073:
074: /**
075: * Normally, a persistence session is analagous to a database transaction,
076: * grouping together like persistence actions unless they fail. This is just
077: * a dummy for the demo, however, and has no real functionality :-)
078: *
079: * @since ivata masks 0.3 (2004-11-12)
080: * @author Colin MacLeod
081: * <a href='mailto:colin.macleod@ivata.com'>colin.macleod@ivata.com</a>
082: * @version $Revision: 1.9 $
083: */
084: public final class CatalogSession implements PersistenceSession {
085: /**
086: * Serialization version (for <code>Serializable</code> interface).
087: */
088: private static final long serialVersionUID = 1L;
089:
090: /**
091: * This method doesn't really do anything. :-)
092: *
093: * @see com.ivata.mask.persistence.PersistenceSession#cancel()
094: */
095: public void cancel() {
096: }
097:
098: /**
099: * <p>
100: * Implements persistence session method. Does nothing for this demo
101: * implementation.
102: * </p>
103: *
104: * @see com.ivata.mask.persistence.PersistenceSession#close()
105: */
106: public void close() throws PersistenceException {
107: }
108:
109: /**
110: * <p>
111: * Implements persistence session method. Does nothing for this demo
112: * implementation.
113: * </p>
114: *
115: * @see com.ivata.mask.persistence.PersistenceSession#getConnection()
116: * @return nothing is ever returned as the exception is always thrown,
117: * @throws PersistenceException always thrown since this method is
118: * unsupported in this demo.
119: */
120: public Connection getConnection() throws PersistenceException {
121: throw new PersistenceException(
122: "CatalogSession.getConnection unsupported in demo program");
123: }
124:
125: /**
126: * {@inheritDoc}
127: *
128: * @return Always returns <code>null</code>, as this simple demo has no
129: * system security session implementation.
130: */
131: public Object getSystemSession() {
132: return null;
133: }
134:
135: }
|