Update of /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate In directory sc8-pr-cvs1:/tmp/cvs-serv29107/hibernate Modified Files: AssertionFailure.java CallbackException.java CompositeUserType.java Criteria.java Databinder.java FlushMode.java Hibernate.java HibernateException.java InstantiationException.java Interceptor.java JDBCException.java LazyInitializationException.java Lifecycle.java LockMode.java MappingException.java ObjectDeletedException.java ObjectNotFoundException.java PersistentEnum.java PersistentObjectException.java PropertyAccessException.java PropertyNotFoundException.java Query.java ScrollableResults.java Session.java SessionFactory.java StaleObjectStateException.java Transaction.java TransactionException.java TransientObjectException.java UserType.java Validatable.java ValidationFailure.java WrongClassException.java Log Message: JavaDoc refresh, including @author tags Index: AssertionFailure.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/AssertionFailure.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** AssertionFailure.java 5 Jan 2003 02:11:19 -0000 1.3 --- AssertionFailure.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 8,11 **** --- 8,12 ---- /** * Indicates failure of an assertion: a possible bug in Hibernate + * @author Gavin King */ Index: CallbackException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/CallbackException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** CallbackException.java 5 Jan 2003 02:11:19 -0000 1.3 --- CallbackException.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 5,9 **** --- 5,11 ---- * Should be thrown by persistent objects from <tt>Lifecycle</tt> * callbacks. + * * @see Lifecycle + * @author Gavin King */ Index: CompositeUserType.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/CompositeUserType.java,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** CompositeUserType.java 8 Apr 2003 09:49:25 -0000 1.2 --- CompositeUserType.java 25 Apr 2003 03:40:29 -0000 1.3 *************** *** 30,33 **** --- 30,34 ---- * @see UserType for more simple cases * @see net.sf.hibernate.type.Type + * @author Gavin King */ public interface CompositeUserType { Index: Criteria.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Criteria.java,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** Criteria.java 9 Mar 2003 04:04:04 -0000 1.2 --- Criteria.java 25 Apr 2003 03:40:29 -0000 1.3 *************** *** 33,36 **** --- 33,37 ---- * @see Session#createCriteria(java.lang.Class) * @see net.sf.hibernate.expression.Expression + * @author Gavin King */ public interface Criteria { Index: Databinder.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Databinder.java,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** Databinder.java 26 Jan 2003 01:33:34 -0000 1.4 --- Databinder.java 25 Apr 2003 03:40:29 -0000 1.5 *************** *** 23,27 **** --- 23,29 ---- * <br> * It is not intended that implementors be threadsafe. + * * @see SessionFactory + * @author Gavin King, Brad Clow */ public interface Databinder { *************** *** 81,86 **** * explicitly initialized or left as they are. * ! * @param initializeLazy true to explicitly initialize lazy objects, false to leave them in ! * the state they are in. */ public void setInitializeLazy(boolean initializeLazy); --- 83,88 ---- * explicitly initialized or left as they are. * ! * @param initializeLazy true to explicitly initialize lazy objects, ! * false to leave them in the state they are in. */ public void setInitializeLazy(boolean initializeLazy); Index: FlushMode.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/FlushMode.java,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** FlushMode.java 9 Feb 2003 06:28:14 -0000 1.4 --- FlushMode.java 25 Apr 2003 03:40:29 -0000 1.5 *************** *** 12,15 **** --- 12,16 ---- * * @see Session#setFlushMode(FlushMode) + * @author Gavin King */ public final class FlushMode implements Serializable { Index: Hibernate.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Hibernate.java,v retrieving revision 1.12 retrieving revision 1.13 diff -C2 -d -r1.12 -r1.13 *** Hibernate.java 19 Apr 2003 03:26:06 -0000 1.12 --- Hibernate.java 25 Apr 2003 03:40:29 -0000 1.13 *************** *** 48,57 **** /** ! * Provides access to the full range of Hibernate built-in types. <tt>Type</tt> * instances may be used to bind values to query parameters. ! * Also a factory for new <tt>Blob</tt>s and <tt>Clob</tt>s. * @see java.sql.Clob * @see java.sql.Blob * @see net.sf.hibernate.type.Type */ --- 48,62 ---- /** ! * <ul> ! * <li>Provides access to the full range of Hibernate built-in types. <tt>Type</tt> * instances may be used to bind values to query parameters. ! * <li>A factory for new <tt>Blob</tt>s and <tt>Clob</tt>s. ! * <li>Defines static methods for manipulation of proxies. ! * </ul> ! * * @see java.sql.Clob * @see java.sql.Blob * @see net.sf.hibernate.type.Type + * @author Gavin King */ Index: HibernateException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/HibernateException.java,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** HibernateException.java 29 Mar 2003 23:44:49 -0000 1.4 --- HibernateException.java 25 Apr 2003 03:40:29 -0000 1.5 *************** *** 10,13 **** --- 10,14 ---- * * @see JDBCException + * @author Gavin King */ Index: InstantiationException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/InstantiationException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** InstantiationException.java 5 Jan 2003 02:11:19 -0000 1.3 --- InstantiationException.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 5,8 **** --- 5,10 ---- * Thrown if Hibernate can't instantiate an entity or component * class at runtime. + * + * @author Gavin King */ Index: Interceptor.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Interceptor.java,v retrieving revision 1.8 retrieving revision 1.9 diff -C2 -d -r1.8 -r1.9 *** Interceptor.java 29 Mar 2003 04:08:46 -0000 1.8 --- Interceptor.java 25 Apr 2003 03:40:29 -0000 1.9 *************** *** 21,24 **** --- 21,25 ---- * @see SessionFactory#openSession(Interceptor) * @see net.sf.hibernate.cfg.Configuration#setInterceptor(Interceptor) + * @author Gavin King */ public interface Interceptor { Index: JDBCException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/JDBCException.java,v retrieving revision 1.2 retrieving revision 1.3 diff -C2 -d -r1.2 -r1.3 *** JDBCException.java 1 Feb 2003 00:33:38 -0000 1.2 --- JDBCException.java 25 Apr 2003 03:40:29 -0000 1.3 *************** *** 13,16 **** --- 13,17 ---- * * @see java.sql.SQLException + * @author Gavin King */ public class JDBCException extends HibernateException { Index: LazyInitializationException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/LazyInitializationException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** LazyInitializationException.java 5 Jan 2003 02:11:19 -0000 1.3 --- LazyInitializationException.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 9,12 **** --- 9,16 ---- * proxy (for example the session was closed) or iterate query * results. + * + * @see Hibernate#initialize(java.lang.Object) + * @see Hibernate#isInitialized(java.lang.Object) + * @author Gavin King */ Index: Lifecycle.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Lifecycle.java,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** Lifecycle.java 9 Mar 2003 04:04:05 -0000 1.4 --- Lifecycle.java 25 Apr 2003 03:40:29 -0000 1.5 *************** *** 35,39 **** --- 35,41 ---- * Note that <tt>onSave()</tt> is called after an identifier is assigned * to the object, except when identity column key generation is used. + * * @see CallbackException + * @author Gavin King */ public interface Lifecycle { Index: LockMode.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/LockMode.java,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** LockMode.java 9 Feb 2003 06:28:14 -0000 1.4 --- LockMode.java 25 Apr 2003 03:40:29 -0000 1.5 *************** *** 15,18 **** --- 15,19 ---- * * @see Session#lock(Object,LockMode) + * @author Gavin King */ public final class LockMode implements Serializable { Index: MappingException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/MappingException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** MappingException.java 5 Jan 2003 02:11:19 -0000 1.3 --- MappingException.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 5,8 **** --- 5,10 ---- * An exception that usually occurs at configuration time, rather * than runtime, as a result of something screwy in the O-R mappings. + * + * @author Gavin King */ Index: ObjectDeletedException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/ObjectDeletedException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** ObjectDeletedException.java 5 Jan 2003 02:11:19 -0000 1.3 --- ObjectDeletedException.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 6,9 **** --- 6,11 ---- /** * Thrown when the user tries to pass a deleted object to the <tt>Session</tt>. + * + * @author Gavin King */ Index: ObjectNotFoundException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/ObjectNotFoundException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** ObjectNotFoundException.java 5 Jan 2003 02:11:19 -0000 1.3 --- ObjectNotFoundException.java 25 Apr 2003 03:40:29 -0000 1.4 *************** *** 7,10 **** --- 7,12 ---- * Thrown when <tt>Session.load()</tt> fails to select a row with * the given primary key (identifier value). + * + * @author Gavin King */ public class ObjectNotFoundException extends HibernateException { Index: PersistentEnum.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/PersistentEnum.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** PersistentEnum.java 5 Jan 2003 02:11:19 -0000 1.3 --- PersistentEnum.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 10,13 **** --- 10,14 ---- * <tt>public static PersistentEnum fromInt(int i)</tt> * + * @author Gavin King */ Index: PersistentObjectException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/PersistentObjectException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** PersistentObjectException.java 5 Jan 2003 02:11:19 -0000 1.3 --- PersistentObjectException.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 5,8 **** --- 5,10 ---- * Throw when the user passes a persistent instance to a <tt>Session</tt> * method that expects a transient instance. + * + * @author Gavin King */ Index: PropertyAccessException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/PropertyAccessException.java,v retrieving revision 1.5 retrieving revision 1.6 diff -C2 -d -r1.5 -r1.6 *** PropertyAccessException.java 15 Feb 2003 08:00:49 -0000 1.5 --- PropertyAccessException.java 25 Apr 2003 03:40:30 -0000 1.6 *************** *** 6,10 **** /** * A problem occurred accessing a property of an instance of a ! * persistent class by reflection. */ --- 6,18 ---- /** * A problem occurred accessing a property of an instance of a ! * persistent class by reflection, or via CGLIB. There are a ! * number of possible underlying causes, including ! * <ul> ! * <li>failure of a security check ! * <li>an exception occurring inside the getter or setter method ! * <li>a nullable database column was mapped to a primitive-type property ! * <li>the Hibernate type was not castable to the property type (or vice-versa) ! * </ul> ! * @author Gavin King */ Index: PropertyNotFoundException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/PropertyNotFoundException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** PropertyNotFoundException.java 5 Jan 2003 02:11:19 -0000 1.3 --- PropertyNotFoundException.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 5,8 **** --- 5,10 ---- * Indicates that an expected getter or setter method could not be * found on a class. + * + * @author Gavin King */ public class PropertyNotFoundException extends MappingException { Index: Query.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Query.java,v retrieving revision 1.11 retrieving revision 1.12 diff -C2 -d -r1.11 -r1.12 *** Query.java 13 Mar 2003 03:15:59 -0000 1.11 --- Query.java 25 Apr 2003 03:40:30 -0000 1.12 *************** *** 53,56 **** --- 53,57 ---- * @see Session#createQuery(java.lang.String) * @see ScrollableResults + * @author Gavin King */ public interface Query { Index: ScrollableResults.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/ScrollableResults.java,v retrieving revision 1.5 retrieving revision 1.6 diff -C2 -d -r1.5 -r1.6 *** ScrollableResults.java 14 Jan 2003 13:42:06 -0000 1.5 --- ScrollableResults.java 25 Apr 2003 03:40:30 -0000 1.6 *************** *** 22,25 **** --- 22,26 ---- * * @see Query#scroll() + * @author Gavin King */ public interface ScrollableResults { Index: Session.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Session.java,v retrieving revision 1.16 retrieving revision 1.17 diff -C2 -d -r1.16 -r1.17 *** Session.java 21 Apr 2003 06:28:17 -0000 1.16 --- Session.java 25 Apr 2003 03:40:30 -0000 1.17 *************** *** 62,65 **** --- 62,66 ---- * * @see SessionFactory + * @author Gavin King */ public interface Session extends Serializable { Index: SessionFactory.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/SessionFactory.java,v retrieving revision 1.8 retrieving revision 1.9 diff -C2 -d -r1.8 -r1.9 *** SessionFactory.java 10 Apr 2003 09:49:15 -0000 1.8 --- SessionFactory.java 25 Apr 2003 03:40:30 -0000 1.9 *************** *** 26,29 **** --- 26,30 ---- * @see net.sf.hibernate.connection.ConnectionProvider * @see net.sf.hibernate.transaction.TransactionFactory + * @author Gavin King */ public interface SessionFactory extends Referenceable, Serializable { Index: StaleObjectStateException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/StaleObjectStateException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** StaleObjectStateException.java 5 Jan 2003 02:11:19 -0000 1.3 --- StaleObjectStateException.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 7,15 **** /** ! * Thrown when a version number check failed, indicating that the * <tt>Session</tt> contained stale data (when using long transactions ! * with versioning). */ - public class StaleObjectStateException extends HibernateException { private final Class persistentClass; --- 7,17 ---- /** ! * Thrown when a version number or timestamp check failed, indicating that the * <tt>Session</tt> contained stale data (when using long transactions ! * with versioning). Also occurs if we try delete or update a row that does ! * not exist. ! * ! * @author Gavin King */ public class StaleObjectStateException extends HibernateException { private final Class persistentClass; Index: Transaction.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Transaction.java,v retrieving revision 1.5 retrieving revision 1.6 diff -C2 -d -r1.5 -r1.6 *** Transaction.java 14 Jan 2003 13:42:07 -0000 1.5 --- Transaction.java 25 Apr 2003 03:40:30 -0000 1.6 *************** *** 20,23 **** --- 20,24 ---- * @see Session#beginTransaction() * @see net.sf.hibernate.transaction.TransactionFactory + * @author Anton van Straaten */ Index: TransactionException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/TransactionException.java,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** TransactionException.java 9 Jan 2003 12:24:50 -0000 1.4 --- TransactionException.java 25 Apr 2003 03:40:30 -0000 1.5 *************** *** 3,9 **** /** ! * Indicated that a transaction could not be begun, committed * or rolled back. * @see Transaction */ --- 3,11 ---- /** ! * Indicates that a transaction could not be begun, committed * or rolled back. + * * @see Transaction + * @author Anton van Straaten */ Index: TransientObjectException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/TransientObjectException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** TransientObjectException.java 5 Jan 2003 02:11:20 -0000 1.3 --- TransientObjectException.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 5,8 **** --- 5,10 ---- * Throw when the user passes a transient instance to a <tt>Session</tt> * method that expects a persistent instance. + * + * @author Gavin King */ Index: UserType.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/UserType.java,v retrieving revision 1.7 retrieving revision 1.8 diff -C2 -d -r1.7 -r1.8 *** UserType.java 6 Apr 2003 10:11:07 -0000 1.7 --- UserType.java 25 Apr 2003 03:40:30 -0000 1.8 *************** *** 38,41 **** --- 38,42 ---- * @see CompositeUserType for more complex cases * @see net.sf.hibernate.type.Type + * @author Gavin King */ public interface UserType { Index: Validatable.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/Validatable.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** Validatable.java 5 Jan 2003 02:11:20 -0000 1.3 --- Validatable.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 5,8 **** --- 5,10 ---- * Implemented by persistent classes with invariants that must * be checked before inserting into or updating the database. + * + * @author Gavin King */ public interface Validatable { Index: ValidationFailure.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/ValidationFailure.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** ValidationFailure.java 5 Jan 2003 02:11:20 -0000 1.3 --- ValidationFailure.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 6,9 **** --- 6,11 ---- * was violated. Some applications might subclass this exception * in order to provide more information about the violation. + * + * @author Gavin King */ public class ValidationFailure extends HibernateException { Index: WrongClassException.java =================================================================== RCS file: /cvsroot/hibernate/Hibernate2/src/net/sf/hibernate/WrongClassException.java,v retrieving revision 1.3 retrieving revision 1.4 diff -C2 -d -r1.3 -r1.4 *** WrongClassException.java 5 Jan 2003 02:11:20 -0000 1.3 --- WrongClassException.java 25 Apr 2003 03:40:30 -0000 1.4 *************** *** 9,12 **** --- 9,14 ---- * discriminator value specifies a different subclass from * the one requested. + * + * @author Gavin King */ public class WrongClassException extends HibernateException { |