You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@wicket.apache.org by gs...@apache.org on 2007/10/15 23:23:31 UTC
svn commit: r584925 [15/34] - in /wicket/trunk/jdk-1.4/wicket/src:
main/java/org/apache/wicket/ main/java/org/apache/wicket/ajax/
main/java/org/apache/wicket/ajax/calldecorator/
main/java/org/apache/wicket/ajax/form/ main/java/org/apache/wicket/ajax/ma...
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEntry.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEntry.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEntry.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEntry.java Mon Oct 15 14:21:25 2007
@@ -20,11 +20,10 @@
import org.apache.wicket.Page;
/**
- * Some source which produces a page. Page implements IPageMapEntry by simply
- * returning "this", but other implementations are possible as well, allowing
- * users to create IPageMapEntry implementations that reconstruct full blown
- * Page objects from a limited set of data (for example, a details page from an
- * id). The advantage of doing this is that you can save session memory (by
+ * Some source which produces a page. Page implements IPageMapEntry by simply returning "this", but
+ * other implementations are possible as well, allowing users to create IPageMapEntry
+ * implementations that reconstruct full blown Page objects from a limited set of data (for example,
+ * a details page from an id). The advantage of doing this is that you can save session memory (by
* trading off against the processing power required to reconstruct the page).
*
* @see org.apache.wicket.session.pagemap.AbstractPageMapEntry
@@ -43,8 +42,8 @@
Page getPage();
/**
- * @return The class of page stored in this page map entry (which can be
- * used by an eviction strategy to prioritize evictions)
+ * @return The class of page stored in this page map entry (which can be used by an eviction
+ * strategy to prioritize evictions)
*/
Class getPageClass();
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEvictionStrategy.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEvictionStrategy.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEvictionStrategy.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/IPageMapEvictionStrategy.java Mon Oct 15 14:21:25 2007
@@ -20,8 +20,8 @@
import org.apache.wicket.IPageMap;
/**
- * Given a page map, evicts zero or more entries from the map according to some
- * algorithm in the implementation.
+ * Given a page map, evicts zero or more entries from the map according to some algorithm in the
+ * implementation.
*
* @author Jonathan Locke
*/
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/LeastRecentlyAccessedEvictionStrategy.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/LeastRecentlyAccessedEvictionStrategy.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/LeastRecentlyAccessedEvictionStrategy.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/session/pagemap/LeastRecentlyAccessedEvictionStrategy.java Mon Oct 15 14:21:25 2007
@@ -23,8 +23,8 @@
import org.apache.wicket.AccessStackPageMap.Access;
/**
- * A simple eviction strategy that evicts the least recently accessed page
- * version from the given page map.
+ * A simple eviction strategy that evicts the least recently accessed page version from the given
+ * page map.
*
* @author Jonathan Locke
*/
@@ -64,8 +64,8 @@
if (accessPM.getVersions() > maxVersions)
{
// Remove oldest entry from access stack
- final AccessStackPageMap.Access oldestAccess = (Access)accessPM.getAccessStack()
- .remove(0);
+ final AccessStackPageMap.Access oldestAccess = (Access)accessPM
+ .getAccessStack().remove(0);
final IPageMapEntry oldestEntry = pageMap.getEntry(oldestAccess.getId());
// If entry is a page (cannot be null if we're evicting)
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IApplicationSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IApplicationSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IApplicationSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IApplicationSettings.java Mon Oct 15 14:21:25 2007
@@ -23,16 +23,15 @@
/**
* Settings interface for application settings.
* <p>
- * <i>internalErrorPage </i>- You can override this with your own page class to
- * display internal errors in a different way.
+ * <i>internalErrorPage </i>- You can override this with your own page class to display internal
+ * errors in a different way.
* <p>
- * <i>pageExpiredErrorPage </i>- You can override this with your own
- * bookmarkable page class to display expired page errors in a different way.
- * You can set property homePageRenderStrategy to choose from different ways the
- * home page url shows up in your browser.
+ * <i>pageExpiredErrorPage </i>- You can override this with your own bookmarkable page class to
+ * display expired page errors in a different way. You can set property homePageRenderStrategy to
+ * choose from different ways the home page url shows up in your browser.
* <p>
- * <b>A Converter Factory </b>- By overriding getConverterFactory(), you can
- * provide your own factory which creates locale sensitive Converter instances.
+ * <b>A Converter Factory </b>- By overriding getConverterFactory(), you can provide your own
+ * factory which creates locale sensitive Converter instances.
*
* @author Jonathan Locke
*/
@@ -54,9 +53,8 @@
IClassResolver getClassResolver();
/**
- * Gets the default maximum size for uploads. This is used by
- * {@link Form#getMaxSize()} if no value is explicitly set through
- * {@link Form#setMaxSize(Bytes)}.
+ * Gets the default maximum size for uploads. This is used by {@link Form#getMaxSize()} if no
+ * value is explicitly set through {@link Form#setMaxSize(Bytes)}.
*
* @return the default maximum size for uploads
*/
@@ -79,8 +77,7 @@
Class getPageExpiredErrorPage();
/**
- * Sets the access denied page class. The class must be bookmarkable and
- * must extend Page.
+ * Sets the access denied page class. The class must be bookmarkable and must extend Page.
*
* @param accessDeniedPage
* The accessDeniedPage to set.
@@ -96,9 +93,8 @@
void setClassResolver(final IClassResolver defaultClassResolver);
/**
- * Sets the default maximum size for uploads. This is used by
- * {@link Form#getMaxSize()} if no value is explicitly set through
- * {@link Form#setMaxSize(Bytes)}.
+ * Sets the default maximum size for uploads. This is used by {@link Form#getMaxSize()} if no
+ * value is explicitly set through {@link Form#setMaxSize(Bytes)}.
*
* @param defaultUploadSize
* the default maximum size for uploads
@@ -106,8 +102,7 @@
void setDefaultMaximumUploadSize(Bytes defaultUploadSize);
/**
- * Sets internal error page class. The class must be bookmarkable and must
- * extend Page.
+ * Sets internal error page class. The class must be bookmarkable and must extend Page.
*
* @param internalErrorPage
* The internalErrorPage to set.
@@ -115,8 +110,7 @@
void setInternalErrorPage(final Class internalErrorPage);
/**
- * Sets the page expired page class. The class must be bookmarkable and must
- * extend Page.
+ * Sets the page expired page class. The class must be bookmarkable and must extend Page.
*
* @param pageExpiredErrorPage
* The pageExpiredErrorPage to set.
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IDebugSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IDebugSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IDebugSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IDebugSettings.java Mon Oct 15 14:21:25 2007
@@ -19,15 +19,14 @@
/**
* Settings interface for various debug settings
* <p>
- * <i>componentUseCheck </i> (defaults to true) - Causes the framework to do a
- * check after rendering each page to ensure that each component was used in
- * rendering the markup. If components are found that are not referenced in the
- * markup, an appropriate error will be displayed <i>serializeSessionAttributes</i>
- * (defaults to true in development mode) - Causes the framework to serialize any
- * attribute put into session - this helps find Not Serializable errors early
+ * <i>componentUseCheck </i> (defaults to true) - Causes the framework to do a check after rendering
+ * each page to ensure that each component was used in rendering the markup. If components are found
+ * that are not referenced in the markup, an appropriate error will be displayed
+ * <i>serializeSessionAttributes</i> (defaults to true in development mode) - Causes the framework
+ * to serialize any attribute put into session - this helps find Not Serializable errors early
* <p>
- *
- *
+ *
+ *
* @author Igor Vaynberg (ivaynberg)
*/
public interface IDebugSettings
@@ -39,83 +38,79 @@
/**
* Sets componentUseCheck debug settings
- *
+ *
* @param check
*/
void setComponentUseCheck(boolean check);
/**
- * Enables or disables ajax debug mode. See {@link org.apache.wicket.settings.IDebugSettings} for
- * details
- *
+ * Enables or disables ajax debug mode. See {@link org.apache.wicket.settings.IDebugSettings}
+ * for details
+ *
* @param enable
- *
+ *
*/
void setAjaxDebugModeEnabled(boolean enable);
/**
- * Returns status of ajax debug mode. See {@link org.apache.wicket.settings.IDebugSettings} for details
- *
+ * Returns status of ajax debug mode. See {@link org.apache.wicket.settings.IDebugSettings} for
+ * details
+ *
* @return true if ajax debug mode is enabled, false otherwise
- *
+ *
*/
boolean isAjaxDebugModeEnabled();
/**
- * Enables wrapping output of markup container in html comments that contain
- * markup container's class name. (Useful for determining which part of page
- * belongs to which markup file).
- *
+ * Enables wrapping output of markup container in html comments that contain markup container's
+ * class name. (Useful for determining which part of page belongs to which markup file).
+ *
* @param enable
*/
void setOutputMarkupContainerClassName(boolean enable);
/**
- * Returns whether the output of markup container's should be wrapped by
- * comments containing the container's class name.
- *
- * @return true if the markup container's class name should be written to
- * response
+ * Returns whether the output of markup container's should be wrapped by comments containing the
+ * container's class name.
+ *
+ * @return true if the markup container's class name should be written to response
*/
public boolean isOutputMarkupContainerClassName();
/**
- * Returns status of line precise error reporting for added components that
- * are not present in the markup: it points to the line where the component
- * was added to the hierarchy in your Java classes. This can cause a
- * significant decrease in performance, do not use in customer facing
+ * Returns status of line precise error reporting for added components that are not present in
+ * the markup: it points to the line where the component was added to the hierarchy in your Java
+ * classes. This can cause a significant decrease in performance, do not use in customer facing
* applications.
- *
+ *
* @return true if the line precise error reporting is enabled
*/
public boolean isLinePreciseReportingOnAddComponentEnabled();
/**
- * Enables line precise error reporting for added components that are not
- * present in the markup: it points to the line where the component was
- * added to the hierarchy in your Java classes. This can cause a significant
- * decrease in performance, do not use in customer facing applications.
- *
+ * Enables line precise error reporting for added components that are not present in the markup:
+ * it points to the line where the component was added to the hierarchy in your Java classes.
+ * This can cause a significant decrease in performance, do not use in customer facing
+ * applications.
+ *
* @param enable
*/
public void setLinePreciseReportingOnAddComponentEnabled(boolean enable);
/**
- * Returns status of line precise error reporting for new components that
- * are not present in the markup: it points to the line where the component
- * was created in your Java classes. This can cause a significant decrease
- * in performance, do not use in customer facing applications.
- *
+ * Returns status of line precise error reporting for new components that are not present in the
+ * markup: it points to the line where the component was created in your Java classes. This can
+ * cause a significant decrease in performance, do not use in customer facing applications.
+ *
* @return true if the line precise error reporting is enabled
*/
public boolean isLinePreciseReportingOnNewComponentEnabled();
/**
- * Enables line precise error reporting for new components that are not
- * present in the markup: it points to the line where the component was
- * created in your Java classes. This can cause a significant decrease in
- * performance, do not use in customer facing applications.
- *
+ * Enables line precise error reporting for new components that are not present in the markup:
+ * it points to the line where the component was created in your Java classes. This can cause a
+ * significant decrease in performance, do not use in customer facing applications.
+ *
* @param enable
*/
public void setLinePreciseReportingOnNewComponentEnabled(boolean enable);
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IExceptionSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IExceptionSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IExceptionSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IExceptionSettings.java Mon Oct 15 14:21:25 2007
@@ -22,13 +22,12 @@
/**
* Settings interface for configuring exception handling related settings.
* <p>
- * <i>unexpectedExceptionDisplay </i> (defaults to SHOW_EXCEPTION_PAGE) -
- * Determines how exceptions are displayed to the developer or user
+ * <i>unexpectedExceptionDisplay </i> (defaults to SHOW_EXCEPTION_PAGE) - Determines how exceptions
+ * are displayed to the developer or user
* <p>
- * <i>throwExceptionOnMissingResource </i> (defaults to true) - Set to true to
- * throw a runtime exception if a required string resource is not found. Set to
- * false to return the requested resource key surrounded by pairs of question
- * mark characters (e.g. "??missingKey??")
+ * <i>throwExceptionOnMissingResource </i> (defaults to true) - Set to true to throw a runtime
+ * exception if a required string resource is not found. Set to false to return the requested
+ * resource key surrounded by pairs of question mark characters (e.g. "??missingKey??")
*
* @author Igor Vaynberg (ivaynberg)
*/
@@ -48,31 +47,27 @@
}
/**
- * Indicates that an exception page appropriate to development should be
- * shown when an unexpected exception is thrown.
+ * Indicates that an exception page appropriate to development should be shown when an
+ * unexpected exception is thrown.
*/
public static final UnexpectedExceptionDisplay SHOW_EXCEPTION_PAGE = new UnexpectedExceptionDisplay(
"SHOW_EXCEPTION_PAGE");
/**
- * Indicates a generic internal error page should be shown when an
- * unexpected exception is thrown.
+ * Indicates a generic internal error page should be shown when an unexpected exception is
+ * thrown.
*/
public static final UnexpectedExceptionDisplay SHOW_INTERNAL_ERROR_PAGE = new UnexpectedExceptionDisplay(
"SHOW_INTERNAL_ERROR_PAGE");
/**
- * Indicates that no exception page should be shown when an unexpected
- * exception is thrown.
+ * Indicates that no exception page should be shown when an unexpected exception is thrown.
*/
public static final UnexpectedExceptionDisplay SHOW_NO_EXCEPTION_PAGE = new UnexpectedExceptionDisplay(
"SHOW_NO_EXCEPTION_PAGE");
/**
- * @return Whether to throw an exception when a missing resource is
- * requested
- * @deprecated use
- * {@link IResourceSettings#getThrowExceptionOnMissingResource()}
- * instead
+ * @return Whether to throw an exception when a missing resource is requested
+ * @deprecated use {@link IResourceSettings#getThrowExceptionOnMissingResource()} instead
*/
boolean getThrowExceptionOnMissingResource();
@@ -83,32 +78,27 @@
/**
* @param throwExceptionOnMissingResource
- * Whether to throw an exception when a missing resource is
- * requested
- * @deprecated use
- * {@link IResourceSettings#setThrowExceptionOnMissingResource(boolean)}
- * instead
+ * Whether to throw an exception when a missing resource is requested
+ * @deprecated use {@link IResourceSettings#setThrowExceptionOnMissingResource(boolean)} instead
*/
void setThrowExceptionOnMissingResource(final boolean throwExceptionOnMissingResource);
/**
- * The exception display type determines how the framework displays
- * exceptions to you as a developer or user.
+ * The exception display type determines how the framework displays exceptions to you as a
+ * developer or user.
* <p>
- * The default value for exception display type is SHOW_EXCEPTION_PAGE. When
- * this value is set and an unhandled runtime exception is thrown by a page,
- * a redirect to a helpful exception display page will occur.
+ * The default value for exception display type is SHOW_EXCEPTION_PAGE. When this value is set
+ * and an unhandled runtime exception is thrown by a page, a redirect to a helpful exception
+ * display page will occur.
* <p>
- * This is a developer feature, however, and you may want to instead show an
- * internal error page without developer details that allows a user to start
- * over at the application's home page. This can be accomplished by setting
- * the exception display type to SHOW_INTERNAL_ERROR_PAGE.
+ * This is a developer feature, however, and you may want to instead show an internal error page
+ * without developer details that allows a user to start over at the application's home page.
+ * This can be accomplished by setting the exception display type to SHOW_INTERNAL_ERROR_PAGE.
* <p>
- * Finally, if you are having trouble with the exception display pages
- * themselves, you can disable exception displaying entirely with the value
- * SHOW_NO_EXCEPTION_PAGE. This will cause the framework to re-throw any
- * unhandled runtime exceptions after wrapping them in a ServletException
- * wrapper.
+ * Finally, if you are having trouble with the exception display pages themselves, you can
+ * disable exception displaying entirely with the value SHOW_NO_EXCEPTION_PAGE. This will cause
+ * the framework to re-throw any unhandled runtime exceptions after wrapping them in a
+ * ServletException wrapper.
*
* @param unexpectedExceptionDisplay
* The unexpectedExceptionDisplay to set.
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IFrameworkSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IFrameworkSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IFrameworkSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IFrameworkSettings.java Mon Oct 15 14:21:25 2007
@@ -24,16 +24,14 @@
public interface IFrameworkSettings
{
/**
- * Gets the Wicket version. The Wicket version is in the same format as the
- * version element in the pom.xml file (project descriptor). The version is
- * generated by maven in the build/release cycle and put in the
- * wicket.properties file located in the root folder of the Wicket jar.
+ * Gets the Wicket version. The Wicket version is in the same format as the version element in
+ * the pom.xml file (project descriptor). The version is generated by maven in the build/release
+ * cycle and put in the wicket.properties file located in the root folder of the Wicket jar.
*
* The version usually follows one of the following formats:
* <ul>
* <li>major.minor[.bug] for stable versions. 1.1, 1.2, 1.2.1 are examples</li>
- * <li>major.minor-state for development versions. 1.2-beta2, 1.3-SNAPSHOT
- * are examples</li>
+ * <li>major.minor-state for development versions. 1.2-beta2, 1.3-SNAPSHOT are examples</li>
* </ul>
*
* @return the Wicket version
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IMarkupSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IMarkupSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IMarkupSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IMarkupSettings.java Mon Oct 15 14:21:25 2007
@@ -23,21 +23,20 @@
/**
* Interface for markup related settings.
* <p>
- * <i>compressWhitespace </i> (defaults to false) - Causes pages to render with
- * redundant whitespace removed. Whitespace stripping is not HTML or JavaScript
- * savvy and can conceivably break pages, but should provide significant
- * performance improvements.
+ * <i>compressWhitespace </i> (defaults to false) - Causes pages to render with redundant whitespace
+ * removed. Whitespace stripping is not HTML or JavaScript savvy and can conceivably break pages,
+ * but should provide significant performance improvements.
* <p>
- * <i>stripComments </i> (defaults to false) - Set to true to strip HTML
- * comments during markup loading
- *
+ * <i>stripComments </i> (defaults to false) - Set to true to strip HTML comments during markup
+ * loading
+ *
* @author Igor Vaynberg (ivaynberg)
*/
public interface IMarkupSettings
{
/**
* If true, automatic link resolution is enabled. Disabled by default.
- *
+ *
* @see org.apache.wicket.markup.resolver.AutoLinkResolver
* @see org.apache.wicket.markup.parser.filter.WicketLinkTagHandler
* @return Returns the automaticLinking.
@@ -62,8 +61,8 @@
/**
* @since 1.1
- * @return Returns default encoding of markup files. If null, the operating
- * system provided encoding will be used.
+ * @return Returns default encoding of markup files. If null, the operating system provided
+ * encoding will be used.
*/
String getDefaultMarkupEncoding();
@@ -74,7 +73,7 @@
/**
* The markup cache also loads the markup if not yet available in the cache.
- *
+ *
* @return markup cache
*/
IMarkupCache getMarkupCache();
@@ -87,13 +86,13 @@
/**
* Gets whether to remove wicket tags from the output.
- *
+ *
* @return whether to remove wicket tags from the output
*/
boolean getStripWicketTags();
/**
- *
+ *
* @since 1.1
* @return if true, xml declaration will be removed.
*/
@@ -101,30 +100,28 @@
/**
* Application default for automatic link resolution. Please
- *
+ *
* @see org.apache.wicket.markup.resolver.AutoLinkResolver and
- * @see org.apache.wicket.markup.parser.filter.WicketLinkTagHandler for more
- * details.
- *
+ * @see org.apache.wicket.markup.parser.filter.WicketLinkTagHandler for more details.
+ *
* @param automaticLinking
* The automaticLinking to set.
*/
void setAutomaticLinking(boolean automaticLinking);
/**
- * Turns on whitespace compression. Multiple occurrences of space/tab
- * characters will be compressed to a single space. Multiple line breaks
- * newline/carriage-return will also be compressed to a single newline.
+ * Turns on whitespace compression. Multiple occurrences of space/tab characters will be
+ * compressed to a single space. Multiple line breaks newline/carriage-return will also be
+ * compressed to a single newline.
* <p>
- * Compression is currently not HTML aware and so it may be possible for
- * whitespace compression to break pages. For this reason, whitespace
- * compression is off by default and you should test your application
- * thoroughly after turning whitespace compression on.
+ * Compression is currently not HTML aware and so it may be possible for whitespace compression
+ * to break pages. For this reason, whitespace compression is off by default and you should test
+ * your application thoroughly after turning whitespace compression on.
* <p>
- * Spaces are removed from markup at markup load time and there should be no
- * effect on page rendering speed. In fact, your pages should render faster
- * with whitespace compression enabled.
- *
+ * Spaces are removed from markup at markup load time and there should be no effect on page
+ * rendering speed. In fact, your pages should render faster with whitespace compression
+ * enabled.
+ *
* @param compressWhitespace
* The compressWhitespace to set.
*/
@@ -143,36 +140,35 @@
void setDefaultBeforeDisabledLink(String defaultBeforeDisabledLink);
/**
- * Set default encoding for markup files. If null, the encoding provided by
- * the operating system will be used.
- *
+ * Set default encoding for markup files. If null, the encoding provided by the operating system
+ * will be used.
+ *
* @since 1.1
* @param encoding
*/
void setDefaultMarkupEncoding(final String encoding);
/**
- * Sets the markup parser factory that will be used to generate parsers for
- * markup. By default {@link MarkupParserFactory} will be used.
- *
+ * Sets the markup parser factory that will be used to generate parsers for markup. By default
+ * {@link MarkupParserFactory} will be used.
+ *
* @param factory
* new factory
*/
void setMarkupParserFactory(IMarkupParserFactory factory);
/**
- * Sets a new markup cache which will also be used to load markup if not yet
- * available in the cache.
- *
+ * Sets a new markup cache which will also be used to load markup if not yet available in the
+ * cache.
+ *
* @param markupCache
* new markup cache
*/
void setMarkupCache(IMarkupCache markupCache);
/**
- * Enables stripping of markup comments denoted in markup by HTML comment
- * tagging.
- *
+ * Enables stripping of markup comments denoted in markup by HTML comment tagging.
+ *
* @param stripComments
* True to strip markup comments from rendered pages
*/
@@ -180,14 +176,14 @@
/**
* Sets whether to remove wicket tags from the output.
- *
+ *
* @param stripWicketTags
* whether to remove wicket tags from the output
*/
void setStripWicketTags(boolean stripWicketTags);
/**
- *
+ *
* @since 1.1
* @param strip
* if true, xml declaration will be stripped from output
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IPageSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IPageSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IPageSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IPageSettings.java Mon Oct 15 14:21:25 2007
@@ -48,24 +48,20 @@
List getComponentResolvers();
/**
- * Gets whether Wicket should try to support opening multiple windows for
- * the same session transparently. If this is true - the default setting -,
- * Wicket tries to detect whether a new window was opened by a user (e.g. in
- * Internet Explorer by pressing ctrl+n or ctrl+click on a link), and if it
- * detects that, it creates a new page map for that window on the fly. As a
- * page map represents the 'history' of one window, each window will then
- * have their own history. If two windows would share the same page map, the
- * non-bookmarkable links on one window could refer to stale state after
- * working a while in the other window.
+ * Gets whether Wicket should try to support opening multiple windows for the same session
+ * transparently. If this is true - the default setting -, Wicket tries to detect whether a new
+ * window was opened by a user (e.g. in Internet Explorer by pressing ctrl+n or ctrl+click on a
+ * link), and if it detects that, it creates a new page map for that window on the fly. As a
+ * page map represents the 'history' of one window, each window will then have their own
+ * history. If two windows would share the same page map, the non-bookmarkable links on one
+ * window could refer to stale state after working a while in the other window.
* <p>
- * <strong> Currently, Wicket trying to do this is a best effort that is not
- * completely fail safe. When the client does not support cookies, support
- * gets tricky and incomplete. See {@link WebPage}'s internals for the
- * implementation. </strong>
+ * <strong> Currently, Wicket trying to do this is a best effort that is not completely fail
+ * safe. When the client does not support cookies, support gets tricky and incomplete. See
+ * {@link WebPage}'s internals for the implementation. </strong>
* </p>
*
- * @return Whether Wicket should try to support multiple windows
- * transparently
+ * @return Whether Wicket should try to support multiple windows transparently
*/
boolean getAutomaticMultiWindowSupport();
@@ -81,25 +77,21 @@
void setVersionPagesByDefault(boolean pagesVersionedByDefault);
/**
- * Sets whether Wicket should try to support opening multiple windows for
- * the same session transparently. If this is true - the default setting -,
- * Wicket tries to detect whether a new window was opened by a user (e.g. in
- * Internet Explorer by pressing ctrl+n or ctrl+click on a link), and if it
- * detects that, it creates a new page map for that window on the fly. As a
- * page map represents the 'history' of one window, each window will then
- * have their own history. If two windows would share the same page map, the
- * non-bookmarkable links on one window could refer to stale state after
- * working a while in the other window.
+ * Sets whether Wicket should try to support opening multiple windows for the same session
+ * transparently. If this is true - the default setting -, Wicket tries to detect whether a new
+ * window was opened by a user (e.g. in Internet Explorer by pressing ctrl+n or ctrl+click on a
+ * link), and if it detects that, it creates a new page map for that window on the fly. As a
+ * page map represents the 'history' of one window, each window will then have their own
+ * history. If two windows would share the same page map, the non-bookmarkable links on one
+ * window could refer to stale state after working a while in the other window.
* <p>
- * <strong> Currently, Wicket trying to do this is a best effort that is not
- * completely fail safe. When the client does not support cookies, support
- * gets tricky and incomplete. See {@link WebPage}'s internals for the
- * implementation. </strong>
+ * <strong> Currently, Wicket trying to do this is a best effort that is not completely fail
+ * safe. When the client does not support cookies, support gets tricky and incomplete. See
+ * {@link WebPage}'s internals for the implementation. </strong>
* </p>
*
* @param automaticMultiWindowSupport
- * Whether Wicket should try to support multiple windows
- * transparently
+ * Whether Wicket should try to support multiple windows transparently
*/
void setAutomaticMultiWindowSupport(boolean automaticMultiWindowSupport);
}
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestCycleSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestCycleSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestCycleSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestCycleSettings.java Mon Oct 15 14:21:25 2007
@@ -72,7 +72,7 @@
* rendered and streamed in one pass.
* <p>
* More documentation is available about each setting in the setter method for the property.
- *
+ *
* @author Igor Vaynberg (ivaynberg)
*/
public interface IRequestCycleSettings
@@ -145,7 +145,7 @@
/**
* Adds a response filter to the list. Filters are evaluated in the order they have been added.
- *
+ *
* @param responseFilter
* The {@link IResponseFilter} that is added
*/
@@ -161,14 +161,14 @@
* {@link BrowserInfoPage a page that polls for client capabilities}. This method is used by
* the default implementation of {@link WebRequestCycle#newClientInfo()}, so if that method is
* overridden, there is no guarantee this method will be taken into account.
- *
+ *
* @return Whether to gather extensive client info
*/
boolean getGatherExtendedBrowserInfo();
/**
* Gets in what way the render part of a request is handled.
- *
+ *
* @return the render strategy
*/
IRequestCycleSettings.RenderStrategy getRenderStrategy();
@@ -182,7 +182,7 @@
* In order to do proper form parameter decoding it is important that the response and the
* following request have the same encoding. see
* http://www.crazysquirrel.com/computing/general/form-encoding.jspx for additional information.
- *
+ *
* @return The request and response encoding
*/
String getResponseRequestEncoding();
@@ -190,14 +190,14 @@
/**
* Gets the time that a request will by default be waiting for the previous request to be
* handled before giving up.
- *
+ *
* @return The time out
*/
Duration getTimeout();
/**
* @see org.apache.wicket.settings.IExceptionSettings#getUnexpectedExceptionDisplay()
- *
+ *
* @return UnexpectedExceptionDisplay
*/
UnexpectedExceptionDisplay getUnexpectedExceptionDisplay();
@@ -213,7 +213,7 @@
* {@link BrowserInfoPage a page that polls for client capabilities}. This method is used by
* the default implementation of {@link WebRequestCycle#newClientInfo()}, so if that method is
* overridden, there is no guarantee this method will be taken into account.
- *
+ *
* <p>
* <strong>WARNING: </strong> though this facility should work transparently in most cases, it
* is recommended that you trigger the roundtrip to get the browser info somewhere where it
@@ -225,7 +225,7 @@
* {@link Session#getClientInfo()} e.g. in a page constructor or somewhere else where you didn't
* do a lot of processing first.
* </p>
- *
+ *
* @param gatherExtendedBrowserInfo
* Whether to gather extensive client info
*/
@@ -266,7 +266,7 @@
* REDIRECT_TO_RENDER. When the application is configured to use REDIRECT_TO_RENDER or
* REDIRECT_TO_BUFFER, setting the redirect flag to false, will result in that request begin
* rendered and streamed in one pass.
- *
+ *
* @param renderStrategy
* the render strategy that should be used by default.
*/
@@ -276,9 +276,9 @@
* In order to do proper form parameter decoding it is important that the response and the
* following request have the same encoding. see
* http://www.crazysquirrel.com/computing/general/form-encoding.jspx for additional information.
- *
+ *
* Default encoding: UTF-8
- *
+ *
* @param responseRequestEncoding
* The request and response encoding to be used.
*/
@@ -287,14 +287,14 @@
/**
* Sets the time that a request will by default be waiting for the previous request to be
* handled before giving up.
- *
+ *
* @param timeout
*/
void setTimeout(Duration timeout);
/**
* @see org.apache.wicket.settings.IExceptionSettings#setUnexpectedExceptionDisplay(org.apache.wicket.settings.Settings.UnexpectedExceptionDisplay)
- *
+ *
* @param unexpectedExceptionDisplay
*/
void setUnexpectedExceptionDisplay(final UnexpectedExceptionDisplay unexpectedExceptionDisplay);
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestLoggerSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestLoggerSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestLoggerSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/IRequestLoggerSettings.java Mon Oct 15 14:21:25 2007
@@ -24,38 +24,38 @@
/**
* Enable/Disable the request logger.
*
- * @param enable boolean.
+ * @param enable
+ * boolean.
*/
void setRequestLoggerEnabled(boolean enable);
-
-
+
+
/**
* @return true if the request Logger is enabled. (default false)
*/
boolean isRequestLoggerEnabled();
-
+
/**
- * Enable/Disable the recording of the session size
- * for every request.
+ * Enable/Disable the recording of the session size for every request.
*
* @param record
*/
void setRecordSessionSize(boolean record);
-
+
/**
* @return true if the session size is recorded. (default true)
*/
boolean getRecordSessionSize();
-
+
/**
- * Set the window of all the requests that is kept in memory
- * for viewing. Default is 2000, You can set this to 0 then
- * only Sessions data is recorded (number of request, total time, latest size)
+ * Set the window of all the requests that is kept in memory for viewing. Default is 2000, You
+ * can set this to 0 then only Sessions data is recorded (number of request, total time, latest
+ * size)
*
* @param size
*/
void setRequestsWindowSize(int size);
-
+
/**
* @return The window size of the recorded requests. (default 2000)
*/
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISecuritySettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISecuritySettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISecuritySettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISecuritySettings.java Mon Oct 15 14:21:25 2007
@@ -53,10 +53,9 @@
ICryptFactory getCryptFactory();
/**
- * Gets whether mounts should be enforced. If true, requests for mounted
- * targets have to done through the mounted paths. If, for instance, a
- * bookmarkable page is mounted to a path, a request to that same page via
- * the bookmarkablePage parameter will be denied.
+ * Gets whether mounts should be enforced. If true, requests for mounted targets have to done
+ * through the mounted paths. If, for instance, a bookmarkable page is mounted to a path, a
+ * request to that same page via the bookmarkablePage parameter will be denied.
*
* @return Whether mounts should be enforced
*/
@@ -84,18 +83,17 @@
void setCookieValuePersisterSettings(CookieValuePersisterSettings cookieValuePersisterSettings);
/**
- * Sets the factory that will be used to create crypt objects. The crypt
- * object returned from the first call is cached.
+ * Sets the factory that will be used to create crypt objects. The crypt object returned from
+ * the first call is cached.
*
* @param cryptFactory
*/
void setCryptFactory(ICryptFactory cryptFactory);
/**
- * Sets whether mounts should be enforced. If true, requests for mounted
- * targets have to done through the mounted paths. If, for instance, a
- * bookmarkable page is mounted to a path, a request to that same page via
- * the bookmarkablePage parameter will be denied.
+ * Sets whether mounts should be enforced. If true, requests for mounted targets have to done
+ * through the mounted paths. If, for instance, a bookmarkable page is mounted to a path, a
+ * request to that same page via the bookmarkablePage parameter will be denied.
*
* @param enforce
* Whether mounts should be enforced
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISessionSettings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISessionSettings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISessionSettings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/ISessionSettings.java Mon Oct 15 14:21:25 2007
@@ -22,14 +22,13 @@
/**
* Interface for session related settings
* <p>
- * <i>pageFactory </i>- The factory class that is used for constructing page
- * instances.
+ * <i>pageFactory </i>- The factory class that is used for constructing page instances.
* <p>
- * <i>pageMapEvictionStrategy </i>- The strategy for evicting pages from page
- * maps when they are too full
+ * <i>pageMapEvictionStrategy </i>- The strategy for evicting pages from page maps when they are too
+ * full
* <p>
- * <i>maxPageMaps </i>- The maximum number of page maps allowed in a session (to
- * prevent denial of service attacks)
+ * <i>maxPageMaps </i>- The maximum number of page maps allowed in a session (to prevent denial of
+ * service attacks)
* <p>
*
* @author Igor Vaynberg (ivaynberg)
@@ -82,16 +81,16 @@
void setPageMapEvictionStrategy(IPageMapEvictionStrategy pageMapEvictionStrategy);
/**
- * Sets whether the id of a page should be unique across the entire session.
- * Default is false, which means that a page id is unique per pagemap.
+ * Sets whether the id of a page should be unique across the entire session. Default is false,
+ * which means that a page id is unique per pagemap.
*
* @param value
*/
void setPageIdUniquePerSession(boolean value);
/**
- * Returns whether the page id is unique per session. If the page id is not
- * unique per session, it is only unique per pagemap.
+ * Returns whether the page id is unique per session. If the page id is not unique per session,
+ * it is only unique per pagemap.
*
* @return
*/
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/Settings.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/Settings.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/Settings.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/settings/Settings.java Mon Oct 15 14:21:25 2007
@@ -68,7 +68,7 @@
/**
* Contains settings exposed via IXXXSettings interfaces. It is not a good idea to use this class
* directly, instead use the provided IXXXSettings interfaces.
- *
+ *
* @author Jonathan Locke
* @author Chris Turner
* @author Eelco Hillenius
@@ -270,7 +270,7 @@
/**
* Called when an unauthorized component instantiation is about to take place (but before it
* happens).
- *
+ *
* @param component
* The partially constructed component (only the id is guaranteed to be valid).
*/
@@ -309,7 +309,7 @@
/**
* Create the application settings, carrying out any necessary initializations.
- *
+ *
* @param application
* The application that these settings are for
*/
@@ -432,7 +432,7 @@
/**
* Get the (modifiable) list of IComponentResolvers.
- *
+ *
* @see AutoComponentResolver for an example
* @return List of ComponentResolvers
*/
@@ -1164,7 +1164,7 @@
/**
* Throws an IllegalArgumentException if the given class is not a subclass of Page.
- *
+ *
* @param pageClass
* the page class to check
*/
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ArrayListStack.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ArrayListStack.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ArrayListStack.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ArrayListStack.java Mon Oct 15 14:21:25 2007
@@ -21,9 +21,9 @@
import java.util.EmptyStackException;
/**
- * A faster, smaller stack implementation. ArrayListStack is final and
- * unsynchronized (the JDK's methods are synchronized). In addition you can set
- * the initial capacity if you want via the ArrayListStack(int) constructor.
+ * A faster, smaller stack implementation. ArrayListStack is final and unsynchronized (the JDK's
+ * methods are synchronized). In addition you can set the initial capacity if you want via the
+ * ArrayListStack(int) constructor.
*
* @author Jonathan Locke
*/
@@ -106,8 +106,8 @@
/**
* Tests if this stack is empty.
*
- * @return <code>true</code> if and only if this stack contains no items;
- * <code>false</code> otherwise.
+ * @return <code>true</code> if and only if this stack contains no items; <code>false</code>
+ * otherwise.
*/
public final boolean empty()
{
@@ -115,18 +115,16 @@
}
/**
- * Returns the 1-based position where an object is on this stack. If the
- * object <tt>o</tt> occurs as an item in this stack, this method returns
- * the distance from the top of the stack of the occurrence nearest the top
- * of the stack; the topmost item on the stack is considered to be at
- * distance <tt>1</tt>. The <tt>equals</tt> method is used to compare
- * <tt>o</tt> to the items in this stack.
+ * Returns the 1-based position where an object is on this stack. If the object <tt>o</tt>
+ * occurs as an item in this stack, this method returns the distance from the top of the stack
+ * of the occurrence nearest the top of the stack; the topmost item on the stack is considered
+ * to be at distance <tt>1</tt>. The <tt>equals</tt> method is used to compare <tt>o</tt>
+ * to the items in this stack.
*
* @param o
* the desired object.
- * @return the 1-based position from the top of the stack where the object
- * is located; the return value <code>-1</code> indicates that the
- * object is not on the stack.
+ * @return the 1-based position from the top of the stack where the object is located; the
+ * return value <code>-1</code> indicates that the object is not on the stack.
*/
public final int search(final Object o)
{
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/IntHashMap.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/IntHashMap.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/IntHashMap.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/IntHashMap.java Mon Oct 15 14:21:25 2007
@@ -28,10 +28,9 @@
import java.util.Set;
/**
- * This is an integer hashmap that has the exact same features and interface as a
- * normal Map except that the key is directly an integer. So no hash is
- * calculated or key object is stored.
- *
+ * This is an integer hashmap that has the exact same features and interface as a normal Map except
+ * that the key is directly an integer. So no hash is calculated or key object is stored.
+ *
* @author jcompagner
*/
public class IntHashMap implements Cloneable, Serializable
@@ -46,8 +45,8 @@
static final int DEFAULT_INITIAL_CAPACITY = 16;
/**
- * The maximum capacity, used if a higher value is implicitly specified by
- * either of the constructors with arguments. MUST be a power of two <= 1<<30.
+ * The maximum capacity, used if a higher value is implicitly specified by either of the
+ * constructors with arguments. MUST be a power of two <= 1<<30.
*/
static final int MAXIMUM_CAPACITY = 1 << 30;
@@ -68,38 +67,35 @@
/**
* The next size value at which to resize (capacity * load factor).
- *
+ *
* @serial
*/
int threshold;
/**
* The load factor for the hash table.
- *
+ *
* @serial
*/
final float loadFactor;
/**
- * The number of times this HashMap has been structurally modified
- * Structural modifications are those that change the number of mappings in
- * the HashMap or otherwise modify its internal structure (e.g., rehash).
- * This field is used to make iterators on Collection-views of the HashMap
- * fail-fast. (See ConcurrentModificationException).
+ * The number of times this HashMap has been structurally modified Structural modifications are
+ * those that change the number of mappings in the HashMap or otherwise modify its internal
+ * structure (e.g., rehash). This field is used to make iterators on Collection-views of the
+ * HashMap fail-fast. (See ConcurrentModificationException).
*/
transient volatile int modCount;
/**
- * Constructs an empty <tt>HashMap</tt> with the specified initial
- * capacity and load factor.
- *
+ * Constructs an empty <tt>HashMap</tt> with the specified initial capacity and load factor.
+ *
* @param initialCapacity
* The initial capacity.
* @param loadFactor
* The load factor.
* @throws IllegalArgumentException
- * if the initial capacity is negative or the load factor is
- * nonpositive.
+ * if the initial capacity is negative or the load factor is nonpositive.
*/
public IntHashMap(int initialCapacity, float loadFactor)
{
@@ -132,9 +128,9 @@
}
/**
- * Constructs an empty <tt>HashMap</tt> with the specified initial
- * capacity and the default load factor (0.75).
- *
+ * Constructs an empty <tt>HashMap</tt> with the specified initial capacity and the default
+ * load factor (0.75).
+ *
* @param initialCapacity
* the initial capacity.
* @throws IllegalArgumentException
@@ -146,8 +142,8 @@
}
/**
- * Constructs an empty <tt>HashMap</tt> with the default initial capacity
- * (16) and the default load factor (0.75).
+ * Constructs an empty <tt>HashMap</tt> with the default initial capacity (16) and the default
+ * load factor (0.75).
*/
public IntHashMap()
{
@@ -160,11 +156,10 @@
// internal utilities
/**
- * Initialization hook for subclasses. This method is called in all
- * constructors and pseudo-constructors (clone, readObject) after HashMap
- * has been initialized but before any entries have been inserted. (In the
- * absence of this method, readObject would require explicit knowledge of
- * subclasses.)
+ * Initialization hook for subclasses. This method is called in all constructors and
+ * pseudo-constructors (clone, readObject) after HashMap has been initialized but before any
+ * entries have been inserted. (In the absence of this method, readObject would require explicit
+ * knowledge of subclasses.)
*/
void init()
{
@@ -172,7 +167,7 @@
/**
* Returns index for hash code h.
- *
+ *
* @param h
* @param length
* @return The index for the hash integer for the given length
@@ -184,7 +179,7 @@
/**
* Returns the number of key-value mappings in this map.
- *
+ *
* @return the number of key-value mappings in this map.
*/
public int size()
@@ -194,7 +189,7 @@
/**
* Returns <tt>true</tt> if this map contains no key-value mappings.
- *
+ *
* @return <tt>true</tt> if this map contains no key-value mappings.
*/
public boolean isEmpty()
@@ -203,17 +198,16 @@
}
/**
- * Returns the value to which the specified key is mapped in this identity
- * hash map, or <tt>null</tt> if the map contains no mapping for this key.
- * A return value of <tt>null</tt> does not <i>necessarily</i> indicate
- * that the map contains no mapping for the key; it is also possible that
- * the map explicitly maps the key to <tt>null</tt>. The
+ * Returns the value to which the specified key is mapped in this identity hash map, or
+ * <tt>null</tt> if the map contains no mapping for this key. A return value of <tt>null</tt>
+ * does not <i>necessarily</i> indicate that the map contains no mapping for the key; it is
+ * also possible that the map explicitly maps the key to <tt>null</tt>. The
* <tt>containsKey</tt> method may be used to distinguish these two cases.
- *
+ *
* @param key
* the key whose associated value is to be returned.
- * @return the value to which this map maps the specified key, or
- * <tt>null</tt> if the map contains no mapping for this key.
+ * @return the value to which this map maps the specified key, or <tt>null</tt> if the map
+ * contains no mapping for this key.
* @see #put(int, Object)
*/
public Object get(int key)
@@ -235,13 +229,11 @@
}
/**
- * Returns <tt>true</tt> if this map contains a mapping for the specified
- * key.
- *
+ * Returns <tt>true</tt> if this map contains a mapping for the specified key.
+ *
* @param key
* The key whose presence in this map is to be tested
- * @return <tt>true</tt> if this map contains a mapping for the specified
- * key.
+ * @return <tt>true</tt> if this map contains a mapping for the specified key.
*/
public boolean containsKey(int key)
{
@@ -259,9 +251,9 @@
}
/**
- * Returns the entry associated with the specified key in the HashMap.
- * Returns null if the HashMap contains no mapping for this key.
- *
+ * Returns the entry associated with the specified key in the HashMap. Returns null if the
+ * HashMap contains no mapping for this key.
+ *
* @param key
* @return The Entry object for the given hash key
*/
@@ -277,18 +269,16 @@
}
/**
- * Associates the specified value with the specified key in this map. If the
- * map previously contained a mapping for this key, the old value is
- * replaced.
- *
+ * Associates the specified value with the specified key in this map. If the map previously
+ * contained a mapping for this key, the old value is replaced.
+ *
* @param key
* key with which the specified value is to be associated.
* @param value
* value to be associated with the specified key.
- * @return previous value associated with specified key, or <tt>null</tt>
- * if there was no mapping for key. A <tt>null</tt> return can
- * also indicate that the HashMap previously associated
- * <tt>null</tt> with the specified key.
+ * @return previous value associated with specified key, or <tt>null</tt> if there was no
+ * mapping for key. A <tt>null</tt> return can also indicate that the HashMap
+ * previously associated <tt>null</tt> with the specified key.
*/
public Object put(int key, Object value)
{
@@ -310,10 +300,10 @@
}
/**
- * This method is used instead of put by constructors and pseudoconstructors
- * (clone, readObject). It does not resize the table, check for
- * comodification, etc. It calls createEntry rather than addEntry.
- *
+ * This method is used instead of put by constructors and pseudoconstructors (clone,
+ * readObject). It does not resize the table, check for comodification, etc. It calls
+ * createEntry rather than addEntry.
+ *
* @param key
* @param value
*/
@@ -322,9 +312,9 @@
int i = indexFor(key, table.length);
/**
- * Look for preexisting entry for key. This will never happen for clone
- * or deserialize. It will only happen for construction if the input Map
- * is a sorted map whose ordering is inconsistent w/ equals.
+ * Look for preexisting entry for key. This will never happen for clone or deserialize. It
+ * will only happen for construction if the input Map is a sorted map whose ordering is
+ * inconsistent w/ equals.
*/
for (Entry e = table[i]; e != null; e = e.next)
{
@@ -348,18 +338,15 @@
}
/**
- * Rehashes the contents of this map into a new array with a larger
- * capacity. This method is called automatically when the number of keys in
- * this map reaches its threshold.
- *
- * If current capacity is MAXIMUM_CAPACITY, this method does not resize the
- * map, but but sets threshold to Integer.MAX_VALUE. This has the effect of
- * preventing future calls.
- *
+ * Rehashes the contents of this map into a new array with a larger capacity. This method is
+ * called automatically when the number of keys in this map reaches its threshold.
+ *
+ * If current capacity is MAXIMUM_CAPACITY, this method does not resize the map, but but sets
+ * threshold to Integer.MAX_VALUE. This has the effect of preventing future calls.
+ *
* @param newCapacity
- * the new capacity, MUST be a power of two; must be greater than
- * current capacity unless current capacity is MAXIMUM_CAPACITY
- * (in which case value is irrelevant).
+ * the new capacity, MUST be a power of two; must be greater than current capacity
+ * unless current capacity is MAXIMUM_CAPACITY (in which case value is irrelevant).
*/
void resize(int newCapacity)
{
@@ -379,7 +366,7 @@
/**
* Transfer all entries from current table to newTable.
- *
+ *
* @param newTable
*/
void transfer(Entry[] newTable)
@@ -406,10 +393,9 @@
}
/**
- * Copies all of the mappings from the specified map to this map These
- * mappings will replace any mappings that this map had for any of the keys
- * currently in the specified map.
- *
+ * Copies all of the mappings from the specified map to this map These mappings will replace any
+ * mappings that this map had for any of the keys currently in the specified map.
+ *
* @param m
* mappings to be stored in this map.
* @throws NullPointerException
@@ -424,13 +410,11 @@
}
/*
- * Expand the map if the map if the number of mappings to be added is
- * greater than or equal to threshold. This is conservative; the obvious
- * condition is (m.size() + size) >= threshold, but this condition could
- * result in a map with twice the appropriate capacity, if the keys to
- * be added overlap with the keys already in this map. By using the
- * conservative calculation, we subject ourself to at most one extra
- * resize.
+ * Expand the map if the map if the number of mappings to be added is greater than or equal
+ * to threshold. This is conservative; the obvious condition is (m.size() + size) >=
+ * threshold, but this condition could result in a map with twice the appropriate capacity,
+ * if the keys to be added overlap with the keys already in this map. By using the
+ * conservative calculation, we subject ourself to at most one extra resize.
*/
if (numKeysToBeAdded > threshold)
{
@@ -459,13 +443,12 @@
/**
* Removes the mapping for this key from this map if present.
- *
+ *
* @param key
* key whose mapping is to be removed from the map.
- * @return previous value associated with specified key, or <tt>null</tt>
- * if there was no mapping for key. A <tt>null</tt> return can
- * also indicate that the map previously associated <tt>null</tt>
- * with the specified key.
+ * @return previous value associated with specified key, or <tt>null</tt> if there was no
+ * mapping for key. A <tt>null</tt> return can also indicate that the map previously
+ * associated <tt>null</tt> with the specified key.
*/
public Object remove(int key)
{
@@ -474,9 +457,9 @@
}
/**
- * Removes and returns the entry associated with the specified key in the
- * HashMap. Returns null if the HashMap contains no mapping for this key.
- *
+ * Removes and returns the entry associated with the specified key in the HashMap. Returns null
+ * if the HashMap contains no mapping for this key.
+ *
* @param key
* @return The Entry object that was removed
*/
@@ -512,7 +495,7 @@
/**
* Special version of remove for EntrySet.
- *
+ *
* @param o
* @return The entry that was removed
*/
@@ -568,13 +551,11 @@
}
/**
- * Returns <tt>true</tt> if this map maps one or more keys to the
- * specified value.
- *
+ * Returns <tt>true</tt> if this map maps one or more keys to the specified value.
+ *
* @param value
* value whose presence in this map is to be tested.
- * @return <tt>true</tt> if this map maps one or more keys to the
- * specified value.
+ * @return <tt>true</tt> if this map maps one or more keys to the specified value.
*/
public boolean containsValue(Object value)
{
@@ -599,7 +580,7 @@
/**
* Special-case code for containsValue with null argument
- *
+ *
* @return boolean true if there is a null value in this map
*/
private boolean containsNullValue()
@@ -619,9 +600,9 @@
}
/**
- * Returns a shallow copy of this <tt>HashMap</tt> instance: the keys and
- * values themselves are not cloned.
- *
+ * Returns a shallow copy of this <tt>HashMap</tt> instance: the keys and values themselves
+ * are not cloned.
+ *
* @return a shallow copy of this map.
*/
public Object clone() throws CloneNotSupportedException
@@ -655,7 +636,7 @@
/**
* Create new entry.
- *
+ *
* @param k
* @param v
* @param n
@@ -736,12 +717,11 @@
}
/**
- * Add a new entry with the specified key, value and hash code to the
- * specified bucket. It is the responsibility of this method to resize the
- * table if appropriate.
- *
+ * Add a new entry with the specified key, value and hash code to the specified bucket. It is
+ * the responsibility of this method to resize the table if appropriate.
+ *
* Subclass overrides this to alter the behavior of put method.
- *
+ *
* @param key
* @param value
* @param bucketIndex
@@ -756,13 +736,12 @@
}
/**
- * Like addEntry except that this version is used when creating entries as
- * part of Map construction or "pseudo-construction" (cloning,
- * deserialization). This version needn't worry about resizing the table.
- *
- * Subclass overrides this to alter the behavior of HashMap(Map), clone, and
- * readObject.
- *
+ * Like addEntry except that this version is used when creating entries as part of Map
+ * construction or "pseudo-construction" (cloning, deserialization). This version needn't worry
+ * about resizing the table.
+ *
+ * Subclass overrides this to alter the behavior of HashMap(Map), clone, and readObject.
+ *
* @param key
* @param value
* @param bucketIndex
@@ -790,7 +769,7 @@
{ // advance to first entry
while (i > 0 && (n = t[--i]) == null)
{
- /* NoOp*/ ;
+ /* NoOp */;
}
}
next = n;
@@ -904,14 +883,13 @@
private transient Set entrySet = null;
/**
- * Returns a set view of the keys contained in this map. The set is backed
- * by the map, so changes to the map are reflected in the set, and
- * vice-versa. The set supports element removal, which removes the
- * corresponding mapping from this map, via the <tt>Iterator.remove</tt>,
- * <tt>Set.remove</tt>, <tt>removeAll</tt>, <tt>retainAll</tt>, and
- * <tt>clear</tt> operations. It does not support the <tt>add</tt> or
- * <tt>addAll</tt> operations.
- *
+ * Returns a set view of the keys contained in this map. The set is backed by the map, so
+ * changes to the map are reflected in the set, and vice-versa. The set supports element
+ * removal, which removes the corresponding mapping from this map, via the
+ * <tt>Iterator.remove</tt>, <tt>Set.remove</tt>, <tt>removeAll</tt>,
+ * <tt>retainAll</tt>, and <tt>clear</tt> operations. It does not support the <tt>add</tt>
+ * or <tt>addAll</tt> operations.
+ *
* @return a set view of the keys contained in this map.
*/
public Set keySet()
@@ -972,15 +950,13 @@
}
/**
- * Returns a collection view of the values contained in this map. The
- * collection is backed by the map, so changes to the map are reflected in
- * the collection, and vice-versa. The collection supports element removal,
- * which removes the corresponding mapping from this map, via the
- * <tt>Iterator.remove</tt>, <tt>Collection.remove</tt>,
- * <tt>removeAll</tt>, <tt>retainAll</tt>, and <tt>clear</tt>
- * operations. It does not support the <tt>add</tt> or <tt>addAll</tt>
- * operations.
- *
+ * Returns a collection view of the values contained in this map. The collection is backed by
+ * the map, so changes to the map are reflected in the collection, and vice-versa. The
+ * collection supports element removal, which removes the corresponding mapping from this map,
+ * via the <tt>Iterator.remove</tt>, <tt>Collection.remove</tt>, <tt>removeAll</tt>,
+ * <tt>retainAll</tt>, and <tt>clear</tt> operations. It does not support the <tt>add</tt>
+ * or <tt>addAll</tt> operations.
+ *
* @return a collection view of the values contained in this map.
*/
public Collection values()
@@ -1025,16 +1001,14 @@
}
/**
- * Returns a collection view of the mappings contained in this map. Each
- * element in the returned collection is a <tt>Map.Entry</tt>. The
- * collection is backed by the map, so changes to the map are reflected in
- * the collection, and vice-versa. The collection supports element removal,
- * which removes the corresponding mapping from the map, via the
- * <tt>Iterator.remove</tt>, <tt>Collection.remove</tt>,
- * <tt>removeAll</tt>, <tt>retainAll</tt>, and <tt>clear</tt>
- * operations. It does not support the <tt>add</tt> or <tt>addAll</tt>
+ * Returns a collection view of the mappings contained in this map. Each element in the returned
+ * collection is a <tt>Map.Entry</tt>. The collection is backed by the map, so changes to the
+ * map are reflected in the collection, and vice-versa. The collection supports element removal,
+ * which removes the corresponding mapping from the map, via the <tt>Iterator.remove</tt>,
+ * <tt>Collection.remove</tt>, <tt>removeAll</tt>, <tt>retainAll</tt>, and
+ * <tt>clear</tt> operations. It does not support the <tt>add</tt> or <tt>addAll</tt>
* operations.
- *
+ *
* @return a collection view of the mappings contained in this map.
* @see Map.Entry
*/
@@ -1094,21 +1068,18 @@
}
/**
- * Save the state of the <tt>HashMap</tt> instance to a stream (i.e.,
- * serialize it).
- *
+ * Save the state of the <tt>HashMap</tt> instance to a stream (i.e., serialize it).
+ *
* @param s
* The ObjectOutputStream
* @throws IOException
- *
- * @serialData The <i>capacity</i> of the HashMap (the length of the bucket
- * array) is emitted (int), followed by the <i>size</i> of the
- * HashMap (the number of key-value mappings), followed by the
- * key (Object) and value (Object) for each key-value mapping
- * represented by the HashMap The key-value mappings are emitted
- * in the order that they are returned by
- * <tt>entrySet().iterator()</tt>.
- *
+ *
+ * @serialData The <i>capacity</i> of the HashMap (the length of the bucket array) is emitted
+ * (int), followed by the <i>size</i> of the HashMap (the number of key-value
+ * mappings), followed by the key (Object) and value (Object) for each key-value
+ * mapping represented by the HashMap The key-value mappings are emitted in the
+ * order that they are returned by <tt>entrySet().iterator()</tt>.
+ *
*/
private void writeObject(java.io.ObjectOutputStream s) throws IOException
{
@@ -1133,9 +1104,8 @@
private static final long serialVersionUID = 362498820763181265L;
/**
- * Reconstitute the <tt>HashMap</tt> instance from a stream (i.e.,
- * deserialize it).
- *
+ * Reconstitute the <tt>HashMap</tt> instance from a stream (i.e., deserialize it).
+ *
* @param s
* @throws IOException
* @throws ClassNotFoundException
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MicroMap.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MicroMap.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MicroMap.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MicroMap.java Mon Oct 15 14:21:25 2007
@@ -26,9 +26,9 @@
import java.util.Set;
/**
- * An implementation of the java.util.Map interface which can only hold a single
- * object. This is particularly useful to control memory usage in Wicket because
- * many containers hold only a single component.
+ * An implementation of the java.util.Map interface which can only hold a single object. This is
+ * particularly useful to control memory usage in Wicket because many containers hold only a single
+ * component.
*
* @author Jonathan Locke
*/
@@ -246,7 +246,8 @@
{
public Object get(final int index)
{
- if (index > size() - 1) {
+ if (index > size() - 1)
+ {
throw new IndexOutOfBoundsException();
}
return value;
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MiniMap.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MiniMap.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MiniMap.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MiniMap.java Mon Oct 15 14:21:25 2007
@@ -26,9 +26,8 @@
import java.util.Set;
/**
- * A fixed size map implementation. Holds an array of keys and array of values
- * which correspond by index. Null key entries are available for use. This means
- * that null is not a valid key.
+ * A fixed size map implementation. Holds an array of keys and array of values which correspond by
+ * index. Null key entries are available for use. This means that null is not a valid key.
*
* @author Jonathan Locke
*/
@@ -365,8 +364,7 @@
}
/**
- * Computes the next index in the key or value array (both are the same
- * length)
+ * Computes the next index in the key or value array (both are the same length)
*
* @param index
* The index
@@ -378,8 +376,7 @@
}
/**
- * Finds the index of the next non-null key. If the map is empty, -1 will be
- * returned.
+ * Finds the index of the next non-null key. If the map is empty, -1 will be returned.
*
* @param start
* Index to start at
@@ -404,8 +401,8 @@
}
/**
- * Finds the index of the next null key. If no null key can be found, the
- * map is full and -1 will be returned.
+ * Finds the index of the next null key. If no null key can be found, the map is full and -1
+ * will be returned.
*
* @param start
* Index to start at
@@ -430,9 +427,9 @@
}
/**
- * Finds a key by starting at lastSearchIndex and searching from there. If
- * the key is found, lastSearchIndex is advanced so the next key search can
- * find the next key in the array, which is the most likely to be retrieved.
+ * Finds a key by starting at lastSearchIndex and searching from there. If the key is found,
+ * lastSearchIndex is advanced so the next key search can find the next key in the array, which
+ * is the most likely to be retrieved.
*
* @param key
* Key to find in map
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MostRecentlyUsedMap.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MostRecentlyUsedMap.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MostRecentlyUsedMap.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/MostRecentlyUsedMap.java Mon Oct 15 14:21:25 2007
@@ -20,8 +20,8 @@
import java.util.Map;
/**
- * Holds a map of most recently used items of a given maximum size. Old entries
- * are expired when the map exceeds that maximum size.
+ * Holds a map of most recently used items of a given maximum size. Old entries are expired when the
+ * map exceeds that maximum size.
*
* @author Jonathan Locke
*/
@@ -31,13 +31,13 @@
/** Value most recently removed from map */
Object removedValue;
-
+
/** Maximum number of entries allowed in this map */
private final int maxEntries;
/**
* Constructor
- *
+ *
* @param maxEntries
* Maximum number of entries allowed in the map
*/
@@ -49,10 +49,10 @@
{
throw new IllegalArgumentException("Must have at least one entry");
}
-
+
this.maxEntries = maxEntries;
}
-
+
/**
* @return Returns the removedValue.
*/
@@ -60,7 +60,7 @@
{
return removedValue;
}
-
+
/**
* @see java.util.LinkedHashMap#removeEldestEntry(java.util.Map.Entry)
*/
Modified: wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ReadOnlyIterator.java
URL: http://svn.apache.org/viewvc/wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ReadOnlyIterator.java?rev=584925&r1=584924&r2=584925&view=diff
==============================================================================
--- wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ReadOnlyIterator.java (original)
+++ wicket/trunk/jdk-1.4/wicket/src/main/java/org/apache/wicket/util/collections/ReadOnlyIterator.java Mon Oct 15 14:21:25 2007
@@ -19,8 +19,8 @@
import java.util.Iterator;
/**
- * Base class for read-only iterators. Calls to {@link #remove()} will result in
- * an {@link UnsupportedOperationException}
+ * Base class for read-only iterators. Calls to {@link #remove()} will result in an
+ * {@link UnsupportedOperationException}
*
* @author Igor Vaynberg (ivaynberg)
*/
@@ -28,7 +28,7 @@
{
public final void remove()
{
- throw new UnsupportedOperationException("Iterator " + getClass().getName()
- + " is a read-only iterator. Calls to remove() are not allowed");
+ throw new UnsupportedOperationException("Iterator " + getClass().getName() +
+ " is a read-only iterator. Calls to remove() are not allowed");
}
}