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 2007/11/12 23:23:28 UTC
svn commit: r594319 [3/40] - in /tapestry/tapestry5/trunk: ./
tapestry-annotations/
tapestry-annotations/src/main/java/org/apache/tapestry/beaneditor/
tapestry-annotations/src/site/ tapestry-component-report/
tapestry-component-report/src/main/java/org...
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/PropertyConduit.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/PropertyConduit.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/PropertyConduit.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/PropertyConduit.java Mon Nov 12 14:22:31 2007
@@ -24,23 +24,22 @@
{
/**
* Reads the property from the instance.
- *
- * @param instance
- * object containing the property
+ *
+ * @param instance object containing the property
* @return the current value of the property
*/
Object get(Object instance);
/**
* Changes the current value of the property.
- *
- * @param instance
- * object containing the property
- * @param value
- * to change the property to
+ *
+ * @param instance object containing the property
+ * @param value to change the property to
*/
void set(Object instance, Object value);
- /** Returns the type of the property read or updated by the conduit. */
+ /**
+ * Returns the type of the property read or updated by the conduit.
+ */
Class getPropertyType();
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/RadioContainer.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/RadioContainer.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/RadioContainer.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/RadioContainer.java Mon Nov 12 14:22:31 2007
@@ -35,14 +35,15 @@
/**
* Converts an object to a client-side string representation of that value.
- *
- * @param value
- * to convert (may be null)
+ *
+ * @param value to convert (may be null)
* @return string representation of the value
* @see ValueEncoder#toClient(Object)
*/
String toClient(Object value);
- /** Returns true if the value is the current selected value. */
+ /**
+ * Returns true if the value is the current selected value.
+ */
boolean isSelected(Object value);
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Renderable.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Renderable.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Renderable.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Renderable.java Mon Nov 12 14:22:31 2007
@@ -1,24 +1,22 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry;
/**
* Base interface for objects that can render markup output using a
* {@link org.apache.tapestry.MarkupWriter}.
- *
- *
*/
public interface Renderable
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModel.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModel.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModel.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModel.java Mon Nov 12 14:22:31 2007
@@ -14,13 +14,13 @@
package org.apache.tapestry;
-import java.util.List;
-
import org.apache.tapestry.corelib.components.Select;
+import java.util.List;
+
/**
* Defines the possible options and option groups for a <select> [X]HTML element.
- * <p>
+ * <p/>
* Primarily used by the {@link Select} component, but potentially used by anything similar, that
* needs to present a list of options to the user. Generally paired with a {@link ValueEncoder} to
* create client-side representations of server-side values.
@@ -29,7 +29,7 @@
{
/**
* The list of groups, each containing some number of individual options.
- *
+ *
* @return the groups, or null
*/
List<OptionGroupModel> getOptionGroups();
@@ -37,7 +37,7 @@
/**
* The list of ungrouped options, which appear after any grouped options. Generally, a model
* will either provide option groups or ungroup options, but not both.
- *
+ *
* @return the ungrouped options, or null
*/
List<OptionModel> getOptions();
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModelVisitor.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModelVisitor.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModelVisitor.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/SelectModelVisitor.java Mon Nov 12 14:22:31 2007
@@ -28,7 +28,7 @@
/**
* Invoked for each option within a group, and at the end, for each ungrouped option.
- *
+ *
* @param optionModel
*/
void option(OptionModel optionModel);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/StreamResponse.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/StreamResponse.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/StreamResponse.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/StreamResponse.java Mon Nov 12 14:22:31 2007
@@ -14,12 +14,12 @@
package org.apache.tapestry;
+import org.apache.tapestry.services.Response;
+
import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
-import org.apache.tapestry.services.Response;
-
/**
* An alternate response from a component event handler method used to directly provide a stream of
* data to be sent to the client, rather than indicating what page to send a render redirect request
@@ -27,7 +27,9 @@
*/
public interface StreamResponse
{
- /** Returns the content type to be reported to the client. */
+ /**
+ * Returns the content type to be reported to the client.
+ */
String getContentType();
/**
@@ -41,6 +43,7 @@
/**
* Prepare response before it is sent to the client.
* This is the place to set any response headers (e.g. content-disposition)
+ *
* @param response Response that will be sent.
*/
void prepareResponse(Response response);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryConstants.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryConstants.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryConstants.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryConstants.java Mon Nov 12 14:22:31 2007
@@ -19,7 +19,9 @@
*/
public final class TapestryConstants
{
- /** Default client event name, "action", used in most situations. */
+ /**
+ * Default client event name, "action", used in most situations.
+ */
public static final String ACTION_EVENT = "action";
/**
@@ -40,10 +42,14 @@
*/
public static final String ASSET_PATH_PREFIX = "/assets/";
- /** Binding expression prefix used for literal strings. */
+ /**
+ * Binding expression prefix used for literal strings.
+ */
public static final String LITERAL_BINDING_PREFIX = "literal";
- /** Binding expression prefix used to bind to a property of the component. */
+ /**
+ * Binding expression prefix used to bind to a property of the component.
+ */
public static final String PROP_BINDING_PREFIX = "prop";
/**
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryFilter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryFilter.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryFilter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryFilter.java Mon Nov 12 14:22:31 2007
@@ -14,20 +14,6 @@
package org.apache.tapestry;
-import java.io.IOException;
-import java.util.Formatter;
-import java.util.List;
-
-import javax.servlet.Filter;
-import javax.servlet.FilterChain;
-import javax.servlet.FilterConfig;
-import javax.servlet.ServletContext;
-import javax.servlet.ServletException;
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpServletResponse;
-
import org.apache.tapestry.internal.ServletContextSymbolProvider;
import org.apache.tapestry.internal.TapestryAppInitializer;
import org.apache.tapestry.ioc.Registry;
@@ -41,6 +27,13 @@
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
+import javax.servlet.*;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import java.io.IOException;
+import java.util.Formatter;
+import java.util.List;
+
/**
* The TapestryFilter is responsible for intercepting all requests into the web application. It
* identifies the requests that are relevant to Tapestry, and lets the servlet container handle the
@@ -72,7 +65,7 @@
SymbolProvider provider = new ServletContextSymbolProvider(context);
TapestryAppInitializer appInitializer = new TapestryAppInitializer(provider, filterName,
- "servlet");
+ "servlet");
appInitializer.addModules(provideExtraModuleDefs(context));
@@ -139,9 +132,8 @@
* Invoked from {@link #init(FilterConfig)} after the Registry has been created, to allow any
* additional initialization to occur. This implementation does nothing, and my be overriden in
* subclasses.
- *
- * @param registry
- * from which services may be extracted
+ *
+ * @param registry from which services may be extracted
* @throws ServletException
*/
protected void init(Registry registry) throws ServletException
@@ -175,7 +167,9 @@
}
}
- /** Shuts down and discards the registry. */
+ /**
+ * Shuts down and discards the registry.
+ */
public final void destroy()
{
destroy(_registry);
@@ -191,7 +185,7 @@
* Invoked from {@link #destroy()} to allow subclasses to add additional shutdown logic to the
* filter. The Registry will be shutdown after this call. This implementation does nothing, and
* may be overridden in subclasses.
- *
+ *
* @param registry
*/
protected void destroy(Registry registry)
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryUtils.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryUtils.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryUtils.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/TapestryUtils.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,11 @@
package org.apache.tapestry;
+import org.apache.tapestry.ioc.internal.util.CollectionFactory;
+
import java.util.Collections;
import java.util.List;
-import org.apache.tapestry.ioc.internal.util.CollectionFactory;
-
/**
* Utilities often needed when building Tapestry applications.
*/
@@ -34,7 +34,7 @@
* Quotes the provided value as a JavaScript string literal. The input value is surrounded by
* single quotes and any interior backslash, single or double quotes are escaped (a preceding
* backslash is added).
- *
+ *
* @param text
* @return quoted text
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Translator.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Translator.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Translator.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Translator.java Mon Nov 12 14:22:31 2007
@@ -19,7 +19,7 @@
/**
* Translates between client-side and server-side values. Client-side values are always strings.
- *
+ *
* @param <T>
*/
public interface Translator<T>
@@ -28,23 +28,19 @@
* Converts a server-side value to a client-side string. This allows for formatting of the value
* in a way appropriate to the end user. The output client value should be parsable by
* {@link #parseClient(String, Messages)}.
- *
- * @param value
- * the server side value (which may be null)
+ *
+ * @param value the server side value (which may be null)
* @return client-side value to present to the user
*/
String toClient(T value);
/**
* Converts a submitted request value into an appropriate server side value.
- *
- * @param clientValue
- * (possibly null or the empty string)
- * @param messages
- * validator messages assembled by {@link ValidationMessagesSource}
+ *
+ * @param clientValue (possibly null or the empty string)
+ * @param messages validator messages assembled by {@link ValidationMessagesSource}
* @return equivalent server-side value (possibly null)
- * @throws ValidationException
- * if the value can not be parsed
+ * @throws ValidationException if the value can not be parsed
*/
T parseClient(String clientValue, Messages messages) throws ValidationException;
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationDecorator.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationDecorator.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationDecorator.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationDecorator.java Mon Nov 12 14:22:31 2007
@@ -25,18 +25,16 @@
/**
* Invoked after the label has rendered its tag, but before it has rendered content inside the
* tag, to allow the decorator to write additional attributes.
- *
- * @param field
- * the field corresponding to the label
- * @param labelElement
- * the element for this label
+ *
+ * @param field the field corresponding to the label
+ * @param labelElement the element for this label
*/
void insideLabel(Field field, Element labelElement);
/**
* Renders immediately before the field itself. The field will typically render a single
* element, though a complex field may render multiple elements or even some JavaScript.
- *
+ *
* @param field
*/
void beforeField(Field field);
@@ -46,11 +44,13 @@
* Generally speaking, you will want to
* {@linkplain ComponentResources#renderInformalParameters(MarkupWriter) render informal parameters}
* <strong>before</strong> invoking this method.
- *
+ *
* @param field
*/
void insideField(Field field);
- /** Invoked after the field has completed rendering itself. */
+ /**
+ * Invoked after the field has completed rendering itself.
+ */
void afterField(Field field);
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTracker.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTracker.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTracker.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTracker.java Mon Nov 12 14:22:31 2007
@@ -14,29 +14,29 @@
package org.apache.tapestry;
-import java.util.List;
-
import org.apache.tapestry.corelib.components.Loop;
+import java.util.List;
+
/**
* Tracks information related to user input validations. This information is:
* <ul>
* <li>The input values provided by the user.
* <li>Any validation exceptions associated with input fields.
* </ul>
- * <p>
+ * <p/>
* The tracker must differentiate between components (which will implement the {@link Field}
* interfaces) and fields. It is a one to many relationship, because each field may be called upon
* to render itself multiple times within a request, because of {@link Loop} or other similar
* components.
- * <p>
+ * <p/>
* Internally, the tracker indexes its information in terms of the {@link Field#getElementName()}
* for each rendering of the component (the mechanics of Tapestry ensures that this is unique within
* the form).
- * <p>
+ * <p/>
* Validation trackers must be serializable, as they will almost always be stored into the
* HttpSession.
- * <p>
+ * <p/>
* Trackers are used by only a single form within a single page; they are not threadsafe.
*/
public interface ValidationTracker
@@ -45,21 +45,21 @@
* Called by a field to record the exact input from the user, prior to any validation. If the
* form is redisplayed (to present errors), the input value will be sent back to the user for
* correction.
- *
- * @param field
- * the field recording the input
- * @param input
- * the value obtained from the forms submission
+ *
+ * @param field the field recording the input
+ * @param input the value obtained from the forms submission
*/
void recordInput(Field field, String input);
- /** Returns a previously recorded input value. */
+ /**
+ * Returns a previously recorded input value.
+ */
String getInput(Field field);
/**
* Records an error message for a field. The error message is primarily derived from a
* {@link ValidationException} thrown by a {@link Validator} or {@link Translator}.
- *
+ *
* @param field
* @param errorMessage
*/
@@ -68,7 +68,7 @@
/**
* Records an error message that is not associated with any specific field. This often reflects
* some amount of cross-form validation.
- *
+ *
* @param errorMessage
*/
void recordError(String errorMessage);
@@ -76,16 +76,20 @@
/**
* For a given field, determines if the field is "in error", meaning that an error message has
* been previously recorded for the field.
- *
+ *
* @param field
* @return true if an error message is present
*/
boolean inError(Field field);
- /** Returns a previously recorded error message. */
+ /**
+ * Returns a previously recorded error message.
+ */
String getError(Field field);
- /** Returns true if any field contains an error. */
+ /**
+ * Returns true if any field contains an error.
+ */
boolean getHasErrors();
/**
@@ -95,6 +99,8 @@
*/
List<String> getErrors();
- /** Clears all information stored by the tracker. */
+ /**
+ * Clears all information stored by the tracker.
+ */
void clear();
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTrackerImpl.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTrackerImpl.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTrackerImpl.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValidationTrackerImpl.java Mon Nov 12 14:22:31 2007
@@ -14,12 +14,12 @@
package org.apache.tapestry;
+import org.apache.tapestry.ioc.internal.util.CollectionFactory;
+import org.apache.tapestry.ioc.internal.util.InternalUtils;
+
import java.io.Serializable;
import java.util.List;
import java.util.Map;
-
-import org.apache.tapestry.ioc.internal.util.CollectionFactory;
-import org.apache.tapestry.ioc.internal.util.InternalUtils;
/**
* Standard implmentation of {@link ValidationTracker}. Works pretty hard to ensure a minimum
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Validator.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Validator.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Validator.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/Validator.java Mon Nov 12 14:22:31 2007
@@ -20,7 +20,7 @@
/**
* Used by a {@link Field} to enforce a <strong>constraint</strong> related to a form submission.
* Validators themselves are stateless singletons.
- * <p>
+ * <p/>
* Validators are usually encapsulated inside a {@link FieldValidator}.
*/
public interface Validator<C, T>
@@ -44,9 +44,9 @@
* Returns the message key, within the validiation messages, normally used by this validator.
* This is used to provide the {@link MessageFormatter} passed to
* {@link #validate(Field, Object, MessageFormatter, Object)} (unless overridden).
- *
- * @see ValidationMessagesSource
+ *
* @return a message key
+ * @see ValidationMessagesSource
*/
String getMessageKey();
@@ -54,17 +54,12 @@
* Invoked after the client-submitted value has been {@link Translator translated} to check that
* the value conforms to expectations (often, in terms of minimum or maximum value). If and only
* if the value is approved by all Validators is the value applied by the field.
- *
- * @param field
- * the field for which a client submitted value is being validated
- * @param constraintValue
- * the value used to constrain
- * @param formatter
- * Validation messages, in the appropriate locale
- * @param value
- * the translated value supplied by the user
- * @throws ValidationException
- * if the value violates the constraint
+ *
+ * @param field the field for which a client submitted value is being validated
+ * @param constraintValue the value used to constrain
+ * @param formatter Validation messages, in the appropriate locale
+ * @param value the translated value supplied by the user
+ * @throws ValidationException if the value violates the constraint
*/
void validate(Field field, C constraintValue, MessageFormatter formatter, T value)
throws ValidationException;
@@ -78,19 +73,14 @@
/**
* Hook used by components to allow the validator to contribute additional attribute or (more
* often) client-side JavaScript (via the {@link PageRenderSupport}).
- *
- * @param field
- * the field which is currently being rendered
- * @param constraintValue
- * the value used to constrain input
- * @param formatter
- * validation message, in the appropriate locale
- * @param writer
- * markup writer, allowing additional attributes to be written into the active
- * element
- * @param pageRenderSupport
- * used to generate client-side JavaScript to support validation
+ *
+ * @param field the field which is currently being rendered
+ * @param constraintValue the value used to constrain input
+ * @param formatter validation message, in the appropriate locale
+ * @param writer markup writer, allowing additional attributes to be written into the active
+ * element
+ * @param pageRenderSupport used to generate client-side JavaScript to support validation
*/
void render(Field field, C constraintValue, MessageFormatter formatter, MarkupWriter writer,
- PageRenderSupport pageRenderSupport);
+ PageRenderSupport pageRenderSupport);
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValueEncoder.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValueEncoder.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValueEncoder.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/ValueEncoder.java Mon Nov 12 14:22:31 2007
@@ -19,11 +19,11 @@
/**
* Used by {@link Select} (and similar components) to encode server side values into client-side
* strings, and back.
- * <p>
+ * <p/>
* Most often a custom implementation is needed for entity type objects, where the
* {@link #toClient(Object)} method extracts a primary key, and the {@link #toValue(String)}
* re-acquires the corresponding entity object.
- *
+ *
* @see SelectModel
*/
public interface ValueEncoder<V>
@@ -32,9 +32,8 @@
* Converts a value into a client-side representation. The value should be parseable by
* {@link #toValue(String)}. In some cases, what is returned is an identifier used to locate
* the true object, rather than a string representation of the value itself.
- *
- * @param value
- * to be encoded
+ *
+ * @param value to be encoded
* @return a string representation of the value, or the value's identity
*/
String toClient(V value);
@@ -42,9 +41,8 @@
/**
* Converts a client-side representation, provided by {@link #toClient(Object)}, back into a
* server-side value.
- *
- * @param clientValue
- * string representation of the value's identity
+ *
+ * @param clientValue string representation of the value's identity
* @return the corresponding entity, or null if not found
*/
V toValue(String clientValue);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRender.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRender.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRender.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRender.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,10 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
@@ -31,6 +30,7 @@
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface AfterRender {
+public @interface AfterRender
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderBody.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderBody.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderBody.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderBody.java Mon Nov 12 14:22:31 2007
@@ -1,25 +1,24 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Corresponds to {@link BeforeRenderBody}, allowing additional markup after rendering the body of
@@ -31,6 +30,7 @@
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface AfterRenderBody {
+public @interface AfterRenderBody
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderTemplate.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderTemplate.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderTemplate.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/AfterRenderTemplate.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,10 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
@@ -29,6 +28,7 @@
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface AfterRenderTemplate {
+public @interface AfterRenderTemplate
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/ApplicationState.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/ApplicationState.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/ApplicationState.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/ApplicationState.java Mon Nov 12 14:22:31 2007
@@ -14,19 +14,18 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.services.ApplicationStateManager;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-import org.apache.tapestry.services.ApplicationStateManager;
-
/**
* Marker annotation for a field that is an <em>application state object</em> as controlled by the
* {@link ApplicationStateManager}.
- * <p>
+ * <p/>
* An ASO file may have a companion field, of type boolean, used to see if the ASO has been created yet.
* If another field exists with the same name, suffixed with "Exists" (i.e., "_aso" for the ASO
* field, and "_asoExists" for the companion field) and the type of that field is boolean, then access
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderBody.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderBody.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderBody.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderBody.java Mon Nov 12 14:22:31 2007
@@ -1,42 +1,42 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Marks methods to be invoked when the component rendering state machine hits the point in the
* component's template where the body element occurs. Such methods may optionally take a
* {@link org.apache.tapestry.MarkupWriter} parameter, and may return void or boolean.
- * <p>
+ * <p/>
* Returning true (or void) will queue up the component's body for rendering.
- * <p>
+ * <p/>
* Returning false will skip the component's body, but continue rendering the template. The
* {@link org.apache.tapestry.annotations.AfterRenderBody} phase will still execute after the
* template finishes rendering.
- * <p>
+ * <p/>
* This phase is skipped for components which do not have a body.
*/
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface BeforeRenderBody {
+public @interface BeforeRenderBody
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderTemplate.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderTemplate.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderTemplate.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeforeRenderTemplate.java Mon Nov 12 14:22:31 2007
@@ -1,25 +1,24 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.ElementType;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Associated with components that have a template, this phase is invoked to allow the component to
@@ -31,6 +30,7 @@
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface BeforeRenderTemplate {
+public @interface BeforeRenderTemplate
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeginRender.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeginRender.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeginRender.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/BeginRender.java Mon Nov 12 14:22:31 2007
@@ -14,34 +14,34 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
* Marker annotation for methods that should be executed at the start of rendering the component.
* This usually includes rendering of the component's start tag.
- * <p>
+ * <p/>
* Such methods may optionally take a {@link org.apache.tapestry.MarkupWriter} parameter, and may
* return void or boolean. Returning true or void will allow the component to advance into the
* render template / render body phase. If a body is present, the
* {@link org.apache.tapestry.annotations.BeforeRenderBody} phase will execute. If a component has a
* template, the {@link BeforeRenderTemplate} phase will execute (and the render body will only
* occur if the template directs so).
- * <p>
+ * <p/>
* Either way, the {@link org.apache.tapestry.annotations.AfterRender} phase will execute after the
* template and/or body have rendered. A component with a body but without a template will still see
* the {@link org.apache.tapestry.annotations.BeforeRenderBody} phase execute.
- * <p>
+ * <p/>
* Returning false will skip rendering of the template and/or body, and jump directly to the
* {@link AfterRender} phase.
*/
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface BeginRender {
+public @interface BeginRender
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/CleanupRender.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/CleanupRender.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/CleanupRender.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/CleanupRender.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,10 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
@@ -32,6 +31,7 @@
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface CleanupRender {
+public @interface CleanupRender
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Component.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Component.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Component.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Component.java Mon Nov 12 14:22:31 2007
@@ -1,35 +1,33 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Used to define an <em>embedded component</em> within another component.
- *
- *
*/
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface Component {
+public @interface Component
+{
/**
* The id of the component. When left blank (the default), the component id is determined from
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Environmental.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Environmental.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Environmental.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Environmental.java Mon Nov 12 14:22:31 2007
@@ -14,15 +14,14 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.services.Environment;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-import org.apache.tapestry.services.Environment;
-
/**
* Defines a field that is replaced at runtime with a read-only value obtained from the
* {@link Environment} service.
@@ -30,7 +29,8 @@
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface Environmental {
+public @interface Environmental
+{
/**
* The value determines if the environmental service to be injected is required or not. In most
* cases, it is, so the default is true.
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Id.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Id.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Id.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Id.java Mon Nov 12 14:22:31 2007
@@ -14,16 +14,15 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.Block;
+import org.apache.tapestry.ioc.annotations.Inject;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-import org.apache.tapestry.Block;
-import org.apache.tapestry.ioc.annotations.Inject;
-
/**
* Optional annotation, used with {@link Inject}, which exists to provide the id of an object when
* it can not be determined by other means (such as from the field name). Currently, this is used
@@ -34,6 +33,8 @@
@Retention(RUNTIME)
public @interface Id
{
- /** The id. */
+ /**
+ * The id.
+ */
String value();
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectContainer.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectContainer.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectContainer.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectContainer.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,10 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectPage.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectPage.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectPage.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/InjectPage.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,10 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
@@ -28,7 +27,8 @@
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface InjectPage {
+public @interface InjectPage
+{
/**
* The name of the page to inject, which is used when the field type is not sufficient to
* identify the page (for example, when the field type is an interface implemented by the page).
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Meta.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Meta.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Meta.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Meta.java Mon Nov 12 14:22:31 2007
@@ -14,15 +14,14 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.TYPE;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.model.ComponentModel;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.TYPE;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-import org.apache.tapestry.model.ComponentModel;
-
/**
* Allows for the specification of per-component meta-data. Meta data can later be accessed via
* {@link ComponentModel#getMeta(String)}. Meta data keys are case insensitive. Meta data defined
@@ -31,7 +30,8 @@
@Target(TYPE)
@Retention(RUNTIME)
@Documented
-public @interface Meta {
+public @interface Meta
+{
/**
* The meta data as a list of "name=value" elements.
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixin.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixin.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixin.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixin.java Mon Nov 12 14:22:31 2007
@@ -1,25 +1,24 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Defines an <em>implementation</em> mixin for a component.
@@ -27,7 +26,8 @@
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface Mixin {
+public @interface Mixin
+{
/**
* Defines the type of mixin, using a logical mixin name. This value takes precedence over the
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinAfter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinAfter.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinAfter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinAfter.java Mon Nov 12 14:22:31 2007
@@ -14,12 +14,11 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.TYPE;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.TYPE;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
@@ -32,6 +31,7 @@
@Documented
@Retention(RUNTIME)
@Inherited
-public @interface MixinAfter {
+public @interface MixinAfter
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinClasses.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinClasses.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinClasses.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/MixinClasses.java Mon Nov 12 14:22:31 2007
@@ -1,36 +1,36 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Used to attach one or more instance mixins to an embedded component. Each mixin is specified as a
* specific class. This annotation is only recognized when used in conjuction with the
* {@link Component} annotation.
- *
+ *
* @see Mixins
*/
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface MixinClasses {
+public @interface MixinClasses
+{
Class[] value();
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixins.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixins.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixins.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Mixins.java Mon Nov 12 14:22:31 2007
@@ -1,38 +1,40 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Used to attach one ore more instance mixin to an embedded component. Each mixin is specified in
* terms of a logical mixin type name. This annotation is only recognized when used in conjuction
* with the {@link Component} annotation.
- *
+ *
* @see MixinClasses
*/
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface Mixins {
+public @interface Mixins
+{
- /** One or more mixin type names, from which actual mixin class names can be resolved. */
+ /**
+ * One or more mixin type names, from which actual mixin class names can be resolved.
+ */
String[] value();
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/OnEvent.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/OnEvent.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/OnEvent.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/OnEvent.java Mon Nov 12 14:22:31 2007
@@ -14,32 +14,31 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
* Marks a method as a handler for a client side event. The handler method will be invoked when a
* component triggers an event. Filters on the type of event and on the originating component ensure
* that only the appropriate methods are invoked.
- * <p>
+ * <p/>
* Client events include a <em>context</em> of one or more values. These context values are
* included in the action URI. The values are optionally supplied to the handler method as
* parameters. Automatic type coercions from string to the type of the actual parameter occur.
- * <p>
+ * <p/>
* Handlers may return a value. Returning a non-null value will abort the handling of the event, and
* will usually control the response sent to the client web browser. The details are somewhat
* specific to the type of event and the component involved.
- * <p>
+ * <p/>
* If a handler is not found within the originating component (or no handler aborts the event
* handling), then handlers within the containing component will be searched. This continues up the
* page hierarchy. In some cases, having no handlers (or no aborting handlers) is considered
* acceptible; in others, it is an error. Again, this is defined by the type of originating
* component, and the type of event.
- * <p>
+ * <p/>
* <strong>If you fail to provide filters on either component or event type, then your method will
* be invoked for all component events, possibly including events that bubble up from embedded
* sub-components. </strong>
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageAttached.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageAttached.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageAttached.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageAttached.java Mon Nov 12 14:22:31 2007
@@ -14,26 +14,26 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.METHOD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.METHOD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
* Method annotation used for methods that should be invoked when the page is first attached to a
* request. This is useful for initializations that should occur on each request that involves the
* page. Often, such initializations will be balanced by cleanups when the page is detached.
- * <p>
+ * <p/>
* PageAttached methods should take no parameters and return void. They must either have this
* annotation, or be named "pageAttached".
- *
+ *
* @see PageDetached
*/
@Target(METHOD)
@Retention(RUNTIME)
@Documented
-public @interface PageAttached {
+public @interface PageAttached
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageDetached.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageDetached.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageDetached.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageDetached.java Mon Nov 12 14:22:31 2007
@@ -14,25 +14,25 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.METHOD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.METHOD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
* Method annotation used for methods that should be invoked when the page is detached at the end of
* a request, before it is returned to the page pool for later reuse.
- * <p>
+ * <p/>
* PageDetached methods should take no parameters and return void. They must either have this
* annotation, or be named "pageDetached".
- *
+ *
* @see PageAttached
*/
@Target(METHOD)
@Retention(RUNTIME)
@Documented
-public @interface PageDetached {
+public @interface PageDetached
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageLoaded.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageLoaded.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageLoaded.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/PageLoaded.java Mon Nov 12 14:22:31 2007
@@ -14,24 +14,24 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.METHOD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.METHOD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
* Method annotation used for methods that should be invoked once the page is fully loaded. This is
* useful for one-time component initializations that can't be done at instantance initialzation
* time, such as refrerences to embedded components or blocks.
- * <p>
+ * <p/>
* PageLoaded methods should take no parameters and return void. They must either have this
* annotation, or be named "pageLoaded".
*/
@Target(METHOD)
@Retention(RUNTIME)
@Documented
-public @interface PageLoaded {
+public @interface PageLoaded
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Parameter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Parameter.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Parameter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Parameter.java Mon Nov 12 14:22:31 2007
@@ -14,15 +14,14 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.TapestryConstants;
+import org.apache.tapestry.services.BindingFactory;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-
-import org.apache.tapestry.TapestryConstants;
-import org.apache.tapestry.services.BindingFactory;
/**
* Annotation placed on a field to indicate that it is, in fact, an parameter. Parameters may be
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Path.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Path.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Path.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Path.java Mon Nov 12 14:22:31 2007
@@ -14,23 +14,22 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.ElementType.PARAMETER;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.Asset;
+import org.apache.tapestry.ioc.annotations.Inject;
import java.lang.annotation.Documented;
+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;
-import org.apache.tapestry.Asset;
-import org.apache.tapestry.ioc.annotations.Inject;
-
/**
* Used in conjunction with the {@link Inject} annotation to inject an {@link Asset} based on a
* path.
*/
@Target(
-{ FIELD, PARAMETER })
+ {FIELD, PARAMETER})
@Documented
@Retention(RUNTIME)
public @interface Path
@@ -39,7 +38,7 @@
* The path to the resource; if prefixed (say with "classpath:") then its a complete path within
* the identified namespace; otherwise it's a relative path from the class containing the
* annotation. Symbols will be expanded.
- *
+ *
* @return
*/
String value();
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Persist.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Persist.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Persist.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Persist.java Mon Nov 12 14:22:31 2007
@@ -14,36 +14,36 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.services.MetaDataLocator;
+import org.apache.tapestry.services.Session;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-import org.apache.tapestry.services.MetaDataLocator;
-import org.apache.tapestry.services.Session;
-
/**
* Identifies a field as persistent, meaning its value persists from one request to the next.
* Different strategies exist for how this is accomplished, the most common being the default,
* "session", which stores the field's value in the {@link Session}.
- * <p>
+ * <p/>
* In most cases, the value will be omitted and will default to the empty string. This forces a
* search for the correct strategy. Starting with the component (or mixin) itself, a check is made
* for the {@link Meta meta data property} <code>tapestry.persistence-strategy</code>. If a value
* is found, it is used, otherwise the search continues up the inheritance hierarchy, towards the
* page. If not found, then the "session" strategy is used.
- * <p>
+ * <p/>
* In this way, the session persistence strategy for a component and all of its sub-components can
* be controlled by the containing component.
- *
+ *
* @see MetaDataLocator
*/
@Target(FIELD)
@Documented
@Retention(RUNTIME)
-public @interface Persist {
+public @interface Persist
+{
/**
* The strategy used to persist the value. The default value, the empty string, allows
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Retain.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Retain.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Retain.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Retain.java Mon Nov 12 14:22:31 2007
@@ -1,42 +1,42 @@
-// 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
-//
-// http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
+// 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
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
-import java.lang.annotation.Documented;
-import java.lang.annotation.Retention;
-import java.lang.annotation.Target;
+import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.FIELD;
+import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import java.lang.annotation.Target;
/**
* Marker annotation placed on fields whose value should be retained past the end of the request.
* This is most often associated with fields that are <em>lazily loaded</em>. By marking such
* fields with the Retain annotation, the fields will <em>not</em> be discarded at the end of the
* request.
- * <p>
+ * <p/>
* This is quite different from {@link Persist}, because the value that's allowed to be retained is
* not stored persistently; it is simply not cleared out. A subsequent request, even from the same
* user, may be processed by a different instance of the page where the value is still null.
- * <p>
+ * <p/>
* This annotation should only be used with lazily-evaluated objects that contain no client-specific
* information.
*/
@Target(FIELD)
@Retention(RUNTIME)
@Documented
-public @interface Retain {
+public @interface Retain
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Service.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Service.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Service.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/Service.java Mon Nov 12 14:22:31 2007
@@ -14,27 +14,28 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.FIELD;
-import static java.lang.annotation.ElementType.PARAMETER;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.ioc.annotations.Inject;
import java.lang.annotation.Documented;
+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;
-import org.apache.tapestry.ioc.annotations.Inject;
-
/**
* Used in conjunction with the {@link Inject} annotation to identify a service <em>by name</em>
* and not by type. This is most useful when there are multiple services with the same service
* interface and a particular one needs to be selected.
*/
@Target(
-{ FIELD, PARAMETER })
+ {FIELD, PARAMETER})
@Documented
@Retention(RUNTIME)
public @interface Service
{
- /** The name of the service. Symbols will be expanded and case is not relevant. */
+ /**
+ * The name of the service. Symbols will be expanded and case is not relevant.
+ */
String value();
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SetupRender.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SetupRender.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SetupRender.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SetupRender.java Mon Nov 12 14:22:31 2007
@@ -14,11 +14,10 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
-
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
/**
@@ -31,6 +30,7 @@
@Target(ElementType.METHOD)
@Retention(RUNTIME)
@Documented
-public @interface SetupRender {
+public @interface SetupRender
+{
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SupportsInformalParameters.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SupportsInformalParameters.java?rev=594319&r1=594318&r2=594319&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SupportsInformalParameters.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/annotations/SupportsInformalParameters.java Mon Nov 12 14:22:31 2007
@@ -14,26 +14,26 @@
package org.apache.tapestry.annotations;
-import static java.lang.annotation.ElementType.TYPE;
-import static java.lang.annotation.RetentionPolicy.RUNTIME;
+import org.apache.tapestry.model.ComponentModel;
import java.lang.annotation.Documented;
+import static java.lang.annotation.ElementType.TYPE;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Target;
-import org.apache.tapestry.model.ComponentModel;
-
/**
* Used to identify a component that can support informal parameters. By default, components do not
* support informal parameters.
- *
+ *
* @see ComponentModel#getSupportsInformalParameters()
*/
@Target(TYPE)
@Retention(RUNTIME)
@Documented
@Inherited
-public @interface SupportsInformalParameters {
+public @interface SupportsInformalParameters
+{
}