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 2008/03/02 18:21:32 UTC
svn commit: r632791 [7/8] - in /tapestry/tapestry5/trunk:
tapestry-core/src/main/java/org/apache/tapestry/
tapestry-core/src/main/java/org/apache/tapestry/annotations/
tapestry-core/src/main/java/org/apache/tapestry/corelib/components/
tapestry-core/sr...
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ComponentSource.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ComponentSource.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ComponentSource.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ComponentSource.java Sun Mar 2 09:21:16 2008
@@ -18,10 +18,9 @@
import org.apache.tapestry.runtime.Component;
/**
- * Used by classes that need to retrieve a component by its complete id, or a page by its logical
- * page name or root component class. The complete id is the logical name of the containing page, a colon,
- * and the nested component id. It may also just be the page name (for the root component of a
- * page).
+ * Used by classes that need to retrieve a component by its complete id, or a page by its logical page name or root
+ * component class. The complete id is the logical name of the containing page, a colon, and the nested component id. It
+ * may also just be the page name (for the root component of a page).
*/
public interface ComponentSource
{
@@ -36,8 +35,8 @@
Component getComponent(String componentId);
/**
- * Returns the page identified by its logical page name. A logical page name is the short form
- * of a page name often emebedded into URLs.
+ * Returns the page identified by its logical page name. A logical page name is the short form of a page name often
+ * emebedded into URLs.
*
* @param pageName the logical page name
* @return the corresponding page's root component
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ContextProvider.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ContextProvider.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ContextProvider.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ContextProvider.java Sun Mar 2 09:21:16 2008
@@ -22,11 +22,11 @@
import java.lang.annotation.Target;
/**
- * Marker annotation to select the correct {@link AssetFactory} for injection. The marked interface will provide
- * assets located in the web application context.
+ * Marker annotation to select the correct {@link AssetFactory} for injection. The marked interface will provide assets
+ * located in the web application context.
*/
@Target(
- {PARAMETER, FIELD})
+ { PARAMETER, FIELD })
@Retention(RUNTIME)
@Documented
public @interface ContextProvider
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Cookies.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Cookies.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Cookies.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Cookies.java Sun Mar 2 09:21:16 2008
@@ -20,17 +20,16 @@
public interface Cookies
{
/**
- * Returns the value of the first cookie whose name matches. Returns null if no such cookie
- * exists. This method is only aware of cookies that are part of the incoming request; it does
- * not know about additional cookies added since then (via
- * {@link #writeCookieValue(String, String)}).
+ * Returns the value of the first cookie whose name matches. Returns null if no such cookie exists. This method is
+ * only aware of cookies that are part of the incoming request; it does not know about additional cookies added
+ * since then (via {@link #writeCookieValue(String, String)}).
*/
String readCookieValue(String name);
/**
- * Creates or updates a cookie value. The value is stored using a max age (in seconds) defined
- * by the symbol <code>org.apache.tapestry.default-cookie-max-age</code>. The factory default
- * for this value is the equivalent of one week.
+ * Creates or updates a cookie value. The value is stored using a max age (in seconds) defined by the symbol
+ * <code>org.apache.tapestry.default-cookie-max-age</code>. The factory default for this value is the equivalent of
+ * one week.
*/
void writeCookieValue(String name, String value);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Core.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Core.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Core.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Core.java Sun Mar 2 09:21:16 2008
@@ -25,7 +25,7 @@
* Marker annotation for services that are provided by the Tapestry core module.
*/
@Target(
- {PARAMETER, FIELD})
+ { PARAMETER, FIELD })
@Retention(RUNTIME)
@Documented
public @interface Core
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Dispatcher.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Dispatcher.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Dispatcher.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Dispatcher.java Sun Mar 2 09:21:16 2008
@@ -20,7 +20,10 @@
* A dispatcher is responsible for recognizing an incoming request. Dispatchers form an ordered chain of command, with
* each dispatcher responsible for recognizing requests that it can process.
*
- * @see org.apache.tapestry.services.TapestryModule#contributeMasterDispatcher(org.apache.tapestry.ioc.OrderedConfiguration, ClasspathAssetAliasManager, org.apache.tapestry.internal.services.ResourceCache, org.apache.tapestry.internal.services.ResourceStreamer, PageRenderRequestHandler, ComponentEventRequestHandler, ComponentClassResolver, ContextValueEncoder, String)
+ * @see org.apache.tapestry.services.TapestryModule#contributeMasterDispatcher(org.apache.tapestry.ioc.OrderedConfiguration,
+ * ClasspathAssetAliasManager, org.apache.tapestry.internal.services.ResourceCache,
+ * org.apache.tapestry.internal.services.ResourceStreamer, PageRenderRequestHandler, ComponentEventRequestHandler,
+ * ComponentClassResolver, ContextValueEncoder, String)
*/
public interface Dispatcher
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Environment.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Environment.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Environment.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Environment.java Sun Mar 2 09:21:16 2008
@@ -17,11 +17,11 @@
import java.util.NoSuchElementException;
/**
- * Provides access to environment services, which are almost always provided to enclosed components
- * by enclosing components. Environmental services are a form of very late binding.
+ * Provides access to environment services, which are almost always provided to enclosed components by enclosing
+ * components. Environmental services are a form of very late binding.
* <p/>
- * The Environment acts like a collection of stacks. Each stack contains environmental service instances of a given type.
- * Most often, a stack has zero or one elements, but on occasion, a particular component will push an override
+ * The Environment acts like a collection of stacks. Each stack contains environmental service instances of a given
+ * type. Most often, a stack has zero or one elements, but on occasion, a particular component will push an override
* onto the stack for the benefit of the components it encloses.
*
* @see org.apache.tapestry.annotations.Environmental
@@ -59,8 +59,7 @@
<T> T pop(Class<T> type);
/**
- * Pushes a new service onto the stack. The old service at the top of the stack is returned (it
- * may be null).
+ * Pushes a new service onto the stack. The old service at the top of the stack is returned (it may be null).
*
* @param <T>
* @param type the type of service to store
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/EnvironmentalShadowBuilder.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/EnvironmentalShadowBuilder.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/EnvironmentalShadowBuilder.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/EnvironmentalShadowBuilder.java Sun Mar 2 09:21:16 2008
@@ -18,18 +18,17 @@
import org.apache.tapestry.ioc.services.PropertyShadowBuilder;
/**
- * Much like {@link PropertyShadowBuilder}, except that instead of accessing a property of some
- * other service, it accesses a value from within the {@link Environment} service. This is useful
- * for defining a new service that can be injected into other services (whereas the
- * {@link Environmental} annotation may only be used within component classes).
+ * Much like {@link PropertyShadowBuilder}, except that instead of accessing a property of some other service, it
+ * accesses a value from within the {@link Environment} service. This is useful for defining a new service that can be
+ * injected into other services (whereas the {@link Environmental} annotation may only be used within component
+ * classes).
*/
public interface EnvironmentalShadowBuilder
{
/**
- * Returns a proxy that delegates all methods to an object obtained from
- * {@link Environment#peekRequired(Class)}. Note that at the time this method is invoked, the
- * Environment service may still be virtual, and will often not yet have been loaded with
- * values, and that's OK, the resolution is deferred to the instant a method is invoked.
+ * Returns a proxy that delegates all methods to an object obtained from {@link Environment#peekRequired(Class)}.
+ * Note that at the time this method is invoked, the Environment service may still be virtual, and will often not
+ * yet have been loaded with values, and that's OK, the resolution is deferred to the instant a method is invoked.
*
* @param <T>
* @param serviceType the service type, which is used to obtained the delegate instance
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorDefaultSource.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorDefaultSource.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorDefaultSource.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorDefaultSource.java Sun Mar 2 09:21:16 2008
@@ -22,14 +22,14 @@
import java.util.Locale;
/**
- * For a particular field, generates the default validation for the field, in accordance with a
- * number of factors and contributions.
+ * For a particular field, generates the default validation for the field, in accordance with a number of factors and
+ * contributions.
*/
public interface FieldValidatorDefaultSource
{
/**
- * Analyzes the property type and property annotations to determine the default set of
- * validations for the property, which are wrapped to form a {@link FieldValidator} for a field.
+ * Analyzes the property type and property annotations to determine the default set of validations for the property,
+ * which are wrapped to form a {@link FieldValidator} for a field.
*
* @param field
* @param overrideId
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorSource.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorSource.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorSource.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/FieldValidatorSource.java Sun Mar 2 09:21:16 2008
@@ -28,48 +28,42 @@
public interface FieldValidatorSource
{
/**
- * Creates the validator. The error message associated with the field validator usually comes
- * from the {@link ValidationMessagesSource} (using the validator's
- * {@link Validator#getMessageKey() message key}). However, if the container component of the
- * field defines a message key <code><i>id</i>-<i>validator</i>
- * (where id is the simple id of the field component, and validator is the validatorType), then that
- * message is used instead. This allows you to override the message for a particular validation of a particular field.
+ * Creates the validator. The error message associated with the field validator usually comes from the {@link
+ * ValidationMessagesSource} (using the validator's {@link Validator#getMessageKey() message key}). However, if the
+ * container component of the field defines a message key <code><i>id</i>-<i>validator</i> (where id is the simple
+ * id of the field component, and validator is the validatorType), then that message is used instead. This allows
+ * you to override the message for a particular validation of a particular field.
*
* @param field the field for which a validator is to be created
- * @param validatorType used to select the {@link Validator} that forms the core of the
- * {@link FieldValidator}
- * @param constraintValue a value used to configure the validator, or null if the validator is not
- * configurarable
+ * @param validatorType used to select the {@link Validator} that forms the core of the {@link FieldValidator}
+ * @param constraintValue a value used to configure the validator, or null if the validator is not configurarable
* @return the field validator for the field
*/
FieldValidator createValidator(Field field, String validatorType, String constraintValue);
/**
- * Full featured version of {@link #createValidator(Field, String, String)} used in situations
- * where the container of the field is not necesarrilly the place to look for override messages,
- * and the id of the field is not the key to use when checking. The {@link BeanEditForm} is an
- * example of this.
+ * Full featured version of {@link #createValidator(Field, String, String)} used in situations where the container
+ * of the field is not necesarrilly the place to look for override messages, and the id of the field is not the key
+ * to use when checking. The {@link BeanEditForm} is an example of this.
*
* @param field the field for which a validator is to be created
- * @param validatorType used to select the {@link Validator} that forms the core of the
- * {@link FieldValidator}
- * @param constraintValue a value used to configure the validator, or null if the validator is not
- * configurable
- * @param overrideId the base id used when searching for validator message overrides (this would
- * normally be the field component's simple id)
- * @param overrideMessages the message catalog to search for override messages (this would normally be the
- * catalog for the container of the field component)
- * @param locale locale used when retrieving default validation messages from the
- * {@link ValidationMessagesSource}
+ * @param validatorType used to select the {@link Validator} that forms the core of the {@link FieldValidator}
+ * @param constraintValue a value used to configure the validator, or null if the validator is not configurable
+ * @param overrideId the base id used when searching for validator message overrides (this would normally be
+ * the field component's simple id)
+ * @param overrideMessages the message catalog to search for override messages (this would normally be the catalog
+ * for the container of the field component)
+ * @param locale locale used when retrieving default validation messages from the {@link
+ * ValidationMessagesSource}
* @return the field validator for the field
*/
FieldValidator createValidator(Field field, String validatorType, String constraintValue,
String overrideId, Messages overrideMessages, Locale locale);
/**
- * Creates a set of validators. The specification is a string used to identify and configure the
- * individual validators. The specification is a comma-separated list of terms. Each term is a
- * validator type name and an optional constraint value (seperated by an equals sign).
+ * Creates a set of validators. The specification is a string used to identify and configure the individual
+ * validators. The specification is a comma-separated list of terms. Each term is a validator type name and an
+ * optional constraint value (seperated by an equals sign).
*
* @param field
* @param specification
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Heartbeat.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Heartbeat.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Heartbeat.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Heartbeat.java Sun Mar 2 09:21:16 2008
@@ -15,18 +15,17 @@
package org.apache.tapestry.services;
/**
- * Allows for deferred execution of logic, useful when trying to get multiple components to
- * coordinate behavior. A component may add a command to be executed "{@link #end() at the end of the heartbeat}".
- * The classic example of this is a Label and the field it labels; since we don't know which order
- * the two will render, we can't tell if the field's id is correct until after both have rendered.
+ * Allows for deferred execution of logic, useful when trying to get multiple components to coordinate behavior. A
+ * component may add a command to be executed "{@link #end() at the end of the heartbeat}". The classic example of this
+ * is a Label and the field it labels; since we don't know which order the two will render, we can't tell if the field's
+ * id is correct until after both have rendered.
* <p/>
* The Heartbeat is injected into components via the {@link org.apache.tapestry.annotations.Environmental} annotation.
*/
public interface Heartbeat
{
/**
- * Begins a new Heartbeat. Heartbeats nest. Every call to begin() should be matched by a call to
- * {@link #end()}.
+ * Begins a new Heartbeat. Heartbeats nest. Every call to begin() should be matched by a call to {@link #end()}.
*/
void begin();
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/HttpServletRequestFilter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/HttpServletRequestFilter.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/HttpServletRequestFilter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/HttpServletRequestFilter.java Sun Mar 2 09:21:16 2008
@@ -1,17 +1,17 @@
-// 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.services;
import javax.servlet.http.HttpServletRequest;
@@ -24,9 +24,9 @@
public interface HttpServletRequestFilter
{
/**
- * Filter interface for the HttpServletRequestHandler pipeline. A filter should
- * delegate to the handler. It may perform operations before or after invoking the handler, and
- * may modify the request and response passed in to the handler.
+ * Filter interface for the HttpServletRequestHandler pipeline. A filter should delegate to the handler. It may
+ * perform operations before or after invoking the handler, and may modify the request and response passed in to the
+ * handler.
*
* @return true if the request has been handled, false otherwise
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/InjectionProvider.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/InjectionProvider.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/InjectionProvider.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/InjectionProvider.java Sun Mar 2 09:21:16 2008
@@ -18,27 +18,25 @@
import org.apache.tapestry.model.MutableComponentModel;
/**
- * Provides some form of injection when the value for an
- * {@link org.apache.tapestry.ioc.annotations.Inject} annotation is present. In this case, the provider
- * is responsible for determining the value to be injected from the field name and field type.
+ * Provides some form of injection when the value for an {@link org.apache.tapestry.ioc.annotations.Inject} annotation
+ * is present. In this case, the provider is responsible for determining the value to be injected from the field name
+ * and field type.
* <p/>
- * This interface will be used as part of a
- * {@link org.apache.tapestry.ioc.services.ChainBuilder chain of command}.
+ * This interface will be used as part of a {@link org.apache.tapestry.ioc.services.ChainBuilder chain of command}.
*/
public interface InjectionProvider
{
/**
- * Peform the injection, if possible. Most often, this will result in a call to
- * {@link ClassTransformation#injectField(String, Object)}. The caller is responsible for
- * invoking {@link ClassTransformation#claimField(String, Object)}.
+ * Peform the injection, if possible. Most often, this will result in a call to {@link
+ * ClassTransformation#injectField(String, Object)}. The caller is responsible for invoking {@link
+ * ClassTransformation#claimField(String, Object)}.
*
* @param fieldName the name of the field requesting injection
* @param fieldType the type of the field
* @param locator allows services to be located
* @param transformation allows the code for the class to be transformed
* @param componentModel defines the relevant aspects of the component
- * @return true if an injection has been made (terminates the command chain), false to continue
- * down the chain
+ * @return true if an injection has been made (terminates the command chain), false to continue down the chain
*/
boolean provideInjection(String fieldName, Class fieldType, ObjectLocator locator,
ClassTransformation transformation, MutableComponentModel componentModel);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/LibraryMapping.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/LibraryMapping.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/LibraryMapping.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/LibraryMapping.java Sun Mar 2 09:21:16 2008
@@ -1,32 +1,28 @@
-// 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.services;
/**
- * Used to configure the {@link ComponentClassResolver}, to allow it to map prefixes to library
- * root packages (the application namespace is a special case of this). In each case, a prefix on
- * the path is mapped to a package. Prefixes should start and end with characters, such as "core".
- * It is allowed for a prefix to contain a slash, though it is not recommended.
+ * Used to configure the {@link ComponentClassResolver}, to allow it to map prefixes to library root packages (the
+ * application namespace is a special case of this). In each case, a prefix on the path is mapped to a package. Prefixes
+ * should start and end with characters, such as "core". It is allowed for a prefix to contain a slash, though it is not
+ * recommended.
* <p/>
- * The root package name should have a number of sub-packages:
- * <dl>
- * <dt>pages</dt> <dd>contains named pages</dd>
- * <dt>components</dt> <dd>contains components</dd>
- * <dt>mixins</dt> <dd>contains component mixins</dd>
- * <dt>base</dt> <dd>contains base classes</dd>
- * </dl>
+ * The root package name should have a number of sub-packages: <dl> <dt>pages</dt> <dd>contains named pages</dd>
+ * <dt>components</dt> <dd>contains components</dd> <dt>mixins</dt> <dd>contains component mixins</dd> <dt>base</dt>
+ * <dd>contains base classes</dd> </dl>
*
* @see org.apache.tapestry.services.TapestryModule#contributeComponentClassResolver(org.apache.tapestry.ioc.Configuration)
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRenderer.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRenderer.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRenderer.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRenderer.java Sun Mar 2 09:21:16 2008
@@ -17,12 +17,13 @@
import org.apache.tapestry.MarkupWriter;
/**
- * An object which will perform rendering of a page (or portion of a page). This interface
- * exists to be filtered via {@link org.apache.tapestry.services.MarkupRendererFilter}.
+ * An object which will perform rendering of a page (or portion of a page). This interface exists to be filtered via
+ * {@link org.apache.tapestry.services.MarkupRendererFilter}.
* <p/>
- * The MarkupRenderer service takes an ordered configuration of {@link org.apache.tapestry.services.MarkupRendererFilter}s, which
- * are used for ordinary page rendering (as opposed to {@linkplain org.apache.tapestry.services.PartialMarkupRenderer partial page rendering} for Ajax requests).
- * The MarkupRenderer service may be selected using the {@link org.apache.tapestry.ioc.annotations.Primary} marker annotation.
+ * The MarkupRenderer service takes an ordered configuration of {@link org.apache.tapestry.services.MarkupRendererFilter}s,
+ * which are used for ordinary page rendering (as opposed to {@linkplain org.apache.tapestry.services.PartialMarkupRenderer
+ * partial page rendering} for Ajax requests). The MarkupRenderer service may be selected using the {@link
+ * org.apache.tapestry.ioc.annotations.Primary} marker annotation.
*/
public interface MarkupRenderer
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRendererFilter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRendererFilter.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRendererFilter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupRendererFilter.java Sun Mar 2 09:21:16 2008
@@ -17,17 +17,18 @@
import org.apache.tapestry.MarkupWriter;
/**
- * Filter interface for {@link org.apache.tapestry.services.MarkupRenderer}, which allows
- * for code to execute before and/or after the main rendering process. Typically, this is to
- * allow for the placement of {@linkplain org.apache.tapestry.services.Environment environmental services}.
+ * Filter interface for {@link org.apache.tapestry.services.MarkupRenderer}, which allows for code to execute before
+ * and/or after the main rendering process. Typically, this is to allow for the placement of {@linkplain
+ * org.apache.tapestry.services.Environment environmental services}.
*
- * @see org.apache.tapestry.services.TapestryModule#contributeMarkupRenderer(org.apache.tapestry.ioc.OrderedConfiguration, org.apache.tapestry.Asset, org.apache.tapestry.Asset, ValidationMessagesSource, org.apache.tapestry.ioc.services.SymbolSource, AssetSource)
+ * @see org.apache.tapestry.services.TapestryModule#contributeMarkupRenderer(org.apache.tapestry.ioc.OrderedConfiguration,
+ * org.apache.tapestry.Asset, org.apache.tapestry.Asset, ValidationMessagesSource,
+ * org.apache.tapestry.ioc.services.SymbolSource, AssetSource)
*/
public interface MarkupRendererFilter
{
/**
- * Implementations should perform work before or after passing the writer
- * to the renderer.
+ * Implementations should perform work before or after passing the writer to the renderer.
*
* @param writer to which markup should be written
* @param renderer delegate to which the writer should be passed.
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupWriterFactory.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupWriterFactory.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupWriterFactory.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MarkupWriterFactory.java Sun Mar 2 09:21:16 2008
@@ -1,17 +1,17 @@
-// 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.services;
import org.apache.tapestry.ContentType;
@@ -25,8 +25,8 @@
/**
* Creates a markup writer for a particular content type.
*
- * @param contentType type of content generated by the markup write; used to control the type of
- * {@link org.apache.tapestry.dom.MarkupModel} used with the {@link org.apache.tapestry.dom.Document}
+ * @param contentType type of content generated by the markup write; used to control the type of {@link
+ * org.apache.tapestry.dom.MarkupModel} used with the {@link org.apache.tapestry.dom.Document}
* the backs the markup writer.
*/
MarkupWriter newMarkupWriter(ContentType contentType);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MethodFilter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MethodFilter.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MethodFilter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/MethodFilter.java Sun Mar 2 09:21:16 2008
@@ -20,8 +20,8 @@
public interface MethodFilter
{
/**
- * Passed each signature in turn, only signatures for which this method returns true will be
- * included in the final result.
+ * Passed each signature in turn, only signatures for which this method returns true will be included in the final
+ * result.
*/
boolean accept(TransformMethodSignature signature);
}
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ObjectRenderer.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ObjectRenderer.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ObjectRenderer.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ObjectRenderer.java Sun Mar 2 09:21:16 2008
@@ -17,8 +17,8 @@
import org.apache.tapestry.MarkupWriter;
/**
- * A strategy interface used for converting an object into markup that describes that object. This
- * is primarily used in terms of an {@link org.apache.tapestry.services.ExceptionReporter} page.
+ * A strategy interface used for converting an object into markup that describes that object. This is primarily used in
+ * terms of an {@link org.apache.tapestry.services.ExceptionReporter} page.
*/
public interface ObjectRenderer<T>
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PageRenderRequestFilter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PageRenderRequestFilter.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PageRenderRequestFilter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PageRenderRequestFilter.java Sun Mar 2 09:21:16 2008
@@ -17,14 +17,14 @@
import java.io.IOException;
/**
- * Filter interface for {@link PageRenderRequestHandler}, which allows extra behaviors to be
- * injected into the processing of a page render request.
+ * Filter interface for {@link PageRenderRequestHandler}, which allows extra behaviors to be injected into the
+ * processing of a page render request.
*/
public interface PageRenderRequestFilter
{
/**
- * Invoked to activate and render a page. The return value of the event handler method(s) for
- * the activate event may result in an action response generator being returned.
+ * Invoked to activate and render a page. The return value of the event handler method(s) for the activate event may
+ * result in an action response generator being returned.
*
* @param parameters defines the page name and activation context
* @param handler to delegate the invocation to
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRenderer.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRenderer.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRenderer.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRenderer.java Sun Mar 2 09:21:16 2008
@@ -18,17 +18,18 @@
import org.apache.tapestry.json.JSONObject;
/**
- * Defines an Ajax-oriented partial page render, wherein a render of a portion of a page occurs, and the content is stored into a key ("content") of a {@link org.apache.tapestry.json.JSONObject}, which is
- * sent to the client side as the final response. Client-side JavaScript receives this reply and uses it to update a portion of the page.
+ * Defines an Ajax-oriented partial page render, wherein a render of a portion of a page occurs, and the content is
+ * stored into a key ("content") of a {@link org.apache.tapestry.json.JSONObject}, which is sent to the client side as
+ * the final response. Client-side JavaScript receives this reply and uses it to update a portion of the page.
* <p/>
* <p/>
- * The PartialMarkupRenderer service takes an ordered configuration of {@link PartialMarkupRendererFilter}s. It can be selected using the {@link org.apache.tapestry.ioc.annotations.Primary} marker annotation.
+ * The PartialMarkupRenderer service takes an ordered configuration of {@link PartialMarkupRendererFilter}s. It can be
+ * selected using the {@link org.apache.tapestry.ioc.annotations.Primary} marker annotation.
*/
public interface PartialMarkupRenderer
{
/**
- * Implementations should perform work before or after passing the writer
- * to the renderer.
+ * Implementations should perform work before or after passing the writer to the renderer.
*
* @param writer to which markup should be written
* @param reply JSONObject which will contain the partial response
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRendererFilter.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRendererFilter.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRendererFilter.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PartialMarkupRendererFilter.java Sun Mar 2 09:21:16 2008
@@ -18,17 +18,19 @@
import org.apache.tapestry.json.JSONObject;
/**
- * A filter (the main interface being {@link PartialMarkupRenderer}) applied when performing a partial page render as part of an Ajax-oriented request. This is similar
- * to {@link org.apache.tapestry.services.MarkupRendererFilter} and filters are often in place so as
- * to contribute {@link org.apache.tapestry.annotations.Environmental} services to the pages and components that render.
+ * A filter (the main interface being {@link PartialMarkupRenderer}) applied when performing a partial page render as
+ * part of an Ajax-oriented request. This is similar to {@link org.apache.tapestry.services.MarkupRendererFilter} and
+ * filters are often in place so as to contribute {@link org.apache.tapestry.annotations.Environmental} services to the
+ * pages and components that render.
*
- * @see org.apache.tapestry.services.TapestryModule#contributePartialMarkupRenderer(org.apache.tapestry.ioc.OrderedConfiguration, org.apache.tapestry.Asset, ValidationMessagesSource, org.apache.tapestry.ioc.services.SymbolSource, AssetSource)
+ * @see org.apache.tapestry.services.TapestryModule#contributePartialMarkupRenderer(org.apache.tapestry.ioc.OrderedConfiguration,
+ * org.apache.tapestry.Asset, ValidationMessagesSource, org.apache.tapestry.ioc.services.SymbolSource,
+ * AssetSource)
*/
public interface PartialMarkupRendererFilter
{
/**
- * Implementations should perform work before or after passing the writer
- * to the renderer.
+ * Implementations should perform work before or after passing the writer to the renderer.
*
* @param writer to which markup should be written
* @param reply JSONObject which will contain the partial response
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldBundle.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldBundle.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldBundle.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldBundle.java Sun Mar 2 09:21:16 2008
@@ -1,17 +1,17 @@
-// 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.services;
/**
@@ -20,20 +20,19 @@
public interface PersistentFieldBundle
{
/**
- * Checks to see if a persistent value has been stored for the indicated component and field.
- * TODO: This method can probably be removed; it doesn't look like its used (instead, we if
- * check getValue() returns null).
+ * Checks to see if a persistent value has been stored for the indicated component and field. TODO: This method can
+ * probably be removed; it doesn't look like its used (instead, we if check getValue() returns null).
*
- * @param componentId the nested id of the component (within the page), may be null or blank for the
- * root component of the page
+ * @param componentId the nested id of the component (within the page), may be null or blank for the root component
+ * of the page
* @param fieldName the name of the field whose value was persisted
* @return true if a change has been stored
*/
boolean containsValue(String componentId, String fieldName);
/**
- * @param componentId the nested if of the component (within the page), may be null or blank for the
- * root component of the page
+ * @param componentId the nested if of the component (within the page), may be null or blank for the root component
+ * of the page
* @param fieldName the name of the field whose value was persisted
* @return the persisted value, possibly null
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldChange.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldChange.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldChange.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PersistentFieldChange.java Sun Mar 2 09:21:16 2008
@@ -1,22 +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.services;
/**
- * Represents a previously stored change to a persistent field, within the context of a particular
- * page of the application.
+ * Represents a previously stored change to a persistent field, within the context of a particular page of the
+ * application.
*/
public interface PersistentFieldChange
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PropertyOutputContext.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PropertyOutputContext.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PropertyOutputContext.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/PropertyOutputContext.java Sun Mar 2 09:21:16 2008
@@ -18,28 +18,27 @@
import org.apache.tapestry.ioc.Messages;
/**
- * Provides context information needed when displaying a value. This interface is an integral part
- * of the {@link Grid} and similar output components. It is made available to
- * components via an {@link org.apache.tapestry.annotations.Environmental} annotation.
+ * Provides context information needed when displaying a value. This interface is an integral part of the {@link Grid}
+ * and similar output components. It is made available to components via an {@link
+ * org.apache.tapestry.annotations.Environmental} annotation.
*/
public interface PropertyOutputContext
{
/**
- * Returns the value of the property (the object being displayed is encapsulated by the
- * context).
+ * Returns the value of the property (the object being displayed is encapsulated by the context).
*/
Object getPropertyValue();
/**
- * Returns the message catalog appropriate for use. In practice, this is the message catalog of
- * the container of the {@link Grid} component. This is used, for example, to locate labels for
- * fields, or to locate string representations of Enums.
+ * Returns the message catalog appropriate for use. In practice, this is the message catalog of the container of the
+ * {@link Grid} component. This is used, for example, to locate labels for fields, or to locate string
+ * representations of Enums.
*/
Messages getMessages();
/**
- * Returns a string that identifies the property, usually the property name. This is used as the
- * basis for the client-side client id.
+ * Returns a string that identifies the property, usually the property name. This is used as the basis for the
+ * client-side client id.
*/
String getPropertyId();
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestExceptionHandler.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestExceptionHandler.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestExceptionHandler.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestExceptionHandler.java Sun Mar 2 09:21:16 2008
@@ -1,30 +1,30 @@
-// 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.services;
import java.io.IOException;
/**
- * Service invoked when an uncaught exception occurs. The error handler is responsible for providing
- * a response to the user to describe the error.
+ * Service invoked when an uncaught exception occurs. The error handler is responsible for providing a response to the
+ * user to describe the error.
*/
public interface RequestExceptionHandler
{
/**
- * Reponsible for handling the error <em>in some way</em> and providing <em>some response</em>
- * to the client. A default implementation may render an error response page.
+ * Reponsible for handling the error <em>in some way</em> and providing <em>some response</em> to the client. A
+ * default implementation may render an error response page.
*
* @param exception uncaught exception to be reported
* @throws IOException
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestGlobals.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestGlobals.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestGlobals.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestGlobals.java Sun Mar 2 09:21:16 2008
@@ -1,25 +1,25 @@
-// 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.services;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
- * Service used to store the current request objects, both the Servlet API versions, and the
- * Tapestry generic versions. The service has a per-thread scope.
+ * Service used to store the current request objects, both the Servlet API versions, and the Tapestry generic versions.
+ * The service has a per-thread scope.
*/
public interface RequestGlobals
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestHandler.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestHandler.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestHandler.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/RequestHandler.java Sun Mar 2 09:21:16 2008
@@ -17,8 +17,8 @@
import java.io.IOException;
/**
- * Service interface for the RequestHandler pipeline service. An ordered configuration of filters may be
- * contributed to the service.
+ * Service interface for the RequestHandler pipeline service. An ordered configuration of filters may be contributed to
+ * the service.
*
* @see org.apache.tapestry.services.RequestFilter
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ResourceDigestGenerator.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ResourceDigestGenerator.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ResourceDigestGenerator.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ResourceDigestGenerator.java Sun Mar 2 09:21:16 2008
@@ -21,8 +21,8 @@
import java.net.URL;
/**
- * Responsible for determining which classpath resources require checksums, and for generating
- * checksums for such resources.
+ * Responsible for determining which classpath resources require checksums, and for generating checksums for such
+ * resources.
*
* @see ClasspathResource
* @see ClasspathAssetFactory
@@ -30,17 +30,16 @@
public interface ResourceDigestGenerator
{
/**
- * Examines the path (typically, the file name extension at the end of the path) to determine if
- * a checksum is required for the path. The path is {@link Resource} style, without a leading
- * slash.
+ * Examines the path (typically, the file name extension at the end of the path) to determine if a checksum is
+ * required for the path. The path is {@link Resource} style, without a leading slash.
*/
boolean requiresDigest(String path);
/**
- * Reads the content of a URL (presumably, for a resource on the classpath) and generates a
- * digest of its content. This digest will be incorporated into the URL provided to the
- * client, to verify that the client has been "granted" access to this resource. This is only
- * used for resources where {@link #requiresDigest(String)} is true.
+ * Reads the content of a URL (presumably, for a resource on the classpath) and generates a digest of its content.
+ * This digest will be incorporated into the URL provided to the client, to verify that the client has been
+ * "granted" access to this resource. This is only used for resources where {@link #requiresDigest(String)} is
+ * true.
*
* @param url
* @return the digest for the resource
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Response.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Response.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Response.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Response.java Sun Mar 2 09:21:16 2008
@@ -21,25 +21,23 @@
import java.io.PrintWriter;
/**
- * API agnostic wrapper for generating a response. Bridges the gaps between the Servlet API and the
- * Portlet API.
+ * API agnostic wrapper for generating a response. Bridges the gaps between the Servlet API and the Portlet API.
*/
public interface Response
{
/**
- * Returns a PrintWriter object to which output may be sent. Invoking flush() on the writer will
- * commit the output.
+ * Returns a PrintWriter object to which output may be sent. Invoking flush() on the writer will commit the output.
*
* @param contentType the MIME content type for the output, typically "text/html"
*/
PrintWriter getPrintWriter(String contentType) throws IOException;
/**
- * Returns an OutputStream to which byte-oriented output may be sent. Invoking flush() on the
- * stream will commit the output.
+ * Returns an OutputStream to which byte-oriented output may be sent. Invoking flush() on the stream will commit the
+ * output.
*
- * @param contentType the MIME content type for the output, often "application/octet-stream" or
- * "text/plain" or one of several others
+ * @param contentType the MIME content type for the output, often "application/octet-stream" or "text/plain" or one
+ * of several others
*/
OutputStream getOutputStream(String contentType) throws IOException;
@@ -59,16 +57,14 @@
void sendRedirect(Link link) throws IOException;
/**
- * Sends an error response to the client using the specified status. The server defaults to
- * creating the response to look like an HTML-formatted server error page containing the
- * specified message, setting the content type to "text/html", leaving cookies and other headers
- * unmodified. If an error-page declaration has been made for the web application corresponding
- * to the status code passed in, it will be served back in preference to the suggested msg
+ * Sends an error response to the client using the specified status. The server defaults to creating the response to
+ * look like an HTML-formatted server error page containing the specified message, setting the content type to
+ * "text/html", leaving cookies and other headers unmodified. If an error-page declaration has been made for the web
+ * application corresponding to the status code passed in, it will be served back in preference to the suggested msg
* parameter.
* <p/>
- * If the response has already been committed, this method throws an IllegalStateException.
- * After using this method, the response should be considered to be committed and should not be
- * written to.
+ * If the response has already been committed, this method throws an IllegalStateException. After using this method,
+ * the response should be considered to be committed and should not be written to.
*
* @param sc the error status code
* @param message the descriptive message
@@ -78,17 +74,15 @@
void sendError(int sc, String message) throws IOException;
/**
- * Sets the length of the content body in the response; this method sets the HTTP Content-Length
- * header.
+ * Sets the length of the content body in the response; this method sets the HTTP Content-Length header.
*
* @param length the length of the content
*/
void setContentLength(int length);
/**
- * Sets a response header with the given name and date-value. The date is specified in terms of
- * milliseconds since the epoch. If the header had already been set, the new value overwrites
- * the previous one.
+ * Sets a response header with the given name and date-value. The date is specified in terms of milliseconds since
+ * the epoch. If the header had already been set, the new value overwrites the previous one.
*
* @param name the name of the header to set
* @param date the assigned date value
@@ -96,8 +90,8 @@
void setDateHeader(String name, long date);
/**
- * Sets a response header with the given name and value. If the header had already been set,
- * the new value overwrites the previous one.
+ * Sets a response header with the given name and value. If the header had already been set, the new value
+ * overwrites the previous one.
*
* @param name the name of the header to set
* @param value the assigned value
@@ -105,8 +99,8 @@
void setHeader(String name, String value);
/**
- * Sets a response header with the given name and integer value. If the header had already been set,
- * the new value overwrites the previous one.
+ * Sets a response header with the given name and integer value. If the header had already been set, the new value
+ * overwrites the previous one.
*
* @param name the name of the header to set
* @param value the assigned integer value
@@ -114,8 +108,8 @@
void setIntHeader(String name, int value);
/**
- * Encodes the URL, ensuring that a session id is included (if a session exists, and as
- * necessary depending on the client browser's use of cookies).
+ * Encodes the URL, ensuring that a session id is included (if a session exists, and as necessary depending on the
+ * client browser's use of cookies).
*
* @param URL
* @return the same URL or a different one with additional information to track the user session
@@ -123,8 +117,8 @@
String encodeURL(String URL);
/**
- * Encodes the URL for use as a redirect, ensuring that a session id is included (if a session
- * exists, and as necessary depending on the client browser's use of cookies).
+ * Encodes the URL for use as a redirect, ensuring that a session id is included (if a session exists, and as
+ * necessary depending on the client browser's use of cookies).
*
* @param URL
* @return the same URL or a different one with additional information to track the user session
@@ -132,8 +126,7 @@
String encodeRedirectURL(String URL);
/**
- * Returns true if the response has already been sent, either as a redirect or as a stream
- * of content.
+ * Returns true if the response has already been sent, either as a redirect or as a stream of content.
*
* @return true if response already sent
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Session.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Session.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Session.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Session.java Sun Mar 2 09:21:16 2008
@@ -18,20 +18,19 @@
import java.util.List;
/**
- * Generic version of {@link HttpSession}, used to bridge the gaps between the Servlet API and the
- * Portlet API.
+ * Generic version of {@link HttpSession}, used to bridge the gaps between the Servlet API and the Portlet API.
*/
public interface Session
{
/**
- * Returns a list of the names of all attributes stored in the session. The names are returned
- * sorted alphabetically.
+ * Returns a list of the names of all attributes stored in the session. The names are returned sorted
+ * alphabetically.
*/
List<String> getAttributeNames();
/**
- * Returns a list of the names of all attributes stored in the session whose name has the
- * provided prefix. The names are returned in alphabetical order.
+ * Returns a list of the names of all attributes stored in the session whose name has the provided prefix. The names
+ * are returned in alphabetical order.
*/
List<String> getAttributeNames(String prefix);
@@ -46,16 +45,16 @@
void setAttribute(String name, Object value);
/**
- * Returns the maximum time interval, in seconds, that the servlet container will keep this
- * session open between client accesses. After this interval, the servlet container will
- * invalidate the session. The maximum time interval can be set with the setMaxInactiveInterval
- * method. A negative time indicates the session should never timeout.
+ * Returns the maximum time interval, in seconds, that the servlet container will keep this session open between
+ * client accesses. After this interval, the servlet container will invalidate the session. The maximum time
+ * interval can be set with the setMaxInactiveInterval method. A negative time indicates the session should never
+ * timeout.
*/
int getMaxInactiveInterval();
/**
- * Specifies the time, in seconds, between client requests before the servlet container will
- * invalidate this session. A negative time indicates the session should never timeout.
+ * Specifies the time, in seconds, between client requests before the servlet container will invalidate this
+ * session. A negative time indicates the session should never timeout.
*/
void setMaxInactiveInterval(int seconds);
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TapestryModule.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TapestryModule.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TapestryModule.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TapestryModule.java Sun Mar 2 09:21:16 2008
@@ -220,7 +220,8 @@
* finishes rendering</dd> <dt>Secure</dt> <dd>Checks for the {@link org.apache.tapestry.annotations.Secure}
* annotation</dd> <dt>ContentType</dt> <dd>Checks for {@link org.apache.tapestry.annotations.ContentType}
* annotation</dd> <dt>ResponseEncoding</dt> <dd>Checks for the {@link org.apache.tapestry.annotations.ResponseEncoding}
- * annotation</dd> </dl>
+ * annotation</dd> <dt>GenerateAccessors</dt> <dd>Generates accessor methods if {@link
+ * org.apache.tapestry.annotations.GenerateAccessors} annotation is present </dd> </dl>
*/
public static void contributeComponentClassTransformWorker(
OrderedConfiguration<ComponentClassTransformWorker> configuration,
@@ -242,7 +243,6 @@
// UnclaimedField is last.
configuration.add("Meta", new MetaWorker());
- configuration.add("ApplicationState", locator.autobuild(ApplicationStateWorker.class));
configuration.add("Inject", new InjectWorker(locator, injectionProvider));
@@ -250,7 +250,6 @@
configuration.add("MixinAfter", new MixinAfterWorker());
configuration.add("Component", new ComponentWorker(resolver));
- configuration.add("Environment", new EnvironmentalWorker(environment));
configuration.add("Mixin", new MixinWorker(resolver));
configuration.add("OnEvent", new OnEventWorker());
configuration.add("SupportsInformalParameters", new SupportsInformalParametersWorker());
@@ -297,6 +296,13 @@
configuration.add("ContentType", new ContentTypeWorker());
configuration.add("ResponseEncoding", new ResponseEncodingWorker());
+
+ configuration.add("GenerateAccessors", new GenerateAccessorsWorker());
+
+ // These must come after GenerateAccessors, since they actually delete fields that may still have the annotation
+ configuration.add("ApplicationState", locator.autobuild(ApplicationStateWorker.class),
+ "after:GenerateAccessors");
+ configuration.add("Environment", new EnvironmentalWorker(environment), "after:GenerateAccessors");
// This one is always last. Any additional private fields that aren't annotated will
// be converted to clear out at the end of the request.
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Traditional.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Traditional.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Traditional.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/Traditional.java Sun Mar 2 09:21:16 2008
@@ -23,7 +23,7 @@
*
* @see ComponentEventRequestHandler
*/
-@Target({ElementType.PARAMETER, ElementType.FIELD})
+@Target({ ElementType.PARAMETER, ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Traditional
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformConstants.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformConstants.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformConstants.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformConstants.java Sun Mar 2 09:21:16 2008
@@ -27,8 +27,8 @@
{
// Shared parameters of a whole bunch of lifecycle methods, representing the different
// component render states.
- private static final String[] RENDER_PHASE_METHOD_PARAMETERS = {MarkupWriter.class.getName(),
- Event.class.getName()};
+ private static final String[] RENDER_PHASE_METHOD_PARAMETERS = { MarkupWriter.class.getName(),
+ Event.class.getName() };
/**
* Signature for {@link org.apache.tapestry.runtime.Component#dispatchComponentEvent(org.apache.tapestry.runtime.ComponentEvent)}.
@@ -36,7 +36,8 @@
* @see org.apache.tapestry.annotations.OnEvent
*/
public static final TransformMethodSignature DISPATCH_COMPONENT_EVENT = new TransformMethodSignature(
- Modifier.PUBLIC, "boolean", "dispatchComponentEvent", new String[]{ComponentEvent.class.getName()}, null);
+ Modifier.PUBLIC, "boolean", "dispatchComponentEvent", new String[] { ComponentEvent.class.getName() },
+ null);
/**
* Signature for {@link org.apache.tapestry.runtime.PageLifecycleListener#containingPageDidLoad()}.
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformMethodSignature.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformMethodSignature.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformMethodSignature.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformMethodSignature.java Sun Mar 2 09:21:16 2008
@@ -19,11 +19,11 @@
import java.lang.reflect.Modifier;
/**
- * A representation of a method signature, which consists of its name, modifiers (primarily,
- * visibility), return type, parameter types, and declared exception types.
+ * A representation of a method signature, which consists of its name, modifiers (primarily, visibility), return type,
+ * parameter types, and declared exception types.
* <p/>
- * Types are stored as class names (or primitive names) because the signature is used with
- * {@link ClassTransformation} (which operates on as-yet unloaded classes).
+ * Types are stored as class names (or primitive names) because the signature is used with {@link ClassTransformation}
+ * (which operates on as-yet unloaded classes).
*/
public class TransformMethodSignature implements Comparable<TransformMethodSignature>
{
@@ -71,8 +71,8 @@
}
/**
- * Returns a non-null array of the names of each declared exception type thrown by the method.
- * Calling code should not modify the array.
+ * Returns a non-null array of the names of each declared exception type thrown by the method. Calling code should
+ * not modify the array.
*/
public String[] getExceptionTypes()
{
@@ -98,8 +98,7 @@
}
/**
- * Returns an array of the type name for each parameter. Calling code should not modify the
- * array.
+ * Returns an array of the type name for each parameter. Calling code should not modify the array.
*/
public String[] getParameterTypes()
{
@@ -163,9 +162,9 @@
}
/**
- * Returns the long form description of the signature. This includes modifiers, return type,
- * method name, parameters and thrown exceptions, formatter approximately as it would appear in
- * Java source (except that parameter names, which are not known, do no appear).
+ * Returns the long form description of the signature. This includes modifiers, return type, method name, parameters
+ * and thrown exceptions, formatter approximately as it would appear in Java source (except that parameter names,
+ * which are not known, do no appear).
*/
@Override
public String toString()
@@ -214,8 +213,8 @@
}
/**
- * Sorting is primarily via method name. For methods with the same name, the second level of
- * sorting is by parameter count (descending).
+ * Sorting is primarily via method name. For methods with the same name, the second level of sorting is by parameter
+ * count (descending).
*/
public int compareTo(TransformMethodSignature o)
{
@@ -228,9 +227,8 @@
}
/**
- * Returns a shortened form of the string representation of the method. It lists just the name
- * of the method and the types of any parameters, omitting return type, exceptions and
- * modifiers.
+ * Returns a shortened form of the string representation of the method. It lists just the name of the method and the
+ * types of any parameters, omitting return type, exceptions and modifiers.
*
* @return
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformUtils.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformUtils.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformUtils.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/TransformUtils.java Sun Mar 2 09:21:16 2008
@@ -1,17 +1,17 @@
-// 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.services;
import static org.apache.tapestry.ioc.internal.util.CollectionFactory.newMap;
@@ -91,8 +91,8 @@
}
/**
- * Returns the name of wrapper type for a given input type. For primitive types, returns the
- * wrapper type. For other types, returns the input type name.
+ * Returns the name of wrapper type for a given input type. For primitive types, returns the wrapper type. For other
+ * types, returns the input type name.
*
* @param type primitive type name, or fully qualified class name
*/
@@ -104,8 +104,7 @@
}
/**
- * For primitive types, returns the method on the <em>wrapper type</em> that converts back to
- * the primitive.
+ * For primitive types, returns the method on the <em>wrapper type</em> that converts back to the primitive.
*
* @param type the primitive type
* @return the method of the corresponding wrapper type, or null if type is not a primitive type
@@ -118,8 +117,8 @@
}
/**
- * Returns the wrapper type for a given input type. For primitive types, returns the wrapper
- * type. For other types, returns the type itself.
+ * Returns the wrapper type for a given input type. For primitive types, returns the wrapper type. For other types,
+ * returns the type itself.
*
* @param type primitive or object type
*/
@@ -131,8 +130,8 @@
}
/**
- * Returns the default value for a type. This is the string "null" for most types, or a literal
- * value for primtive types.
+ * Returns the default value for a type. This is the string "null" for most types, or a literal value for primtive
+ * types.
*/
public static String getDefaultValue(String type)
{
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValidationConstraintGenerator.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValidationConstraintGenerator.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValidationConstraintGenerator.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValidationConstraintGenerator.java Sun Mar 2 09:21:16 2008
@@ -20,24 +20,23 @@
import java.util.List;
/**
- * Invoked to generate a list of validation constraint strings for a property. This typically
- * involves scanning the property for annotations or naming conventions that confer the desired
- * validation. The constraint strings are ultimately handed to
- * {@link FieldValidatorSource#createValidator(org.apache.tapestry.Field, String, String, String, org.apache.tapestry.ioc.Messages, java.util.Locale)}.
+ * Invoked to generate a list of validation constraint strings for a property. This typically involves scanning the
+ * property for annotations or naming conventions that confer the desired validation. The constraint strings are
+ * ultimately handed to {@link FieldValidatorSource#createValidator(org.apache.tapestry.Field, String, String, String,
+ * org.apache.tapestry.ioc.Messages, java.util.Locale)}.
*/
public interface ValidationConstraintGenerator
{
/**
- * For a given property, identify all the approprite validation constraints. Each returned value
- * is the name of a validator (i.e., "required") or a validator name and configuration (i.e.,
- * "minlength=5"). These contraints are exactly the individual terms in a
- * {@link FieldValidatorSource#createValidators(org.apache.tapestry.Field, String) validate specification}.
- * These will ultimately be used to create {@link FieldValidator}s for the field that edits the
- * property.
+ * For a given property, identify all the approprite validation constraints. Each returned value is the name of a
+ * validator (i.e., "required") or a validator name and configuration (i.e., "minlength=5"). These contraints are
+ * exactly the individual terms in a {@link FieldValidatorSource#createValidators(org.apache.tapestry.Field, String)
+ * validate specification}. These will ultimately be used to create {@link FieldValidator}s for the field that edits
+ * the property.
*
* @param propertyType the type of the property for which constraints are needed
- * @param annotationProvider provides access to any annotations concerning the property (for implementations
- * that are based on analysis of property annotations)
+ * @param annotationProvider provides access to any annotations concerning the property (for implementations that
+ * are based on analysis of property annotations)
* @return a list of constraints
* @see FieldValidatorSource
*/
Modified: tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValueEncoderSource.java
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValueEncoderSource.java?rev=632791&r1=632790&r2=632791&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValueEncoderSource.java (original)
+++ tapestry/tapestry5/trunk/tapestry-core/src/main/java/org/apache/tapestry/services/ValueEncoderSource.java Sun Mar 2 09:21:16 2008
@@ -14,7 +14,6 @@
package org.apache.tapestry.services;
-import org.apache.tapestry.ComponentResources;
import org.apache.tapestry.ValueEncoder;
/**