http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Autocomplete.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Autocomplete.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Autocomplete.java index 03a96da..1dfcd3d 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Autocomplete.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Autocomplete.java @@ -28,11 +28,11 @@ import java.util.List; /** * A mixin for a text field that allows for autocompletion of text fields. This is based on * Twttter <a href="http://twitter.github.io/typeahead.js/">typeahead.js</a> version 0.10.5. - * <p/> + * * The container is responsible for providing an event handler for event "providecompletions". The context will be the * partial input string sent from the client. The return value should be an array or list of completions, in * presentation order. e.g. - * <p/> + * * <pre> * String[] onProvideCompletionsFromMyField(String input) * {
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Confirm.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Confirm.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Confirm.java index 1464129..0a746ef 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Confirm.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/Confirm.java @@ -22,7 +22,7 @@ import org.apache.tapestry5.services.javascript.JavaScriptSupport; /** * A mixin that can be placed on a clickable component, such as {@link org.apache.tapestry5.corelib.components.LinkSubmit}, * and will raise a confirmation dialog when the element is clicked. - * <p/> + * * Due to conflicts between jQuery (as used by Bootstrap's JavaScript library) and Prototype, this mixin does not operate * when the {@linkplain org.apache.tapestry5.SymbolConstants#JAVASCRIPT_INFRASTRUCTURE_PROVIDER JavaScript infrastructure provider} * is "prototype". http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormFieldFocus.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormFieldFocus.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormFieldFocus.java index 82e2aaf..9fcc124 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormFieldFocus.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormFieldFocus.java @@ -1,5 +1,3 @@ -// Copyright (c) 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 @@ -15,7 +13,6 @@ package org.apache.tapestry5.corelib.mixins; import org.apache.tapestry5.BindingConstants; -import org.apache.tapestry5.ClientElement; import org.apache.tapestry5.Field; import org.apache.tapestry5.FieldFocusPriority; import org.apache.tapestry5.annotations.AfterRender; @@ -30,7 +27,7 @@ import org.slf4j.Logger; /** * A mixin that instruments the outer {@link org.apache.tapestry5.corelib.components.Form} on which * component the focus should be activated. - * <p/> + * * This is meant to be used only with {@link org.apache.tapestry5.corelib.components.Form} component. * * @since 5.3 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormGroup.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormGroup.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormGroup.java index 424fc5a..f90bcc5 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormGroup.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/FormGroup.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 @@ -26,7 +24,7 @@ import org.apache.tapestry5.ioc.annotations.Inject; import org.apache.tapestry5.ioc.annotations.Symbol; /** - * <p>Applied to a {@link org.apache.tapestry5.Field}, this provides the outer layers of markup to correctly + * Applied to a {@link org.apache.tapestry5.Field}, this provides the outer layers of markup to correctly * render text fields, selects, and textareas using Bootstrap: * an outer {@code <div class="field-group">} containing a {@code <label class="control-label">} and the field itself. * Actually, the class attribute of the div is defined by the @@ -35,8 +33,8 @@ import org.apache.tapestry5.ioc.annotations.Symbol; * <code>field-group</code> and <code>control-label</code> are the default values. * As with the {@link org.apache.tapestry5.corelib.components.Label} component, the {@code for} attribute is set (after the field itself * renders). - * </p> - * <p> + * + * * You can also use the {@link SymbolConstants#FORM_GROUP_FORM_FIELD_WRAPPER_ELEMENT_NAME} symbol * to optionally wrap the input field in an element and {@link SymbolConstants#FORM_GROUP_FORM_FIELD_WRAPPER_ELEMENT_CSS_CLASS} * to give it a CSS class. This is useful for Bootstrap form-horizontal forms. @@ -44,11 +42,11 @@ import org.apache.tapestry5.ioc.annotations.Symbol; * {@link SymbolConstants#FORM_GROUP_FORM_FIELD_WRAPPER_ELEMENT_CSS_CLASS} to <code>col-sm-10</code> * and {@link SymbolConstants#FORM_GROUP_LABEL_CSS_CLASS} to <code>col-sm-2</code> * will generate labels 2 columns wide and form fields 10 columns wide. - * </p> - * <p> + * + * * This component is not appropriate for radio buttons or checkboxes as they use a different class on the outermost element * ("radio" or "checkbox") and next the element inside the {@code <label>}. - * </p> + * * * @tapestrydoc * @since 5.4 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/NotEmpty.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/NotEmpty.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/NotEmpty.java index 5cd0f9b..996e33e 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/NotEmpty.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/NotEmpty.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -22,7 +20,7 @@ import org.apache.tapestry5.dom.Element; * A mixin that attaches to an element that renders an element. At the end of the render, if the element is empty, then * a non-breaking space (&nbsp;) is injected into the element. This is often necessary for proper rendering on the * client. - * <p/> + * * Often used in conjunction with the {@link org.apache.tapestry5.corelib.components.Any} component. * * @since 5.1.0.0 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.java index 5cd9df0..874bdf2 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/OverrideFieldFocus.java @@ -1,5 +1,3 @@ -// Copyright (c) 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,21 +12,18 @@ package org.apache.tapestry5.corelib.mixins; -import org.apache.tapestry5.BindingConstants; import org.apache.tapestry5.Field; import org.apache.tapestry5.FieldFocusPriority; import org.apache.tapestry5.annotations.AfterRender; import org.apache.tapestry5.annotations.Environmental; import org.apache.tapestry5.annotations.InjectContainer; -import org.apache.tapestry5.annotations.Parameter; -import org.apache.tapestry5.corelib.components.Form; import org.apache.tapestry5.ioc.annotations.Inject; import org.apache.tapestry5.services.javascript.JavaScriptSupport; import org.slf4j.Logger; /** * A mixin that let a {@link org.apache.tapestry5.Field} gain focus. - * <p/> + * * This supersede {@link org.apache.tapestry5.corelib.mixins.FormFieldFocus} in 5.4 * * @since 5.4 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderClientId.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderClientId.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderClientId.java index 23a2fdb..aeda081 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderClientId.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderClientId.java @@ -1,5 +1,3 @@ -// Copyright 2007, 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,9 +12,9 @@ package org.apache.tapestry5.corelib.mixins; -import org.apache.tapestry5.annotations.InjectContainer; -import org.apache.tapestry5.annotations.AfterRender; import org.apache.tapestry5.ClientElement; +import org.apache.tapestry5.annotations.AfterRender; +import org.apache.tapestry5.annotations.InjectContainer; /** * Forces a client element to render its client id by ensuring that @@ -24,7 +22,7 @@ import org.apache.tapestry5.ClientElement; * is called. This is sometimes needed because, by design, most components (those that * implement {@link ClientElement}) only render a client-side ID if their getClientId * method is called sometime during the server-side DOM render. - * <p/> + * * See the {@link org.apache.tapestry5.corelib.components.Any Any} component * for an example of use. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderInformals.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderInformals.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderInformals.java index bdb8471..4f9cd9e 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderInformals.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/RenderInformals.java @@ -1,5 +1,3 @@ -// Copyright 2006, 2007, 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 @@ -16,25 +14,21 @@ package org.apache.tapestry5.corelib.mixins; import org.apache.tapestry5.ComponentResources; import org.apache.tapestry5.MarkupWriter; -import org.apache.tapestry5.annotations.AfterRenderTemplate; -import org.apache.tapestry5.annotations.BeforeRenderTemplate; -import org.apache.tapestry5.annotations.BeginRender; -import org.apache.tapestry5.annotations.MixinAfter; -import org.apache.tapestry5.annotations.SupportsInformalParameters; +import org.apache.tapestry5.annotations.*; import org.apache.tapestry5.ioc.annotations.Inject; /** * Used to render out all informal parameters, at the end of the {@link org.apache.tapestry5.annotations.BeginRender} * phase. - * <p/> + * * This mixin can be used with components that render a single tag inside the {@link BeginRender} phase. RenderInformals * will activate during the PostBeginRender phase to write additional attributes, from the informal parameters, into the * active element. - * <p/> + * * If you want this behavior, but need to render more than a single tag, then implement render phase methods for the * {@link BeforeRenderTemplate} and {@link AfterRenderTemplate} phases. Use those phases to write the additional * elements and close them. - * <p/> + * * This is often used as a base class, for cases where a component doesn't have other mixins. * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/ZoneRefresh.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/ZoneRefresh.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/ZoneRefresh.java index d2ca6dd..68dec3b 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/ZoneRefresh.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/mixins/ZoneRefresh.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -14,11 +12,7 @@ package org.apache.tapestry5.corelib.mixins; -import org.apache.tapestry5.BindingConstants; -import org.apache.tapestry5.ComponentResources; -import org.apache.tapestry5.EventConstants; -import org.apache.tapestry5.EventContext; -import org.apache.tapestry5.Link; +import org.apache.tapestry5.*; import org.apache.tapestry5.annotations.AfterRender; import org.apache.tapestry5.annotations.Events; import org.apache.tapestry5.annotations.InjectContainer; @@ -29,15 +23,15 @@ import org.apache.tapestry5.ioc.annotations.Inject; import org.apache.tapestry5.services.javascript.JavaScriptSupport; /** - * <p> + * * This mixin periodically refreshs a {@link org.apache.tapestry5.corelib.components.Zone zone} * by triggering an event on the server using ajax requests. - * </p> - * <p> + * + * * Server-side, the mixin triggers the "refresh" event with the mixin's context. A container may but * does not need to handle the event. If the event is handled and a value is returned, that value is * used to render the response. Otherwise, the Zone's body is re-rendered. - * </p> + * * <b>Note: </b> This mixin is only meant for a {@link org.apache.tapestry5.corelib.components.Zone zone}. * * @tapestrydoc http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/corelib/pages/ServiceStatus.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/pages/ServiceStatus.java b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/pages/ServiceStatus.java index 55a3b62..8546c6c 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/corelib/pages/ServiceStatus.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/corelib/pages/ServiceStatus.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -29,7 +27,7 @@ import java.util.List; /** * Page used to see the status of all services defined by the {@link Registry}. - * <p/> + * * TODO: Add filters to control which services are displayed */ @UnknownActivationContextCheck(false) http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/dom/Element.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/dom/Element.java b/tapestry-core/src/main/java/org/apache/tapestry5/dom/Element.java index 75dc68a..00c1312 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/dom/Element.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/dom/Element.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,7 +26,7 @@ import java.util.regex.Pattern; /** * An element that will render with a begin tag and attributes, a body, and an end tag. Also acts as a factory for * enclosed Element, Text and Comment nodes. - * <p/> + * * TODO: Support for CDATA nodes. Do we need Entity nodes? */ public final class Element extends Node http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalComponentResourcesCommon.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalComponentResourcesCommon.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalComponentResourcesCommon.java index 0cf7e62..16bfc2c 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalComponentResourcesCommon.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalComponentResourcesCommon.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 @@ -35,7 +33,7 @@ public interface InternalComponentResourcesCommon /** * Used during construction of the page to identify the binding for a particular parameter. - * <p/> + * */ void bindParameter(String parameterName, Binding binding); http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalSymbols.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalSymbols.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalSymbols.java index 1066c71..b335ac9 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalSymbols.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/InternalSymbols.java @@ -34,7 +34,7 @@ public class InternalSymbols * Comma-separated list of pre-allocated Form component control names. Basically, this exists to * work around name collisions on the client side. Starting in 5.3, these names are * also pre-allocated as ids. - * <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/internal/TapestryAppInitializer.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryAppInitializer.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryAppInitializer.java index 8fbc12e..41bd45e 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryAppInitializer.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryAppInitializer.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 @@ -32,9 +30,9 @@ import java.util.List; * This class is used to build the {@link Registry}. The Registry contains * {@link org.apache.tapestry5.ioc.modules.TapestryIOCModule} and {@link TapestryModule}, any * modules identified by {@link #addModules(Class[])} )}, plus the application module. - * <p/> + * * The application module is optional. - * <p/> + * * The application module is identified as <em>package</em>.services.<em>appName</em>Module, where * <em>package</em> and the <em>appName</em> are specified by the caller. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryInternalUtils.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryInternalUtils.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryInternalUtils.java index 5e4ab42..0353dfe 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryInternalUtils.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/TapestryInternalUtils.java @@ -268,7 +268,7 @@ public class TapestryInternalUtils /** * Converts an enum to a label string, allowing for overrides from a message catalog. - * <p/> + * * <ul> * <li>As key <em>prefix</em>.<em>name</em> if present. Ex: "ElementType.LOCAL_VARIABLE" * <li>As key <em>name</em> if present, i.e., "LOCAL_VARIABLE". http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/LiteralBinding.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/LiteralBinding.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/LiteralBinding.java index 776418d..8b93de6 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/LiteralBinding.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/LiteralBinding.java @@ -1,5 +1,3 @@ -// Copyright 2006, 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 @@ -20,8 +18,8 @@ import org.apache.tapestry5.ioc.Location; * Binding type for literal, immutable values. Literal bindings are {@linkplain org.apache.tapestry5.Binding#isInvariant() * invariant}; any value provided by a LiteralBinding, even if {@linkplain org.apache.tapestry5.ioc.services.TypeCoercer#coerce(Object, * Class) coerced}, will be cached aggresively by Tapestry cmponent. - * <p/> - * <p>LiteralBindings are often used for literal string values supplied in-line in the component template, but is used + * + * LiteralBindings are often used for literal string values supplied in-line in the component template, but is used * for many other things as well, any kind of fixed, read-only value. */ public class LiteralBinding extends AbstractBinding http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/PropBindingFactory.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/PropBindingFactory.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/PropBindingFactory.java index 4f65bac..8dc3418 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/PropBindingFactory.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/bindings/PropBindingFactory.java @@ -1,5 +1,3 @@ -// Copyright 2006, 2007, 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 @@ -24,7 +22,7 @@ import org.apache.tapestry5.services.PropertyConduitSource; /** * Binding factory for reading and updating JavaBean properties. - * <p/> + * * Expression are evaluated via a {@link PropertyConduit}, which is generated by {@link PropertyConduitSource} (which * therefore defines the expression language). */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/EmbeddedComponentAssembler.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/EmbeddedComponentAssembler.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/EmbeddedComponentAssembler.java index acad5df..376596b 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/EmbeddedComponentAssembler.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/EmbeddedComponentAssembler.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -36,10 +34,10 @@ interface EmbeddedComponentAssembler extends Locatable * the latter case, the mixinId is validated (to ensure it exists). In addition, a special mixinid that matches the * component's class name can be used; this is necessary to disambiguate informal parameters of the component from formal mixin parameters * (where an unqualified name would be bound to the mixin's parameter). - * <p/> + * * If the name of the parameter does not match a formal parameter of the component (or mixin) and the component (or * mixin) does not support informal parameters, then null is returned. - * <p/> + * * This method should only be called at page-assembly time as it requires some data that is collected during * ComponentAssembly construction in order to handle published parameters of embedded components. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/PageLoaderImpl.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/PageLoaderImpl.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/PageLoaderImpl.java index 17a92d6..0ee401e 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/PageLoaderImpl.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/pageload/PageLoaderImpl.java @@ -49,7 +49,7 @@ import java.util.Map; * There's still a lot of room to beef up {@link org.apache.tapestry5.internal.pageload.ComponentAssembler} and * {@link org.apache.tapestry5.internal.pageload.EmbeddedComponentAssembler} to perform more static analysis, but * that may no longer be necessary, given the switch to shared (non-pooled) pages in 5.2. - * <p/> + * * Loading a page involves a recursive process of creating * {@link org.apache.tapestry5.internal.pageload.ComponentAssembler}s: for the root component, then down the tree for * each embedded component. A ComponentAssembler is largely a collection of @@ -58,7 +58,7 @@ import java.util.Map; * matching parameters to bindings, is done as part of the one-time construction of the ComponentAssembler. The end * result removes a huge amount of computational redundancy that was present in Tapestry 5.0, but to understand this, * you need to split your mind into two phases: construction (of the ComponentAssemblers) and assembly. - * <p/> + * * And truly, <em>This is the Tapestry Heart, This is the Tapestry Soul...</em> */ public class PageLoaderImpl implements PageLoader, ComponentAssemblerSource http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/BlockInjectionProvider.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/BlockInjectionProvider.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/BlockInjectionProvider.java index c8a52e1..fc468c0 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/BlockInjectionProvider.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/BlockInjectionProvider.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 @@ -33,7 +31,7 @@ import org.apache.tapestry5.services.transform.InjectionProvider2; * fields containing the injected Block from the template. The annotation's value is the id of the * block to inject; if * omitted, the block id is deduced from the field id. - * <p/> + * * Must be scheduled before {@link DefaultInjectionProvider} because it uses the same annotation, Inject, with a * different interpretation. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentInstantiatorSource.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentInstantiatorSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentInstantiatorSource.java index dbd3cb9..e7b9df6 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentInstantiatorSource.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentInstantiatorSource.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 @@ -21,14 +19,14 @@ import org.apache.tapestry5.services.transform.ControlledPackageType; /** * Creates {@link org.apache.tapestry5.internal.services.Instantiator}s for components, based on component class name. * This will involve transforming the component's class before it is loaded. - * <p/> + * * In addition, a source acts as an event hub for {@link org.apache.tapestry5.services.InvalidationListener}s, so that * any information derived from loaded classes can be discarded and rebuilt when classes change. - * <p/> + * * The strategy used is that when <em>any</em> class (in a controlled package) changes, the entire class loader is * discarded, along with any instances derived from those classes. A new class loader is created, and then invalidation * events are fired to listeners. - * <p/> + * * Starting in Tapestry 5.3, the packages that are loaded are controlled by a configuration that maps package names to * {@link ControlledPackageType}s. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentModelSource.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentModelSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentModelSource.java index 6b22d67..7fcc1b1 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentModelSource.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentModelSource.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 @@ -18,7 +16,7 @@ import org.apache.tapestry5.model.ComponentModel; /** * Access to component models (as provided via {@link org.apache.tapestry5.internal.services.ComponentInstantiatorSource}). - * <p/> + * * This is a good candidate to move into the public services package. * * @since 5.1.0.0 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentResourcesOperation.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentResourcesOperation.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentResourcesOperation.java index 4563da2..46b8bfa 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentResourcesOperation.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentResourcesOperation.java @@ -1,5 +1,3 @@ -// Copyright 2007, 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 @@ -18,7 +16,7 @@ import org.apache.tapestry5.ComponentResources; /** * A kind of callback that can easily be injected into a transformed class to perform complex work. - * <p/> + * * These callbacks are often injected into a transformed component class. Bear in mind that such * callbacks must be <em>threadsafe</em>, since every instance of such a class will share a single instance of the * operation. http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSource.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSource.java index cda1920..ed57a9d 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSource.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSource.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 @@ -23,7 +21,7 @@ import org.apache.tapestry5.services.pageload.ComponentResourceSelector; * Provides access to cached {@link org.apache.tapestry5.internal.parser.ComponentTemplate}s. The source acts as a * invalidation event hub, and will broadcast invalidation events when any loaded template resource changes. The * listener for these invalidation events is the page source, which stores cached page instances. - * <p/> + * * Any search for a template will end with success (a non-null template), but the template returned may be the * {@link ComponentTemplate#isMissing() missing template}. */ @@ -33,7 +31,7 @@ public interface ComponentTemplateSource * Provides access to a template. The template will be parsed as necessary. If no template for the exact component * is found, then the template for the component's parent is returned. In this way, it is possible for a component * to extend the behavior of its super-class without duplicating the super-class component's template. - * <p/> + * * In some cases, the empty template will be returned. * * @param componentModel http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSourceImpl.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSourceImpl.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSourceImpl.java index d580b9e..04f8b80 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSourceImpl.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ComponentTemplateSourceImpl.java @@ -169,7 +169,7 @@ public final class ComponentTemplateSourceImpl extends InvalidationEventHubImpl /** * Resolves the component name to a localized {@link Resource} (using the {@link ComponentTemplateLocator} chain of * command service). The localized resource is used as the key to a cache of {@link ComponentTemplate}s. - * <p/> + * * If a template doesn't exist, then the missing ComponentTemplate is returned. */ public ComponentTemplate getTemplate(ComponentModel componentModel, Locale locale) http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DefaultRequestExceptionHandler.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DefaultRequestExceptionHandler.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DefaultRequestExceptionHandler.java index 5923dfb..26c0a63 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DefaultRequestExceptionHandler.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DefaultRequestExceptionHandler.java @@ -29,7 +29,6 @@ import org.apache.tapestry5.services.*; import org.slf4j.Logger; import javax.servlet.http.HttpServletResponse; - import java.io.IOException; import java.io.OutputStream; import java.net.URLEncoder; @@ -44,12 +43,12 @@ import java.util.Map.Entry; * servlet spec's standard error handling, the default exception handler allows configuring handlers for specific types of * exceptions. The error-page/exception-type configuration in web.xml does not work in Tapestry application as errors are * wrapped in Tapestry's exception types (see {@link OperationException} and {@link ComponentEventException} ). - * <p/> + * * Configurations are flexible. You can either contribute a {@link ExceptionHandlerAssistant} to use arbitrary complex logic * for error handling or a page class to render for the specific exception. Additionally, exceptions can carry context for the - * error page. Exception context is formed either from the name of Exception (e.g. SmtpNotRespondingException -> ServiceFailure mapping + * error page. Exception context is formed either from the name of Exception (e.g. SmtpNotRespondingException {@code ->} ServiceFailure mapping * would render a page with URL /servicefailure/smtpnotresponding) or they can implement {@link ContextAwareException} interface. - * <p/> + * * If no configured exception type is found, the default exception page {@link SymbolConstants#EXCEPTION_REPORT_PAGE} is rendered. * This fallback exception page must implement the {@link org.apache.tapestry5.services.ExceptionReporter} interface. */ @@ -130,7 +129,7 @@ public class DefaultRequestExceptionHandler implements RequestExceptionHandler /** * Handles the exception thrown at some point the request was being processed - * <p/> + * * First checks if there was a specific exception handler/page configured for this exception type, it's super class or super-super class. * Renders the default exception page if none was configured. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DocumentLinker.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DocumentLinker.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DocumentLinker.java index d8b9a12..e63b014 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DocumentLinker.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/DocumentLinker.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 @@ -63,7 +61,7 @@ public interface DocumentLinker * of the page (in a full page render) and collected as the "script" property of the partial page render response. * The JavaScript is executed after the page loads (or in an Ajax update, after external JavaScript libraries are * loaded and the DOM is updated). - * <p/> + * * This method may be called multiple times for the same priority and the script will be accumulated. * * @param priority http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/FormControlNameManager.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/FormControlNameManager.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/FormControlNameManager.java index e4b92f0..e880109 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/FormControlNameManager.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/FormControlNameManager.java @@ -34,8 +34,6 @@ public interface FormControlNameManager /** * Tells whether a given name is reserved. * - * @param string - * @return */ boolean isReserved(String name); http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/LinkSource.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/LinkSource.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/LinkSource.java index 3ec9ef6..40d62ba 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/LinkSource.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/LinkSource.java @@ -50,7 +50,7 @@ public interface LinkSource * Creates a render link for the page. If an activation context is supplied then that context is built into the URI. * If no activation context is supplied, then the activation context is obtained from the page itself, by triggering * a passivate event on its root component. - * <p/> + * * When the activationContext is an empty array, the targeted page is checked to see if it can provide an activation * context. This is accomplished by triggering a "passivate" event on the targeted page. If the override parameter * is true, this will not occur (even when the activation context is empty). http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/MessagesSourceImpl.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/MessagesSourceImpl.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/MessagesSourceImpl.java index e2238e7..4583705 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/MessagesSourceImpl.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/MessagesSourceImpl.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 @@ -35,11 +33,11 @@ import java.util.Map; * them, in accordance with extension rules and locale. This represents code that was refactored out of * {@link ComponentMessagesSourceImpl}. This class can be used as a base class, though the existing code base uses it as * a utility. Composition trumps inheritance! - * <p/> + * * The message catalog for a component is the combination of all appropriate properties files for the component, plus * any keys inherited form base components and, ultimately, the application global message catalog. At some point we * should add support for per-library message catalogs. - * <p/> + * * Message catalogs are read using the UTF-8 character set. This is tricky in JDK 1.5; we read the file into memory then * feed that bytestream to Properties.load(). */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/PageRenderQueue.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/PageRenderQueue.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/PageRenderQueue.java index 9c28827..c169b7f 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/PageRenderQueue.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/PageRenderQueue.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -78,9 +76,9 @@ public interface PageRenderQueue * Adds an optional filter to the rendering. Optional filters are <em>temporary</em>, used just during the current * partial render (as opposed to filters contributed to the * {@link org.apache.tapestry5.services.PartialMarkupRenderer} service which are permanent, shared and stateless. - * <p/> + * * Filters are added to the <em>end</em> of the pipeline (after all permanent contributions). - * <p/> + * * Filters will be executed in the order in which they are added. * * @param filter to add to the pipeline http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/RequestPageCache.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/RequestPageCache.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/RequestPageCache.java index e60b828..4509ee4 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/RequestPageCache.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/RequestPageCache.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 @@ -20,10 +18,10 @@ import org.apache.tapestry5.runtime.PageLifecycleListener; /** * Per-thread service that caches page instances for the duration of the request, and is also responsible for tracking * the active page (the page which will ultimately render the response). - * <p/> + * * Since {@link org.apache.tapestry5.internal.structure.Page} is internal, most user-code should use the * {@link org.apache.tapestry5.services.ComponentSource} service instead. - * <p> + * * Starting in 5.2, page instances are shared (with externalized mutable state), not pooled, but the cache is still * useful for managing the page's {@linkplain PageLifecycleListener lifecycle}. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ResourceDigestManager.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ResourceDigestManager.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ResourceDigestManager.java index 90b1eb2..62b797b 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ResourceDigestManager.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/ResourceDigestManager.java @@ -1,5 +1,3 @@ -// Copyright 2006, 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 @@ -22,10 +20,10 @@ import org.apache.tapestry5.services.ResourceDigestGenerator; * Caches information about resources on the classpath. In addition, acts as an invalidation hub for any resources for * which information is obtained (when any of the resources are changed, invalidation listeners are notified so they can * clear their caches). - * <p/> + * * Note that the name and role of this class changed (and diminished) quite a bit in Tapestry 5.3. It is now focused on * determining which files require a digest, and which what the digests are for resources. - * <p/> + * * Further, in 5.4, this service has been stripped down to an unused placeholder; it only present to prevent * errors where modules have contributed a String extension to protected (even though the service is internal). As of * 5.4, all assets have a built-in checksum in the URL directly (in 5.3 and earlier, the URL included the application @@ -50,7 +48,7 @@ public interface ResourceDigestManager extends InvalidationEventHub /** * Returns the digest for the given path. - * <p/> + * * As of 5.4, simple returns null. * * @param resource http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SaxTemplateParser.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SaxTemplateParser.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SaxTemplateParser.java index 4a7c355..3deaa8d 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SaxTemplateParser.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SaxTemplateParser.java @@ -34,7 +34,7 @@ import static org.apache.tapestry5.internal.services.SaxTemplateParser.Version.* * SAX-based template parser logic, taking a {@link Resource} to a Tapestry * template file and returning * a {@link ComponentTemplate}. - * <p/> + * * Earlier versions of this code used the StAX (streaming XML parser), but that * was really, really bad for Google App Engine. This version uses SAX under the * covers, but kind of replicates the important bits of the StAX API as @@ -339,27 +339,27 @@ public class SaxTemplateParser /** * Processes an element through to its matching end tag. - * <p/> + * * An element can be: - * <p/> + * * a Tapestry component via <t:type> - * <p/> + * * a Tapestry component via t:type="type" and/or t:id="id" - * <p/> + * * a Tapestry component via a library namespace - * <p/> + * * A parameter element via <t:parameter> - * <p/> + * * A parameter element via <p:name> - * <p/> + * * A <t:remove> element (in the 5.1 schema) - * <p/> + * * A <t:content> element (in the 5.1 schema) - * <p/> + * * A <t:block> element - * <p/> + * * The body <t:body> - * <p/> + * * An ordinary element */ void element(TemplateParserState initialState) http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SessionPersistentFieldStrategy.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SessionPersistentFieldStrategy.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SessionPersistentFieldStrategy.java index 3de9108..d53d910 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SessionPersistentFieldStrategy.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/SessionPersistentFieldStrategy.java @@ -1,5 +1,3 @@ -// Copyright 2006, 2007 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.services.Session; /** * A strategy for storing persistent page properties into the {@link Session session}. - * <p/> + * * Builds attribute names as: <code>state:<em>page-name</em>:<em>component-id</em>:<em>field-name</em></code> */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/UnknownActivationContextHandler.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/UnknownActivationContextHandler.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/UnknownActivationContextHandler.java index a48d388..45b1c02 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/UnknownActivationContextHandler.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/UnknownActivationContextHandler.java @@ -1,5 +1,3 @@ -// Copyright 2030 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 java.io.IOException; * enabled. * The default implementation is to respond with a 404 NOT FOUND. * - * @see http://issues.apache.org/jira/browse/TAP5-2070 + * @see <a href="http://issues.apache.org/jira/browse/TAP5-2070">TAP5-2070</a> * @see org.apache.tapestry5.annotations.UnknownActivationContextCheck * @see org.apache.tapestry5.services.HttpError * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/CSSURLRewriter.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/CSSURLRewriter.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/CSSURLRewriter.java index 9d9ccb3..d478ffe 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/CSSURLRewriter.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/CSSURLRewriter.java @@ -35,8 +35,8 @@ import java.util.regex.Pattern; * CSS file will change (which would ordinarily break relative URLs), and for changing the relative directories of * the CSS file and the image assets it may refer to (useful for incorporating a hash of the resource's content into * the exposed URL). - * <p/> - * <p/> + * + * * One potential problem with URL rewriting is the way that URLs for referenced resources are generated; we are * somewhat banking on the fact that referenced resources are non-compressable images. * http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/JavaScriptStackAssembler.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/JavaScriptStackAssembler.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/JavaScriptStackAssembler.java index 735c1e8..1d0698f 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/JavaScriptStackAssembler.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/services/assets/JavaScriptStackAssembler.java @@ -31,7 +31,7 @@ public interface JavaScriptStackAssembler * Obtains the {@link org.apache.tapestry5.services.javascript.JavaScriptStack} by name, and then * uses the {@link org.apache.tapestry5.services.assets.StreamableResourceSource} service to * obtain the assets, which are combined together. - * <p/> + * * Expects the {@linkplain org.apache.tapestry5.services.LocalizationSetter#setNonPersistentLocaleFromLocaleName(String) non-persistent locale} to be set before invoking! */ StreamableResource assembleJavaScriptResourceForStack(String stackName, boolean compress, JavaScriptAggregationStrategy javascriptAggregationStrategy) throws IOException; http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/ComponentPageElementImpl.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/ComponentPageElementImpl.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/ComponentPageElementImpl.java index 6c34ab8..8fc51ba 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/ComponentPageElementImpl.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/ComponentPageElementImpl.java @@ -45,13 +45,13 @@ import java.util.*; * Implements {@link RenderCommand} and represents a component within an overall page. Much of a * component page * element's behavior is delegated to user code, via a {@link org.apache.tapestry5.runtime.Component} instance. - * <p/> + * * Once instantiated, a ComponentPageElement should be registered as a * {@linkplain org.apache.tapestry5.internal.structure.Page#addLifecycleListener(org.apache.tapestry5.runtime.PageLifecycleListener) * lifecycle listener}. This could be done inside the constructors, but that tends to complicate unit tests, so its done * by {@link org.apache.tapestry5.internal.services.PageElementFactoryImpl}. There's still a bit of refactoring in this * class (and its many inner classes) that can improve overall efficiency. - * <p/> + * * Modified for Tapestry 5.2 to adjust for the no-pooling approach (shared instances with externalized mutable state). */ public class ComponentPageElementImpl extends BaseLocatable implements ComponentPageElement http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/Page.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/Page.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/Page.java index 3099c72..80c5d25 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/Page.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/structure/Page.java @@ -26,7 +26,7 @@ import org.slf4j.Logger; * Represents a unique page within the application. Pages are part of the <em>internal</em> structure of a Tapestry * application; end developers who refer to "page" are really referring to the {@link #getRootComponent() root * component} of the actual page. - * <p/> + * * Starting in release 5.2, the nature of pages changed considerably. Pages are no longer pooled instances. Instead, * pages are shared instances (per locale) but all internal <em>mutable</em> state is stored inside * {@link PerthreadManager}. Page construction time is considered to extend past the @@ -35,7 +35,7 @@ import org.slf4j.Logger; * other mechanisms). At best, we can be assured that the entire page construction phase is protected by a single * synchronized block (but not on the page itself). An ideal system would build the page bottom to top so that all * assignments could take place in constructors, assigning to final fields. Maybe some day. - * <p/> + * * The Page object is never visible to end-user code, though it exposes an interface ({@link PageLifecycleCallbackHub} that * {@linkplain org.apache.tapestry5.ComponentResources#getPageLifecycleCallbackHub() is}). */ @@ -108,13 +108,13 @@ public interface Page extends PageLifecycleCallbackHub * Invoked to inform the page that it is being detached from the current request. This occurs * just before the page * is returned to the page pool. - * <p/> + * * A page may be clean or dirty. A page is dirty if its dirty count is greater than zero (meaning that, during the * render of the page, some components did not fully render), or if any of its listeners throw an exception from * containingPageDidDetach(). - * <p/> + * * The page pool should discard pages that are dirty, rather than store them into the pool. - * <p/> + * * Under Tapestry 5.2 and pool-less pages, the result is ignored; all mutable state is expected to be discarded * automatically from the {@link PerthreadManager}. A future release of Tapestry will likely convert this method to * type void. @@ -128,7 +128,7 @@ public interface Page extends PageLifecycleCallbackHub * Invoked to inform the page that it is attached to the current request. This occurs when a * page is first referenced within a request. If the page was created from scratch for this request, the call * to {@link #loaded()} will preceded the call to {@link #attached()}. - * <p/> + * * First all listeners have {@link PageLifecycleListener#restoreStateBeforePageAttach()} invoked, followed by * {@link PageLifecycleListener#containingPageDidAttach()}. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/EventHandlerMethodParameterProvider.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/EventHandlerMethodParameterProvider.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/EventHandlerMethodParameterProvider.java index e69526c..6ba04bf 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/EventHandlerMethodParameterProvider.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/EventHandlerMethodParameterProvider.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 @@ -20,7 +18,7 @@ import org.apache.tapestry5.runtime.ComponentEvent; * Supplies one parameter value when invoking a component event handler method. In general, * this involves extracting a value form the event's context and coercing it to a type * appropriate to the parameter. - * <p/> + * * These values are accumulated and used to invoke the event handler method. * * @since 5.2.0 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/InjectWorker.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/InjectWorker.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/InjectWorker.java index 39273bd..85b6b35 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/InjectWorker.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/InjectWorker.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 @@ -30,7 +28,7 @@ import org.apache.tapestry5.services.transform.TransformationSupport; /** * Performs injection triggered by any field annotated with the {@link org.apache.tapestry5.ioc.annotations.Inject} * annotation or the {@link javax.inject.Inject} annotation. - * <p/> + * * The implementation of this worker mostly delegates to a chain of command of {@link InjectionProvider2}. */ public class InjectWorker implements ComponentClassTransformWorker2 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/ParameterConduit.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/ParameterConduit.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/ParameterConduit.java index e2a99a7..336d074 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/ParameterConduit.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/transform/ParameterConduit.java @@ -1,5 +1,3 @@ -// Copyright 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 @@ -24,10 +22,10 @@ import org.apache.tapestry5.plastic.FieldConduit; * A facade around {@link Binding} and {@link InternalComponentResources} that is used to instrument * fields with the {@link Parameter} annotation. Extends {@link FieldConduit} so that * the get() method implicitly coerces the value to the field's type. - * <p/> + * * {@link #get(Object, org.apache.tapestry5.plastic.InstanceContext)} will read from the underlying {@link Binding} and used the {@link TypeCoercer} coerce the value to the * parameter field's type. get() also includes a null value check (as per {@link Parameter#allowNull()}. - * <p/> + * * {@link #set(Object, org.apache.tapestry5.plastic.InstanceContext, Object)} pushes the value into the binding. * * @since 5.2.0 http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/LocaleUtils.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/LocaleUtils.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/LocaleUtils.java index 7d6f2ee..773d2f8 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/LocaleUtils.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/LocaleUtils.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 @@ -22,17 +20,17 @@ import java.util.Locale; public class LocaleUtils { /** - * <p>Converts a String to a Locale.</p> <p/> <p>This method takes the string format of a locale and creates the - * locale object from it.</p> <p/> + * Converts a String to a Locale. This method takes the string format of a locale and creates the + * locale object from it. * <pre> * LocaleUtils.toLocale("en") = new Locale("en", "") * LocaleUtils.toLocale("en_GB") = new Locale("en", "GB") * LocaleUtils.toLocale("en_GB_xxx") = new Locale("en", "GB", "xxx") (#) * </pre> - * <p/> <p>(#) The behaviour of the JDK variant constructor changed between JDK1.3 and JDK1.4. In JDK1.3, the + * (#) The behaviour of the JDK variant constructor changed between JDK1.3 and JDK1.4. In JDK1.3, the * constructor upper cases the variant, in JDK1.4, it doesn't. Thus, the result from getVariant() may vary depending - * on your JDK.</p> <p/> <p>This method validates the input strictly. The language code must be lowercase. The - * country code must be uppercase. The separator must be an underscore. The length must be correct. </p> + * on your JDK. This method validates the input strictly. The language code must be lowercase. The + * country code must be uppercase. The separator must be an underscore. The length must be correct. * * @param input the locale String to convert, null returns null * @return a Locale, null if null input http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/NamedSet.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/NamedSet.java b/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/NamedSet.java index 301954c..dce5b75 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/NamedSet.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/internal/util/NamedSet.java @@ -29,7 +29,7 @@ import java.util.concurrent.locks.ReadWriteLock; * This is optimized to use less memory (than a {@link CaseInsensitiveMap} (it uses a singly-liked list), * though the cost of a lookup is more expensive. However, this is a good match against many of the structures inside * a page instance, where most lookups occur only during page constructions, and the number of values is often small. - * <p/> + * * Each NameSet has its own {@link ReadWriteLock}. * * @param <T> http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/model/ComponentModel.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/model/ComponentModel.java b/tapestry-core/src/main/java/org/apache/tapestry5/model/ComponentModel.java index 6366611..1133723 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/model/ComponentModel.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/model/ComponentModel.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 @@ -14,10 +12,11 @@ package org.apache.tapestry5.model; -import org.apache.tapestry5.annotations.MixinAfter; -import org.apache.tapestry5.annotations.Persist; -import org.apache.tapestry5.annotations.SupportsInformalParameters; +import org.apache.tapestry5.EventConstants; +import org.apache.tapestry5.annotations.*; import org.apache.tapestry5.ioc.Resource; +import org.apache.tapestry5.services.ComponentClassResolver; +import org.apache.tapestry5.services.LibraryMapping; import org.slf4j.Logger; import java.util.List; @@ -36,8 +35,8 @@ public interface ComponentModel * Returns the name of the library that defines this component; this may be the empty string for * an application page or component, or will be a name of a library (possibly including "core" for built-in * components). - * Library names are defined by the {@link org.apache.tapestry5.services.LibraryMapping} contributions - * to the {@link org.apache.tapestry5.services.ComponentClassResolver} service. + * Library names are defined by the {@link LibraryMapping} contributions + * to the {@link ComponentClassResolver} service. * * @return library name containing the component, or empty string for application components * @since 5.4 @@ -65,7 +64,7 @@ public interface ComponentModel /** * Returns the ids of all embedded components defined within the component class (via the {@link - * org.apache.tapestry5.annotations.Component} annotation), including those defined by any super-class. + * Component} annotation), including those defined by any super-class. */ List<String> getEmbeddedComponentIds(); @@ -185,8 +184,7 @@ public interface ComponentModel /** * Returns a set of all the render phases that this model (including parent models) that are handled. Render phases - * are represented by the corresponding annotation ({@link org.apache.tapestry5.annotations.BeginRender}, {@link - * org.apache.tapestry5.annotations.AfterRender}, etc.). + * are represented by the corresponding annotation ({@link BeginRender}, {@link AfterRender}, etc.). * * @return set of classes * @since 5.0.19, 5.1.0.0 @@ -213,13 +211,12 @@ public interface ComponentModel String[] getOrderForMixin(String mixinClassName); /** - * Relevant for pages only, indicates that the component handle the {@link org.apache.tapestry5.EventConstants.ACTIVATE} + * Relevant for pages only, indicates that the component handle the {@link EventConstants#ACTIVATE} * events with a catch all rules * + * @return true if the page implements catch all rules for the activate event context, or false otherwise + * @see MutableComponentModel#doHandleActivationEventContext() * @since 5.4 - * @see {@link MutableComponentModel.doHandleActivationEventContext()} - * @return <code>true</code> in case the page implement a catch all rules for the activate event context, - * <code>false</code> otherwise */ boolean handleActivationEventContext(); } http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/model/MutableComponentModel.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/model/MutableComponentModel.java b/tapestry-core/src/main/java/org/apache/tapestry5/model/MutableComponentModel.java index e289ba5..623a6df 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/model/MutableComponentModel.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/model/MutableComponentModel.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 @@ -122,7 +120,7 @@ public interface MutableComponentModel extends ComponentModel void addEventHandler(String eventType); /** - * Relevant for pages only, identifies that the component handle {@link org.apache.tapestry5.EventConstants.ACTIVATE} + * Relevant for pages only, identifies that the component handle {@link org.apache.tapestry5.EventConstants#ACTIVATE} * events supporting one of the three special case for catch all rules: * <ul> * <li><code>{@link java.lang.Object}[]</code></li> http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/modules/AssetsModule.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/modules/AssetsModule.java b/tapestry-core/src/main/java/org/apache/tapestry5/modules/AssetsModule.java index 513f118..bc306a3 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/modules/AssetsModule.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/modules/AssetsModule.java @@ -326,6 +326,7 @@ public class AssetsModule * <dt>AppCatalog</dt> * <dd>The Resource defined by {@link SymbolConstants#APPLICATION_CATALOG}</dd> * <dt> + * </dl> * * @since 5.2.0 */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/modules/InternalModule.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/modules/InternalModule.java b/tapestry-core/src/main/java/org/apache/tapestry5/modules/InternalModule.java index 6d7f967..682fdc4 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/modules/InternalModule.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/modules/InternalModule.java @@ -27,7 +27,6 @@ import org.apache.tapestry5.services.*; import org.apache.tapestry5.services.transform.ControlledPackageType; import javax.servlet.http.Cookie; - import java.util.Map; /** @@ -103,7 +102,7 @@ public class InternalModule * <dl> * <dt>LinkDecoration (instance of {@link LinkDecorationListener})</dt> * <dd>Triggers events for notifications about links</dd> - * <dl> + * </dl> * * @since 5.2.0 */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/modules/JavaScriptModule.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/modules/JavaScriptModule.java b/tapestry-core/src/main/java/org/apache/tapestry5/modules/JavaScriptModule.java index c11d6a9..9a092ea 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/modules/JavaScriptModule.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/modules/JavaScriptModule.java @@ -106,7 +106,7 @@ public class JavaScriptModule * <dt>jquery</dt> * <dd>Added if the infrastructure provider is "jquery".</dd> * </dl> - * <p/> + * * User modules may replace or extend this list. */ @Contribute(JavaScriptStack.class) http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/modules/TapestryModule.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/modules/TapestryModule.java b/tapestry-core/src/main/java/org/apache/tapestry5/modules/TapestryModule.java index 119ca58..2c67c04 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/modules/TapestryModule.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/modules/TapestryModule.java @@ -507,8 +507,8 @@ public final class TapestryModule * <dd>Support for the {@link HeartbeatDeferred} annotation, which defers method invocation to the end of the {@link Heartbeat} * <dt>Inject</dt> * <dd>Used with the {@link org.apache.tapestry5.ioc.annotations.Inject} annotation, when a value is supplied</dd> + * <dt>Operation</dt> <dd>Support for the {@link Operation} method annotation</dd> * </dl> - * <dd>Operation</dt> <dd>Support for the {@link Operation} method annotation</dd></dd> */ @Contribute(ComponentClassTransformWorker2.class) @Primary @@ -769,6 +769,7 @@ public final class TapestryModule * applications</dd> * <dt>GZip</dt> * <dd>Handles GZIP compression of response streams (if supported by client)</dd> + * </dl> */ public void contributeHttpServletRequestHandler(OrderedConfiguration<HttpServletRequestFilter> configuration, @@ -1157,7 +1158,7 @@ public final class TapestryModule * Builds the PropBindingFactory as a chain of command. The terminator of * the chain is responsible for ordinary * property names (and property paths). - * <p/> + * * This mechanism has been replaced in 5.1 with a more sophisticated parser based on ANTLR. See <a * href="https://issues.apache.org/jira/browse/TAP5-79">TAP5-79</a> for details. There are no longer any built-in * contributions to the configuration. @@ -1600,7 +1601,7 @@ public final class TapestryModule * <dt>{@link org.apache.tapestry5.ajax.MultiZoneUpdate}</dt> * <dd>Sends a single JSON response to update the content of multiple zones * </dl> - * <p/> + * * In most cases, when you want to support a new type, you should convert it to one of the built-in supported types * (such as {@link RenderCommand}. You can then inject the master AjaxComponentEventResultProcessor (use the * {@link Ajax} marker annotation) and delegate to it. @@ -2238,7 +2239,7 @@ public final class TapestryModule /** * Contributes strategies accessible via the {@link NullFieldStrategySource} service. - * <p/> + * * <dl> * <dt>default</dt> * <dd>Does nothing, nulls stay null.</dd> @@ -2255,9 +2256,9 @@ public final class TapestryModule /** * Determines positioning of hidden fields relative to other elements (this * is needed by {@link org.apache.tapestry5.corelib.components.FormFragment} and others. - * <p/> + * * For elements input, select, textarea and label the hidden field is positioned after. - * <p/> + * * For elements p, div, li and td, the hidden field is positioned inside. */ public static void contributeHiddenFieldLocationRules( http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/runtime/Component.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/runtime/Component.java b/tapestry-core/src/main/java/org/apache/tapestry5/runtime/Component.java index 0e0bb34..e79d185 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/runtime/Component.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/runtime/Component.java @@ -1,5 +1,3 @@ -// Copyright 2006, 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 @@ -22,10 +20,10 @@ import org.apache.tapestry5.annotations.OnEvent; * many different events. This interface is part of the public API for Tapestry, but is <em>not</em> expected to be * directly implemented by component classes; it should only be implemented as part of the component class * transformation process. - * <p/> + * * Most of the methods are related to render phases; see the corresponding annotations and component rendering * documentation to see how they relate to each other. - * <p/> + * * Starting in 5.3 this interface no longer implements {@link PageLifecycleListener}. Normally, this would be an incompatible * change, but Component is not supposed to be directly implemented by user code. */ http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/runtime/RenderCommand.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/runtime/RenderCommand.java b/tapestry-core/src/main/java/org/apache/tapestry5/runtime/RenderCommand.java index ee438d0..7921e47 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/runtime/RenderCommand.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/runtime/RenderCommand.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 @@ -25,7 +23,7 @@ public interface RenderCommand * Invoked on an object to request that it render itself. This involves a mix of invoking methods on the writer, and * queueing up additional commands (often, representing children of the object that was invoked) to perform * additional rendering. - * <p/> + * * In this way, rendering is a tail recursive algorithm, but is not implemented using tail recursion. */ void render(MarkupWriter writer, RenderQueue queue); http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-core/src/main/java/org/apache/tapestry5/services/ApplicationStateManager.java ---------------------------------------------------------------------- diff --git a/tapestry-core/src/main/java/org/apache/tapestry5/services/ApplicationStateManager.java b/tapestry-core/src/main/java/org/apache/tapestry5/services/ApplicationStateManager.java index 05569dd..f3f943f 100644 --- a/tapestry-core/src/main/java/org/apache/tapestry5/services/ApplicationStateManager.java +++ b/tapestry-core/src/main/java/org/apache/tapestry5/services/ApplicationStateManager.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 @@ -21,11 +19,11 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration; * Responsible for managing <em>session state objects</em>, objects which persist between requests, but are not tied to * any individual page or component. SSOs are also created on demand. SSOs are typically stored in the session, so that * they are specific to a particular client. - * <p/> + * * The term "Application" is a hold-over from Tapestry 5.0, which used the @ApplicationState (deprecated and deleted) * annotation, and called them "ASOs" (Application State Objects). This service would be better named * "SessionStateManager" (but renaming it would cause backwards compatibility issues). - * <p/> + * * Tapestry has a built-in default strategy for storing SSOs (in the session) and instantiating them. If desired, * contributions to the service configuration can override the default behavior, either specifying an alternate storage * strategy, or an alternate {@linkplain org.apache.tapestry5.services.ApplicationStateCreator creation strategy}.