You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by hl...@apache.org on 2015/04/06 21:20:20 UTC
[5/9] tapestry-5 git commit: Clean up markup inside JavaDoc to
confirm to JDK 1.8's stricter rules
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetFactory.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetFactory.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetFactory.java
index a06dc5a..faf8f35 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetFactory.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetFactory.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 2013 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -19,16 +17,16 @@ import org.apache.tapestry5.ioc.Resource;
/**
* Used by {@link AssetSource} to create new {@link Asset}s as needed.
- * <p/>
+ *
* Starting in Tapestry 5.4, the built-in implementations of this interface (for context assets, and for classpath assets)
* were changed so that when underlying resources changed, the client URLs for Assets are discarded; this is necessitated by two factors:
- * <p/>1) the {@linkplain org.apache.tapestry5.Asset#toClientURL() client URL}
+ * 1) the {@linkplain org.apache.tapestry5.Asset#toClientURL() client URL}
* for an Asset now includes a checksum based on the content of the underlying resource, so a change to resource content
* (during development) results in a change to the URL.
- * <p/>2) {@link org.apache.tapestry5.services.javascript.JavaScriptStack} (especially the {@link org.apache.tapestry5.services.javascript.ExtensibleJavaScriptStack} implementation)
+ * 2) {@link org.apache.tapestry5.services.javascript.JavaScriptStack} (especially the {@link org.apache.tapestry5.services.javascript.ExtensibleJavaScriptStack} implementation)
* made no provision for rebuilding the Assets post-construction, and there is no backwards compatible way to
* introduce this concept (and JavaScriptStacks are something many applications and third-party libraries make use of).
- * <p/>So, starting in Tapestry 5.4, the implementations of {@link Asset} should be
+ * So, starting in Tapestry 5.4, the implementations of {@link Asset} should be
*
* @see org.apache.tapestry5.services.AssetSource
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetPathConverter.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetPathConverter.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetPathConverter.java
index 6fbb3e6..8040612 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetPathConverter.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetPathConverter.java
@@ -1,5 +1,3 @@
-// Copyright 2009, 2013 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -18,7 +16,7 @@ package org.apache.tapestry5.services;
* Converts the {@linkplain org.apache.tapestry5.Asset#toClientURL() path (or URI) of an asset} into a new format. This
* is the <em>hook</em> needed to make use of a <a href="http://en.wikipedia.org/wiki/Content_Delivery_Network">Content
* Delivery Network</a>.
- * <p/>
+ *
* The default implementation of this is <em>identity</em>, the URI is passed through unchanged. Using a contribution to
* the {@link org.apache.tapestry5.ioc.services.ServiceOverride} service, you may override the default implementation.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetSource.java
index 111b2f9..df82262 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/AssetSource.java
@@ -23,11 +23,11 @@ import java.util.Locale;
/**
* Used to find or create an {@link org.apache.tapestry5.Asset} with a given path.
- * <p/>
+ *
* Assets are defined with a domain, and the domain is indicated by a prefix. The two builtin domains are "context:"
* (for files inside the web application context) and "classpath:" for files stored on the classpath (typically, inside
* a JAR, such as a component library). Other domains can be defined via contributions to the AssetSource service.
- * <p/>
+ *
* Since 5.1.0.0, is is preferred that
* {@link org.apache.tapestry5.services.AssetFactory#createAsset(org.apache.tapestry5.ioc.Resource)} return an instance
* of {@link org.apache.tapestry5.Asset2}.
@@ -40,7 +40,7 @@ public interface AssetSource
* <em>or</em> it may have a prefix, such as "context:" or "classpath:", in which case it is treated as a complete
* path within the indicated domain. The resulting Resource is then localized (to the provided Locale) and returned
* as an Asset.
- * <p/>
+ *
* The AssetSource caches its results, so a single Asset instance may be shared among many different components.
*
* @param baseResource
@@ -129,7 +129,7 @@ public interface AssetSource
* This is the preferred location in 5.4, with compatibility for 5.3 that allows assets to be stored on the classpath
* alongside Java classes and server-only resources such as templates and message catalogs.
*
- * <p/>
+ *
* When resolving a resource in a component that is subclass, the point of injection is the class which contains
* the injecting annotation (e.g., {@link org.apache.tapestry5.ioc.annotations.Inject} with {@link org.apache.tapestry5.annotations.Path},
* or {@link org.apache.tapestry5.annotations.Import}). In other words, the library name for the library containing the class,
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockOverrideSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockOverrideSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockOverrideSource.java
index 887a611..1057b3d 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockOverrideSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockOverrideSource.java
@@ -1,5 +1,3 @@
-// Copyright 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -31,7 +29,7 @@ public interface BeanBlockOverrideSource
*
* @param datatype logical name for the type of data to be displayed
* @return the Block
- * @throws null if no override is available
+ * @throws NullPointerException if no override is available
*/
Block getEditBlock(String datatype);
@@ -40,7 +38,7 @@ public interface BeanBlockOverrideSource
*
* @param datatype logical name for the type of data to be displayed
* @return the Block
- * @throws null if no override is available
+ * @throws NullPointerException if no override is available
*/
Block getDisplayBlock(String datatype);
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockSource.java
index 3de8743..b921456 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/BeanBlockSource.java
@@ -1,5 +1,3 @@
-// Copyright 2007-2013 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -22,10 +20,10 @@ import org.apache.tapestry5.ioc.annotations.UsesConfiguration;
* org.apache.tapestry5.corelib.components.Grid} component), or to edit the properties of a bean (used by the {@link
* org.apache.tapestry5.corelib.components.BeanEditForm} component). Contributions to this service (a configuration of
* {@link BeanBlockContribution}s) define what properties may be editted.
- * <p/>
+ *
* Blocks are accessed in terms of a <strong>data type</strong> a string that identifies the type of data to be editted,
* such as "string", "date", "boolean", etc.
- * <p/>
+ *
* Tapestry contributes a number of default data types and corresponding edit and display blocks. The {@link
* org.apache.tapestry5.services.BeanBlockOverrideSource} service allows these to be overridden.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingFactory.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingFactory.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingFactory.java
index 13c27e8..e7f336a 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingFactory.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingFactory.java
@@ -1,5 +1,3 @@
-// Copyright 2006 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -26,7 +24,7 @@ public interface BindingFactory
{
/**
* Creates a new binding instance.
- * <p/>
+ *
* The binding represents a connection between the container and the component (the component is usually the child
* of the component, though in a few cases, it is the component itself). In most cases, the expression is evaluated
* in terms of the resources of the <em>container</em> and the component is ignored.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingSource.java
index 2bc6fd2..6049584 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/BindingSource.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -31,7 +29,7 @@ public interface BindingSource
* BindingFactory}, which receives the description, the expression (after the prefix), and the location. If the
* prefix doesn't exist, or if there's no prefix, then the factory for the default prefix (often "literal") is used
* (and passed the full prefix).
- * <p/>
+ *
* The binding represents a connection between the container and the component (the component is usually the child
* of the container, though in a few cases, it is the component itself). In most cases, the expression is evaluated
* in terms of the resources of the <em>container</em> and the component is ignored.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ClasspathAssetAliasManager.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ClasspathAssetAliasManager.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ClasspathAssetAliasManager.java
index b540780..ac777f4 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ClasspathAssetAliasManager.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ClasspathAssetAliasManager.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008, 2010, 2011, 2013 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -26,19 +24,19 @@ import java.util.Map;
* {@link org.apache.tapestry5.ioc.Resource} to a URL that can be accessed by the client. The asset path, within the
* classpath, is converted into a shorter virtual path. The term "alias" here is generally referred to as
* "virtual folder" elsewhere.
- * <p/>
+ *
* Service configuration is a map from folder aliases (short names) to complete paths. Names should not start or end end
* with a slash. Generally, an alias should be a single name (not contain a slash). Paths should also not start or end
* with a slash. An example mapping would be <code>mylib</code> to <code>com/example/mylib</code>.
- * <p/>
+ *
* As originally envisioned, this service would simply <em>optimize</em> classpath assets, allowing the URL path for
* such assets to be shortened (and have a version number added, important for caching); thus the word "alias" makes
* sense ... it was responsible for creating an "alias" URL shorter than the default "classpath" URL.
- * <p/>
+ *
* Starting in Tapestry 5.2, this changed; all classpath assets <strong>must</strong> be "aliased" to a shorter URL
* path. Any URL that can not be shortened is now rejected. This simplifies creating new libraries, but also helps with
* security concerns, as it limits which portions of the classpath can <em>ever</em> be exposed to the user agent.
- * <p/>
+ *
* Tapestry automatically contributes a number of mappings: for the application root package itself (as alias "app") and
* for each library (via {@link ComponentClassResolver#getFolderToPackageMapping()});
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientBehaviorSupport.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientBehaviorSupport.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientBehaviorSupport.java
index eb78d4c..22e5bc0 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientBehaviorSupport.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientBehaviorSupport.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008, 2009, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,7 +19,7 @@ import org.apache.tapestry5.corelib.data.InsertPosition;
/**
* Collects details about zone usage for efficient initialization of the client side objects. This has grown to include
* the client-side behavior associated with {@link org.apache.tapestry5.corelib.components.FormFragment}s.
- * <p/>
+ *
* This interface is only kept for binary compatibility in Tapestry 5.4; the implementation no longer does anything but
* throw exceptions and will be removed in 5.5.
*
@@ -48,7 +46,7 @@ public interface ClientBehaviorSupport
/**
* Sets the client-side onclick handler for an <a> element to perform an Ajax update of a zone.
- * <p/>
+ *
* Starting in Tapestry 5.4, this can be accomplished by adding a "data-update-zone" attribute
* to the element. The attribute value may be {@code ^} or the id of the zone's client element.
*
@@ -95,7 +93,7 @@ public interface ClientBehaviorSupport
/**
* Adds a new client-side Tapestry.FormFragment object. FormFragment's are used to make parts of a client-side form
* visible or invisible, which involves interactions with both the server-side and client-side validation.
- * <p/>
+ *
* <strong>This implementation has been removed in 5.4; it throws an {@link UnsupportedOperationException}.</strong>
*
* @param clientId
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientDataEncoder.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientDataEncoder.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientDataEncoder.java
index 89ac933..9774989 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientDataEncoder.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ClientDataEncoder.java
@@ -1,5 +1,3 @@
-// Copyright 2009, 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,7 +19,7 @@ import java.io.ObjectInputStream;
* A service used when a component or service needs to encode some amount of data on the client as a string. The string
* may be a query parameter, hidden form field, or a portion of a URL. The default implementation converts the object
* output stream into a Base64 string.
- * <p/>
+ *
* Starting in release 5.3.6, the encoded data incorporates an HMAC (hash based message authentication code) signature,
* as a prefix. HMAC requires a secret key, configured using the
* {@link org.apache.tapestry5.SymbolConstants#HMAC_PASSPHRASE} symbol.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentClassResolver.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentClassResolver.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentClassResolver.java
index 15fedf7..de77c43 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentClassResolver.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentClassResolver.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 2009, 2010, 2011, 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -28,14 +26,14 @@ import java.util.Map;
* Resolves page names and component types to fully qualified class names. Pages and components may be provided by the
* application or inside a <em>mapped package</em>. Page names often appear inside URLs, and component types often
* appear in component templates (when specifying the type of an embedded component).
- * <p/>
+ *
* The service is configured using a collection of {@link LibraryMapping}s. Each mapping maps a prefix, such as "core"
* to a root package name, such as "org.apache.tapestry5.corelib". The root package is expected to have sub-packages:
* "pages", "components", "mixins" and "base" ("base" is for base classes).
- * <p/>
+ *
* The resolver performs a search of the classpath (via {@link ClassNameLocator}), to build up a set of case-insensitive
* maps from logical page name, component type, or mixin type to fully qualified class name.
- * <p/>
+ *
* Certain ambiguities occur if mapped packages overlap, either in terms of the the prefixes or the package names. Keep
* things clearly separate to avoid lookup problems.
*/
@@ -130,7 +128,7 @@ public interface ComponentClassResolver
/**
* A mapping from virtual folder name to a package name (used for converting classpath {@link Asset}s
* to client URLs). This is derived from the contributed {@link LibraryMapping}s.
- * <p/>
+ *
* It is allowed to contribute multiple root packages as a single folder name. In this case, the best common package
* name is used. For example, if both <code>com.example.main</code> and <code>com.example.extras</code> is mapped to
* folder "example", then the package mapping for "example" will be <code>com.example</code>.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventLinkEncoder.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventLinkEncoder.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventLinkEncoder.java
index 7113e67..c2c491e 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventLinkEncoder.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventLinkEncoder.java
@@ -1,5 +1,3 @@
-// Copyright 2009, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -42,7 +40,7 @@ public interface ComponentEventLinkEncoder
/**
* Creates a link that encapsulates a component event request, including <em>{@link
* org.apache.tapestry5.services.PersistentLocale} (if set)</em>.
- * <p>
+ *
* Forms:
* <ul>
* <li>/context/pagename:eventname -- event on the page, no action context</li>
@@ -53,15 +51,15 @@ public interface ComponentEventLinkEncoder
* <li>/context/pagename.bar.baz:eventname/foo/gnu -- event on component bar.baz within the page with action context
* "foo" , "gnu"</li>
* </ul>
- * <p/>
+ *
* The persistent locale may be placed in between the context name and the page name, i.e., "/context/fr/SomePage".
- * <p/>
+ *
* In many cases the context name is blank, so the path begins with a "/" and then the locale name or page name.
- * <p/>
+ *
* The page name portion may itself consist of a series of folder names, i.e., "admin/user/create". The context
* portion isn't the concern of this code, since {@link org.apache.tapestry5.services.Request#getPath()} will
* already have stripped that off. We can act as if the context is always "/" (the path always starts with a slash).
- * <p/>
+ *
* Passes the resulting Link through the {@link ComponentEventLinkTransformer} chain of command, returning the
* result.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventRequestHandler.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventRequestHandler.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventRequestHandler.java
index 9ae643d..c24efe4 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventRequestHandler.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventRequestHandler.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -22,11 +20,11 @@ import java.io.IOException;
* Handler interface for component event requests. Component event requests <em>do things</em> such as process a form
* submission or otherwise change state. In the majority of cases, after the component event, a redirect response is
* sent to the client which, in turn, causes a page render.
- * <p/>
+ *
* The ComponentEventRequestHandler service is a pipeline, allowing extensibility via contributed {@linkplain
* org.apache.tapestry5.services.ComponentEventRequestFilter filters}. It may be distinguished by the @{@link
* org.apache.tapestry5.services.Traditional} marker annotation.
- * <p/>
+ *
* A second service, AjaxComponentEventRequestHandler is also a pipeline and may be distinguished by the @{@link
* org.apache.tapestry5.services.Ajax} marker annotation.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventResultProcessor.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventResultProcessor.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventResultProcessor.java
index c43b2d9..5505ff9 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventResultProcessor.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentEventResultProcessor.java
@@ -1,5 +1,3 @@
-// Copyright 200-2014 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import java.io.IOException;
/**
* Responsible for handling the return value provided by a component event handler method.
- * <p/>
+ *
* There are two services built into Tapestry that implement this interface: ComponentEventResultProcessor (used for
* ordinary page-oriented requests, and distinguished by the @{@link org.apache.tapestry5.services.Traditional}
* and/or @{@link org.apache.tapestry5.ioc.annotations.Primary} marker annotations) and
@@ -35,7 +33,7 @@ public interface ComponentEventResultProcessor<T>
{
/**
* For a given, non-null return value from a component event method, construct and send a response.
- * <p/>
+ *
* Starting in release 5.4, it is recommended that for any response that involves Tapestry pages or components,
* the implementation should create an {@link org.apache.tapestry5.ioc.IOOperation} to do the rendering, and
* add the operation to the {@link org.apache.tapestry5.services.Request} as attribute
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentOverride.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentOverride.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentOverride.java
index cbbbf98..4e650e6 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentOverride.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ComponentOverride.java
@@ -23,7 +23,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
* replaced, the value is the replacement.
*
* @since 5.4
- * @see org.apache.tapestry5.services.ComponentClassResolver.
+ * @see org.apache.tapestry5.services.ComponentClassResolver
*/
@UsesMappedConfiguration(key = Class.class, value = Class.class)
public interface ComponentOverride
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/Environment.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/Environment.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/Environment.java
index be00050..6672458 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/Environment.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/Environment.java
@@ -1,5 +1,3 @@
-// Copyright 2006-2014 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -19,7 +17,7 @@ import java.util.NoSuchElementException;
/**
* Provides access to environment objects, which are almost always provided to enclosed components by enclosing
* components. Environmental services are a form of very late binding.
- * <p/>
+ *
* The Environment acts like a collection of stacks. Each stack contains environmental objects of a given type. Most
* often, a stack has zero or one elements, but on occasion, a particular component will push an override onto the stack
* for the benefit of the components it encloses.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ExceptionReporter.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ExceptionReporter.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ExceptionReporter.java
index 070aa84..7fe2261 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ExceptionReporter.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ExceptionReporter.java
@@ -14,13 +14,13 @@ package org.apache.tapestry5.services;
/**
* Interface implemented by a page used for reporting exceptions.
- * <p/>
+ *
* Alternately, implemented by services to report request handling exceptions. This is invoked <em>before</em> the exception report page is rendered.
* The default implementation converts the exception into a well formatted text file, with content similar to the default
* {@link org.apache.tapestry5.corelib.pages.ExceptionReport} page, and stores this file on the file system.
- * <p/>
+ *
* Exception report files are stored beneath a root directory, with intermediate folders for the day (e.g., "2014-06-02"), hour, and minute.
- * <p/>
+ *
* Directories are created as necessary; however, there is nothing in place to delete these exceptions reports.
*
* @see org.apache.tapestry5.SymbolConstants#EXCEPTION_REPORTS_DIR
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/FieldValidatorSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/FieldValidatorSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/FieldValidatorSource.java
index 4ea3ede..ffd4582 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/FieldValidatorSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/FieldValidatorSource.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008, 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -33,7 +31,7 @@ public interface FieldValidatorSource
/**
* Creates the validator. The error message associated with the field validator usually comes from the
* global message catalog (using the validator's {@link Validator#getMessageKey() message key}). However,
- * if the container component of the field defines a message key <code><i>id</i>-<i>validator</i> (where id is the simple
+ * if the container component of the field defines a message key <code><i>id</i>-<i>validator</i></code> (where id is the simple
* id of the field component, and validator is the validatorType), then that message is used instead. This allows
* you to override the message for a particular validation of a particular field.
*
@@ -50,7 +48,7 @@ public interface FieldValidatorSource
/**
* Full featured version of {@link #createValidator(Field, String, String)} used in situations where the container
- * of the field is not necesarrilly the place to look for override messages, and the id of the field is not the key
+ * of the field is not necessarily the place to look for override messages, and the id of the field is not the key
* to use when checking. The {@link BeanEditForm} is an example of this.
*
* @param field
@@ -76,7 +74,7 @@ public interface FieldValidatorSource
/**
* Creates a set of validators. The specification is a string used to identify and configure the individual
* validators. The specification is a comma-separated list of terms. Each term is a validator type name and an
- * optional constraint value (seperated by an equals sign).
+ * optional constraint value (separated by an equals sign).
*
* @param field
* @param specification
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/Heartbeat.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/Heartbeat.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/Heartbeat.java
index f3db6a1..cb7046a 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/Heartbeat.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/Heartbeat.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,7 +19,7 @@ import org.apache.tapestry5.annotations.HeartbeatDeferred;
* component may add a command to be executed "{@linkplain #end() at the end of the heartbeat}". The classic example of
* this is a Label and the field it labels; since we don't know which order the two will render, we can't tell if the
* field's id is correct until after both have rendered.
- * <p/>
+ *
* The Heartbeat is injected into components via the {@link org.apache.tapestry5.annotations.Environmental} annotation.
*/
public interface Heartbeat
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/HiddenFieldLocationRules.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/HiddenFieldLocationRules.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/HiddenFieldLocationRules.java
index 092d016..30692a2 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/HiddenFieldLocationRules.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/HiddenFieldLocationRules.java
@@ -1,5 +1,3 @@
-// Copyright 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -19,7 +17,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* Provides some assistance in determining <em>where</em> to place a hidden field based on standard (X)HTML elements.
- * <p/>
+ *
* The service works based on a mapped service contribution; keys are the element names, values area {@link
* org.apache.tapestry5.services.RelativeElementPosition}.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/LibraryMapping.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/LibraryMapping.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/LibraryMapping.java
index f1cfc5f..6794bdc 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/LibraryMapping.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/LibraryMapping.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2010, 2011, 2012, 2014 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -18,7 +16,7 @@ import org.apache.tapestry5.ioc.internal.util.InternalUtils;
/**
* Used to configure the {@link ComponentClassResolver}, to allow it to map library names to library root packages (the
* application namespace is a special case of this). In each case, a prefix on the path is mapped to a package.
- * <p/>
+ *
* The root package name should have a number of sub-packages:
* <dl>
* <dt>pages</dt>
@@ -30,7 +28,7 @@ import org.apache.tapestry5.ioc.internal.util.InternalUtils;
* <dt>base</dt>
* <dd>contains base classes</dd>
* </dl>
- * <p>
+ *
* @see ComponentLibraryInfo
*/
public final class LibraryMapping
@@ -40,13 +38,13 @@ public final class LibraryMapping
/**
* Identifies the root package of a library. The application has uses the library name "" (the empty string).
* The special library "core" is all the built-in components.
- * <p/>
+ *
* The library name is sometimes referred to as the "path prefix" or the "virtual folder name". This is for historical
* reasons, as the concept of a library and how it was defined and managed evolved from release to release.
- * <p/>
+ *
* The library name should be alpha numeric, and directly encodable into a URL. It may contain slashes (though this is not
* used often), but may not start or end with one.
- * <p/>
+ *
* Note that it <em>is</em> allowed to contribute multiple LibraryMappings with the library name to the
* {@link ComponentClassResolver}, and the results are merged: the single library will have multiple root packages.
* Be careful that <em>none</em> of the root packages overlap!
@@ -75,7 +73,7 @@ public final class LibraryMapping
* Returns the library name; the method is oddly named for historical reasons. The library name is sometimes
* referred to as the virtual folder name.
*
- * @deprecated In 5.4, use {@link #getLibraryName()} instead.
+ * @deprecated In 5.4, use {@link #libraryName} instead.
*/
public String getPathPrefix()
{
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/LocalizationSetter.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/LocalizationSetter.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/LocalizationSetter.java
index 5cee327..0555cd7 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/LocalizationSetter.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/LocalizationSetter.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2009, 2010, 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,16 +12,16 @@
package org.apache.tapestry5.services;
-import java.util.List;
-import java.util.Locale;
-
import org.apache.tapestry5.SelectModel;
import org.apache.tapestry5.ioc.annotations.IncompatibleChange;
+import java.util.List;
+import java.util.Locale;
+
/**
* Sets the thread's locale given a desired locale. Note that the desired locale is just a hint. It will try to honor it
* but there is no guarantee that it will be used as is.
- * <p/>
+ *
* Localization is controlled by the {@link org.apache.tapestry5.SymbolConstants#SUPPORTED_LOCALES} symbol.
*/
public interface LocalizationSetter
@@ -34,7 +32,7 @@ public interface LocalizationSetter
* to the provided locale, if supported, or to the default locale). If the locale name is supported, it will also
* set the {@link org.apache.tapestry5.services.PersistentLocale} (which may affect how page and event links are
* generated, to persist the selected locale across requests).
- * <p/>
+ *
* Note that locale names <strong>are</strong> case sensitive.
*
* @param localeName
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/MarkupRenderer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/MarkupRenderer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/MarkupRenderer.java
index b58a26e..5b91893 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/MarkupRenderer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/MarkupRenderer.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008, 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import org.apache.tapestry5.ioc.annotations.UsesOrderedConfiguration;
/**
* An object which will perform rendering of a page (or portion of a page). This interface exists to be filtered via
* {@link org.apache.tapestry5.services.MarkupRendererFilter}.
- * <p/>
+ *
* The MarkupRenderer service takes an ordered configuration of {@link org.apache.tapestry5.services.MarkupRendererFilter}s,
* which are used for ordinary page rendering (as opposed to {@linkplain org.apache.tapestry5.services.PartialMarkupRenderer
* partial page rendering} for Ajax requests). The MarkupRenderer service may be selected using the
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/MetaDataLocator.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/MetaDataLocator.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/MetaDataLocator.java
index 3a57b1a..f08e98d 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/MetaDataLocator.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/MetaDataLocator.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008, 2009, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -24,7 +22,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
* containment hierarchy (to the component's container, and the container's container, and so on). If <em>that</em>
* proves unfruitful, a system of defaults is provided by configuration and matched against the containing page's
* logical name.
- * <p/>
+ *
* Finally, if no metadata is available, then {@link org.apache.tapestry5.ioc.services.SymbolSource#valueForSymbol(String)}
* is used to obtain a value. Generally speaking, if you are going to use this service to look up meta data, your should
* also make a contribution to the FactoryDefaults service; otherwise, you risk a runtime exception if a meta-data key
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ObjectRenderer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ObjectRenderer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ObjectRenderer.java
index ad40d82..711970d 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ObjectRenderer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ObjectRenderer.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* A strategy interface used for converting an object into markup that describes that object. This is primarily used in
* terms of an {@link org.apache.tapestry5.services.ExceptionReporter} page.
- * <p/>
+ *
* The ObjectRenderer service (distinguished by the @{@link org.apache.tapestry5.ioc.annotations.Primary} marker
* annotation) uses {@linkplain org.apache.tapestry5.ioc.services.StrategyBuilder type-based matching} to find a
* specific ObjectRenderer for any given type.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/PageRenderRequestHandler.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/PageRenderRequestHandler.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/PageRenderRequestHandler.java
index 6ca2e41..7407170 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/PageRenderRequestHandler.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/PageRenderRequestHandler.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import java.io.IOException;
/**
* Handles a invocation related to rendering out a pages complete content.
- * <p/>
+ *
* The PageRenderRequestHandler service is an extensible {@linkplain org.apache.tapestry5.ioc.services.PipelineBuilder
* pipeline}.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialMarkupRenderer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialMarkupRenderer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialMarkupRenderer.java
index 3be19da..e850815 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialMarkupRenderer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialMarkupRenderer.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -22,8 +20,8 @@ import org.apache.tapestry5.json.JSONObject;
* Defines an Ajax-oriented partial page render, wherein a render of a portion of a page occurs, and the content is
* stored into a key ("content") of a {@link org.apache.tapestry5.json.JSONObject}, which is sent to the client side as
* the final response. Client-side JavaScript receives this reply and uses it to update a portion of the page.
- * <p/>
- * <p/>
+ *
+ *
* The PartialMarkupRenderer service takes an ordered configuration of {@link PartialMarkupRendererFilter}s. It can be
* selected using the {@link org.apache.tapestry5.ioc.annotations.Primary} marker annotation.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialTemplateRenderer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialTemplateRenderer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialTemplateRenderer.java
index e4a595a..dd179a9 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialTemplateRenderer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/PartialTemplateRenderer.java
@@ -1,5 +1,3 @@
-// Copyright 2014, The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -16,38 +14,36 @@ package org.apache.tapestry5.services;
import org.apache.tapestry5.Block;
import org.apache.tapestry5.alerts.Alert;
import org.apache.tapestry5.dom.Document;
-import org.apache.tapestry5.dom.Element;
import org.apache.tapestry5.ioc.services.TypeCoercer;
import org.apache.tapestry5.runtime.RenderCommand;
/**
- * <p>
- * Service that provides methods that render {@link Block}s (<code><t:block>>)</code>,
+ *
+ * Service that provides methods that render {@link Block}s ({@code <t:block>} in the template),
* component instances and {@link RenderCommand}s to a {@link String} or
* {@link Document org.apache.tapestry5.dom.Document} in a programatic way.
- * </p>
- * <p>
+ *
+ *
* This service was created for situations in which a page or component needs to generate some markup
* that wouldn't be rendered normally, but for external use, such as e-mails, returning
* HTML for AJAX requests or passing HTML instead of plain string for an {@link Alert}.
- * </p>
- * <p>
+ *
+ *
* The name of this interface comes from <a href="https://issues.apache.org/jira/browse/TAP5-938">TAP5-938</a>:
* <em>Expose ability to render a portion of a page (a Block, Component, etc.) without using internal services</em>.
- * </p>
+ *
* @since 5.4
*/
public interface PartialTemplateRenderer
{
-
/**
- * <p>
+ *
* Renders an object, probably a {@link Block} or component instance, to a string.
* This method supposes any kind of initialization needed
* was already done. CSS and JavaScript inclusions or importings are ignored.
* The object must implement {@link RenderCommand} or being able to be coerced to it
* by {@link TypeCoercer}.
- * <p>
+ *
* @param object an object, probably a {@link Block} or component instance or {@link RenderCommand}.
* @throws IllegalArgumentException if the object isn't a {@link RenderCommand} and cannot be coerced to it by {@link TypeCoercer}.
*/
@@ -58,7 +54,7 @@ public interface PartialTemplateRenderer
* This method supposes any kind of initialization needed
* was already done. CSS and JavaScript inclusions or importings are ignored.
*
- * @param renderCommand a {@link RenderCommand}.
+ * @param object to render, a {@link RenderCommand}, or {@linkplain TypeCoercer coercible} to one
* @return a {@link Document}.
*/
Document renderAsDocument(Object object);
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/Request.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/Request.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/Request.java
index e2f7ee2..7166264 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/Request.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/Request.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 2011, 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import java.util.Locale;
/**
* Generic version of {@link javax.servlet.http.HttpServletRequest}, used to encapsulate the Servlet API version, and to
* help bridge the differences between Servlet API and Porlet API.
- * <p/>
+ *
* The Request service is a {@linkplain org.apache.tapestry5.ioc.services.PropertyShadowBuilder shadow} of the current
* thread's request.
*/
@@ -81,10 +79,10 @@ public interface Request
* Returns the value of the specified request header as a <code>long</code> value that represents a
* <code>Date</code> object. Use this method with headers that contain dates, such as <code>If-Modified-Since</code>
* .
- * <p/>
+ *
* The date is returned as the number of milliseconds since January 1, 1970 GMT. The header name is case
* insensitive.
- * <p/>
+ *
* If the request did not have a header of the specified name, this method returns -1. If the header can't be
* converted to a date, the method throws an <code>IllegalArgumentException</code>.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/RequestExceptionHandler.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/RequestExceptionHandler.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/RequestExceptionHandler.java
index 3d63bf8..df4fe79 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/RequestExceptionHandler.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/RequestExceptionHandler.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -23,10 +21,10 @@ import java.io.IOException;
public interface RequestExceptionHandler
{
/**
- * Reponsible for handling the error <em>in some way</em> and providing <em>some response</em> to the client. A
+ * Responsible for handling the error <em>in some way</em> and providing <em>some response</em> to the client. A
* default implementation may render an error response page.
- * <p/>
- * <p/>
+ *
+ *
* The handler is also responsible for setting the response status and the X-Tapestry-ErrorMessage response header.
* These are very important in Ajax requests to allow the client-side logic to detect the error and present it to
* the user.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ResourceDigestGenerator.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ResourceDigestGenerator.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ResourceDigestGenerator.java
index c1f1477..ed28b38 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ResourceDigestGenerator.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ResourceDigestGenerator.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,7 +19,7 @@ import java.net.URL;
/**
* Responsible for determining which classpath resources require checksums, and for generating checksums for such
* resources.
- * <p/>
+ *
* The service's configuration identifies which file extensions will be secured using an checksum. The default list
* (in Tapestry 5.3) is
* "class" and "tml". Note that in 5.4, there are no longer any contributions to this service by Tapestry, and
@@ -39,7 +37,7 @@ public interface ResourceDigestGenerator
/**
* Examines the path (typically, the file name extension at the end of the path) to determine if a checksum is
* required for the path. The path is {@link org.apache.tapestry5.ioc.Resource} style, without a leading slash.
- * <p/>
+ *
* As of Tapestry 5.4, simply returns false.
*/
boolean requiresDigest(String path);
@@ -49,7 +47,7 @@ public interface ResourceDigestGenerator
* This digest will be incorporated into the URL provided to the client, to verify that the client has been
* "granted" access to this resource. This is only used for resources where {@link #requiresDigest(String)} is
* true.
- * <p/>
+ *
* As of Tapestry 5.4, simply returns null.
*
* @param url
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/Response.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/Response.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/Response.java
index 1269937..7b2795c 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/Response.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/Response.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -23,8 +21,8 @@ import java.io.PrintWriter;
/**
* API agnostic wrapper for generating a response. Bridges the gaps between the Servlet API and the Portlet API.
- * <p/>
- * <p/>
+ *
+ *
* The Response service is a {@linkplain org.apache.tapestry5.ioc.services.PropertyShadowBuilder shadow} of the current
* thread's response object.
*/
@@ -81,7 +79,7 @@ public interface Response
* "text/html", leaving cookies and other headers unmodified. If an error-page declaration has been made for the web
* application corresponding to the status code passed in, it will be served back in preference to the suggested msg
* parameter.
- * <p/>
+ *
* If the response has already been committed, this method throws an IllegalStateException. After using this method,
* the response should be considered to be committed and should not be written to.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/SessionPersistedObjectAnalyzer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/SessionPersistedObjectAnalyzer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/SessionPersistedObjectAnalyzer.java
index 950fbeb..25c7ee0 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/SessionPersistedObjectAnalyzer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/SessionPersistedObjectAnalyzer.java
@@ -1,5 +1,3 @@
-// Copyright 2008, 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -18,11 +16,11 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* Analyzes a session-persisted object, specifically to see if it is dirty or not.
- * <p/>
+ *
* This service is provided to support applications which store mutable session attributes where the
* session is replicated to a slower medium (e.g. RDMBS, Cluster, etc) this can help alleviate excessive writes
* to the session store while ensuring changes are propagated.
- * <p/>
+ *
* The service implementation uses a mapped configuration to form a
* {@linkplain org.apache.tapestry5.ioc.services.StrategyBuilder strategy} based on object type. The service may be
* injected using the {@link org.apache.tapestry5.ioc.annotations.Primary} marker annotation.
@@ -36,7 +34,7 @@ public interface SessionPersistedObjectAnalyzer<T>
{
/**
* Atomically check and reset the dirty state of the session persisted object.
- * <p/>
+ *
* The implementer should take consideration for the fact that session attributes are accessed concurrently. A
* naive check/set algorithm may allow changes to go un-noticed.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/StreamPageContent.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/StreamPageContent.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/StreamPageContent.java
index a7acebb..1f54e18 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/StreamPageContent.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/StreamPageContent.java
@@ -1,5 +1,3 @@
-// Copyright 2010, 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -19,11 +17,11 @@ package org.apache.tapestry5.services;
* of a particular page without causing a redirect to that page; the rendering takes place as part
* of the original component event request, thus forming the opposite of Tapestry's normal
* redirect-after-event behavior.
- * <p>
+ *
* The page will be activated using the provided page activation context (or an empty page activation
* context). Starting with 5.3, the page activation step can be bypassed. Rendering occurs using
* the standard {@link PageRenderRequestHandler} pipeline.
- * </p>
+ *
*
* @since 5.2.0
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/TransformConstants.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/TransformConstants.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/TransformConstants.java
index 3cdfa52..7d61ecf 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/TransformConstants.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/TransformConstants.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 2009, 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -28,7 +26,7 @@ import java.lang.reflect.Modifier;
/**
* Constants used by implementations {@link ComponentClassTransformWorker2}.
- * <p/>
+ *
* Note: render phase methods on transformed components will not be invoked <em>unless</em>
* {@linkplain org.apache.tapestry5.model.MutableComponentModel#addRenderPhase(Class) the component model is updated to
* identify the use of the corresponding render phase}. This represents an optimization introduced in Tapestry 5.1.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorAlternatesSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorAlternatesSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorAlternatesSource.java
index 0aec87b..d0bbd9a 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorAlternatesSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorAlternatesSource.java
@@ -1,5 +1,3 @@
-// Copyright 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,16 +12,16 @@
package org.apache.tapestry5.services;
-import java.util.Map;
-
import org.apache.tapestry5.Translator;
import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
+import java.util.Map;
+
/**
* This service is used by {@link TranslatorSource} to specify {@link Translator} <em>alternates</em>: translators that
* are used when specified explicitly by name. These translators may overlap the standard translators
* by type (thus requiring a separate configuration).
- * <p>
+ *
* Translators contributed to this configuration must have names that do not overlap the standard translators. Further,
* the contribution key must match the {@linkplain Translator#getName() translator name}.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorSource.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorSource.java
index d53f1f6..5890b90 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorSource.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/TranslatorSource.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -22,13 +20,13 @@ import org.apache.tapestry5.ioc.util.StrategyRegistry;
* A source for {@link org.apache.tapestry5.Translator}s, either by name or by property type. The source knows
* about two sets of translators: the <em>standard</em> translators contributed directly to the service
* and the <em>alternate</em> translators, contributed to the {@link TranslatorAlternatesSource} service.
- * <p/>
+ *
* Each contributed translator must have a unique {@linkplain org.apache.tapestry5.Translator#getName() name}.
- * <p>
+ *
* Generally, Translators are matched by type (i.e., the type matching a particular property that will be read or
* updated). Contributions to this service use a {@link StrategyRegistry} to match by type. Translators can also be
* selected by name. The {@link TranslatorAlternatesSource} service configuration is often used for this purpose.
- * <p>
+ *
* The contribution key must match the {@linkplain Translator#getType() translator type}.
*/
@UsesMappedConfiguration(key=Class.class, value=Translator.class)
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ajax/AjaxResponseRenderer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ajax/AjaxResponseRenderer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ajax/AjaxResponseRenderer.java
index aae2b9f..7013291 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ajax/AjaxResponseRenderer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ajax/AjaxResponseRenderer.java
@@ -19,7 +19,7 @@ import org.apache.tapestry5.services.PartialMarkupRendererFilter;
* Manages the rendering of a partial page render as part of an Ajax response. This replaces
* the {@link org.apache.tapestry5.ajax.MultiZoneUpdate} introduced in Tapestry 5.1. Much of the API is used to
* queue behaviors that take effect when {@linkplain org.apache.tapestry5.services.PartialMarkupRenderer partial markup rendering takes place}.
- * <p/>
+ *
* The implementation of this class provides {@link org.apache.tapestry5.services.PartialMarkupRendererFilter} to
* the {@link org.apache.tapestry5.internal.services.PageRenderQueue}.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/AssetRequestHandler.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/AssetRequestHandler.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/AssetRequestHandler.java
index e8c2e99..54d8164 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/AssetRequestHandler.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/AssetRequestHandler.java
@@ -24,7 +24,7 @@ import java.io.IOException;
* Handler for asset requests, which expose some kind of {@link Asset} to
* the user agent (i.e., the client web browser). When contributed to the {@link AssetDispatcher} service,
* the contributed key is a handler id (such as "meta/core").
- * <p/>
+ *
* An example request path might be <code>/assets/meta/core/dd8d73ac51dbab28caaec4865d302bf2/deselect.png</code>.
* The handler id would be
* <code>meta/core</code>, the {@linkplain AssetChecksumGenerator checksum of the resource content} is the
@@ -43,11 +43,11 @@ public interface AssetRequestHandler
* (via {@link Response#getOutputStream(String)}) or an error response
* (via {@link Response#sendError(int, String)}). It is the handler's responsibility to allow
* for client-side caching (possibly sending an {@link HttpServletResponse#SC_NOT_MODIFIED} response).
- * <p/>
+ *
* The handler should return true if it provided a response. If the handler returns false, this indicates that the
* extra path did not identify a known asset (virtual or otherwise) and the AssetDispatcher service should send a
* {@link HttpServletResponse#SC_NOT_FOUND} response.
- * <p/>
+ *
* Starting in Tapestry 5.4, the handler is informed by the {@link org.apache.tapestry5.services.AssetRequestDispatcher}
* whether or not the content should be compressed (this is determined based on information in the URL).
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/CompressionAnalyzer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/CompressionAnalyzer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/CompressionAnalyzer.java
index 4f060ff..a61e56c 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/CompressionAnalyzer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/CompressionAnalyzer.java
@@ -17,9 +17,9 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* Identifies which content types are compressable. In general, content types are assumed to be compressable. The
* configuration of the service identifies exceptions, which are usually image file formats.
- * <p/>
+ *
* The configuration maps content types to boolean values (true for compressable).
- * <p/>
+ *
* Since 5.4, the contributed values may also be a wild-card such as "image/*" (that is, the subtype
* may be a '*' to match any content type with the same top-level type).
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ContentTypeAnalyzer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ContentTypeAnalyzer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ContentTypeAnalyzer.java
index ec2ea9e..1a7c045 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ContentTypeAnalyzer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ContentTypeAnalyzer.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -22,7 +20,7 @@ import org.apache.tapestry5.services.Context;
* Used to determine the MIME content type for a resource. The service configuration is the first step,
* followed by {@link Context#getMimeType(String)}, and then (finally) "application/octet-stream"
* as a stop-gap.
- * <p>
+ *
* The service configuration maps the file extension (e.g., "png") to its corresponding MIME type (e.g., "image/png");
*/
@UsesMappedConfiguration(String.class)
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ResourceMinimizer.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ResourceMinimizer.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ResourceMinimizer.java
index 23a71a4..dc1cd11 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ResourceMinimizer.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/ResourceMinimizer.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,15 +12,15 @@
package org.apache.tapestry5.services.assets;
-import java.io.IOException;
-
import org.apache.tapestry5.ioc.annotations.Primary;
import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
+import java.io.IOException;
+
/**
* Certain kinds of resources can be minimized: this primarily refers to JavaScript and CSS, both of which contain
* whitespace, comments and other features that can be reduced.
- * <p>
+ *
* The service configuration maps a MIME content type (e.g., "text/javascript") to an appropriate implementation of this
* interface. The master service has the @{@link Primary} marker interface.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/package-info.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/package-info.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/package-info.java
index 651e184..c330180 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/package-info.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/assets/package-info.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -13,6 +11,6 @@
// limitations under the License.
/**
- * Various services for assets (e.g., images, JavaScript & CSS files)
+ * Various services for assets (e.g., images, JavaScript and CSS files)
*/
package org.apache.tapestry5.services.assets;
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Compatibility.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Compatibility.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Compatibility.java
index 6825282..6ab45cb 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Compatibility.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Compatibility.java
@@ -1,5 +1,3 @@
-// Copyright 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -19,7 +17,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* Used globally to track what compatibility traits are enabled. By default, in Tapestry 5.4,
* all traits are enabled unless explicitly disabled. This behavior may change in Tapestry 5.5.
- * <p/>
+ *
* The configuration allows traits to be explicitly enabled or disabled.
*
* @since 5.4
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Trait.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Trait.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Trait.java
index 00023fb..752da85 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Trait.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/compatibility/Trait.java
@@ -1,5 +1,3 @@
-// Copyright 2012, 2013 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,6 +12,8 @@
package org.apache.tapestry5.services.compatibility;
+import org.apache.tapestry5.SymbolConstants;
+
/**
* Defines different traits that may be enabled or disabled. This was introduced in Tapestry 5.4 to allow certain
* features that exist in Tapestry 5.3 to be optionally enabled for compatibility.
@@ -24,13 +24,13 @@ public enum Trait
* Indicates that the Scriptaculous JavaScript libraries should be included. Tapestry 5.3 includes options for performing
* some kinds of animations when certain elements were updated or removed; that is no longer present in Tapestry 5.4
* and Scriptaculous is not used. This trait is only used if the
- * {@linkplain org.apache.tapestry5.SymbolConstants#JAVASCRIPT_INFRASTRUCTURE_PROVIDER JavaScript infrastructure provider}
+ * {@linkplain SymbolConstants#JAVASCRIPT_INFRASTRUCTURE_PROVIDER JavaScript infrastructure provider}
* is set to "prototype".
*/
SCRIPTACULOUS,
/**
- * Support for Tapestry 5.3 style initializers (the client-side {@code T5.initializers} namespace).</code>
+ * Support for Tapestry 5.3 style initializers (the client-side {@code T5.initializers} namespace).
*/
- INITIALIZERS;
+ INITIALIZERS
}
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/AMDWrapper.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/AMDWrapper.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/AMDWrapper.java
index 3783a65..ee98504 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/AMDWrapper.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/AMDWrapper.java
@@ -1,5 +1,3 @@
-// Copyright 2014 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,6 +12,14 @@
package org.apache.tapestry5.services.javascript;
+import org.apache.tapestry5.func.F;
+import org.apache.tapestry5.func.Flow;
+import org.apache.tapestry5.func.Mapper;
+import org.apache.tapestry5.func.Predicate;
+import org.apache.tapestry5.internal.util.VirtualResource;
+import org.apache.tapestry5.ioc.Resource;
+import org.apache.tapestry5.ioc.internal.util.InternalUtils;
+
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.InputStream;
@@ -24,25 +30,17 @@ import java.util.Map;
import java.util.Map.Entry;
import java.util.Vector;
-import org.apache.tapestry5.func.F;
-import org.apache.tapestry5.func.Flow;
-import org.apache.tapestry5.func.Mapper;
-import org.apache.tapestry5.func.Predicate;
-import org.apache.tapestry5.internal.util.VirtualResource;
-import org.apache.tapestry5.ioc.Resource;
-import org.apache.tapestry5.ioc.internal.util.InternalUtils;
-
/**
* Used to wrap plain JavaScript libraries as AMD modules. The underlying
* resource is transformed before it is sent to the client.
- * <p>
+ *
* This is an alternative to configuring RequireJS module shims for the
* libraries. As opposed to shimmed libraries, the modules created using the
* AMDWrapper can be added to JavaScript stacks.
- * <p>
+ *
* If the library depends on global variables, these can be added as module
* dependencies. For a library that expects jQuery to be available as
- * <code>$<code>, the wrapper should be setup calling <code>require("jQuery", "$")<code>
+ * <code>$</code>, the wrapper should be setup calling <code>require("jQuery", "$")</code>
* on the respective wrapper.
*
* @since 5.4
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/ExtensibleJavaScriptStack.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/ExtensibleJavaScriptStack.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/ExtensibleJavaScriptStack.java
index 1e1afce..8fa030f 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/ExtensibleJavaScriptStack.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/ExtensibleJavaScriptStack.java
@@ -32,7 +32,7 @@ import java.util.List;
* {@link ServiceBinder#bind(Class, Class)} and {@link ServiceBindingOptions#withMarker(Class...)} to construct the
* service, then use the marker annotation to inject the service when contributing the service into to the
* {@link JavaScriptStackSource}.
- * <p/>
+ *
* A limitation of this implementation is that the contributed assets are not localized at all.
*
* @see StackExtension
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/Initialization.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/Initialization.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/Initialization.java
index 64cb880..a633722 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/Initialization.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/Initialization.java
@@ -1,5 +1,3 @@
-// Copyright 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -35,7 +33,7 @@ public interface Initialization
/**
* Changes the initialization priority of the initialization from its default, {@link InitializationPriority#NORMAL}.
- * <p/>
+ *
* Note: it is possible that this method may be removed before release 5.4 is final.
*
* @param priority
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/InitializationPriority.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/InitializationPriority.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/InitializationPriority.java
index 31848d2..e7babbf 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/InitializationPriority.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/InitializationPriority.java
@@ -1,5 +1,3 @@
-// Copyright 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -29,7 +27,7 @@ public enum InitializationPriority
* Provided JavaScript will be executed immediately (it is not deferred until the page loads). Execution occur via
* JavaScript's {@code eval}, and occurs once all {@linkplain JavaScriptSupport#importJavaScriptLibrary(org.apache.tapestry5.Asset) JavaScript libraries}
* (but not modules) for the page have been loaded.
- * <p/>
+ *
*
* @deprecated Deprecated in 5.4; this is now treated as "earlier than {@linkplain #EARLY early}".
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/JavaScriptModuleConfiguration.java
----------------------------------------------------------------------
diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/JavaScriptModuleConfiguration.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/JavaScriptModuleConfiguration.java
index 2fb1478..8b7427e 100644
--- a/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/JavaScriptModuleConfiguration.java
+++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/javascript/JavaScriptModuleConfiguration.java
@@ -1,5 +1,3 @@
-// Copyright 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -23,10 +21,10 @@ import java.util.List;
* Used to define a <a href="http://requirejs.org/docs/api.html#config-shim">module shim</a>, used to adapt non-AMD JavaScript libraries
* to operate like proper modules. This information is used to build up a list of dependencies for the contributed JavaScript module,
* and to identify the resource to be streamed to the client.
- * <p/>
+ *
* Instances of this class are contributed to the {@link ModuleManager} service; the contribution key is the module name
* (typically, a single word).
- * <p/>
+ *
* In some cases, an instance may be created and contributed to override a default module; if the module has no dependencies,
* exports, or initExpression (that is, if it is a proper AMD module, where such dependencies are provided inside
* the module itself), then no client-side shim configuration will be written for the module, but requests for the
@@ -111,7 +109,7 @@ public final class JavaScriptModuleConfiguration
* Used as an alternative to {@linkplain #exports(String)}, this allows a short expression to be specified; the
* expression is used to initialize, clean up, and (usually) return the module's export value. For Underscore, this
* would be "_.noConflict()". If the expression returns null, then the exports value is used.
- * <p/>
+ *
* In RequireJS 2.1.1 (the version shipped with Tapestry, currently), an init function is not invoked unless
* the shim also defines an exports. See <a href="https://github.com/jrburke/requirejs/issues/517">RequireJS issue 517</a>.
* At this time, you should specify {@link #exports} even if you provide a {@link #initializeWith(String)}}.