RESOLVED - SPR-5523: Replace all 'package.html' artifacts with 'package-info.java'

* Applied patch submitted by Carlos Zuniga git-svn-id: https://src.springframework.org/svn/spring-framework/trunk@1281 50f2f4bb-b051-0410-bef5-90022cba6387
2026-09-21 21:39:05 +00:00 · 2009-06-01 04:14:22 +00:00
parent 34633797d5
commit 49b6bbc8fa
499 changed files with 2627 additions and 2420 deletions
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Annotation support for DAOs. Contains a bean post-processor for translating
+ * persistence exceptions based on a repository stereotype annotation.
+ *
+ */
+package org.springframework.dao.annotation;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Annotation support for DAOs. Contains a bean post-processor for translating
-persistence exceptions based on a repository stereotype annotation.
-
-</html>
-</body>
@@ -0,0 +1,20 @@
+
+/**
+ *
+ * Exception hierarchy enabling sophisticated error handling independent
+ * of the data access approach in use. For example, when DAOs and data
+ * access frameworks use the exceptions in this package (and custom
+ * subclasses), calling code can detect and handle common problems such
+ * as deadlocks without being tied to a particular data access strategy,
+ * such as JDBC.
+ * 
+ * <p>All these exceptions are unchecked, meaning that calling code can
+ * leave them uncaught and treat all data access exceptions as fatal.
+ * 
+ * <p>The classes in this package are discussed in Chapter 9 of
+ * <a href="http://www.amazon.com/exec/obidos/tg/detail/-/0764543857/">Expert One-On-One J2EE Design and Development</a>
+ * by Rod Johnson (Wrox, 2002).
+ *
+ */
+package org.springframework.dao;
+
@@ -1,19 +0,0 @@
-<html>
-<body>
-
-Exception hierarchy enabling sophisticated error handling independent
-of the data access approach in use. For example, when DAOs and data
-access frameworks use the exceptions in this package (and custom
-subclasses), calling code can detect and handle common problems such
-as deadlocks without being tied to a particular data access strategy,
-such as JDBC.
-
-<p>All these exceptions are unchecked, meaning that calling code can
-leave them uncaught and treat all data access exceptions as fatal.
-
-<p>The classes in this package are discussed in Chapter 9 of
-<a href="http://www.amazon.com/exec/obidos/tg/detail/-/0764543857/">Expert One-On-One J2EE Design and Development</a>
-by Rod Johnson (Wrox, 2002).
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Support classes for DAO implementations,
+ * providing miscellaneous utility methods.
+ *
+ */
+package org.springframework.dao.support;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Support classes for DAO implementations,
-providing miscellaneous utility methods.
-
-</body>
-</html>
@@ -0,0 +1,10 @@
+
+/**
+ *
+ * Provides a utility class for easy ConnectionFactory access,
+ * a PlatformTransactionManager for local CCI transactions,
+ * and various simple ConnectionFactory proxies/adapters.
+ *
+ */
+package org.springframework.jca.cci.connection;
+
@@ -1,9 +0,0 @@
-<html>
-<body>
-
-Provides a utility class for easy ConnectionFactory access,
-a PlatformTransactionManager for local CCI transactions,
-and various simple ConnectionFactory proxies/adapters.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Provides the core JCA CCI support, based on CciTemplate
+ * and its associated callback interfaces.
+ *
+ */
+package org.springframework.jca.cci.core;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Provides the core JCA CCI support, based on CciTemplate
-and its associated callback interfaces.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Classes supporting the <code>org.springframework.jca.cci.core</code> package.
+ * Contains a DAO base class for CciTemplate usage.
+ *
+ */
+package org.springframework.jca.cci.core.support;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Classes supporting the <code>org.springframework.jca.cci.core</code> package.
-Contains a DAO base class for CciTemplate usage.
-
-</body>
-</html>
@@ -0,0 +1,12 @@
+
+/**
+ *
+ * The classes in this package represent EIS operations as threadsafe,
+ * reusable objects. This higher level of CCI abstraction depends on the
+ * lower-level abstraction in the <code>org.springframework.jca.cci.core</code> package.
+ * Exceptions thrown are as in the <code>org.springframework.dao</code> package,
+ * meaning that code using this package does not need to worry about error handling.
+ *
+ */
+package org.springframework.jca.cci.object;
+
@@ -1,11 +0,0 @@
-<html>
-<body>
-
-The classes in this package represent EIS operations as threadsafe,
-reusable objects. This higher level of CCI abstraction depends on the
-lower-level abstraction in the <code>org.springframework.jca.cci.core</code> package.
-Exceptions thrown are as in the <code>org.springframework.dao</code> package,
-meaning that code using this package does not need to worry about error handling.
-
-</body>
-</html>
@@ -0,0 +1,11 @@
+
+/**
+ *
+ * This package contains Spring's support for the Common Client Interface (CCI),
+ * as defined by the J2EE Connector Architecture. It is conceptually similar
+ * to the <code>org.springframework.jdbc</code> package, providing the same
+ * levels of data access abstraction.
+ *
+ */
+package org.springframework.jca.cci;
+
@@ -1,10 +0,0 @@
-<html>
-<body>
-
-This package contains Spring's support for the Common Client Interface (CCI),
-as defined by the J2EE Connector Architecture. It is conceptually similar
-to the <code>org.springframework.jdbc</code> package, providing the same
-levels of data access abstraction.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Integration package that allows for deploying a Spring application context
+ * as a JCA 1.5 compliant RAR file.
+ *
+ */
+package org.springframework.jca.context;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Integration package that allows for deploying a Spring application context
-as a JCA 1.5 compliant RAR file.
-
-</body>
-</html>
@@ -0,0 +1,8 @@
+
+/**
+ *
+ * This package provides a facility for generic JCA message endpoint management.
+ *
+ */
+package org.springframework.jca.endpoint;
+
@@ -1,7 +0,0 @@
-<html>
-<body>
-
-This package provides a facility for generic JCA message endpoint management.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Provides generic support classes for JCA usage within Spring,
+ * mainly for local setup of a JCA ResourceAdapter and/or ConnectionFactory.
+ *
+ */
+package org.springframework.jca.support;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Provides generic support classes for JCA usage within Spring,
-mainly for local setup of a JCA ResourceAdapter and/or ConnectionFactory.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Convenience package for obtaining a GlassFish JCA WorkManager for use in
+ * web applications. Provides a Spring TaskExecutor adapter for GlassFish.
+ *
+ */
+package org.springframework.jca.work.glassfish;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Convenience package for obtaining a GlassFish JCA WorkManager for use in
-web applications. Provides a Spring TaskExecutor adapter for GlassFish.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Convenience package for obtaining a JBoss JCA WorkManager for use in
+ * web applications. Provides a Spring TaskExecutor adapter for JBoss.
+ *
+ */
+package org.springframework.jca.work.jboss;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Convenience package for obtaining a JBoss JCA WorkManager for use in
-web applications. Provides a Spring TaskExecutor adapter for JBoss.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Convenience classes for scheduling based on the JCA 1.5 WorkManager facility,
+ * as supported within JCA 1.5 ResourceAdapters.
+ *
+ */
+package org.springframework.jca.work;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Convenience classes for scheduling based on the JCA 1.5 WorkManager facility,
-as supported within JCA 1.5 ResourceAdapters.
-
-</body>
-</html>
@@ -0,0 +1,10 @@
+
+/**
+ *
+ * JDK 1.5+ annotation for transaction demarcation.
+ * Hooked into Spring's transaction interception infrastructure
+ * via a special TransactionAttributeSource implementation.
+ *
+ */
+package org.springframework.transaction.annotation;
+
@@ -1,9 +0,0 @@
-<html>
-<body>
-
-JDK 1.5+ annotation for transaction demarcation.
-Hooked into Spring's transaction interception infrastructure
-via a special TransactionAttributeSource implementation.
-
-</body>
-</html>
@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Support package for declarative transaction configuration,
+ * with XML schema being the primary configuration format.
+ *
+ */
+package org.springframework.transaction.config;
+
@@ -1,8 +0,0 @@
-<html>
-<body>
-
-Support package for declarative transaction configuration,
-with XML schema being the primary configuration format.
-
-</body>
-</html>
@@ -0,0 +1,18 @@
+
+/**
+ *
+ * AOP-based solution for declarative transaction demarcation.
+ * Builds on the AOP infrastructure in org.springframework.aop.framework.
+ * Any POJO can be transactionally advised with Spring.
+ * 
+ * <p>The TransactionFactoryProxyBean can be used to create transactional
+ * AOP proxies transparently to code that uses them.
+ * 
+ * <p>The TransactionInterceptor is the AOP Alliance MethodInterceptor that
+ * delivers transactional advice, based on the Spring transaction abstraction.
+ * This allows declarative transaction management in any environment,
+ * even without JTA if an application uses only a single database.
+ *
+ */
+package org.springframework.transaction.interceptor;
+
@@ -1,17 +0,0 @@
-<html>
-<body>
-
-AOP-based solution for declarative transaction demarcation.
-Builds on the AOP infrastructure in org.springframework.aop.framework.
-Any POJO can be transactionally advised with Spring.
-
-<p>The TransactionFactoryProxyBean can be used to create transactional
-AOP proxies transparently to code that uses them.
-
-<p>The TransactionInterceptor is the AOP Alliance MethodInterceptor that
-delivers transactional advice, based on the Spring transaction abstraction.
-This allows declarative transaction management in any environment,
-even without JTA if an application uses only a single database.
-
-</body>
-</html>
@@ -0,0 +1,8 @@
+
+/**
+ *
+ * Transaction SPI implementation for JTA.
+ *
+ */
+package org.springframework.transaction.jta;
+
@@ -1,7 +0,0 @@
-<html>
-<body>
-
-Transaction SPI implementation for JTA.
-
-</body>
-</html>
@@ -0,0 +1,10 @@
+
+/**
+ *
+ * Exception hierarchy for Spring's transaction infrastructure,
+ * independent of any specific transaction management system.
+ * Contains transaction manager, definition, and status interfaces.
+ *
+ */
+package org.springframework.transaction;
+
@@ -1,9 +0,0 @@
-<html>
-<body>
-
-Exception hierarchy for Spring's transaction infrastructure,
-independent of any specific transaction management system.
-Contains transaction manager, definition, and status interfaces.
-
-</body>
-</html>
@@ -0,0 +1,10 @@
+
+/**
+ *
+ * Support classes for the org.springframework.transaction package.
+ * Provides an abstract base class for transaction manager implementations,
+ * and a template plus callback for transaction demarcation.
+ *
+ */
+package org.springframework.transaction.support;
+
@@ -1,9 +0,0 @@
-<html>
-<body>
-
-Support classes for the org.springframework.transaction package.
-Provides an abstract base class for transaction manager implementations,
-and a template plus callback for transaction demarcation.
-
-</body>
-</html>