Author: apetrelli
Date: Wed Mar 21 09:52:32 2007
New Revision: 520946
URL: http://svn.apache.org/viewvc?view=rev&rev=520946
Log:
TILES-86
Fifth run of JavaDocs added.
Modified:
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesApplicationContext.java
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesContainer.java
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/MutableTilesContainer.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/MapEntry.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesContextFactory.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesRequestContext.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ComponentDefinition.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerException.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerFactory.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparerSupport.java
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/util/ClassUtil.java
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockComponentDefinitions.java
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockOnlyLocaleTilesContext.java
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestReloadableDefinitionsFactory.java
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestUrlDefinitionsFactory.java
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/AddAttributeTagParent.java
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/PutAttributeTagParent.java
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/UseAttributeTag.java
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/DestroyContainerTag.java
tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/preparer/TestViewPreparer.java
Modified:
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesApplicationContext.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesApplicationContext.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesApplicationContext.java
(original)
+++
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesApplicationContext.java
Wed Mar 21 09:52:32 2007
@@ -57,7 +57,7 @@
*
* @param path to the desired resource.
* @return the first located resource which matches the given path.
- * @throws java.net.MalformedURLException if the path is malformed
+ * @throws IOException if the path is malformed
*/
URL getResource(String path) throws IOException;
@@ -66,7 +66,7 @@
*
* @param path to the desired resource.
* @return all resources which match the given path.
- * @throws java.net.MalformedURLException if the url is illegal
+ * @throws IOException if the url is illegal
*/
Set<URL> getResources(String path) throws IOException;
}
Modified:
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesContainer.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesContainer.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesContainer.java
(original)
+++
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/TilesContainer.java
Wed Mar 21 09:52:32 2007
@@ -98,10 +98,14 @@
/**
* Render the given ComponentAttribute.
- * @param attribute
- * @param writer TODO
+ *
+ * @param attribute The attribute to render.
+ * @param writer The writer to use when rendering an attribute of "string"
+ * type.
* @param requestItems the current request objects.
- * @throws TilesException
+ * @throws TilesException If something goes wrong during accessing Tiles
+ * elements.
+ * @throws IOException If something goes wrong during writing to the
output.
*/
void render(ComponentAttribute attribute, Writer writer, Object...
requestItems)
throws TilesException, IOException;
Modified:
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/MutableTilesContainer.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/MutableTilesContainer.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/MutableTilesContainer.java
(original)
+++
tiles/framework/trunk/tiles-api/src/main/java/org/apache/tiles/mgmt/MutableTilesContainer.java
Wed Mar 21 09:52:32 2007
@@ -37,6 +37,7 @@
*
* @param definition
* @param requestItems the current request objects.
+ * @throws TilesException If something goes wrong during registration.
*/
void register(TileDefinition definition, Object... requestItems)
throws TilesException;
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/beans/MenuItem.java
Wed Mar 21 09:52:32 2007
@@ -32,42 +32,58 @@
public interface MenuItem extends Serializable {
/**
- * Set value property.
+ * Sets the value (i.e. the visible part) of this menu item.
+ *
+ * @param value The value of this item.
*/
public void setValue(String value);
/**
- * Get value property.
+ * Returns the value (i.e. the visible part) of this menu item.
+ *
+ * @return The value of this item.
*/
public String getValue();
/**
- * Set link property.
+ * Sets the URL of this menu item.
+ *
+ * @param link The URL of this item.
*/
public void setLink(String link);
/**
- * Get link property.
+ * Returns the URL of this menu item.
+ *
+ * @return The URL of this item.
*/
public String getLink();
/**
- * Set icon property.
+ * Sets the icon URL of this menu item.
+ *
+ * @param link The icon URL.
*/
public void setIcon(String link);
/**
- * Get icon property.
+ * Returns the icon URL of this menu item.
+ *
+ * @return The icon URL.
*/
public String getIcon();
/**
- * Set tooltip property.
+ * Sets the tooltip text.
+ *
+ * @param link The tooltip text.
*/
public void setTooltip(String link);
/**
- * Get tooltip property.
+ * Returns the tooltip text.
+ *
+ * @return The tooltip text.
*/
public String getTooltip();
}
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/MapEntry.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/MapEntry.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/MapEntry.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/MapEntry.java
Wed Mar 21 09:52:32 2007
@@ -30,6 +30,8 @@
* or not.</p>
*
* @version $Rev$ $Date$
+ * @param <K> The key type.
+ * @param <V> The value type.
*/
public class MapEntry<K, V> implements Map.Entry<K, V> {
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesContextFactory.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesContextFactory.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesContextFactory.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesContextFactory.java
Wed Mar 21 09:52:32 2007
@@ -35,7 +35,9 @@
public interface TilesContextFactory {
/**
- * Initialize the impl
+ * Initialize the factory.
+ *
+ * @param configurationParameters A map of parameters.
*/
void init(Map<String, String> configurationParameters);
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesRequestContext.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesRequestContext.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesRequestContext.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/context/TilesRequestContext.java
Wed Mar 21 09:52:32 2007
@@ -25,6 +25,8 @@
import java.util.Locale;
import java.util.Map;
+import org.apache.tiles.locale.LocaleResolver;
+
/**
* Encapsulation of request information.
*
@@ -36,6 +38,8 @@
/**
* Return an immutable Map that maps header names to the first (or only)
* header value (as a String).
+ *
+ * @return The header map.
*/
Map<String, String> getHeader();
@@ -43,45 +47,65 @@
* Return an immutable Map that maps header names to the set of all values
* specified in the request (as a String array). Header names must be
* matched in a case-insensitive manner.
+ *
+ * @return The header values map.
*/
Map<String, String[]> getHeaderValues();
/**
* Return a mutable Map that maps request scope attribute names to their
* values.
+ *
+ * @return The request scope map.
*/
Map<String, Object> getRequestScope();
/**
* Return a mutable Map that maps session scope attribute names to their
* values.
+ *
+ * @return The request scope map.
*/
Map<String, Object> getSessionScope();
/**
* Dispatches the request to a specified path.
+ *
+ * @param path The path to dispatch to.
+ * @throws IOException If something goes wrong during dispatching.
*/
void dispatch(String path) throws IOException;
/**
* Includes the response from the specified URL in the current response
output.
+ *
+ * @param path The path to include.
+ * @throws IOException If something goes wrong during inclusion.
*/
void include(String path) throws IOException;
/**
* Return an immutable Map that maps request parameter names to the first
* (or only) value (as a String).
+ *
+ * @return The parameter map.
*/
Map<String, String> getParam();
/**
* Return an immutable Map that maps request parameter names to the set of
* all values (as a String array).
+ *
+ * @return The parameter values map.
*/
Map<String, String[]> getParamValues();
/**
* Return the preferred Locale in which the client will accept content.
+ *
+ * @return The current request locale. It is the locale of the request
+ * object itself and it is NOT the locale that the user wants to use. See
+ * [EMAIL PROTECTED] LocaleResolver} to implement strategies to resolve
locales.
*/
Locale getRequestLocale();
@@ -94,11 +118,15 @@
/**
* Get the underlying request.
+ *
+ * @return The current request object.
*/
Object getRequest();
/**
* Get the underlying response.
+ *
+ * @return The current request object.
*/
Object getResponse();
}
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ComponentDefinition.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ComponentDefinition.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ComponentDefinition.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/definition/ComponentDefinition.java
Wed Mar 21 09:52:32 2007
@@ -62,6 +62,8 @@
* Create a new definition initialized with parent definition.
* Do a shallow copy : attributes are shared between copies, but not the
Map
* containing attributes.
+ *
+ * @param definition The definition to copy.
*/
public ComponentDefinition(TileDefinition definition) {
attributes = new HashMap<String, ComponentAttribute>(
@@ -75,6 +77,9 @@
/**
* Constructor.
+ * @param name The name of the definition.
+ * @param template The template of the definition.
+ * @param attributes The attribute map of the definition.
*/
public ComponentDefinition(String name, String template,
Map<String, ComponentAttribute> attributes) {
@@ -135,6 +140,8 @@
/**
* Returns a description of the attributes.
+ *
+ * @return A string representation of the content of this definition.
*/
public String toString() {
return "{name="
@@ -152,6 +159,8 @@
/**
* Get extends flag.
+ *
+ * @return <code>true</code> if this definition extends another.
*/
public boolean isExtending() {
return inherit != null;
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerException.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerException.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerException.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerException.java
Wed Mar 21 09:52:32 2007
@@ -34,10 +34,21 @@
*/
public class PreparerException extends TilesException {
+ /**
+ * Constructor.
+ *
+ * @param message The message to include.
+ */
public PreparerException(String message) {
super(message);
}
+ /**
+ * Constructor.
+ *
+ * @param message The message to include.
+ * @param e The cause exception.
+ */
public PreparerException(String message, Exception e) {
super(message, e);
}
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerFactory.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerFactory.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerFactory.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/PreparerFactory.java
Wed Mar 21 09:52:32 2007
@@ -49,10 +49,10 @@
* @param name ViewPreparer name, commonly the qualified classname.
* @param context the context within which the preparerInstance will be
invoked.
* @return instance of the ViewPreparer
- * @throws NoSuchPreparerException when the named preparerInstance can not
be found.
+ * @throws TilesException If something goes wrong during preparer creation.
*/
ViewPreparer getPreparer(String name, TilesRequestContext context)
- throws PreparerException, TilesException;
+ throws TilesException;
}
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparer.java
Wed Mar 21 09:52:32 2007
@@ -52,6 +52,7 @@
*
* @param tilesContext Current tiles application context.
* @param componentContext Current tile context.
+ * @throws Exception If something goes wrong during execution.
*/
public void execute(TilesRequestContext tilesContext,
ComponentContext componentContext)
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparerSupport.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparerSupport.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparerSupport.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/preparer/ViewPreparerSupport.java
Wed Mar 21 09:52:32 2007
@@ -34,9 +34,7 @@
*/
public class ViewPreparerSupport implements ViewPreparer {
- /**
- * Stubs out preparerInstance method.
- */
+ /** [EMAIL PROTECTED] */
public void execute(TilesRequestContext tilesContext,
ComponentContext componentContext) throws Exception {
}
Modified:
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/util/ClassUtil.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/util/ClassUtil.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/util/ClassUtil.java
(original)
+++
tiles/framework/trunk/tiles-core/src/main/java/org/apache/tiles/util/ClassUtil.java
Wed Mar 21 09:52:32 2007
@@ -25,14 +25,35 @@
/**
+ * Utilities to work with dynamic class loading and instantiation.
+ *
* @version $Rev$ $Date$
*/
public class ClassUtil {
+ /**
+ * Returns an instance of the given class name, by calling the default
+ * constructor.
+ *
+ * @param className The class name to load and to instantiate.
+ * @return The new instance of the class name.
+ * @throws TilesException If something goes wrong during instantiation.
+ */
public static Object instantiate(String className) throws TilesException {
return instantiate(className, false);
}
+ /**
+ * Returns an instance of the given class name, by calling the default
+ * constructor.
+ *
+ * @param className The class name to load and to instantiate.
+ * @param returnNull If <code>true</code>, if the class is not found it
+ * returns <code>true</code>, otherwise it throws a
+ * <code>TilesException</code>.
+ * @return The new instance of the class name.
+ * @throws TilesException If something goes wrong during instantiation.
+ */
public static Object instantiate(String className, boolean returnNull)
throws TilesException {
ClassLoader original = Thread.currentThread().getContextClassLoader();
Modified:
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockComponentDefinitions.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockComponentDefinitions.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockComponentDefinitions.java
(original)
+++
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockComponentDefinitions.java
Wed Mar 21 09:52:32 2007
@@ -43,6 +43,8 @@
/**
* Hokey way to verify that this class was created.
+ *
+ * @return The number of created instances.
*/
public static int getInstanceCount() {
return instanceCount;
@@ -96,15 +98,11 @@
public void addDefinitions(Map<String, ComponentDefinition> defsMap) {
}
- /**
- * Resolves configuration inheritance properties.
- */
+ /** [EMAIL PROTECTED] */
public void resolveInheritances() throws NoSuchDefinitionException {
}
- /**
- * Resolves configuration inheritance properties.
- */
+ /** [EMAIL PROTECTED] */
public void resolveInheritances(Locale locale) throws
NoSuchDefinitionException {
}
@@ -114,9 +112,7 @@
public void reset() {
}
- /**
- * Returns base definitions collection;
- */
+ /** [EMAIL PROTECTED] */
public Map<String, ComponentDefinition> getBaseDefinitions() {
return null;
}
Modified:
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockOnlyLocaleTilesContext.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockOnlyLocaleTilesContext.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockOnlyLocaleTilesContext.java
(original)
+++
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/MockOnlyLocaleTilesContext.java
Wed Mar 21 09:52:32 2007
@@ -23,8 +23,6 @@
package org.apache.tiles.definition;
import java.io.IOException;
-import java.net.MalformedURLException;
-import java.net.URL;
import java.util.Locale;
import java.util.Map;
@@ -63,61 +61,55 @@
// nothing or returning null, because they are not needed at all in tests
// that use this class.
+ /** [EMAIL PROTECTED] */
public void dispatch(String path) throws IOException {
}
-
- public String getDefinitionName() {
- return null;
- }
-
- public Map<String, Object> getApplicationScope() {
- return null;
- }
-
+ /** [EMAIL PROTECTED] */
public Map<String, String> getHeader() {
return null;
}
+ /** [EMAIL PROTECTED] */
public Map<String, String[]> getHeaderValues() {
return null;
}
- public Map<String, String> getInitParams() {
- return null;
- }
-
+ /** [EMAIL PROTECTED] */
public Map<String, String> getParam() {
return null;
}
+ /** [EMAIL PROTECTED] */
public Map<String, String[]> getParamValues() {
return null;
}
+ /** [EMAIL PROTECTED] */
public Map<String, Object> getRequestScope() {
return null;
}
- public URL getResource(String path) throws MalformedURLException {
- return null;
- }
-
+ /** [EMAIL PROTECTED] */
public Map<String, Object> getSessionScope() {
return null;
}
+ /** [EMAIL PROTECTED] */
public void include(String path) throws IOException {
}
+ /** [EMAIL PROTECTED] */
public boolean isUserInRole(String role) {
return false;
}
+ /** [EMAIL PROTECTED] */
public Object getRequest() {
return null; //To change body of implemented methods use File |
Settings | File Templates.
}
+ /** [EMAIL PROTECTED] */
public Object getResponse() {
return null; //To change body of implemented methods use File |
Settings | File Templates.
}
Modified:
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestReloadableDefinitionsFactory.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestReloadableDefinitionsFactory.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestReloadableDefinitionsFactory.java
(original)
+++
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestReloadableDefinitionsFactory.java
Wed Mar 21 09:52:32 2007
@@ -45,6 +45,8 @@
/**
* Creates a new instance of TestReloadableDefinitionsFactory
+ *
+ * @param name The name of the test.
*/
public TestReloadableDefinitionsFactory(String name) {
super(name);
@@ -70,6 +72,8 @@
/**
* Tests reloading definitions impl.
+ *
+ * @throws Exception If something goes wrong.
*/
public void testReloadableDefinitionsFactory() throws Exception {
DefinitionsFactory factory = new UrlDefinitionsFactory();
Modified:
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestUrlDefinitionsFactory.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestUrlDefinitionsFactory.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestUrlDefinitionsFactory.java
(original)
+++
tiles/framework/trunk/tiles-core/src/test/java/org/apache/tiles/definition/TestUrlDefinitionsFactory.java
Wed Mar 21 09:52:32 2007
@@ -50,6 +50,8 @@
/**
* Creates a new instance of TestUrlDefinitionsFactory
+ *
+ * @param name The name of the test.
*/
public TestUrlDefinitionsFactory(String name) {
super(name);
@@ -75,6 +77,8 @@
/**
* Tests the readDefinitions method under normal conditions.
+ *
+ * @throws Exception If something goes wrong.
*/
@SuppressWarnings("unchecked")
public void testReadDefinitions() throws Exception {
@@ -106,6 +110,8 @@
/**
* Tests the getDefinition method.
+ *
+ * @throws Exception If something goes wrong.
*/
@SuppressWarnings("unchecked")
public void testGetDefinition() throws Exception {
@@ -169,6 +175,8 @@
/**
* Tests addSource with a bad source object type.
+ *
+ * @throws Exception If something goes wrong.
*/
@SuppressWarnings("unchecked")
public void testBadSourceType() throws Exception {
@@ -187,6 +195,8 @@
/**
* Tests the addDefinitions method under normal
* circumstances.
+ *
+ * @throws Exception If something goes wrong.
*/
@SuppressWarnings("unchecked")
public void testReadByLocale() throws Exception {
@@ -232,6 +242,8 @@
/**
* Tests the isContextProcessed method.
+ *
+ * @throws Exception If something goes wrong.
*/
@SuppressWarnings("unchecked")
public void testIsContextProcessed() throws Exception {
@@ -259,6 +271,8 @@
/**
* Tests the reader init param.
+ *
+ * @throws Exception If something goes wrong.
*/
public void testReaderParam() throws Exception {
Map<String, String> params = new HashMap<String, String>();
Modified:
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/AddAttributeTagParent.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/AddAttributeTagParent.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/AddAttributeTagParent.java
(original)
+++
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/AddAttributeTagParent.java
Wed Mar 21 09:52:32 2007
@@ -35,6 +35,7 @@
* Process the nested tag.
*
* @param nestedTag Nested tag to process.
+ * @throws JspException If something goes wrong during processing.
*/
void processNestedTag(AddAttributeTag nestedTag) throws JspException;
Modified:
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/PutAttributeTagParent.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/PutAttributeTagParent.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/PutAttributeTagParent.java
(original)
+++
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/PutAttributeTagParent.java
Wed Mar 21 09:52:32 2007
@@ -38,6 +38,7 @@
* Process the nested tag.
*
* @param nestedTag Nested tag to process.
+ * @throws JspException If something goes wrong during processing.
*/
void processNestedTag(PutAttributeTag nestedTag) throws JspException;
Modified:
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/UseAttributeTag.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/UseAttributeTag.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/UseAttributeTag.java
(original)
+++
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/UseAttributeTag.java
Wed Mar 21 09:52:32 2007
@@ -83,6 +83,11 @@
pageContext.setAttribute(getScriptingVariable(), attribute.getValue(),
scope);
}
+ /**
+ * Returns the scripting variable to use.
+ *
+ * @return The scripting variable.
+ */
public String getScriptingVariable() {
return id == null ? getName() : id;
}
@@ -94,9 +99,7 @@
*/
public static class Tei extends TagExtraInfo {
- /**
- * Return information about the scripting variables to be created.
- */
+ /** [EMAIL PROTECTED] */
public VariableInfo[] getVariableInfo(TagData data) {
String classname = data.getAttributeString("classname");
if (classname == null) {
Modified:
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/DestroyContainerTag.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/DestroyContainerTag.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/DestroyContainerTag.java
(original)
+++
tiles/framework/trunk/tiles-jsp/src/main/java/org/apache/tiles/jsp/taglib/definition/DestroyContainerTag.java
Wed Mar 21 09:52:32 2007
@@ -28,10 +28,14 @@
import javax.servlet.jsp.tagext.TagSupport;
/**
+ * Destroys the accessible container.
+ *
* @version $Rev$ $Date$
*/
public class DestroyContainerTag extends TagSupport {
+ /** [EMAIL PROTECTED] */
+ @Override
public int doEndTag() throws JspException {
try {
TilesAccess.setContainer(pageContext.getServletContext(), null);
Modified:
tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/preparer/TestViewPreparer.java
URL:
http://svn.apache.org/viewvc/tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/preparer/TestViewPreparer.java?view=diff&rev=520946&r1=520945&r2=520946
==============================================================================
---
tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/preparer/TestViewPreparer.java
(original)
+++
tiles/framework/trunk/tiles-test/src/main/java/org/apache/tiles/test/preparer/TestViewPreparer.java
Wed Mar 21 09:52:32 2007
@@ -27,10 +27,13 @@
import org.apache.tiles.ComponentAttribute;
/**
+ * A simple test <code>ViewPreparer</code>.
+ *
* @version $Rev$ $Date$
*/
public class TestViewPreparer implements ViewPreparer {
+ /** [EMAIL PROTECTED] */
public void execute(TilesRequestContext tilesContext, ComponentContext
componentContext)
throws Exception {
componentContext.putAttribute(
