You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by hl...@apache.org on 2015/04/06 21:20:18 UTC
[3/9] tapestry-5 git commit: Clean up markup inside JavaDoc to
confirm to JDK 1.8's stricter rules
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/services/cron/CronExpression.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/services/cron/CronExpression.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/services/cron/CronExpression.java
index e2a3c75..1a71ca9 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/services/cron/CronExpression.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/services/cron/CronExpression.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
@@ -16,98 +14,83 @@ package org.apache.tapestry5.ioc.internal.services.cron;
import java.io.Serializable;
import java.text.ParseException;
-import java.util.Calendar;
-import java.util.Date;
-import java.util.HashMap;
-import java.util.Locale;
-import java.util.Map;
-import java.util.SortedSet;
-import java.util.StringTokenizer;
-import java.util.TimeZone;
-import java.util.TreeSet;
+import java.util.*;
/**
* Provides a parser and evaluator for unix-like cron expressions. Cron
* expressions provide the ability to specify complex time combinations such as
* "At 8:00am every Monday through Friday" or "At 1:30am every
* last Friday of the month".
- * <P>
+ *
* Cron expressions are comprised of 6 required fields and one optional field
* separated by white space. The fields respectively are described as follows:
- * <p/>
+ *
* <table cellspacing="8">
* <tr>
* <th align="left">Field Name</th>
* <th align="left"> </th>
* <th align="left">Allowed Values</th>
- * <th align="left"> </th>
* <th align="left">Allowed Special Characters</th>
* </tr>
* <tr>
* <td align="left"><code>Seconds</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>0-59</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * /</code></td>
* </tr>
* <tr>
* <td align="left"><code>Minutes</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>0-59</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * /</code></td>
* </tr>
* <tr>
* <td align="left"><code>Hours</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>0-23</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * /</code></td>
* </tr>
* <tr>
* <td align="left"><code>Day-of-month</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>1-31</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * ? / L W</code></td>
* </tr>
* <tr>
* <td align="left"><code>Month</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>1-12 or JAN-DEC</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * /</code></td>
* </tr>
* <tr>
* <td align="left"><code>Day-of-Week</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>1-7 or SUN-SAT</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * ? / L #</code></td>
* </tr>
* <tr>
* <td align="left"><code>Year (Optional)</code></td>
- * <td align="left"> </th>
+ * <td align="left"> </td>
* <td align="left"><code>empty, 1970-2199</code></td>
- * <td align="left"> </th>
* <td align="left"><code>, - * /</code></td>
* </tr>
+ * <caption>Cron Expressions</caption>
* </table>
- * <P>
+ *
* The '*' character is used to specify all values. For example, "*"
* in the minute field means "every minute".
- * <P>
+ *
* The '?' character is allowed for the day-of-month and day-of-week fields. It
* is used to specify 'no specific value'. This is useful when you need to
* specify something in one of the two fields, but not the other.
- * <P>
+ *
* The '-' character is used to specify ranges For example "10-12" in
* the hour field means "the hours 10, 11 and 12".
- * <P>
+ *
* The ',' character is used to specify additional values. For example
* "MON,WED,FRI" in the day-of-week field means "the days Monday,
* Wednesday, and Friday".
- * <P>
+ *
* The '/' character is used to specify increments. For example "0/15"
* in the seconds field means "the seconds 0, 15, 30, and 45". And
* "5/15" in the seconds field means "the seconds 5, 20, 35, and
@@ -119,7 +102,7 @@ import java.util.TreeSet;
* on every "nth" value in the given set. Thus "7/6" in the
* month field only turns on month "7", it does NOT mean every 6th
* month, please note that subtlety.
- * <P>
+ *
* The 'L' character is allowed for the day-of-month and day-of-week fields.
* This character is short-hand for "last", but it has different
* meaning in each of the two fields. For example, the value "L" in
@@ -132,7 +115,7 @@ import java.util.TreeSet;
* from the last day of the month, such as "L-3" which would mean the third-to-last
* day of the calendar month. <i>When using the 'L' option, it is important not to
* specify lists, or ranges of values, as you'll get confusing/unexpected results.</i>
- * <P>
+ *
* The 'W' character is allowed for the day-of-month field. This character
* is used to specify the weekday (Monday-Friday) nearest the given day. As an
* example, if you were to specify "15W" as the value for the
@@ -144,11 +127,11 @@ import java.util.TreeSet;
* 1st is a Saturday, the trigger will fire on Monday the 3rd, as it will not
* 'jump' over the boundary of a month's days. The 'W' character can only be
* specified when the day-of-month is a single day, not a range or list of days.
- * <P>
+ *
* The 'L' and 'W' characters can also be combined for the day-of-month
* expression to yield 'LW', which translates to "last weekday of the
* month".
- * <P>
+ *
* The '#' character is allowed for the day-of-week field. This character is
* used to specify "the nth" XXX day of the month. For example, the
* value of "6#3" in the day-of-week field means the third Friday of
@@ -159,7 +142,7 @@ import java.util.TreeSet;
* no firing will occur that month. If the '#' character is used, there can
* only be one expression in the day-of-week field ("3#1,6#3" is
* not valid, since there are two expressions).
- * <P>
+ *
* <!--The 'C' character is allowed for the day-of-month and day-of-week fields.
* This character is short-hand for "calendar". This means values are
* calculated against the associated calendar, if any. If no calendar is
@@ -167,11 +150,11 @@ import java.util.TreeSet;
* value of "5C" in the day-of-month field means "the first day included by the
* calendar on or after the 5th". A value of "1C" in the day-of-week field
* means "the first day included by the calendar on or after Sunday".-->
- * <P>
+ *
* The legal characters and the names of months and days of the week are not
* case sensitive.
- * <p/>
- * <p>
+ *
+ *
* <b>NOTES:</b>
* <ul>
* <li>Support for specifying both a day-of-week and a day-of-month value is
@@ -185,7 +168,7 @@ import java.util.TreeSet;
* interpretation CronExpression chooses. An example would be
* "0 0 14-6 ? * FRI-MON". </li>
* </ul>
- * </p>
+ *
*
* @author Sharada Jambula, James House
* @author Contributions from Mads Henderson
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/ConcurrentBarrier.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/ConcurrentBarrier.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/ConcurrentBarrier.java
index f861e8d..eb37a08 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/ConcurrentBarrier.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/internal/util/ConcurrentBarrier.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 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
@@ -51,7 +49,7 @@ public class ConcurrentBarrier
* Invokes the object after acquiring the read lock (if necessary). If invoked when the read lock has not yet been
* acquired, then the lock is acquired for the duration of the call. If the lock has already been acquired, then the
* status of the lock is not changed.
- * <p/>
+ *
* TODO: Check to see if the write lock is acquired and <em>not</em> acquire the read lock in that situation.
* Currently this code is not re-entrant. If a write lock is already acquired and the thread attempts to get the
* read lock, then the thread will hang. For the moment, all the uses of ConcurrentBarrier are coded in such a way
@@ -216,7 +214,7 @@ public class ConcurrentBarrier
* @param runnable Runnable object to execute inside the write lock.
* @param timeout Time to wait for write lock.
* @param timeoutUnit Units of timeout.
- * @return true if lock was obtained & runnabled executed. False otherwise.
+ * @return true if lock was obtained and the runnable executed, or false otherwise.
*/
public boolean tryWithWrite(final Runnable runnable, long timeout, TimeUnit timeoutUnit)
{
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ChainBuilder.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ChainBuilder.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ChainBuilder.java
index 4505528..efd079e 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ChainBuilder.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ChainBuilder.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
@@ -20,16 +18,16 @@ import java.util.List;
* A service which can assemble an implementation based on a command interface, and an ordered list of objects
* implementing that interface (the "commands"). This is an implementation of the Gang of Four Chain Of Command
* pattern.
- * <p/>
+ *
* For each method in the interface, the chain implementation will call the corresponding method on each command object
* in turn (with the order defined by the list). If any of the command objects return true, then the chain of command
* stops and the initial method invocation returns true. Otherwise, the chain of command continues to the next command
* (and will return false if none of the commands returns true).
- * <p/>
+ *
* For methods whose return type is not boolean, the chain stops with the first non-null (for object types), or non-zero
* (for numeric types). The chain returns the value that was returned by the command. If the method return type is void,
* all commands will be invoked.
- * <p/>
+ *
* Method invocations will also be terminated if an exception is thrown.
*/
public interface ChainBuilder
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ExceptionAnalysis.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ExceptionAnalysis.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ExceptionAnalysis.java
index 142d4d6..7662301 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ExceptionAnalysis.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ExceptionAnalysis.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
@@ -18,7 +16,7 @@ import java.util.List;
/**
* An analysis of an exception (including nested exceptions).
- * <p/>
+ *
* TODO: Make serializable and/or convert to XML format.
*/
public interface ExceptionAnalysis
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LazyAdvisor.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LazyAdvisor.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LazyAdvisor.java
index 6db5eb4..463378a 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LazyAdvisor.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LazyAdvisor.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
@@ -22,12 +20,12 @@ import org.apache.tapestry5.ioc.MethodAdviceReceiver;
* as if any of the parameters to a method are mutable, or the internal state of the invoked service changes, the lazily
* evaluated results may not match the immediately evaluated result. This effect is greatly exaggerated if the lazy
* return object is evaluated in a different thread than when it was generated.
- * <p/>
+ *
* Another consideration is that exceptions that would occur immediately in the non-lazy case are also deferred, often
* losing much context in the process.
- * <p/>
+ *
* Use laziness with great care.
- * <p/>
+ *
* Use the {@link org.apache.tapestry5.ioc.annotations.NotLazy} annotation on methods that should not be advised.
*
* @since 5.1.0.0
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LoggingDecorator.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LoggingDecorator.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LoggingDecorator.java
index be0c43e..bfa0eeb 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LoggingDecorator.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/LoggingDecorator.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 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,7 +18,7 @@ import org.slf4j.Logger;
* Service that can create a logging interceptor that wraps around a service implementation (or interceptor). The
* interceptor works with the service's log to log, at debug level, method entry (with arguments), method exit (with
* return value, if any) as well as any thrown exceptions.
- * <p/>
+ *
* This represents the Tapestry 5.0 decorator approach; for Tapestry 5.1 you may want to use the {@link
* org.apache.tapestry5.ioc.services.LoggingAdvisor} in conjunction with a service advisor method.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/MasterObjectProvider.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/MasterObjectProvider.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/MasterObjectProvider.java
index defe334..41ae3d4 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/MasterObjectProvider.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/MasterObjectProvider.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
@@ -22,11 +20,11 @@ import org.apache.tapestry5.ioc.annotations.UsesOrderedConfiguration;
/**
* A service that acts as a chain-of-command over a number of {@link org.apache.tapestry5.ioc.ObjectProvider}, but
* allows for the case where no object may be provided.
- * <p/>
+ *
* This service is itself a key part of Tapestry's general injection mechanism; it is used when instantiating a service
* implementation instance, invoking module methods (service builder, decorator, or contribution methods), when
* {@linkplain ObjectLocator#autobuild(Class) autobuilding} objects of any type.
- * <p/>
+ *
* As of Tapestry 5.3, the MasterObjectProvider allows injection of {@link org.apache.tapestry5.ioc.OperationTracker} as a
* special case (not based on a contributed ObjectProvider).
*/
@@ -37,7 +35,7 @@ public interface MasterObjectProvider
* Provides an object based on an expression. The process of providing objects occurs within a particular
* <em>context</em>, which will typically be a service builder method, service contributor method, or service
* decorator method. The locator parameter provides access to the services visible <em>to that context</em>.
- * <p/>
+ *
* When the value is required and no {@link ObjectProvider} provided a non-null value, then {@link
* ObjectLocator#getService(Class, Class[])} is invoked (with no marker annotations),
* to provide a uniquely matching service, or throw a failure exception
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PerthreadManager.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PerthreadManager.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PerthreadManager.java
index ad2512f..a906819 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PerthreadManager.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PerthreadManager.java
@@ -19,10 +19,6 @@ import org.apache.tapestry5.ioc.ObjectCreator;
* Manages per-thread data, and provides a way for listeners to know when such data should be cleaned up. Typically,
* data is cleaned up at the end of the request (in a web application). Tapestry IoC has any number of objects that need
* to know when this event occurs, so that they can clean up any per-thread/per-request state.
- * <p/>
- * Due to <a href="https://issues.apache.org/jira/browse/TAPESTRY-2141">TAPESTRY-2141<a> (and the underlying JDK 1.5 bug
- * <a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5025230">5025230</a>), this service has expanded to
- * manage per-thread data (not just end-of-request listeners).
*/
public interface PerthreadManager
{
@@ -57,8 +53,8 @@ public interface PerthreadManager
<T> PerThreadValue<T> createValue();
/**
- * Return {@link org.apache.tapestry5.ioc.ObjectCreator}, which for each thread,
- * the first call will use the delegate {@link org.apache.tapestry5.ioc.ObjectCreator} to create
+ * Return {@link ObjectCreator}, which for each thread,
+ * the first call will use the delegate {@link ObjectCreator} to create
* an instance, and later calls will reuse the same per-thread instance. The instance is stored in the
* {@link org.apache.tapestry5.ioc.services.PerthreadManager} and will be released at the end of the request.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PipelineBuilder.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PipelineBuilder.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PipelineBuilder.java
index 98dfa97..2cfa200 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PipelineBuilder.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PipelineBuilder.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
@@ -23,15 +21,15 @@ import java.util.List;
* filter interface: the filter interface is a variant of the service interface, where each method has an additional
* parameter that is an instance of the service interface. Typically, this service parameter (often named "delegate") is
* either the first or the last parameter of each method.
- * <p/>
+ *
* The implementation of a filter method is expected to pass all of its parameters to the service instance passed into
* it.
- * <p/>
+ *
* The interesting thing is that there may be multiple filters in the pipeline. A fabricated "bridge" object (that
* implements the service interface) is created to let each filter invoke methods on the next filter down the pipeline.
* This simplifies the model for creating pipelines, as each filter is coded as if it was directly "in front of" the
* terminator. In fact, it may be indirectly invoking methods on the next filter in the pipeline via a bridge instance.
- * <p/>
+ *
* The builder is fairly smart about matching up service interface methods to filter interface methods, but keeping it
* simple is also a good idea. By convention, the final parameter of each filter method is the delegate object (the bridge or terminator).
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PropertyShadowBuilder.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PropertyShadowBuilder.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PropertyShadowBuilder.java
index 95ecc33..22b5fab 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PropertyShadowBuilder.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/PropertyShadowBuilder.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
@@ -18,7 +16,7 @@ package org.apache.tapestry5.ioc.services;
* Creates a "shadow" of a property of an object. The shadow has the same type as the property, and delegates all method
* invocations to the property. Each method invocation on the shadow re-acquires the value of the property from the
* underlying object and delegates to the current value of the property.
- * <p/>
+ *
* Typically, the object in question is another service, one with the "perthread" service lifecycle. This allows a
* global singleton to shadow a value that is specific to the current thread (and therefore, the current request).
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceLifecycleSource.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceLifecycleSource.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceLifecycleSource.java
index 13a1523..c18d946 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceLifecycleSource.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceLifecycleSource.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* Provides access to user defined lifecycles (beyond the two built-in lifecycles: "singleton" and "primitive"). The
* user defined lifecycles are contributed into the service's configuration.
- * <p/>
+ *
* Note that the default scope {@linkplain org.apache.tapestry5.ioc.ScopeConstants#DEFAULT "singleton"} is special and
* not a contribution.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceOverride.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceOverride.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceOverride.java
index 383c8cc..e822c70 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceOverride.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ServiceOverride.java
@@ -1,5 +1,3 @@
-// Copyright 2009, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,7 +19,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
* Used to override built in services. Simply contribute a mapping from a type to an instance of that type. Anywhere
* that exact type is injected, without specifying markers or other annotations, the contributed instance will be
* injected, even if there is already a service that implements the interface.
- * <p>
+ *
* In fact, this is <em>not</em> limited to overriding services; any object that can be injected based solely on type
* can be contributed.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/StrategyBuilder.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/StrategyBuilder.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/StrategyBuilder.java
index 6ddac07..ece42e0 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/StrategyBuilder.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/StrategyBuilder.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,12 +19,12 @@ import java.util.Map;
/**
* A service implementation builder that operates around a {@link StrategyRegistry}, implementing a version of the Gang
* of Four Strategy pattern.
- * <p/>
+ *
* The constructed service is configured with a number of adapters (that implement the same service interface). Method
* invocations on the service are routed to one of the adapters.
- * <p/>
+ *
* The first parameter of each method is used to select the appropriate adapter.
- * <p/>
+ *
* The ideal interface for use with this builder has only one method.
*/
public interface StrategyBuilder
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolProvider.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolProvider.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolProvider.java
index 8a1f134..9745090 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolProvider.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolProvider.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 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
@@ -18,7 +16,7 @@ import org.apache.tapestry5.ioc.annotations.UsesMappedConfiguration;
/**
* A provider of values for symbols, used by the {@link org.apache.tapestry5.ioc.services.SymbolSource} service.
- * <p/>
+ *
* This is the service interface for the FactoryDefaults and ApplicationDefaults services; each of these takes a
* configuration mapping symbols to their values.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolSource.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolSource.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolSource.java
index 52c1c41..a38d718 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolSource.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/SymbolSource.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -21,7 +19,7 @@ import org.apache.tapestry5.ioc.annotations.Value;
* Used to manage <em>symbols</em>, configuration properties whose value is evaluated at runtime. Symbols use the Ant
* syntax: <code>${foo.bar.baz}</code> where <code>foo.bar.baz</code> is the name of the symbol. The symbol may appear
* inside some annotation, such as {@link Value}.
- * <p/>
+ *
* The SymbolSource service configuration is an ordered list of {@link org.apache.tapestry5.ioc.services.SymbolProvider}s.
* Two key SymbolProvider services are FactoryDefaults and ApplicationDefaults.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ThreadCleanupListener.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ThreadCleanupListener.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ThreadCleanupListener.java
index b465b4f..b857cbf 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ThreadCleanupListener.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/ThreadCleanupListener.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 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
@@ -18,7 +16,7 @@ import java.util.EventListener;
/**
* Listener interface for object that need to know about thread event cleanup.
- * <p/>
+ *
* Note that registration with the {@link org.apache.tapestry5.ioc.services.PerthreadManager} is a one-shot affair; it
* lasts no longer than the next cleanup.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/Schedule.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/Schedule.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/Schedule.java
index f22319e..cab803a 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/Schedule.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/services/cron/Schedule.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
@@ -31,7 +29,7 @@ public interface Schedule
* Computes the next execution time for a job.
*
* @param previousExecution time of previous execution (in system clock millis)
- * @return time of next execution (in system clock millis) or a value <=0 to cancel the job's execution
+ * @return time of next execution (in system clock millis) or a value <= 0 to cancel the job's execution
*/
long nextExecution(long previousExecution);
}
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/IdAllocator.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/IdAllocator.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/IdAllocator.java
index fde8d07..6bf275c 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/IdAllocator.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/IdAllocator.java
@@ -1,5 +1,3 @@
-// Copyright 2004, 2005, 2006, 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,18 +12,18 @@
package org.apache.tapestry5.ioc.util;
+import org.apache.tapestry5.ioc.internal.util.CollectionFactory;
+import org.apache.tapestry5.ioc.internal.util.InternalUtils;
+
import java.util.HashMap;
import java.util.IdentityHashMap;
import java.util.List;
import java.util.Map;
-import org.apache.tapestry5.ioc.internal.util.CollectionFactory;
-import org.apache.tapestry5.ioc.internal.util.InternalUtils;
-
/**
* Used to "uniquify" names within a given context. A base name is passed in, and the return value is the base name, or
* the base name extended with a suffix to make it unique.
- * <p/>
+ *
* This class is not threadsafe.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/LocalizedNameGenerator.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/LocalizedNameGenerator.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/LocalizedNameGenerator.java
index 6f86cc7..c7c7dab 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/LocalizedNameGenerator.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/ioc/util/LocalizedNameGenerator.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 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
@@ -14,19 +12,19 @@
package org.apache.tapestry5.ioc.util;
+import org.apache.tapestry5.ioc.internal.util.InternalUtils;
+
import java.util.Iterator;
import java.util.Locale;
import java.util.NoSuchElementException;
-import org.apache.tapestry5.ioc.internal.util.InternalUtils;
-
/**
* Generates name variations for a given file name or path and a locale. The name variations
* are provided in most-specific to least-specific order, so for a path of "Base.ext" and a Locale
* of "en_US", the generated names would be "Base_en_US.ext", "Base_en.ext", "Base.ext".
- * <p>
+ *
* Implements Iterable, so a LocalizedNameGenerator may be used directly in a for loop.
- * <p/>
+ *
* This class is not threadsafe.
*
* @since 5.3
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListener.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListener.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListener.java
index ad0633e..8eabe3a 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListener.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListener.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -16,7 +14,7 @@ package org.apache.tapestry5.services;
/**
* Interface for objects which can periodically check for updates.
- * <p>
+ *
* Note that this interface has moved from module tapestry-core to tapestry-ioc, but has kept the same package (for
* backwards compatibility reasons).
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListenerHub.java
----------------------------------------------------------------------
diff --git a/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListenerHub.java b/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListenerHub.java
index ced0354..5395060 100644
--- a/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListenerHub.java
+++ b/tapestry-ioc/src/main/java/org/apache/tapestry5/services/UpdateListenerHub.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 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
@@ -23,14 +21,14 @@ import org.apache.tapestry5.ioc.ObjectLocator;
* external resource files (such as classes or template files) can check to see if any file they've used has changed. If
* so, the service can invalidate its internal cache, or notify other services (typically via
* {@link org.apache.tapestry5.services.InvalidationListener} that they should do the same.
- * <p>
+ *
* Note that this interface has moved from module tapestry-core to tapestry-ioc, but has kept the same package (for
* backwards compatibility reasons).
- * <p>
+ *
* A <em>weak reference</em> to the listener is kept; this ensures that registering as a listener will not prevent a
* listener instance from being reclaimed by the garbage collector (this is useful as proxies created by
* {@link ObjectLocator#proxy(Class, Class)} may register as listeners, but still be ephemeral).
- * <p>
+ *
* Starting in Tapestry 5.3, this services does <em>nothing</em> in production mode.
*
* @since 5.1.0.0
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerManager.java
----------------------------------------------------------------------
diff --git a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerManager.java b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerManager.java
index 9884b70..48650f9 100644
--- a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerManager.java
+++ b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerManager.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,15 +12,14 @@
package org.apache.tapestry5.jpa;
-import java.util.Map;
-
import javax.persistence.EntityManager;
+import java.util.Map;
/**
* Manages <code>EntityManager</code>s for the current thread.
* An <code>EntityManager</code> is created as needed and closed at the end of each request.
*
- * <p/>
+ *
*
* The implementation of this service is per-thread.
*
@@ -31,15 +28,15 @@ import javax.persistence.EntityManager;
public interface EntityManagerManager
{
/**
- * Gets the active <code>EntityManager</code> for this request, creating it as necessary.
+ * Gets the active EntityManager for this request, creating it as necessary.
*
- * @param persistenceUnitName the name of a persistence unit as defined in <code>persistence.xml<code>
+ * @param persistenceUnitName the name of a persistence unit as defined in {@code persistence.xml}
* @return EntityManager for the persistence unit,
*/
EntityManager getEntityManager(String persistenceUnitName);
/**
- * Gets all active <code>EntityManager</code>s for this request, creating them as necessary.
+ * Gets all active EntityManagers for this request, creating them as necessary.
*
* @return Map in which persistence unit names are associated with EntityManagers
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerSource.java
----------------------------------------------------------------------
diff --git a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerSource.java b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerSource.java
index f9ec159..dddf84c 100644
--- a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerSource.java
+++ b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/EntityManagerSource.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,11 +12,10 @@
package org.apache.tapestry5.jpa;
-import java.util.List;
-
import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.spi.PersistenceUnitInfo;
+import java.util.List;
/**
* Responsible for creating an EntityManager as needed.
@@ -28,24 +25,24 @@ import javax.persistence.spi.PersistenceUnitInfo;
public interface EntityManagerSource
{
/**
- * Creates an <code>EntityManager</code> for the given persistence unit name.
+ * Creates an EntityManager for the given persistence unit name.
*
- * @param persistenceUnitName the name of a persistence unit as defined in <code>persistence.xml<code>
+ * @param persistenceUnitName the name of a persistence unit as defined in {@code persistence.xml}
* @return EntityManager for the given persistence unit name
*/
EntityManager create(String persistenceUnitName);
/**
- * Gets the <code>EntityManagerFactory</code> for the given persistence unit name, creating it as necessary.
+ * Gets the EntityManagerFactory for the given persistence unit name, creating it as necessary.
*
- * @param persistenceUnitName the name of a persistence unit as defined in <code>persistence.xml<code>
+ * @param persistenceUnitName the name of a persistence unit as defined in {@code persistence.xml}
*
* @return EntityManagerFactory for the given persistence unit name
*/
EntityManagerFactory getEntityManagerFactory(String persistenceUnitName);
/**
- * Get the list of {@linkplain PersistenceUnitInfo} parsed from <code>persistence.xml<code>.
+ * Get the list of {@linkplain PersistenceUnitInfo} parsed from {@code persistence.xml}.
*
* @return list of PersistenceUnitInfos
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaEntityPackageManager.java
----------------------------------------------------------------------
diff --git a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaEntityPackageManager.java b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaEntityPackageManager.java
index e5f7b51..a4d28dc 100644
--- a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaEntityPackageManager.java
+++ b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaEntityPackageManager.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,13 +12,13 @@
package org.apache.tapestry5.jpa;
-import java.util.Collection;
-
import org.apache.tapestry5.ioc.annotations.UsesConfiguration;
+import java.util.Collection;
+
/**
* Contains a set of contributed package names from which to load entities.
- * <p/>
+ *
* The service's configuration is the names of Java packages to search for JPA entities.
*
* @since 5.3
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaGridDataSource.java
----------------------------------------------------------------------
diff --git a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaGridDataSource.java b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaGridDataSource.java
index 040afdd..00004c9 100644
--- a/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaGridDataSource.java
+++ b/tapestry-jpa/src/main/java/org/apache/tapestry5/jpa/JpaGridDataSource.java
@@ -1,5 +1,3 @@
-// Copyright 2011 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,7 +12,8 @@
package org.apache.tapestry5.jpa;
-import java.util.List;
+import org.apache.tapestry5.grid.GridDataSource;
+import org.apache.tapestry5.grid.SortConstraint;
import javax.persistence.EntityManager;
import javax.persistence.TypedQuery;
@@ -22,9 +21,7 @@ import javax.persistence.criteria.CriteriaBuilder;
import javax.persistence.criteria.CriteriaQuery;
import javax.persistence.criteria.Path;
import javax.persistence.criteria.Root;
-
-import org.apache.tapestry5.grid.GridDataSource;
-import org.apache.tapestry5.grid.SortConstraint;
+import java.util.List;
/**
* A simple implementation of {@link org.apache.tapestry5.grid.GridDataSource} based on a
@@ -32,9 +29,9 @@ import org.apache.tapestry5.grid.SortConstraint;
* entity class. This implementation does support multiple
* {@link org.apache.tapestry5.grid.SortConstraint sort
* constraints}.
- * <p/>
+ *
* This class is <em>not</em> thread-safe; it maintains internal state.
- * <p/>
+ *
* Typically, an instance of this object is created fresh as needed (that is, it is not stored
* between requests).
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONArray.java
----------------------------------------------------------------------
diff --git a/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONArray.java b/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONArray.java
index 7cb7d55..385a612 100644
--- a/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONArray.java
+++ b/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONArray.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008, 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
@@ -45,16 +43,16 @@ import java.util.List;
* accessing the values by index, and {@code put} methods for adding or replacing values. The values can be any of
* these types: {@code Boolean}, {@code JSONArray}, {@code JSONObject}, {@code Number},
* {@code String}, or the {@code JSONObject.NULL object}.
- * <p/>
+ *
* The constructor can convert a JSON text into a Java object. The {@code toString} method converts to JSON text.
- * <p/>
+ *
* A {@code get} method returns a value if one can be found, and throws an exception if one cannot be found. An
* {@code opt} method returns a default value instead of throwing an exception, and so is useful for obtaining
* optional values.
- * <p/>
+ *
* The generic {@code get()} and {@code opt()} methods return an object which you can cast or query for type.
* There are also typed {@code get} and {@code opt} methods that do type checking and type coersion for you.
- * <p/>
+ *
* The texts produced by the {@code toString} methods strictly conform to JSON syntax rules. The constructors are
* more forgiving in the texts they will accept:
* <ul>
@@ -104,7 +102,7 @@ public final class JSONArray extends JSONCollection implements Iterable<Object>
/**
* Create a new array, and adds all values fro the iterable to the array (using {@link #putAll(Iterable)}.
- * <p/>
+ *
* This is implemented as a static method so as not to break the semantics of the existing {@link #JSONArray(Object...)} constructor.
* Adding a constructor of type Iterable would change the meaning of <code>new JSONArray(new JSONArray())</code>.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONCollection.java
----------------------------------------------------------------------
diff --git a/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONCollection.java b/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONCollection.java
index f06118b..c5ee108 100644
--- a/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONCollection.java
+++ b/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONCollection.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
@@ -28,9 +26,9 @@ public abstract class JSONCollection implements Serializable
{
/**
* Converts this JSON collection into a parsable string representation.
- * <p/>
+ *
* Warning: This method assumes that the data structure is acyclical.
- * <p>
+ *
* Starting in release 5.2, the result will be pretty printed for readability.
*
* @return a printable, displayable, portable, transmittable representation of the object, beginning with
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONObject.java
----------------------------------------------------------------------
diff --git a/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONObject.java b/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONObject.java
index 1392bb8..a9555b8 100644
--- a/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONObject.java
+++ b/tapestry-json/src/main/java/org/apache/tapestry5/json/JSONObject.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
@@ -50,18 +48,18 @@ import java.util.*;
* values into a JSON text using the <code>put</code> and <code>toString</code> methods. A <code>get</code> method
* returns a value if one can be found, and throws an exception if one cannot be found. An <code>opt</code> method
* returns a default value instead of throwing an exception, and so is useful for obtaining optional values.
- * <p/>
+ *
* The generic <code>get()</code> and <code>opt()</code> methods return an object, which you can cast or query for type.
* There are also typed <code>get</code> and <code>opt</code> methods that do type checking and type coersion for you.
- * <p/>
+ *
* The <code>put</code> methods adds values to an object. For example,
- * <p/>
+ *
* <pre>
* myString = new JSONObject().put("JSON", "Hello, World!").toString();
* </pre>
- * <p/>
+ *
* produces the string <code>{"JSON": "Hello, World"}</code>.
- * <p/>
+ *
* The texts produced by the <code>toString</code> methods strictly conform to the JSON syntax rules. The constructors
* are more forgiving in the texts they will accept:
* <ul>
@@ -71,19 +69,19 @@ import java.util.*;
* contain leading or trailing spaces, and if they do not contain any of these characters: <code>{ }
* [ ] / \ : , = ; #</code> and if they do not look like numbers and if they are not the reserved words
* <code>true</code>, <code>false</code>, or <code>null</code>.</li>
- * <li>Keys can be followed by <code>=</code> or <code>=></code> as well as by <code>:</code>.</li>
+ * <li>Keys can be followed by <code>=</code> or {@code =>} as well as by {@code :}.</li>
* <li>Values can be followed by <code>;</code> <small>(semicolon)</small> as well as by <code>,</code>
* <small>(comma)</small>.</li>
* <li>Numbers may have the <code>0-</code> <small>(octal)</small> or <code>0x-</code> <small>(hex)</small> prefix.</li>
* <li>Comments written in the slashshlash, slashstar, and hash conventions will be ignored.</li>
* </ul>
- * <hr/>
- * <p/>
+ * <hr>
+ *
* This class, and the other related classes, have been heavily modified from the original source, to fit Tapestry
* standards and to make use of JDK 1.5 features such as generics. Further, since the interest of Tapestry is primarily
* constructing JSON (and not parsing it), many of the non-essential methods have been removed (since the original code
* came with no tests).
- * <p/>
+ *
* Finally, support for the {@link org.apache.tapestry5.json.JSONLiteral} type has been added, which allows the exact
* output to be controlled; useful when a JSONObject is being used as a configuration object, and must contain values
* that are not simple data, such as an inline function (making the result not JSON).
@@ -175,7 +173,7 @@ public final class JSONObject extends JSONCollection
* Constructs a new JSONObject using a series of String keys and object values.
* Object values sholuld be compatible with {@link #put(String, Object)}. Keys must be strings
* (toString() will be invoked on each key).
- * <p/>
+ *
* Prior to release 5.4, keysAndValues was type String...; changing it to Object... makes
* it much easier to initialize a JSONObject in a single statement, which is more readable.
*
@@ -305,8 +303,7 @@ public final class JSONObject extends JSONCollection
* @param value
* An object to be accumulated under the key.
* @return this.
- * @throws {@link
- * RuntimeException} If the value is an invalid number or if the key is null.
+ * @throws RuntimeException if the value is an invalid number or if the key is null.
*/
public JSONObject accumulate(String key, Object value)
{
@@ -696,8 +693,8 @@ public final class JSONObject extends JSONCollection
}
/**
- * Produce a string in double quotes with backslash sequences in all the right places. A backslash will be inserted
- * within </, allowing JSON text to be delivered in HTML. In JSON text, a string cannot contain a control character
+ * Produce a string in double quotes with backslash sequences in all the right places,
+ * allowing JSON text to be delivered in HTML. In JSON text, a string cannot contain a control character
* or an unescaped quote or backslash.
*
* @param string
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-json/src/main/java/org/apache/tapestry5/json/package-info.java
----------------------------------------------------------------------
diff --git a/tapestry-json/src/main/java/org/apache/tapestry5/json/package-info.java b/tapestry-json/src/main/java/org/apache/tapestry5/json/package-info.java
index 62c1972..5a757e7 100644
--- a/tapestry-json/src/main/java/org/apache/tapestry5/json/package-info.java
+++ b/tapestry-json/src/main/java/org/apache/tapestry5/json/package-info.java
@@ -1,5 +1,3 @@
-// Copyright 2012, 2013 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,7 +12,7 @@
/**
* Repackaged, improved (and tested) version of code originally from json.org.
- * <p/>
+ *
* Starting in release 5.4, {@link org.apache.tapestry5.json.JSONObject} and {@link org.apache.tapestry5.json.JSONArray}
* are serializable.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-kaptcha/src/main/java/org/apache/tapestry5/kaptcha/components/KaptchaImage.java
----------------------------------------------------------------------
diff --git a/tapestry-kaptcha/src/main/java/org/apache/tapestry5/kaptcha/components/KaptchaImage.java b/tapestry-kaptcha/src/main/java/org/apache/tapestry5/kaptcha/components/KaptchaImage.java
index 973a801..7e05811 100644
--- a/tapestry-kaptcha/src/main/java/org/apache/tapestry5/kaptcha/components/KaptchaImage.java
+++ b/tapestry-kaptcha/src/main/java/org/apache/tapestry5/kaptcha/components/KaptchaImage.java
@@ -35,7 +35,7 @@ import java.io.InputStream;
* Part of a Captcha based authentication scheme; a KaptchaImage generates a new
* text image whenever it <em>renders</em> and can provide the previously
* rendered text subsequently (it is stored persistently in the session).
- * <p/>
+ *
* The component renders an {@code <img>} tag, including width and height attributes. Other attributes
* come from informal parameters.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/MockTester.java
----------------------------------------------------------------------
diff --git a/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/MockTester.java b/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/MockTester.java
index eba74ec..eca1c1f 100644
--- a/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/MockTester.java
+++ b/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/MockTester.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 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
@@ -22,7 +20,7 @@ import org.easymock.IMocksControl;
* suite. A <em>single</em> standard mock control is used for all mock instances. The control does not care about
* execution order, but will balk at any unexpected method invocations. This class is thread safe (it used a thread
* local to store the mock control).
- * <p>
+ *
* This class was originally in the tapestry-ioc module as was moved to tapestry-test; the package name was not changed
* to ensure backwards compatibility.
* @deprecated In 5.4, with no replacement
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestBase.java
----------------------------------------------------------------------
diff --git a/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestBase.java b/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestBase.java
index 5bb263e..e8f5788 100644
--- a/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestBase.java
+++ b/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestBase.java
@@ -1,5 +1,3 @@
-// Copyright 2006, 2007, 2008, 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
@@ -19,20 +17,20 @@ import org.testng.annotations.AfterMethod;
/**
* Manages a set of EasyMock mock objects. Used as a base class for test cases.
- * <p/>
+ *
* Extends from {@link org.testng.Assert} to bring in all the public static assert methods without requiring extra
* imports.
- * <p/>
+ *
* Provides a common mock factory method, {@link #newMock(Class)}. A single <em>standard</em> mock control is used for
* all mock objects. Standard mocks do not care about the exact order in which methods are invoked, though they are as
* rigorous as strict mocks when checking that parameters are the correct values.
- * <p/>
+ *
* This base class is created with the intention of use within a TestNG test suite; if using JUnit, you can get the same
* functionality using {@link MockTester}.
- * <p/>
+ *
* This class is thread safe (it uses a thread local to store the mock control). In theory, this should allow TestNG to
* execute tests in parallel.
- * <p>
+ *
* This class was originally in the tapestry-ioc module as was moved to tapestry-test; the package name was not changed
* to ensure backwards compatibility.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestUtils.java
----------------------------------------------------------------------
diff --git a/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestUtils.java b/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestUtils.java
index 31bf6fb..0cfdcc2 100644
--- a/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestUtils.java
+++ b/tapestry-test/src/main/java/org/apache/tapestry5/ioc/test/TestUtils.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,7 +22,7 @@ import java.util.List;
/**
* Extra assertions on top of the standard set, packaged as a base class for easy referencing in tests. Also,
* utilities for instantiation objects and setting and reading private fields of those objects.
- * <p>
+ *
* This class was originally in the tapestry-ioc module as was moved to tapestry-test; the package name was not changed
* to ensure backwards compatibility.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-test/src/main/java/org/apache/tapestry5/test/SeleniumTestCase.java
----------------------------------------------------------------------
diff --git a/tapestry-test/src/main/java/org/apache/tapestry5/test/SeleniumTestCase.java b/tapestry-test/src/main/java/org/apache/tapestry5/test/SeleniumTestCase.java
index 890cdb6..5b04def 100644
--- a/tapestry-test/src/main/java/org/apache/tapestry5/test/SeleniumTestCase.java
+++ b/tapestry-test/src/main/java/org/apache/tapestry5/test/SeleniumTestCase.java
@@ -121,11 +121,12 @@ public abstract class SeleniumTestCase extends Assert implements Selenium
* <td>*firefox</td>
* <td>Command string used to launch the browser, as defined by Selenium</td>
* </tr>
+ * <caption>Options and defaults</caption>
* </table>
- * <p/>
+ *
* Tests in the <em>beforeStartup</em> group will be run before the start of Selenium. This can be used to
* programmatically override the above parameter values.
- * <p/>
+ *
* This method will be invoked in <em>each</em> subclass, but is set up to only startup the servers once (it checks
* the {@link ITestContext} to see if the necessary keys are already present).
*
@@ -386,7 +387,7 @@ public abstract class SeleniumTestCase extends Assert implements Selenium
/**
* Returns the base URL for the application. This is of the typically <code>http://localhost:9999/</code> (i.e., it
* includes a trailing slash).
- * <p/>
+ *
* Generally, you should use {@link #openLinks(String...)} to start from your application's home page.
*/
public String getBaseURL()
@@ -1612,7 +1613,7 @@ public abstract class SeleniumTestCase extends Assert implements Selenium
/**
* Waits, up to the page load limit for an element (identified by a CSS rule) to exist
* (it is not assured that the element will be visible).
- * <p/>
+ *
* This implementation only works if the application provides a function onto the
* window object: "testSupport.findCSSMatchCount()" which accepts a CSS rule and returns the number
* of matching elements.
@@ -1647,8 +1648,8 @@ public abstract class SeleniumTestCase extends Assert implements Selenium
/**
* Waits for the element to be removed from the DOM.
- * <p/>
- * <p/>
+ *
+ *
* This implementation depends on window being extended with testSupport.isNotVisible().
*
* @param elementId
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry-webresources/src/main/java/org/apache/tapestry5/internal/webresources/ResourceTransformerFactory.java
----------------------------------------------------------------------
diff --git a/tapestry-webresources/src/main/java/org/apache/tapestry5/internal/webresources/ResourceTransformerFactory.java b/tapestry-webresources/src/main/java/org/apache/tapestry5/internal/webresources/ResourceTransformerFactory.java
index c509cce..559d8fa 100644
--- a/tapestry-webresources/src/main/java/org/apache/tapestry5/internal/webresources/ResourceTransformerFactory.java
+++ b/tapestry-webresources/src/main/java/org/apache/tapestry5/internal/webresources/ResourceTransformerFactory.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
@@ -17,7 +15,7 @@ package org.apache.tapestry5.internal.webresources;
import org.apache.tapestry5.services.assets.ResourceTransformer;
/**
- * Creates ResourceTransformer around a named {@link org.apache.tapestry5.webresources.services.ResourceProcessor}.
+ * Wraps a {@link ResourceTransformer} to provide additional features such as caching.
*
* @see org.apache.tapestry5.services.assets.StreamableResourceSource
* @since 5.4
@@ -38,7 +36,6 @@ public interface ResourceTransformerFactory
* @param cacheMode
* Indicates if and how the compiled content should be cached (in development mode only)
* @return transformer
- * @see org.apache.tapestry5.webresources.services.ResourceProcessorSource
*/
ResourceTransformer createCompiler(String contentType, String sourceName, String targetName, ResourceTransformer transformer, CacheMode cacheMode);
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Translate.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Translate.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Translate.java
index a5c7b2e..d0634b3 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Translate.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Translate.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,23 +12,20 @@
package org.apache.tapestry5.beaneditor;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.BEAN;
-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.ioc.annotations.UseWith;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
-import org.apache.tapestry5.ioc.annotations.UseWith;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
/**
* Used to attach the name of a Translator used to convert the associated property between server-side and
* client-side representations.
- * <p/>
+ *
* May be placed on any getter or setter method, or on the matching field.
*
* @see Validate
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Validate.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Validate.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Validate.java
index d5c12e7..842e91c 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Validate.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Validate.java
@@ -1,5 +1,3 @@
-// Copyright 2007, 2008, 2009, 2010 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -14,18 +12,15 @@
package org.apache.tapestry5.beaneditor;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.BEAN;
-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.ioc.annotations.UseWith;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
-import org.apache.tapestry5.ioc.annotations.UseWith;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
/**
* Used to attach validation constraints directly to a property (either the getter or the setter method). The annotation
@@ -33,7 +28,7 @@ import org.apache.tapestry5.ioc.annotations.UseWith;
* "required", "minlength") and optionally, a constraint value. Most validators need a constraint value, which is
* separated from the type by an equals size (i.e., "maxlength=30"). In addition, the value may include
* validator macros.
- * <p/>
+ *
* May be placed on any getter or setter method, or on the matching field.
*
* @see Translate
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Width.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Width.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Width.java
index 5b1faed..8cdfc58 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Width.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/beaneditor/Width.java
@@ -1,5 +1,3 @@
-// Copyright 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
@@ -15,17 +13,18 @@
package org.apache.tapestry5.beaneditor;
import org.apache.tapestry5.ioc.annotations.UseWith;
-import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
import java.lang.annotation.*;
+import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
+
/**
* Defines the desired width of the field used to edit the property. Note that width (generally equivalent to the size
* attribute of an HTML <input> element) is only used for presentation; validation must be used to actually
* enforce a maximum input length.
- * <p/>
- * <p/>
+ *
+ *
* May be placed on an getter or setter method, or on the matching field.
*/
@Target({ ElementType.FIELD, ElementType.METHOD })
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Inject.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Inject.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Inject.java
index f09e1a1..45a5369 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Inject.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Inject.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
@@ -15,35 +13,35 @@
package org.apache.tapestry5.ioc.annotations;
import java.lang.annotation.Documented;
-import static java.lang.annotation.ElementType.*;
import java.lang.annotation.Retention;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
+import static java.lang.annotation.ElementType.*;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
/**
* This annotation serves is something of the Swiss Army knife for operations related to injection of dependencies into
* an arbitrary method of Java Bean.
- * <p/>
- * <p>
+ *
+ *
* It marks parameters that should be injected in the IoC container, and it marks fields that should be injected inside
* Tapestry components.
- * <p/>
+ *
* In terms of the IoC container; normally, resources take precedence over annotations when injecting. The Inject
* annotation overrides this default, forcing the resolution of the parameters value via the master
* {@link org.apache.tapestry5.ioc.ObjectProvider}, even when the parameter's type matches a type that is normally a
* resource.
- * <p/>
+ *
* For service implementations, module classes, and other objects constructed via
* {@link org.apache.tapestry5.ioc.ObjectLocator#autobuild(Class)}, this annotation indicates that an injection is
* desired on the field, as with fields of a Tapestry component.
- * <p/>
+ *
* In terms of the IoC container, the Inject annotation is only used on parameters to service builder methods (and
* contributor and decorator methods) and on module class constructors. constructors. However, inside Tapestry
* components (<em>and only inside components</em>), it may be applied to fields. On fields that require injection, the
* Inject annotation is <em>required</em>.
- * <p/>
+ *
* Finally, on a constructor, this is used to indicate <em>which</em> constructor should be used when more than one is
* available.
*
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectResource.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectResource.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectResource.java
index 0e1eb34..f57c256 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectResource.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectResource.java
@@ -1,5 +1,3 @@
-// Copyright 2008, 2009, 2012 The Apache Software Foundation
-//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
@@ -20,7 +18,7 @@ import java.lang.annotation.*;
/**
* Annotation used with field injection when the desired injection value is a resource (such as a service id, service
* configuration, or logger) and not an object obtained from the {@link org.apache.tapestry5.ioc.services.MasterObjectProvider}.
- * <p/>
+ *
* In Tapestry 5.3, the logic for this was changed so that it is treated the same as {@link Inject}. This reflects what people usually want.
*
* @deprecated Deprecated in Tapestry 5.3, to be removed in a later release. Use {@link Inject} instead.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectService.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectService.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectService.java
index 38eaa03..80be73c 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectService.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/InjectService.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
@@ -15,18 +13,19 @@
package org.apache.tapestry5.ioc.annotations;
import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.lang.annotation.Target;
+
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.PARAMETER;
-import java.lang.annotation.Retention;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
-import java.lang.annotation.Target;
/**
* Annotation used with parameters of service builder methods to identify the service to be injected into the service
* builder method via the parameter. In many cases the {@link org.apache.tapestry5.ioc.annotations.Inject} annotation is
* more flexible or appropriate.
- * <p/>
+ *
* This annotation may also be used with fields of service implementation classes, modules, or other objects constructed
* via {@link org.apache.tapestry5.ioc.ObjectLocator#autobuild(Class)}.
*/
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/PostInjection.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/PostInjection.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/PostInjection.java
index 60d3169..c905aba 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/PostInjection.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/PostInjection.java
@@ -1,5 +1,3 @@
-// Copyright 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,7 +20,7 @@ import java.lang.annotation.*;
* after field injection. It should be placed on a <strong>public method</strong>. Any return value from the method is
* ignored. The order of invocation for classes with multiple marked methods (including methods inherited from
* super-classes) is not, at this time, defined.
- * <p/>
+ *
* Tapestry also honors the {@link javax.annotation.PostConstruct} annotation, and treats it identically to
* PostInjection. This is both more flexible than PostConstruct (in that methods may have parameters, and multiple methods
* may be annotated) but also falls short (Tapestry will only seek out public methods).
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Symbol.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Symbol.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Symbol.java
index eb007dd..7cfa3bd 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Symbol.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/Symbol.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
@@ -27,8 +25,8 @@ import static org.apache.tapestry5.ioc.annotations.AnnotationUseContext.*;
* Used to inject a symbol value, via a symbol name. This is used much like {@link
* org.apache.tapestry5.ioc.annotations.Value} annotation, except that symbols are not expanded ... the entire value is
* a symbol name. This allows the annotation to reference a public constant variable.
- * <p/>
- * <p/>
+ *
+ *
* The injected value may be coerced from string to an alternate type (defined by the field or parameter to which
* the @Symbol annotation is attached). For better control, use the {@link IntermediateType} annotation as well, which
* allows the string to be coerced to an alternate type before being coerced a second time to the field or parameter type.
http://git-wip-us.apache.org/repos/asf/tapestry-5/blob/84053397/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/UsesMappedConfiguration.java
----------------------------------------------------------------------
diff --git a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/UsesMappedConfiguration.java b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/UsesMappedConfiguration.java
index a336365..f2a1fc8 100644
--- a/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/UsesMappedConfiguration.java
+++ b/tapestry5-annotations/src/main/java/org/apache/tapestry5/ioc/annotations/UsesMappedConfiguration.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
@@ -19,8 +17,8 @@ import java.lang.annotation.*;
/**
* A documentation-only interface placed on service interfaces for services which have a {@linkplain
* org.apache.tapestry5.ioc.MappedConfiguration mapped configuration}, to identify the type of key (often, a String),
- * and type ofcontribution.
- * <p/>
+ * and type of contribution.
+ *
* Remember that when the key type is String, the map will be case-insensitive.
*/
@Target(ElementType.TYPE)