http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageActivationContext.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageActivationContext.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageActivationContext.java index ae1d129..408f021 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageActivationContext.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageActivationContext.java @@ -1,5 +1,3 @@ -// Copyright 2008, 2009 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,20 +12,21 @@ package org.apache.tapestry5.annotations; +import org.apache.tapestry5.ioc.annotations.UseWith; + import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.FIELD; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.PAGE; -import org.apache.tapestry5.ioc.annotations.UseWith; /** * Annotation for a field for which the page activation context handlers (onActivate and onPassivate) should be created. * In order to use this annotation you must contribute a {@link org.apache.tapestry5.ValueEncoder} for the class of the * annotated property. - * <p/> + * * If using this annotation more than once per page class you must specify unique indexes for each. Indexes must start * at 0 and increment by 1 (eg. if 3 annotations are present they must have indexes of 0, 1 and 2) */
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageAttached.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageAttached.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageAttached.java index 2914ac5..c646573 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageAttached.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageAttached.java @@ -26,10 +26,10 @@ import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; * Method annotation used for methods that should be invoked when the page is first attached to a request. This is * useful for initializations that should occur on each request that involves the page. Often, such initializations will * be balanced by cleanups when the page is detached. - * <p/> + * * PageAttached methods should take no parameters and return void. They must either have this annotation, or be named * "pageAttached". - * <p/> + * * To be clear: methods with this annotation (or name) are still invoked even in Tapestry 5.2, which does away with * the page pool. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java index b9d3f82..2a3deb8 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageDetached.java @@ -25,10 +25,10 @@ import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; /** * Method annotation used for methods that should be invoked when the page is detached at the end of a request, before * it is returned to the page pool for later reuse. - * <p/> + * * PageDetached methods should take no parameters and return void. They must either have this annotation, or be named * "pageDetached". - * <p/> + * * To be clear: methods with this annotation (or name) are still invoked even in Tapestry 5.2, which does away with the * page pool. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageLoaded.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageLoaded.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageLoaded.java index ccbecd1..e50017e 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageLoaded.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageLoaded.java @@ -1,5 +1,3 @@ -// Copyright 2007, 2009, 2010 The Apache Software Foundation -// // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use tis file except in compliance with the License. // You may obtain a copy of the License at @@ -14,20 +12,21 @@ package org.apache.tapestry5.annotations; +import org.apache.tapestry5.ioc.annotations.UseWith; + import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.METHOD; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.METHOD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; -import org.apache.tapestry5.ioc.annotations.UseWith; /** * Method annotation used for methods that should be invoked once the page is fully loaded. This is useful for one-time * component initializations that can't be done at instance initialization time, such as references to embedded * components or blocks. - * <p/> + * * PageLoaded methods should take no parameters and return void. They must either have this annotation, or be named * "pageLoaded". */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageReset.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageReset.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageReset.java index d8121ee..dd73f10 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageReset.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/PageReset.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,26 +12,24 @@ package org.apache.tapestry5.annotations; -import static java.lang.annotation.ElementType.METHOD; -import static java.lang.annotation.RetentionPolicy.RUNTIME; -import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.COMPONENT; -import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.MIXIN; -import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.PAGE; +import org.apache.tapestry5.corelib.components.Grid; +import org.apache.tapestry5.internal.transform.PageResetAnnotationWorker; +import org.apache.tapestry5.ioc.annotations.UseWith; import java.lang.annotation.Documented; import java.lang.annotation.Retention; import java.lang.annotation.Target; -import org.apache.tapestry5.corelib.components.Grid; -import org.apache.tapestry5.internal.transform.PageResetAnnotationWorker; -import org.apache.tapestry5.ioc.annotations.UseWith; +import static java.lang.annotation.ElementType.METHOD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; +import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; /** * Marker annotation for a method that should be invoked when a page is reset. A page reset occurs * when a page is linked to from another page. This is an opportunity to re-initialize aspects of a * page when the user returns to a page after visiting other pages. A common example is to * reset the active page of a {@link Grid} component. - * <p> + * * Methods marked with this annotation are invoked <em>after</em> the page is sent the * <code>activate</code> event. This is to allow the page to reset itself as appropriate for * whatever persistent state was encoded in its page activation context. http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Persist.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Persist.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Persist.java index 15abc7b..0600882 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Persist.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Persist.java @@ -1,5 +1,3 @@ -// Copyright 2006, 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 @@ -14,27 +12,27 @@ package org.apache.tapestry5.annotations; +import org.apache.tapestry5.ioc.annotations.UseWith; import org.apache.tapestry5.services.Session; import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.FIELD; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; -import org.apache.tapestry5.ioc.annotations.UseWith; /** * Identifies a field as persistent, meaning its value persists from one request to the next. Different strategies exist * for how this is accomplished, the most common being the default, "session", which stores the field's value in the * {@link Session}. - * <p/> + * * In most cases, the value will be omitted and will default to the empty string. This forces a search for the correct * strategy. Starting with the component (or mixin) itself, a check is made for the {@link Meta meta data property} * <code>tapestry.persistence-strategy</code>. If a value is found, it is used, otherwise the search continues up the * inheritance hierarchy, towards the page. If not found, then the "session" strategy is used. - * <p/> + * * In this way, the session persistence strategy for a component and all of its sub-components can be controlled by the * containing component. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Property.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Property.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Property.java index 73ef8fd..7ae97a9 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Property.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Property.java @@ -1,5 +1,3 @@ -// Copyright 2008, 2009 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,20 +12,21 @@ package org.apache.tapestry5.annotations; +import org.apache.tapestry5.ioc.annotations.UseWith; + import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.FIELD; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; -import org.apache.tapestry5.ioc.annotations.UseWith; /** * Annotation for fields for which accessor methods (getters and setters) should be created. This can help when * defining the kind of placeholder properties often used in components, though the disadvantage is that you can't * access the fields in a unit test, and you may get compiler warnings about unused private variables. - * <p/> + * * The annotation <em>will not</em> overwrite an existing getter or setter method; if you put a Property annotation on a * field that already has a getter or a setter you will see a runtime exception. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/RequestParameter.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/RequestParameter.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/RequestParameter.java index ac72f8a..fc94bd7 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/RequestParameter.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/RequestParameter.java @@ -1,5 +1,3 @@ -// Copyright 2010, 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,20 +12,17 @@ package org.apache.tapestry5.annotations; -import static java.lang.annotation.ElementType.PARAMETER; -import static java.lang.annotation.RetentionPolicy.RUNTIME; -import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.COMPONENT; -import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.MIXIN; -import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.PAGE; +import org.apache.tapestry5.internal.transform.OnEventWorker; +import org.apache.tapestry5.ioc.annotations.UseWith; +import org.apache.tapestry5.services.Request; import java.lang.annotation.Documented; import java.lang.annotation.Retention; import java.lang.annotation.Target; -import org.apache.tapestry5.internal.transform.OnEventWorker; -import org.apache.tapestry5.ioc.annotations.UseWith; -import org.apache.tapestry5.ioc.services.TypeCoercer; -import org.apache.tapestry5.services.Request; +import static java.lang.annotation.ElementType.PARAMETER; +import static java.lang.annotation.RetentionPolicy.RUNTIME; +import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; /** * Annotation that may be placed on parameters of event handler methods. @@ -36,7 +31,7 @@ import org.apache.tapestry5.services.Request; * from ordinary context parameters (extracted from the Request path). Typically, this is used when * client-side JavaScript adds a query parameter to a request to communicate some information from the client * side to the server side. - * <p> + * * Individual fields may also be directly mapped to query parameters using the {@link ActivationRequestParameter} annotation. * * @since 5.2.0 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Retain.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Retain.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Retain.java index ad4a757..a3729bd 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Retain.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Retain.java @@ -1,5 +1,3 @@ -// Copyright 2006, 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 @@ -14,24 +12,25 @@ package org.apache.tapestry5.annotations; +import org.apache.tapestry5.ioc.annotations.UseWith; + import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.FIELD; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; -import org.apache.tapestry5.ioc.annotations.UseWith; /** * Marker annotation placed on fields whose value should be retained past the end of the request. This is most often * associated with fields that are <em>lazily loaded</em>. By marking such fields with the Retain annotation, the fields * will <em>not</em> be discarded at the end of the request. - * <p/> + * * This is quite different from {@link Persist}, because the value that's allowed to be retained is not stored * persistently; it is simply not cleared out. A subsequent request, even from the same user, may be processed by a * different instance of the page where the value is still null. - * <p/> + * * This annotation should only be used with lazily-evaluated objects that contain no client-specific information. * * @deprecated This rarely used annotation is likely to cause threading issues starting in Tapestry 5.2 (which no longer http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Secure.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Secure.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Secure.java index 24b9b35..03144c4 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Secure.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/Secure.java @@ -1,5 +1,3 @@ -// Copyright 2008, 2009 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 @@ -15,18 +13,19 @@ package org.apache.tapestry5.annotations; import org.apache.tapestry5.SymbolConstants; -import org.apache.tapestry5.ioc.annotations.UseWith; import org.apache.tapestry5.ioc.annotations.AnnotationUseContext; +import org.apache.tapestry5.ioc.annotations.UseWith; import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.TYPE; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.TYPE; +import static java.lang.annotation.RetentionPolicy.RUNTIME; + /** * A marker annotation that indicates that the page in question may only be accessed via HTTPS. - * <p> + * * Normally, this annotation is ignored in development mode and only used in production mode. This can be changed * via the {@link SymbolConstants#SECURE_ENABLED} configuration symbol. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/SessionState.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/SessionState.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/SessionState.java index a176301..d9366cc 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/SessionState.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/SessionState.java @@ -1,5 +1,3 @@ -// Copyright 2009 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,27 +12,28 @@ package org.apache.tapestry5.annotations; +import org.apache.tapestry5.ioc.annotations.UseWith; + import java.lang.annotation.Documented; -import static java.lang.annotation.ElementType.FIELD; import java.lang.annotation.Retention; -import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Target; +import static java.lang.annotation.ElementType.FIELD; +import static java.lang.annotation.RetentionPolicy.RUNTIME; import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*; -import org.apache.tapestry5.ioc.annotations.UseWith; /** * Marker annotation for a field that is a <em>session state object</em> (SSO) as controlled by the {@link * org.apache.tapestry5.services.ApplicationStateManager}. An SSO stored as global session object (i.e., in the {@link * javax.servlet.ServletContext}); every page or component. In fact, the built-in strategies for ASO management are * <em>very</em> user specific, ultimately storing data in the {@link org.apache.tapestry5.services.Session}. - * <p/> + * * An SSO field may have a companion field, of type boolean, used to see if the SSO has been created yet. If another * field exists with the same name, suffixed with "Exists" (i.e., "sso" for the SSO field, and "ssoExists" for the * companion field) and the type of that field is boolean, then access to the field will determine whether the SSO has * already been created. This is necessary because even a null check ("sso != null") may force the SSO to be created. * Instead, check the companion boolean field ("asoExists"). - * <p/> + * * Note: Tapestry 5.0 called these objects "Application State Objects"; thus many of the underlying services have a * confusing name (ApplicationStateManager, which really should be SessionStateManager ... but can't be renamed for * backwards compatibility reasons). http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/annotations/WhitelistAccessOnly.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/WhitelistAccessOnly.java b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/WhitelistAccessOnly.java index b2b5e31..893c5b7 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/annotations/WhitelistAccessOnly.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/annotations/WhitelistAccessOnly.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -27,7 +25,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME; /** * Identifies a page that should only be accessed from clients on the whitelist. This is used for * the built-in {@link org.apache.tapestry5.corelib.pages.T5Dashboard} page, but can also be used in application pages. - * <p/> + * * Tapestry does its best to make a request to a whitelist-only page that is accessed from a client not on the whitelist * appear to behave as if the page does not exist at all. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractField.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractField.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractField.java index 4f977d0..c8331b8 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractField.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractField.java @@ -121,7 +121,7 @@ public abstract class AbstractField implements Field2 * bound (or null) and {@link org.apache.tapestry5.services.javascript.JavaScriptSupport#allocateClientId(org.apache.tapestry5.ComponentResources)} * is used to generate a unique client-id based on the component's id. In some cases, when creating client-side * behaviors, it is useful to explicitly set a unique id for an element using this parameter. - * <p/> + * * Certain values, such as "submit", "method", "reset", etc., will cause client-side conflicts and are not allowed; using such will * cause a runtime exception. */ @@ -132,10 +132,10 @@ public abstract class AbstractField implements Field2 * A rarely used option that indicates that the actual client id should start with the clientId parameter (if non-null) * but should still pass that Id through {@link org.apache.tapestry5.services.javascript.JavaScriptSupport#allocateClientId(String)} * to generate the final id. - * <p/> + * * An example of this are the components used inside a {@link org.apache.tapestry5.corelib.components.BeanEditor} which * will specify a clientId (based on the property name) but still require that it be unique. - * <p/> + * * Defaults to false. * * @since 5.4 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.java index a3a29de..cb42838 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractPropertyOutput.java @@ -29,7 +29,7 @@ import org.apache.tapestry5.services.PropertyOutputContext; * such a component and its container, as the container may provide messages in its message catalog needed by the {@link * Block}s that render the values. In addition, the component may be passed Block parameters that are output overrides * for specified properties. - * <p/> + * * Subclasses will implement a <code>beginRender()</code> method that invokes {@link #renderPropertyValue(MarkupWriter, * String)}. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractTextField.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractTextField.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractTextField.java index 7e6b742..0ae4a09 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractTextField.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/base/AbstractTextField.java @@ -1,5 +1,3 @@ -// Copyright 2006, 2007, 2008, 2009, 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,15 +26,15 @@ import java.util.Locale; /** * Abstract class for a variety of components that render some variation of a text field. Most of the hooks for user * input validation are in this class. - * <p/> + * * In particular, all subclasses support the "toclient" and "parseclient" events. These two events allow the normal * {@link Translator} (specified by the translate parameter, but often automatically derived by Tapestry) to be * augmented. - * <p/> + * * If the component container (i.e., the page) provides an event handler method for the "toclient" event, and that * handler returns a non-null string, that will be the string value sent to the client. The context passed to the event * handler method is t he current value of the value parameter. - * <p/> + * * Likewise, on a form submit, the "parseclient" event handler method will be passed the string provided by the client, * and may provide a non-null value as the parsed value. Returning null allows the normal translator to operate. The * event handler may also throw {@link org.apache.tapestry5.ValidationException}. @@ -162,7 +160,7 @@ public abstract class AbstractTextField extends AbstractField * Invoked from {@link #begin(MarkupWriter)} to write out the element and attributes (typically, <input>). The * {@linkplain AbstractField#getControlName() controlName} and {@linkplain AbstractField#getClientId() clientId} * properties will already have been set or updated. - * <p/> + * * Generally, the subclass will invoke {@link MarkupWriter#element(String, Object[])}, and will be responsible for * including an {@link AfterRender} phase method to invoke {@link MarkupWriter#end()}. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/AjaxFormLoop.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/AjaxFormLoop.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/AjaxFormLoop.java index 3f394cf..c87c9e1 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/AjaxFormLoop.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/AjaxFormLoop.java @@ -32,18 +32,18 @@ import java.util.Iterator; * A special form of the {@link org.apache.tapestry5.corelib.components.Loop} * component that adds Ajax support to handle adding new rows and removing * existing rows dynamically. - * <p/> + * * This component expects that the values being iterated over are entities that * can be identified via a {@link org.apache.tapestry5.ValueEncoder}, therefore * you must either bind the "encoder" parameter to a ValueEncoder or use an * entity type for the "value" parameter for which Tapestry can provide a * ValueEncoder automatically. - * <p/> + * * Works with {@link org.apache.tapestry5.corelib.components.AddRowLink} and * {@link org.apache.tapestry5.corelib.components.RemoveRowLink} components. - * <p/> + * * The addRow event will receive the context specified by the context parameter. - * <p/> + * * The removeRow event will receive the client-side value for the row being iterated. * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Alerts.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Alerts.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Alerts.java index ac3b955..5392f26 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Alerts.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Alerts.java @@ -28,7 +28,7 @@ import org.apache.tapestry5.services.compatibility.DeprecationWarning; * Renders out an empty {@code <div>} element and provides JavaScript initialization to make the element * the container for alerts. After rendering markup (and initialization JavaScript), it * {@linkplain org.apache.tapestry5.alerts.AlertStorage#dismissNonPersistent() removes all non-persistent alerts}. - * <p/> + * * Alerts are created using the {@link org.apache.tapestry5.alerts.AlertManager} service. * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Any.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Any.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Any.java index 3f7b359..d06f665 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Any.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Any.java @@ -1,5 +1,3 @@ -// Copyright 2008, 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 @@ -14,7 +12,10 @@ package org.apache.tapestry5.corelib.components; -import org.apache.tapestry5.*; +import org.apache.tapestry5.BindingConstants; +import org.apache.tapestry5.ClientElement; +import org.apache.tapestry5.ComponentResources; +import org.apache.tapestry5.MarkupWriter; import org.apache.tapestry5.annotations.Parameter; import org.apache.tapestry5.annotations.SupportsInformalParameters; import org.apache.tapestry5.dom.Element; @@ -28,7 +29,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; * (so it will be unique on the client side) and is available after the component * renders using {@link #getClientId()}. The Any component has no template of its * own but does render its body, if any. - * <p> + * * Some common uses are: * <ul> * @@ -73,7 +74,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; * when the new component should support informal parameters or needs a dynamically * generated client ID: * - * <pre>public class MyComponent extends Any { ... } + * <pre>public class MyComponent extends Any { ... }</pre> * </li> * </ul> * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanDisplay.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanDisplay.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanDisplay.java index 3eaefbc..630092c 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanDisplay.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanDisplay.java @@ -1,5 +1,3 @@ -// Copyright 2007, 2008, 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 @@ -30,10 +28,10 @@ import org.apache.tapestry5.services.BeanModelSource; * <dl> element containing a series of <dt>/<dd> pairs. The property label is used as the <dt> * and the property value (formatted as per the datatype) is the <dd>. Only properties that have a known data type * are displayed. - * <p/> + * * The property id is used as the class attribute of the <dt> and <dd> element, allowing CSS customization * per property. This does not occur when lean is bound to true. - * <p/> + * * The outer <dl> element has the CSS class "t-beandisplay". * * @see org.apache.tapestry5.beaneditor.DataType http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanEditForm.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanEditForm.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanEditForm.java index a06fac7..07f7c35 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanEditForm.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/BeanEditForm.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 @@ -28,12 +26,12 @@ import org.apache.tapestry5.services.BeanModelSource; * property (text field, checkbox, drop down list) determined from the property type (or by other means, such as an * annotation), and the order and validation for the properties determined from annotations on the property's getter and * setter methods. - * <p/> + * * You may add block parameters to the component; when the name matches (case insensitive) the name of a property, then * the corresponding Block is renderered, rather than any of the built in property editor blocks. This allows you to * override specific properties with your own customized UI, for cases where the default UI is insufficient, or no * built-in editor type is appropriate. - * <p/> + * * BeanEditForm contains a {@link org.apache.tapestry5.corelib.components.Form} component and will trigger all the * events of a Form. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Checklist.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Checklist.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Checklist.java index 1f94f71..0c764bd 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Checklist.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Checklist.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -29,7 +27,7 @@ import java.util.Set; /** * A list of checkboxes, allowing selection of multiple items in a list. - * <p/> + * * For an alternative component that can be used for similar purposes, see * {@link Palette}. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DateField.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DateField.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DateField.java index b55cc7b..2e47739 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DateField.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DateField.java @@ -1,5 +1,3 @@ -// Copyright 2007-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 @@ -37,11 +35,11 @@ import java.util.Locale; /** * A component used to collect a provided date from the user using a client-side JavaScript calendar. Non-JavaScript * clients can simply type into a text field. - * <p/> + * * One aspect here is that, because client-side JavaScript formatting and parsing is so limited, we (currently) * use Ajax to send the user's input to the server for parsing (before raising the popup) and formatting (after closing * the popup). Weird and inefficient, but easier than writing client-side JavaScript for that purpose. - * <p/> + * * Tapestry's DateField component is a wrapper around <a * href="http://webfx.eae.net/dhtml/datepicker/datepicker.html">WebFX DatePicker</a>. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Delegate.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Delegate.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Delegate.java index 0e06d25..cb501bd 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Delegate.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Delegate.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 @@ -25,12 +23,12 @@ import org.apache.tapestry5.runtime.Component; /** * A component that does not do any rendering of its own, but will delegate to some other object that can do rendering. * This other object may be a component or a {@link Block} (among other things). - * <p> + * * This component may also be used to create inline components. For each informal parameter the value will be stored as a * render variable. To create an inline component, create a block * and use Delegate multiple times in the template to render the block passing parameters to Delegate. In the block body * reference the render variables using the "var:" binding prefix and the name of the parameter. - * <p> + * * Note that the default binding prefix for informal parameter values is "literal". * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DevTool.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DevTool.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DevTool.java index 0954e66..a7c57cd 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DevTool.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/DevTool.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -32,7 +30,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; /** * Renders a dropdown menu of useful options when developing. By default, the DevTool is disabled (invisible) * during production. - * <p/> + * * The DevTool provides the following options: * <ul> * <li>Reset the page state, discarding any persistent page properties</li> @@ -42,7 +40,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; * <li>Reload all pages and components: classes, messages, templates</li> * <li>Open the T5 Dashboard page in a new window</li> * </ul> - * <p/> + * * Note that due to conflicts between Prototype and jQuery, the dev tool is hidden after selecting an item from the menu. * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Dynamic.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Dynamic.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Dynamic.java index 69b6791..b728655 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Dynamic.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Dynamic.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 @@ -30,13 +28,13 @@ import org.apache.tapestry5.services.dynamic.DynamicTemplateParser; /** * The Dynamic component allows a component to render itself differently at different times, by making use of * an external template file. - * <p> + * * The content of the template file replaces the Dynamic component entirely with one exception: certain elements will be * replaced with {@linkplain Block}s passed to the Dynamic component as informal parameters; this is triggered by * <strong>id</strong> of the element. When the id attribute has the prefix {@code param:}, the remainder is the name of * a Block parameter. There are no limitations on what can appear inside such a Block: text, components, forms, even the * {@literal <t:body/>} directive. - * <p> + * * Dynamic templates emulate how expansions work in standard Tapestry templates: Expansions (the <code>${ ... }</code> * syntax) can appear in attribute values or interspersed in element text. This allows container properties, messages, * assets, and so forth to be referenced within the external template. It should be noted that such access is quite a http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Error.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Error.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Error.java index 37f7c8a..03831ca 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Error.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Error.java @@ -1,5 +1,3 @@ -// Copyright 2010-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 @@ -29,11 +27,11 @@ import org.apache.tapestry5.ioc.annotations.Inject; * Must be enclosed by a * {@link org.apache.tapestry5.corelib.components.Form} component and assumes the field and the Error component * are enclosed by a {@code <div class="form-group">}. - * <p/> + * * It is acceptable to include multiple Errors components for a single field; this is sometimes necessary * when creating a responsive layout - which should probably ensure that only one of the Errors is * visible at any time. - * <p/> + * * Errors is optional, and Tapestry's client-side logic will do a reasonable job of placing a help block * dynamically when a validation error must be presented; this component is intended for use when the default logic * doesn't place the help block in the right spot. http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/EventLink.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/EventLink.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/EventLink.java index 8aa3e1a..b23325c 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/EventLink.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/EventLink.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -22,11 +20,11 @@ import org.apache.tapestry5.corelib.base.AbstractComponentEventLink; /** * A close relative of {@link org.apache.tapestry5.corelib.components.ActionLink} except in two ways. - * <p/> + * * First, the event that it triggers is explicitly controlled, rather than always "action". - * <p/> + * * Second, the event is triggered in its container. - * <p/> + * * This allows slightly shorter URLs but also allows multiple components within the same container to generate identical * URLs for common actions. * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Form.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Form.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Form.java index ea40106..6147565 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Form.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Form.java @@ -50,38 +50,38 @@ import java.net.URLDecoder; /** * An HTML form, which will enclose other components to render out the various * types of fields. - * <p> + * * A Form triggers many notification events. When it renders, it triggers a * {@link org.apache.tapestry5.EventConstants#PREPARE_FOR_RENDER} notification, followed by a - * {@link EventConstants#PREPARE} notification.</p> - * <p> + * {@link EventConstants#PREPARE} notification. + * * When the form is submitted, the component triggers several notifications: first a * {@link EventConstants#PREPARE_FOR_SUBMIT}, then a {@link EventConstants#PREPARE}: these allow the page to update its - * state as necessary to prepare for the form submission.</p> - * <p> + * state as necessary to prepare for the form submission. + * * The Form component then determines if the form was cancelled (see {@link org.apache.tapestry5.corelib.SubmitMode#CANCEL}). If so, - * a {@link EventConstants#CANCELED} event is triggered.</p> - * <p> + * a {@link EventConstants#CANCELED} event is triggered. + * * Next come notifications to contained components (or more accurately, the execution of stored {@link ComponentAction}s), to allow each component to retrieve and validate * submitted values, and update server-side properties. This is based on the {@code t:formdata} query parameter, * which contains serialized object data (generated when the form initially renders). - * </p> - * <p>Once the form data is processed, the next step is to trigger the + * + * Once the form data is processed, the next step is to trigger the * {@link EventConstants#VALIDATE}, which allows for cross-form validation. After that, either a * {@link EventConstants#SUCCESS} OR {@link EventConstants#FAILURE} event (depending on whether the * {@link ValidationTracker} has recorded any errors). Lastly, a {@link EventConstants#SUBMIT} event, for any listeners - * that care only about form submission, regardless of success or failure.</p> - * <p> + * that care only about form submission, regardless of success or failure. + * * For all of these notifications, the event context is derived from the <strong>context</strong> component parameter. This * context is encoded into the form's action URI (the parameter is not read when the form is submitted, instead the * values encoded into the form are used). - * </p> - * <p> + * + * * While rendering, or processing a Form submission, the Form component places a {@link FormSupport} object into the {@linkplain Environment environment}, * so that enclosed components can coordinate with the Form component. It also places a {@link ValidationTracker} into the environment during both render and submission. * During submission it also pushes a {@link Heartbeat} into the environment, which is {@link org.apache.tapestry5.services.Heartbeat#end() ended} just before * {@linkplain FormSupport#defer(Runnable) deferred FormSupport operations} are executed. - * </p> + * * * @tapestrydoc * @see BeanEditForm @@ -409,7 +409,7 @@ public class Form implements ClientElement, FormValidationControl /** * Creates an {@link org.apache.tapestry5.corelib.internal.InternalFormSupport} for * this Form. - * <p/> + * * This method may also be invoked as the handler for the "internalCreateRenderTimeFormSupport" event. * * @param clientId @@ -596,9 +596,9 @@ public class Form implements ClientElement, FormValidationControl /** * A hook invoked from {@link #onAction(org.apache.tapestry5.EventContext)} after the * {@link org.apache.tapestry5.EventConstants#SUBMIT} or {@link org.apache.tapestry5.EventConstants#FAILURE} event has been triggered. - * <p/> + * * This method will be invoked regardless of whether the submit or failure event was aborted. - * <p/> + * * This implementation does nothing. * * @since 5.4 @@ -611,7 +611,7 @@ public class Form implements ClientElement, FormValidationControl /** * A hook invoked from {@link #onAction(org.apache.tapestry5.EventContext)} before any other setup. - * <p/> + * * This implementation does nothing. * * @param context @@ -627,9 +627,9 @@ public class Form implements ClientElement, FormValidationControl * A hook invoked from {@link #onAction(org.apache.tapestry5.EventContext)} after the * {@link org.apache.tapestry5.EventConstants#VALIDATE} event has been triggered, and * before the {@link #tracker} has been {@linkplain org.apache.tapestry5.ValidationTracker#clear() cleared}. - * <p/> + * * Only invoked if the valiate event did not abort (that is, the no event handler method returned a value). - * <p/> + * * This implementation does nothing. * * @since 5.4 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/FormFragment.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/FormFragment.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/FormFragment.java index 209a903..aadfa00 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/FormFragment.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/FormFragment.java @@ -1,5 +1,3 @@ -// Copyright 2008-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 @@ -40,7 +38,7 @@ import org.slf4j.Logger; * form is submitted (e.g., the hidden form field is disabled); * alternately, client-side logic can simply remove the form fragment element (including its visible and * hidden fields) to prevent server-side processing. - * <p/> + * * The client-side element will now listen to two new events defined by client-side constants: * <dl> * <dt>core/events.formfragment.changeVisibility or Tapestry.CHANGE_VISIBILITY_EVENT</dt> http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Grid.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Grid.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Grid.java index 110b9a1..e81d658 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Grid.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Grid.java @@ -36,13 +36,13 @@ import java.util.List; /** * A grid presents tabular data. It is a composite component, created in terms of several sub-components. The * sub-components are statically wired to the Grid, as it provides access to the data and other models that they need. - * <p/> + * * A Grid may operate inside a {@link org.apache.tapestry5.corelib.components.Form}. By overriding the cell renderers of * properties, the default output-only behavior can be changed to produce a complex form with individual control for * editing properties of each row. There is a big caveat here: if the order of rows provided by * the {@link org.apache.tapestry5.grid.GridDataSource} changes between render and form submission, then there's the * possibility that data will be applied to the wrong server-side objects. - * <p/> + * * For this reason, when using Grid and Form together, you should generally * provide the Grid with a {@link org.apache.tapestry5.ValueEncoder} (via the * encoder parameter), or use an entity type for the "row" parameter for which http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/GridRows.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/GridRows.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/GridRows.java index f7d83a5..8a4fc32 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/GridRows.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/GridRows.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 @@ -43,13 +41,13 @@ import java.util.List; /** * Renders out a series of rows within the table. - * <p/> + * * Inside a {@link Form}, a series of row index numbers are stored into the form * ( {@linkplain FormSupport#store(Object, ComponentAction) as * ComponentActions}). This can be a problem in situations where the data set * can shift between the form render and the form submission, with a risk of * applying changes to the wrong objects. - * <p/> + * * For this reason, when using GridRows inside a Form, you should generally * provide a {@link org.apache.tapestry5.ValueEncoder} (via the encoder * parameter), or use an entity type for the "row" parameter for which http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Hidden.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Hidden.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Hidden.java index 27219aa..cb6f60a 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Hidden.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Hidden.java @@ -1,5 +1,3 @@ -// Copyright 2009, 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 @@ -30,7 +28,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; * Used to record a page property as a value into the form. The value is encoded * when the form is rendered, then decoded after the form is submitted back to * the server, and the "value" parameter updated. - * <p/> + * * The encoding and decoding is done via a {@link org.apache.tapestry5.ValueEncoder}, * therefore you must either bind the "encoder" parameter to a ValueEncoder or * use an entity type for the "value" parameter for which Tapestry can provide a http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Label.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Label.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Label.java index 2b15eeb..5610131 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Label.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Label.java @@ -1,5 +1,3 @@ -// Copyright 2006-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 @@ -25,7 +23,7 @@ import org.apache.tapestry5.ioc.internal.util.InternalUtils; /** * Generates a <label> element for a particular field. It writes the CSS class "control-label". - * <p/> + * * A Label will render its body, if it has one. However, in most cases it will not have a body, and will render its * {@linkplain org.apache.tapestry5.Field#getLabel() field's label} as its body. Remember, however, that it is the * field label that will be used in any error messages. The Label component allows for client- and server-side http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/LocalDate.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/LocalDate.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/LocalDate.java index bf33f30..797bc5f 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/LocalDate.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/LocalDate.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -29,12 +27,12 @@ import java.util.Date; /** * Used to present a date, formatted in the time zone of the client browser. * This is based on the <a href="http://momentjs.com/">Moment</a> JavaScript library. - * <p/> + * * If the value parameter is non-null, then this component will render an element * wrapping the value (formatted in ISO-8601). The element will match the template element, * or a "span" if the template did not provide an element. Informal parameters will be rendered * into the element. - * <p/> + * * When a date is rendered, it is rendered in an element, used to specify the client-side formatting. * The element's content will be the ISO-8601 format. The client-side will * immediately rewrite the content to the formatted value, in the client browser's time http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Loop.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Loop.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Loop.java index 36cee93..f03d0ed 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Loop.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Loop.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 @@ -14,23 +12,8 @@ package org.apache.tapestry5.corelib.components; -import java.util.Iterator; -import java.util.List; - -import org.apache.tapestry5.BindingConstants; -import org.apache.tapestry5.Block; -import org.apache.tapestry5.ComponentAction; -import org.apache.tapestry5.ComponentResources; -import org.apache.tapestry5.EventConstants; -import org.apache.tapestry5.MarkupWriter; -import org.apache.tapestry5.ValueEncoder; -import org.apache.tapestry5.annotations.AfterRender; -import org.apache.tapestry5.annotations.BeginRender; -import org.apache.tapestry5.annotations.Environmental; -import org.apache.tapestry5.annotations.Events; -import org.apache.tapestry5.annotations.Parameter; -import org.apache.tapestry5.annotations.SetupRender; -import org.apache.tapestry5.annotations.SupportsInformalParameters; +import org.apache.tapestry5.*; +import org.apache.tapestry5.annotations.*; import org.apache.tapestry5.corelib.LoopFormState; import org.apache.tapestry5.ioc.annotations.Inject; import org.apache.tapestry5.ioc.internal.util.CollectionFactory; @@ -38,6 +21,9 @@ import org.apache.tapestry5.services.ComponentDefaultProvider; import org.apache.tapestry5.services.FormSupport; import org.apache.tapestry5.services.Heartbeat; +import java.util.Iterator; +import java.util.List; + /** * A basic looping component; loops over a number of items (provided by its source parameter), rendering its body for each * one. When a Loop is inside a {@link Form}, it records quite a bit of state into the Form to coordinate access @@ -46,12 +32,12 @@ import org.apache.tapestry5.services.Heartbeat; * (which stores the individual values looped over, or via a {@link ValueEncoder}, just the value's ids), and * 'iteration' (which just stores indexes to the values within the source parameter, which means that the source * parameter will be accessed during the form submission). - * <p> + * * For a non-volatile Loop inside the form, the Loop stores a series of commands that start and end * {@linkplain Heartbeat heartbeats}, and stores state for each value in the source parameter (either as full objects * when the encoder parameter is not bound, or as client-side objects when there is an encoder). For a Loop that doesn't * need to be aware of the enclosing Form (if any), the formState parameter should be bound to 'none'. - * <p/> + * * When the Loop is used inside a Form, it will generate an * {@link org.apache.tapestry5.EventConstants#SYNCHRONIZE_VALUES} event to inform its container what values were * submitted and in what order; this can allow the container to pre-load the values in a single batch form external http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PageLink.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PageLink.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PageLink.java index 5d38d63..bd738be 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PageLink.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PageLink.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 @@ -27,7 +25,7 @@ import org.apache.tapestry5.services.PageRenderLinkSource; * Generates a render request link to some other page in the application. If an activation context is supplied (as the * context parameter), then the context values will be encoded into the URL. If no context is supplied, then the target * page itself will supply the context via a passivate event. - * <p/> + * * Pages are not required to have an activation context. When a page does have an activation context, the value * typically represents the identity of some object displayed or otherwise manipulated by the page. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Palette.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Palette.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Palette.java index 764aa6d..beead7b 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Palette.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Palette.java @@ -29,36 +29,36 @@ import java.util.Collection; * Multiple selection component. Generates a UI consisting of two <select> elements configured for multiple * selection; the one on the left is the list of "available" elements, the one on the right is "selected". Elements can * be moved between the lists by clicking a button, or double clicking an option (and eventually, via drag and drop). - * <p/> + * * The items in the available list are kept ordered as per {@link SelectModel} order. When items are moved from the * selected list to the available list, they items are inserted back into their proper positions. - * <p/> + * * The Palette may operate in normal or re-orderable mode, controlled by the reorder parameter. - * <p/> + * * In normal mode, the items in the selected list are kept in the same "natural" order as the items in the available * list. - * <p/> + * * In re-order mode, items moved to the selected list are simply added to the bottom of the list. In addition, two extra * buttons appear to move items up and down within the selected list. - * <p/> + * * Much of the look and feel is driven by CSS, the default Tapestry CSS is used to set up the columns, etc. By default, * the <select> element's widths are 200px, and it is common to override this to a specific value: - * <p/> + * * <pre> * <style> * DIV.palette SELECT { width: 300px; } * </style> * </pre> - * <p/> + * * You'll want to ensure that both <select> in each column is the same width, otherwise the display will update * poorly as options are moved from one column to the other. - * <p/> + * * Option groups within the {@link SelectModel} will be rendered, but are not supported by many browsers, and are not * fully handled on the client side. - * <p/> + * * For an alternative component that can be used for similar purposes, see * {@link Checklist}. - * <p>Starting in 5.4, the selected parameter may be any kind of collection, but is typically a List if the Palette is configured for re-ordering, + * Starting in 5.4, the selected parameter may be any kind of collection, but is typically a List if the Palette is configured for re-ordering, * and a Set if order does not matter (though it is common to use a List in the latter case as well). Also, starting in 5.4, * the Palette is compatible with the {@link org.apache.tapestry5.validator.Required} validator (on both client and server-side), and * triggers new events that allows the application to veto a proposed changed to the selection (see the {@code t5/core/events} module). @@ -129,7 +129,7 @@ public class Palette extends AbstractField * The list of selected values from the {@link org.apache.tapestry5.SelectModel}. This will be updated when the form * is submitted. If the value for the parameter is null, a new list will be created, otherwise the existing list * will be cleared. If unbound, defaults to a property of the container matching this component's id. - * <p/> + * * Prior to Tapestry 5.4, this allowed null, and a list would be created when the form was submitted. Starting * with 5.4, the selected list may not be null, and it need not be a list (it may be, for example, a set). */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PasswordField.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PasswordField.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PasswordField.java index d64694f..88850cc 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PasswordField.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/PasswordField.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 @@ -21,7 +19,7 @@ import org.apache.tapestry5.corelib.base.AbstractTextField; * A version of {@link TextField}, but rendered out as an <input type="password"> element. Further, the output * value for a PasswordField is always blank. When the value provided to the PasswordField is blank, it does not update * its property (care should be taken that the "required" validator not be used in that case). - * <p/> + * * Includes the <code>size</code> attribute, if a {@link org.apache.tapestry5.beaneditor.Width} annotation is present on * the property bound to the value parameter. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/ProgressiveDisplay.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/ProgressiveDisplay.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/ProgressiveDisplay.java index a6a9935..1a4272f 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/ProgressiveDisplay.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/ProgressiveDisplay.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 @@ -33,7 +31,7 @@ import java.io.IOException; * ...") and an Ajax request then supplies the component's true body. This * results in much faster page loads. You can * even nest these! - * <p/> + * * The component simply does not render its body on initial render. On the subsequent action event request, it fires a * {@link org.apache.tapestry5.EventConstants#PROGRESSIVE_DISPLAY} event to inform the container about the (optional) * event context. The event handler method may return a renderable object; if not then the component's body is rendered http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Radio.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Radio.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Radio.java index c0c492b..176856e 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Radio.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Radio.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 @@ -28,7 +26,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; /** * A radio button (i.e., <input type="radio">). Radio buttons <strong>must</strong> operate within a * {@link RadioContainer} (normally, the {@link RadioGroup} component). - * <p/> + * * If the value parameter is not bound, then the default value is a property of the container component whose name * matches the Radio component's id. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Select.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Select.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Select.java index 44f4e79..37a7c79 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Select.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Select.java @@ -34,7 +34,7 @@ import java.util.List; /** * Select an item from a list of values, using an [X]HTML <select> element on the client side. Any validation * decorations will go around the entire <select> element. - * <p/> + * * A core part of this component is the {@link ValueEncoder} (the encoder parameter) that is used to convert between * server-side values and unique client-side strings. In some cases, a {@link ValueEncoder} can be generated automatically from * the type of the value parameter. The {@link ValueEncoderSource} service provides an encoder in these situations; it http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextArea.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextArea.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextArea.java index e46ee37..f0e2072 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextArea.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextArea.java @@ -1,5 +1,3 @@ -// Copyright 2006-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 @@ -21,7 +19,7 @@ import org.apache.tapestry5.corelib.base.AbstractTextField; * TextArea component corresponds to a <textarea> element. The value parameter is almost always bound to a string, * but this is not an absolute requirement. Since the component accepts informal parameters, the rows and cols attribute may * be set that way (there is not a formal parameter). - * <p/> + * * Includes the <code>cols</code> attribute, if a {@link org.apache.tapestry5.beaneditor.Width} annotation is present on * the property bound to the value parameter. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextField.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextField.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextField.java index ddf9f2f..d75a1a6 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextField.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TextField.java @@ -1,5 +1,3 @@ -// Copyright 2006-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 @@ -24,7 +22,7 @@ import org.apache.tapestry5.corelib.base.AbstractTextField; * {@link Form} is rendered, and updated when the form is submitted). TextField * is generally used with string values, but other values are acceptable, as long as they can be freely converted back * and forth to strings. - * <p/> + * * Includes the <code>size</code> attribute, if a {@link org.apache.tapestry5.beaneditor.Width} annotation is present on * the property bound to the value parameter. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TimeInterval.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TimeInterval.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TimeInterval.java index 789fce9..01d3482 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TimeInterval.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/TimeInterval.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -28,11 +26,11 @@ import java.util.Date; * Used to present an interval value using Moment.js's from() or fromNow() functions. The interval * is determined in terms of a start and end date; either (but not both) may be omitted, in which * case the client will dynamically update the element. In that case, the value will live update, approximately every second. - * <p/> + * * This component will render an empty element. The element will match the template element, * or a "span" if the template did not provide an element. Informal parameters will be rendered * into the element. - * <p/> + * * When the end date is after the start date, the rendered text will be prefixed with "in". * When the end date precedes the start date, the rendered text will be suffixed with "ago". * The plain parameter is used to turn off the prefix or suffix. http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java index f44b2f0..108d1bf 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Tree.java @@ -34,10 +34,10 @@ import java.util.List; * by the component is provided as a {@link TreeModel}. A secondary model, the {@link TreeExpansionModel}, is used * to track which nodes have been expanded. The optional {@link TreeSelectionModel} is used to track node selections (as currently * implemented, only leaf nodes may be selected). - * <p/> + * * Tree is <em>not</em> a form control component; all changes made to the tree on the client * (expansions, collapsing, and selections) are propagated immediately back to the server. - * <p/> + * * The Tree component uses special tricks to support recursive rendering of the Tree as necessary. * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Zone.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Zone.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Zone.java index 00f2016..627f6f6 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Zone.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/components/Zone.java @@ -31,14 +31,14 @@ import org.slf4j.Logger; * A Zone is portion of the output page designed for easy dynamic updating via Ajax or other client-side effects. A * Zone renders out as a <div> element (or whatever is specified in the template) and may have content initially, * or may only get its content as a result of client side activity. - * <p/> + * * When a user clicks an {@link org.apache.tapestry5.corelib.components.ActionLink} whose zone parameter is set triggers a * series of client-side behaviors, and an Ajax request to the server. - * <p/> + * * The server side event handler can return a {@link org.apache.tapestry5.Block} or a component to render as the new * content on the client side. Often, re-rendering the Zone's {@linkplain #getBody() body} is useful. Multiple * client-side zones may be updated via the {@link org.apache.tapestry5.services.ajax.AjaxResponseRenderer} service. - * <p/> + * * You will often want to specify the id parameter of the Zone, in addition to its Tapestry component id; this "locks * down" the client-side id, so the same value is used even in later partial renders of the page (essential if the Zone * is nested inside another Zone). When you specify the client-side id, it is used exactly as provided (meaning that you @@ -46,15 +46,15 @@ import org.slf4j.Logger; * the page). Failure to provide an explicit id results in a new, and non-predictable, id being generated for each * partial render, which will often result in client-side failures to locate the element to update when the Zone is * triggered. - * <p/> + * * In some cases, you may want to know (on the server side) the client id of the zone that was updated; this is passed * as part of the Ajax request, as the {@link QueryParameterConstants#ZONE_ID} parameter. An example use of this would * be to provide new content into a Zone that updates the same Zone, when the Zone's client-side id is dynamically * allocated (rather than statically defined). In most cases, however, the programmer is responsible for assigning a * specific client-side id, via the id parameter. - * <p/> + * * A Zone starts and stops a {@link Heartbeat} when it renders (both normally, and when re-rendering). - * <p/> + * * After the client-side content is updated, a client-side event is fired on the zone's element. The constant * <code>core/events:zone.didUpdate</code> can be used to listen to the event. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/data/SecureOption.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/data/SecureOption.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/data/SecureOption.java index e8f6598..cf6a057 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/data/SecureOption.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/data/SecureOption.java @@ -1,5 +1,3 @@ -// Copyright 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,9 @@ package org.apache.tapestry5.corelib.data; +import org.apache.tapestry5.SelectModel; +import org.apache.tapestry5.corelib.components.Select; + /** * Possible values of the "secure" parameter for components that use a * {@link SelectModel} (such as {@link Select}), to control whether the submitted @@ -41,5 +42,5 @@ public enum SecureOption * persist a custom SelectModel across a form submission or recreate it * when the form is submitted). */ - AUTO; + AUTO } http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/internal/FormSupportImpl.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/internal/FormSupportImpl.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/internal/FormSupportImpl.java index 9003893..7bb3859 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/internal/FormSupportImpl.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/internal/FormSupportImpl.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 @@ -28,7 +26,7 @@ import java.util.List; /** * Provides support to components enclosed by a form when the form is rendering (allowing the components to registry * form submit callback commands), and also during form submission time. - * <p/> + * * TODO: Most methods should only be invokable depending on whether the form is rendering or processing a submission. */ public class FormSupportImpl implements InternalFormSupport, Locatable