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

* Applied patch submitted by Carlos Zuniga
This commit is contained in:
Chris Beams
2009-06-01 04:14:22 +00:00
parent f3e6242568
commit a9696c7282
499 changed files with 2627 additions and 2420 deletions

View File

@@ -0,0 +1,9 @@
/**
*
* Annotations for binding requests to controllers and handler methods
* as well as for binding request parameters to method arguments.
*
*/
package org.springframework.web.bind.annotation;

View File

@@ -1,8 +0,0 @@
<html>
<body>
Annotations for binding requests to controllers and handler methods
as well as for binding request parameters to method arguments.
</body>
</html>

View File

@@ -0,0 +1,8 @@
/**
*
* Support classes for web annotation processing.
*
*/
package org.springframework.web.bind.annotation.support;

View File

@@ -1,7 +0,0 @@
<html>
<body>
Support classes for web annotation processing.
</body>
</html>

View File

@@ -0,0 +1,8 @@
/**
*
* Provides web-specific data binding functionality.
*
*/
package org.springframework.web.bind;

View File

@@ -1,7 +0,0 @@
<html>
<body>
Provides web-specific data binding functionality.
</body>
</html>

View File

@@ -0,0 +1,8 @@
/**
*
* Support classes for web data binding.
*
*/
package org.springframework.web.bind.support;

View File

@@ -1,7 +0,0 @@
<html>
<body>
Support classes for web data binding.
</body>
</html>

View File

@@ -0,0 +1,9 @@
/**
*
* MultipartResolver implementation for
* <a href="http://jakarta.apache.org/commons/fileupload">Jakarta Commons FileUpload</a>.
*
*/
package org.springframework.web.multipart.commons;

View File

@@ -1,8 +0,0 @@
<html>
<body>
MultipartResolver implementation for
<a href="http://jakarta.apache.org/commons/fileupload">Jakarta Commons FileUpload</a>.
</body>
</html>

View File

@@ -0,0 +1,11 @@
/**
*
* Multipart resolution framework for handling file uploads.
* Provides a MultipartResolver strategy interface,
* and a generic extension of the HttpServletRequest interface
* for accessing multipart files in web application code.
*
*/
package org.springframework.web.multipart;

View File

@@ -1,10 +0,0 @@
<html>
<body>
Multipart resolution framework for handling file uploads.
Provides a MultipartResolver strategy interface,
and a generic extension of the HttpServletRequest interface
for accessing multipart files in web application code.
</body>
</html>

View File

@@ -0,0 +1,10 @@
/**
*
* Support classes for the multipart resolution framework.
* Contains property editors for multipart files, and a
* servlet filter for multipart handling without Spring's web MVC.
*
*/
package org.springframework.web.multipart.support;

View File

@@ -1,9 +0,0 @@
<html>
<body>
Support classes for the multipart resolution framework.
Contains property editors for multipart files, and a
servlet filter for multipart handling without Spring's web MVC.
</body>
</html>

View File

@@ -0,0 +1,9 @@
/**
*
* Provides standard HandlerMapping implementations,
* including abstract base classes for custom implementations.
*
*/
package org.springframework.web.servlet.handler;

View File

@@ -1,8 +0,0 @@
<html>
<body>
Provides standard HandlerMapping implementations,
including abstract base classes for custom implementations.
</body>
</html>

View File

@@ -0,0 +1,10 @@
/**
*
* Locale support classes for Spring's web MVC framework.
* Provides standard LocaleResolver implementations,
* and a HandlerInterceptor for locale changes.
*
*/
package org.springframework.web.servlet.i18n;

View File

@@ -1,9 +0,0 @@
<html>
<body>
Locale support classes for Spring's web MVC framework.
Provides standard LocaleResolver implementations,
and a HandlerInterceptor for locale changes.
</body>
</html>

View File

@@ -0,0 +1,8 @@
/**
*
* Support package for annotation-based Servlet MVC controllers.
*
*/
package org.springframework.web.servlet.mvc.annotation;

View File

@@ -1,7 +0,0 @@
<html>
<body>
Support package for annotation-based Servlet MVC controllers.
</body>
</html>

View File

@@ -0,0 +1,24 @@
/**
*
* Package allowing MVC Controller implementations to handle requests
* at <i>method</i> rather than <i>class</i> level. This is useful when
* we want to avoid having many trivial controller classes, as can
* easily happen when using an MVC framework.
*
* <p>Typically a controller that handles multiple request types will
* extend MultiActionController, and implement multiple request handling
* methods that will be invoked by reflection if they follow this class'
* naming convention. Classes are analyzed at startup and methods cached,
* so the performance overhead of reflection in this approach is negligible.
*
* <p>This approach is analogous to the Struts 1.1 <b>DispatcherAction</b>
* class, but more sophisticated, as it supports configurable mapping from
* requests to URLs and allows for delegation as well as subclassing.
*
* <p>This package is discussed in Chapter 12 of <a href="http://www.amazon.com/exec/obidos/tg/detail/-/0764543857/">Expert One-On-One J2EE Design and Development</a>
* by Rod Johnson, and used in the sample application.
*
*/
package org.springframework.web.servlet.mvc.multiaction;

View File

@@ -1,23 +0,0 @@
<html>
<body>
Package allowing MVC Controller implementations to handle requests
at <i>method</i> rather than <i>class</i> level. This is useful when
we want to avoid having many trivial controller classes, as can
easily happen when using an MVC framework.
<p>Typically a controller that handles multiple request types will
extend MultiActionController, and implement multiple request handling
methods that will be invoked by reflection if they follow this class'
naming convention. Classes are analyzed at startup and methods cached,
so the performance overhead of reflection in this approach is negligible.
<p>This approach is analogous to the Struts 1.1 <b>DispatcherAction</b>
class, but more sophisticated, as it supports configurable mapping from
requests to URLs and allows for delegation as well as subclassing.
<p>This package is discussed in Chapter 12 of <a href="http://www.amazon.com/exec/obidos/tg/detail/-/0764543857/">Expert One-On-One J2EE Design and Development</a>
by Rod Johnson, and used in the sample application.
</body>
</html>

View File

@@ -0,0 +1,45 @@
/**
*
* <p>
* Standard controller implementations for the servlet MVC framework that comes
* with Spring. Provides both abstract base classes and concrete implementations
* for often seen use cases.
* </p>
*
* <p>
* A <code>Controller</code> - as defined in this package - is analogous to a Struts
* <code>Action</code>. Usually <code>Controllers</code> are JavaBeans
* to allow easy configuration using the {@link org.springframework.beans org.springframework.beans}
* package. Controllers define the <code>C</code> from so-called MVC paradigm
* and can be used in conjunction with the {@link org.springframework.web.servlet.ModelAndView ModelAndView}
* to achieve interactive applications. The view might be represented by a
* HTML interface, but, because of model and the controller being completely
* independent of the view, PDF views are possible, as well as for instance Excel
* views.
* </p>
*
* <p>
* How to actually set up a (web)application using the MVC framework Spring
* provides is explained in more detail in the
* <a href="../../../../../../MVC-step-by-step/Spring-MVC-step-by-step.html">MVC-Step-by-Step
* tutorial</a>, also provided in this package (or have a look
* <a href="http://www.springframework.org">here</a> for an online version).
* The classes contained by this package explain in more detail the actual
* workflow of some of the abstract and concrete controller and how to extend
* and fully use their functionality.
* </p>
*
* <p>
* Especially useful to read, while getting into the Spring MVC framework
* are the following:
* <ul>
* <li><a href="Controller.html">Controller</a></li>
* <li><a href="SimpleFormController.html">BaseCommandController</a></li>
* <li><a href="ParameterizableViewController.html">ParameterizableViewController</a></li>
* </ul>
* </p>
*
*/
package org.springframework.web.servlet.mvc;

View File

@@ -1,44 +0,0 @@
<html>
<body>
<p>
Standard controller implementations for the servlet MVC framework that comes
with Spring. Provides both abstract base classes and concrete implementations
for often seen use cases.
</p>
<p>
A <code>Controller</code> - as defined in this package - is analogous to a Struts
<code>Action</code>. Usually <code>Controllers</code> are JavaBeans
to allow easy configuration using the {@link org.springframework.beans org.springframework.beans}
package. Controllers define the <code>C</code> from so-called MVC paradigm
and can be used in conjunction with the {@link org.springframework.web.servlet.ModelAndView ModelAndView}
to achieve interactive applications. The view might be represented by a
HTML interface, but, because of model and the controller being completely
independent of the view, PDF views are possible, as well as for instance Excel
views.
</p>
<p>
How to actually set up a (web)application using the MVC framework Spring
provides is explained in more detail in the
<a href="../../../../../../MVC-step-by-step/Spring-MVC-step-by-step.html">MVC-Step-by-Step
tutorial</a>, also provided in this package (or have a look
<a href="http://www.springframework.org">here</a> for an online version).
The classes contained by this package explain in more detail the actual
workflow of some of the abstract and concrete controller and how to extend
and fully use their functionality.
</p>
<p>
Especially useful to read, while getting into the Spring MVC framework
are the following:
<ul>
<li><a href="Controller.html">Controller</a></li>
<li><a href="SimpleFormController.html">BaseCommandController</a></li>
<li><a href="ParameterizableViewController.html">ParameterizableViewController</a></li>
</ul>
</p>
</body>
</html>

View File

@@ -0,0 +1,9 @@
/**
*
* Support package for MVC controllers.
* Contains a special HandlerMapping for controller conventions.
*
*/
package org.springframework.web.servlet.mvc.support;

View File

@@ -1,8 +0,0 @@
<html>
<body>
Support package for MVC controllers.
Contains a special HandlerMapping for controller conventions.
</body>
</html>

View File

@@ -0,0 +1,14 @@
/**
*
* Provides servlets that integrate with the application context
* infrastructure, and the core interfaces and classes for the
* Spring web MVC framework.
*
* <p>This package and related packages are discussed in Chapters 12 and 13 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.web.servlet;

View File

@@ -1,13 +0,0 @@
<html>
<body>
Provides servlets that integrate with the application context
infrastructure, and the core interfaces and classes for the
Spring web MVC framework.
<p>This package and related packages are discussed in Chapters 12 and 13 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>

View File

@@ -0,0 +1,10 @@
/**
*
* Support classes for Spring's web MVC framework.
* Provides easy evaluation of the request context in views,
* and miscellaneous HandlerInterceptor implementations.
*
*/
package org.springframework.web.servlet.support;

View File

@@ -1,9 +0,0 @@
<html>
<body>
Support classes for Spring's web MVC framework.
Provides easy evaluation of the request context in views,
and miscellaneous HandlerInterceptor implementations.
</body>
</html>

View File

@@ -0,0 +1,10 @@
/**
*
* Spring's form tag library for JSP 1.2+.
* Supports JSP view implementations for Spring's web MVC framework.
* See <code>spring-form.tld</code> for descriptions of the various tags.
*
*/
package org.springframework.web.servlet.tags.form;

View File

@@ -1,9 +0,0 @@
<html>
<body>
Spring's form tag library for JSP 1.2+.
Supports JSP view implementations for Spring's web MVC framework.
See <code>spring-form.tld</code> for descriptions of the various tags.
</body>
</html>

View File

@@ -0,0 +1,10 @@
/**
*
* Spring's JSP standard tag library for JSP 1.2+.
* Supports JSP view implementations within Spring's web MVC framework.
* See <code>spring.tld</code> for descriptions of the various tags.
*
*/
package org.springframework.web.servlet.tags;

View File

@@ -1,9 +0,0 @@
<html>
<body>
Spring's JSP standard tag library for JSP 1.2+.
Supports JSP view implementations within Spring's web MVC framework.
See <code>spring.tld</code> for descriptions of the various tags.
</body>
</html>

View File

@@ -0,0 +1,24 @@
/**
*
* Theme support classes for Spring's web MVC framework.
* Provides standard ThemeResolver implementations,
* and a HandlerInterceptor for theme changes.
*
* <p>
* <ul>
* <li>If you don't provide a bean of one of these classes as <code>themeResolver</code>,
* a <code>FixedThemeResolver</code> will be provided with the default theme name 'theme'.</li>
* <li>If you use a defined <code>FixedThemeResolver</code>, you will able to use another theme
* name for default, but the users will stick on this theme.</li>
* <li>With a <code>CookieThemeResolver</code> or <code>SessionThemeResolver</code>, you can allow
* the user to change his current theme.</li>
* <li>Generally, you will put in the themes resource bundles the paths of CSS files, images and HTML constructs.</li>
* <li>For retrieving themes data, you can either use the spring:theme tag in JSP or access via the
* <code>RequestContext</code> for other view technologies.</li>
* <li>The <code>pagedlist</code> demo application uses themes</li>
* </ul>
*
*/
package org.springframework.web.servlet.theme;

View File

@@ -1,23 +0,0 @@
<html>
<body>
Theme support classes for Spring's web MVC framework.
Provides standard ThemeResolver implementations,
and a HandlerInterceptor for theme changes.
<p>
<ul>
<li>If you don't provide a bean of one of these classes as <code>themeResolver</code>,
a <code>FixedThemeResolver</code> will be provided with the default theme name 'theme'.</li>
<li>If you use a defined <code>FixedThemeResolver</code>, you will able to use another theme
name for default, but the users will stick on this theme.</li>
<li>With a <code>CookieThemeResolver</code> or <code>SessionThemeResolver</code>, you can allow
the user to change his current theme.</li>
<li>Generally, you will put in the themes resource bundles the paths of CSS files, images and HTML constructs.</li>
<li>For retrieving themes data, you can either use the spring:theme tag in JSP or access via the
<code>RequestContext</code> for other view technologies.</li>
<li>The <code>pagedlist</code> demo application uses themes</li>
</ul>
</body>
</html>

View File

@@ -0,0 +1,9 @@
/**
*
* Support classes for document generation,
* providing View implementations for PDF and Excel.
*
*/
package org.springframework.web.servlet.view.document;

View File

@@ -1,8 +0,0 @@
<html>
<body>
Support classes for document generation,
providing View implementations for PDF and Excel.
</body>
</html>

View File

@@ -0,0 +1,8 @@
/**
*
* Support classes for feed generation, providing View implementations for Atom and RSS
*
*/
package org.springframework.web.servlet.view.feed;

View File

@@ -1,5 +0,0 @@
<html>
<body>
Support classes for feed generation, providing View implementations for Atom and RSS.
</body>
</html>

View File

@@ -0,0 +1,11 @@
/**
*
* Support classes for the integration of
* <a href="http://www.freemarker.org">FreeMarker</a>
* as Spring web view technology.
* Contains a View implementation for FreeMarker templates.
*
*/
package org.springframework.web.servlet.view.freemarker;

View File

@@ -1,10 +0,0 @@
<html>
<body>
Support classes for the integration of
<a href="http://www.freemarker.org">FreeMarker</a>
as Spring web view technology.
Contains a View implementation for FreeMarker templates.
</body>
</html>

View File

@@ -0,0 +1,11 @@
/**
*
* Support classes for the integration of
* <a href="http://jasperreports.sourceforge.net">JasperReports</a>
* as Spring web view technology.
* Contains various View implementations for JasperReports.
*
*/
package org.springframework.web.servlet.view.jasperreports;

View File

@@ -1,10 +0,0 @@
<html>
<body>
Support classes for the integration of
<a href="http://jasperreports.sourceforge.net">JasperReports</a>
as Spring web view technology.
Contains various View implementations for JasperReports.
</body>
</html>

View File

@@ -0,0 +1,15 @@
/**
*
* Provides standard View and ViewResolver implementations,
* including abstract base classes for custom implementations.
*
* <p>Application developers don't usually need to implement views,
* as the framework provides standard views for JSPs, Velocity,
* XSLT, etc. However, the ability to implement custom views easily
* by subclassing the AbstractView class in this package can be
* very helpful if an application has unusual view requirements.
*
*/
package org.springframework.web.servlet.view;

View File

@@ -1,14 +0,0 @@
<html>
<body>
Provides standard View and ViewResolver implementations,
including abstract base classes for custom implementations.
<p>Application developers don't usually need to implement views,
as the framework provides standard views for JSPs, Velocity,
XSLT, etc. However, the ability to implement custom views easily
by subclassing the AbstractView class in this package can be
very helpful if an application has unusual view requirements.
</body>
</html>

View File

@@ -0,0 +1,11 @@
/**
*
* Support classes for the integration of
* <a href="http://tiles.apache.org">Tiles2</a>
* (the standalone version of Tiles) as Spring web view technology.
* Contains a View implementation for Tiles definitions.
*
*/
package org.springframework.web.servlet.view.tiles2;

View File

@@ -1,10 +0,0 @@
<html>
<body>
Support classes for the integration of
<a href="http://tiles.apache.org">Tiles2</a>
(the standalone version of Tiles) as Spring web view technology.
Contains a View implementation for Tiles definitions.
</body>
</html>

View File

@@ -0,0 +1,11 @@
/**
*
* Support classes for the integration of
* <a href="http://velocity.apache.org">Velocity</a>
* as Spring web view technology.
* Contains a View implementation for Velocity templates.
*
*/
package org.springframework.web.servlet.view.velocity;

View File

@@ -1,10 +0,0 @@
<html>
<body>
Support classes for the integration of
<a href="http://velocity.apache.org">Velocity</a>
as Spring web view technology.
Contains a View implementation for Velocity templates.
</body>
</html>

View File

@@ -0,0 +1,8 @@
/**
*
* Support classes for providing a View implementation based on XML Marshalling.
*
*/
package org.springframework.web.servlet.view.xml;

View File

@@ -1,7 +0,0 @@
<html>
<body>
Support classes for providing a View implementation based on XML Marshalling.
</body>
</html>

View File

@@ -0,0 +1,9 @@
/**
*
* Support classes for XSLT,
* providing a View implementation for XSLT stylesheets.
*
*/
package org.springframework.web.servlet.view.xslt;

View File

@@ -1,8 +0,0 @@
<html>
<body>
Support classes for XSLT,
providing a View implementation for XSLT stylesheets.
</body>
</html>