Author: steveh
Date: Tue Aug 3 16:19:50 2004
New Revision: 35651
Modified:
incubator/beehive/trunk/netui/src/bootstrap/org/apache/beehive/netui/tools/NetUITldTagsHandler.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/DynamicSubappActionServlet.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/PageFlowConstants.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/ProcessPopulate.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/annotations/Jpf.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/internal/JavaControlUtils.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluationException.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluator.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionUpdateException.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/IllegalExpressionException.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/BundleContext.java
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/ScriptablePageInput.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallMethod.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallPageFlow.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/MethodParameter.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/Message.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/MessageArg.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/pageinput/DeclarePageInput.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/Repeater.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterFooter.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterHeader.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/pad/Pad.java
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/script/GetData.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/AbstractBaseTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DataSourceTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DefaultableDataSourceTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/HtmlUtils.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Anchor.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Attribute.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBox.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxGroup.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxOption.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Content.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ErrorBaseTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Exceptions.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/FormatNumber.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Html.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlBaseTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDataSourceTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDefaultableDataSourceTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlGroupBaseTag.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Image.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ScriptContainer.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/NameInterceptor.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/PrefixNameInterceptor.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/package.html
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/rendering/TagRenderingBase.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/Tree.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeElement.java
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeItem.java
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Attribute.java
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/DivPanel.java
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/IncludeSection.java
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Section.java
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/SetAttribute.java
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Template.java
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/config/ConfigUtil.java
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/BaseTypeConverter.java
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/TypeUtils.java
Log:
Latest javadoc content for netui API and tag references. Can now run javadoc
without any warning or errors.
Modified:
incubator/beehive/trunk/netui/src/bootstrap/org/apache/beehive/netui/tools/NetUITldTagsHandler.java
==============================================================================
---
incubator/beehive/trunk/netui/src/bootstrap/org/apache/beehive/netui/tools/NetUITldTagsHandler.java
(original)
+++
incubator/beehive/trunk/netui/src/bootstrap/org/apache/beehive/netui/tools/NetUITldTagsHandler.java
Tue Aug 3 16:19:50 2004
@@ -237,7 +237,6 @@
/**
* @param template Describe what the parameter does
* @param attributes Describe what the parameter does
- * @param forType Describe what the parameter does
* @exception XDocletException Describe the exception
* @doc:tag type="block"
* @doc:tag name="tagName" optional="false"
values="netui.tldx:attribute,netui-tld:attribute"
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/DynamicSubappActionServlet.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/DynamicSubappActionServlet.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/DynamicSubappActionServlet.java
Tue Aug 3 16:19:50 2004
@@ -23,7 +23,7 @@
* ActionServlet that dynamically registers modules based on naming/location
conventions for Struts
* configuration files that are generated by the Page Flow compiler. These
files are located in
* /WEB-INF/.pageflow-struts-generated, and are named
jpf-struts-config-<i>module-name</i>.xml.
- * The user may specify additional [EMAIL PROTECTED] ModuleConfigLocator}
classes in web.xml, using the
+ * The user may specify additional ModuleConfigLocator classes in web.xml,
using the
* "moduleConfigLocators" init-parameter; this allows the user to define other
patterns for
* auto-registered Struts modules.
*
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/PageFlowConstants.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/PageFlowConstants.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/PageFlowConstants.java
Tue Aug 3 16:19:50 2004
@@ -87,13 +87,13 @@
public static final int DEFAULT_NESTING_OVERFLOW_COUNT = 25;
/**
- * Servlet context-param that configures a [EMAIL PROTECTED]
HttpRedirector}-derived class to instantiate to handle
+ * Servlet context-param that configures a HttpRedirector-derived class to
instantiate to handle
* forwards and redirects.
*/
public static final String HTTP_REDIRECTOR_PARAM = "jpf-http-redirector";
/**
- * Servlet context-param that configures a [EMAIL PROTECTED]
LoginHandler}-derived class to instantiate to handle
+ * Servlet context-param that configures a [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.handler.LoginHandler}-derived class to
instantiate to handle
* user logins.
*/
public static final String LOGIN_HANDLER_PARAM = "jpf-login-handler";
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/ProcessPopulate.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/ProcessPopulate.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/ProcessPopulate.java
Tue Aug 3 16:19:50 2004
@@ -46,7 +46,7 @@
/**
* Implement the processPopulate stage of the Struts / PageFlow request
- * processing lifecycle. The [EMAIL PROTECTED] #populate(HttpServletRequest,
ActionForm)} method is
+ * processing lifecycle. The [EMAIL PROTECTED] #populate(HttpServletRequest,
HttpServletResponse, ActionForm, boolean)} method is
* invoked in order to take request parameters from the [EMAIL PROTECTED]
HttpServletRequest}
* use the key / value pairs from the request to perform an update to the
underlying
* JavaBean objects.
@@ -99,15 +99,15 @@
}
/**
- * Register a [EMAIL PROTECTED] RequestParameterHandler} that is added to
handle a
+ * Register a [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.RequestParameterHandler} that is added to
handle a
* particular prefix which be present as a prefix to a request parameter
* key. For keys that match the prefix, the key / value from the request
- * are put in an [EMAIL PROTECTED] #ExpressionUpdateNode} struct and
handed to the
- * [EMAIL PROTECTED] RequestParameterHandler} for processing. The
returned [EMAIL PROTECTED] #ExpressionUpdateNode}
+ * are put in an [EMAIL PROTECTED] ExpressionUpdateNode} struct and handed
to the
+ * [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.RequestParameterHandler} for processing. The
returned [EMAIL PROTECTED] ExpressionUpdateNode}
* is used to perform an expression update.
*
* @param prefix the String prefix that will be appended to request
paramters that
- * should pass through the [EMAIL PROTECTED] RequestParamterHandler}
before being updated.
+ * should pass through the [EMAIL PROTECTED] RequestParameterHandler}
before being updated.
* @param handler the handler that should handle all request paramters
with
* the given <code>prefix</code>
*/
@@ -147,13 +147,13 @@
/**
* Use the request parameters to populate all properties that have
expression keys into
* the underlying JavaBeans.
+ * Creates a <code>java.util.Map</code> of objects that will be consumed
by
+ * Struts processPopulate. This includes all request attributes
that
+ * were not expressions
*
* @param request the current <code>HttpServletRequest</code>
* @param form if this request references an action and it has an
<code>ActionForm</code>
* associated with it, then the <code>form</code> parameter is
non-null.
- * @return a <code>java.util.Map</code> of objects that will be consumed
by
- * Struts processPopulate. This includes all request attributes
that
- * were not expressions
* @throws ServletException when an error occurs in populating data after
* the request; failure here can be caused by failures in creating
* or executing update expressions.
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/annotations/Jpf.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/annotations/Jpf.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/annotations/Jpf.java
Tue Aug 3 16:19:50 2004
@@ -126,7 +126,7 @@
/**
* Tells whether the original query string will be restored on a rerun
of a previous action. Only valid when
* <code>navigateTo</code> is <code>NavigateTo.previousAction</code>.
- * @return
+ * @return boolean
*/
boolean restoreQueryString() default false;
@@ -264,7 +264,7 @@
/**
* Tells whether the original query string will be restored on a rerun
of a previous action. Only valid when
* <code>navigateTo</code> is <code>NavigateTo.previousAction</code>.
- * @return
+ * @return boolean
*/
boolean restoreQueryString() default false;
@@ -362,7 +362,7 @@
/**
* Tells whether the original query string will be restored on a rerun
of a previous action. Only valid when
* <code>navigateTo</code> is <code>NavigateTo.previousAction</code>.
- * @return
+ * @return boolean
*/
boolean restoreQueryString() default false;
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/internal/JavaControlUtils.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/internal/JavaControlUtils.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/pageflow/internal/JavaControlUtils.java
Tue Aug 3 16:19:50 2004
@@ -145,7 +145,7 @@
* get the bean class name.
* @param controlID
* @param properties
- * @return
+ * @return ControlBean
*/
public static ControlBean createControl( String controlClassName, boolean
isBeanClass, String controlID,
PropertyMap properties,
ControlBeanContext beanContext )
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluationException.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluationException.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluationException.java
Tue Aug 3 16:19:50 2004
@@ -73,7 +73,7 @@
/**
* Construct a ExpressionEvaluationException with the given
<code>message</code> and <code>cause</code>.
*
- * @param message a String containing the text of the exception message
+ * @param expression a String containing the text of the exception message
* @param cause a <code>Throwable</code> that is wrapped by this exception
*/
public ExpressionEvaluationException(String expression, Throwable cause)
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluator.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluator.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionEvaluator.java
Tue Aug 3 16:19:50 2004
@@ -52,7 +52,7 @@
*
* @param expression the expression whose value to update
* @param value the new value for the update
- * @param availableContexts the set of contexts that may be used in
expression evaluation. This set
+ * @param implicitObjects the set of contexts that may be used in
expression evaluation. This set
* is not necessarily complete as some objects that can be used as
top-level expression contexts
* may be contained within an object available in this JavaBean.
* @param requestParameter a boolean that marks this update as occurring
from data in the request, if
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionUpdateException.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionUpdateException.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/ExpressionUpdateException.java
Tue Aug 3 16:19:50 2004
@@ -58,7 +58,6 @@
*
* @param message a String containing the text of the exception message
* @param expression the expression whose update failed
- * @param updateValue the value that should have been set to the value
referenced by the expression
*
*/
public ExpressionUpdateException(String message, String expression)
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/IllegalExpressionException.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/IllegalExpressionException.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/IllegalExpressionException.java
Tue Aug 3 16:19:50 2004
@@ -90,7 +90,7 @@
* @param expression the expression that was malformed and caused this
exception to be thrown
* @param cause a <code>Throwable</code> that caused this exception to be
thrown
*/
- public IllegalExpressionException(String message, String expressoin,
Throwable cause)
+ public IllegalExpressionException(String message, String expression,
Throwable cause)
{
this(message, cause);
this.expression = expression;
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/BundleContext.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/BundleContext.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/BundleContext.java
Tue Aug 3 16:19:50 2004
@@ -37,7 +37,7 @@
* An object that acts as a storage location for ResourceBundles that are
* declared inside of a JSP. This object is cached in the PageContext
* and is re-created on every page that declares a bundle with the
- * [EMAIL PROTECTED] DeclareBundle} tag.
+ * [EMAIL PROTECTED]
org.apache.beehive.netui.tags.databinding.bundle.DeclareBundle} tag.
*
* @exclude
*/
Modified:
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/ScriptablePageInput.java
==============================================================================
---
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/ScriptablePageInput.java
(original)
+++
incubator/beehive/trunk/netui/src/pageflow/org/apache/beehive/netui/script/common/ScriptablePageInput.java
Tue Aug 3 16:19:50 2004
@@ -71,7 +71,7 @@
* assumes that the page input set does not change, which is acceptable for
* JSP clients as the page inputs have been specified when the JSP starts
* to render.
- * @return
+ * @return Set
*/
public Set entrySet()
{
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/bundle/DeclareBundle.java
Tue Aug 3 16:19:50 2004
@@ -99,7 +99,7 @@
* </p>
*
* @jsptagref.tagdescription
- * <p>This tag declares a [EMAIL PROTECTED] java.util.ResourceBundle
java.util.ResourceBundle}
+ * <p>Declares a [EMAIL PROTECTED] java.util.ResourceBundle
java.util.ResourceBundle}
* as a source for displaying internationalized messages.
* The declared resource bundle is accessible
* using the <code>{bundle...}</code> data binding context.
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/cellrepeater/CellRepeater.java
Tue Aug 3 16:19:50 2004
@@ -141,7 +141,7 @@
*
* @jsptagref.tagdescription
* <p>
- * The <netui-data:cellRepeater> tag renders
+ * Renders
* individual cells of an HTML table. The tag
* is data bound to a data set specified in the <code>dataSource</code>
* attribute. Other <netui...> tags in the body of
<netui-data:cellRepeater>
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java
Tue Aug 3 16:19:50 2004
@@ -49,7 +49,7 @@
* [EMAIL PROTECTED] MethodParameter}; these tags must be in the same
* order as the parameter list in the method signature of the
* method that will be invoked. To invoke an overloaded method, the
- * [EMAIL PROTECTED] MethodParamter#setType()} property must be set to the
String
+ * [EMAIL PROTECTED] MethodParameter#setType(String)} property must be set to
the String
* name of the type to pass to the method. If the type attribute values
* on nested [EMAIL PROTECTED] MethodParameter} tags do not match any method
signature,
* an error will be reported in the page.
@@ -164,7 +164,7 @@
/**
* Reflectively invokes the method specified by the <code>method</code>
attribute,
- * [EMAIL PROTECTED] #getMethod()}. The arguments passed to the method
are taken from any nested
+ * [EMAIL PROTECTED] #findMethod(Object, String, boolean)}. The arguments
passed to the method are taken from any nested
* [EMAIL PROTECTED] MethodParameter} tags. When the parameters which are
added by the
* [EMAIL PROTECTED] MethodParameter} tags are [EMAIL PROTECTED]
java.lang.String} types, an attempt is made
* to convert each of these parameters into the type expected by the
method. This
@@ -178,7 +178,7 @@
* @throws JspException if there are errors. All exceptions that may be
thrown
* in the process of reflectively invoking the method and performing type
* conversion are reported as @see javax.servlet.jsp.JspException.
- * @see #getMethod()
+ * @see #findMethod(Object, String, boolean)
* @see #handleReturnValue(java.lang.Object)
* @see MethodParameter
* @see ObjectNotFoundException
@@ -366,7 +366,7 @@
* The result is set as an attribute if the <code>result</code> is not
null and the
* [EMAIL PROTECTED] CallMethod#setResultId(java.lang.String)} String is
not null. If the value returned
* from calling a method is null and the [EMAIL PROTECTED]
CallMethod#setResultId(java.lang.String)} is non-null,
- * the [EMAIL PROTECTED]
javax.servlet.jsp.PageContext.removeAttribute(java.lang.String)}
+ * the [EMAIL PROTECTED]
javax.servlet.jsp.PageContext#removeAttribute(java.lang.String)}
* is called to remove the attribute from the attribute map.
* </p>
*
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallMethod.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallMethod.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallMethod.java
Tue Aug 3 16:19:50 2004
@@ -39,7 +39,7 @@
* [EMAIL PROTECTED] MethodParameter}; these tags must be in the same
* order as the parameter list in the method signature of the
* method that will be invoked. To invoke an overloaded method, the
- * [EMAIL PROTECTED] MethodParamter#setType()} property must be set to the
String
+ * [EMAIL PROTECTED] MethodParameter#setType(String)} property must be set to
the String
* name of the type to pass to the method. If the type attribute values
* on nested [EMAIL PROTECTED] MethodParameter} tags do not match any method
signature,
* an error will be reported in the page.
@@ -67,7 +67,7 @@
* </p>
*
* @jsptagref.tagdescription
- * This tag is used to call methods on any Java classes within the current
Workshop Project.
+ * Calls methods on any Java classes.
* <p>The <code>controlId</code> attribute is used to specify the cclass to be
called.
* The value returned is stored in the
* <code>{pageContext...}</code> data binding context object under the
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallPageFlow.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallPageFlow.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/CallPageFlow.java
Tue Aug 3 16:19:50 2004
@@ -61,7 +61,7 @@
* </table>
*
* @jsptagref.tagdescription
- * This tag calls a method on the Controller file (= JPF file) in the same
directory
+ * Calls methods on the Controller file (= JPF file) in the same directory
* as the JSP page. If no Controller file
* is found, an [EMAIL PROTECTED] ObjectNotFoundException} is
* thrown and the tag execution fails.
@@ -99,7 +99,7 @@
* @example
* In the following sample, the <netui-data:callPageFlow> tag calls the
* sumCartItems method on the Controller file. The
- * [EMAIL PROTECTED] com.bea.wlw.netui.tags.html.Label} tag
+ * [EMAIL PROTECTED] org.apache.beehive.netui.tags.html.Label} tag
* accesses the result through the {pageContext...} data binding context.
* <pre> <netui-data:callPageFlow method="sumCartItems"
resultId="cartSum">
* <netui-data:methodParameter
value="{pageFlow.cart.lineItemList}"/>
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/MethodParameter.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/MethodParameter.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/MethodParameter.java
Tue Aug 3 16:19:50 2004
@@ -83,15 +83,14 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * This tag provides an argument to a method-calling tag.
+ * Provides an argument to a method-calling tag.
* The <netui-data:methodParameter> tag can be nested within the following
* method-calling tags:
* <blockquote>
* <ul>
- * <li>[EMAIL PROTECTED]
com.bea.wlw.netui.tags.databinding.invoke.CallControl}</li>
- * <li>[EMAIL PROTECTED]
com.bea.wlw.netui.tags.databinding.invoke.CallMethod}</li>
- * <li>[EMAIL PROTECTED]
com.bea.wlw.netui.tags.databinding.invoke.CallPageFlow}</li>
- * <li>[EMAIL PROTECTED]
com.bea.wlw.netui.tags.databinding.repeater.choice.ChoiceMethod}</li>
+ * <li>[EMAIL PROTECTED]
org.apache.beehive.netui.tags.databinding.invoke.CallControl}</li>
+ * <li>[EMAIL PROTECTED]
org.apache.beehive.netui.tags.databinding.invoke.CallMethod}</li>
+ * <li>[EMAIL PROTECTED]
org.apache.beehive.netui.tags.databinding.invoke.CallPageFlow}</li>
* </ul>
* </blockquote>
*
@@ -138,38 +137,6 @@
*
* This will correspond to the method call:</p>
* <pre> foo(42, null);</pre>
- *
- * <p>This next example shows a <netui-data:methodParameter> tag being
used to specify
- * a dynamic parameter as an argument to the "isItemOnSale" method.
- * The parameter passed is dependent on the current data item in the data set.
- * The <netui-data:methodParameter> tag, in this example, is embedded
- * within a [EMAIL PROTECTED]
com.bea.wlw.netui.tags.databinding.repeater.choice.ChoiceMethod}
- * tag.
- * </p>
- *
- * <pre> ...
- * <netui-data:repeaterItem>
- * <netui-data:choiceMethod object="{pageFlow.someDataSet}"
method="isItemOnSale">
- * <netui-data:methodParameter
value="{container.item.quantityavailable}"/>
- * </netui-data:choiceMethod>
- * <netui-data:choice value="true">
- * <tr class="row" bgcolor="#FF9999">
- * <td><netui:label
value="{container.item.itemnumber}"/></td>
- * <td><netui:label
value="{container.item.itemname}"/></td>
- * <td><netui:label
value="{container.item.quantityavailable}"/></td>
- * <td><netui:label
value="{container.item.price}"/> Clearance Item</td>
- * </tr>
- * </netui-data:choice>
- * <netui-data:choice value="false">
- * <tr class="row">
- * <td><netui:label
value="{container.item.itemnumber}"/></td>
- * <td><netui:label
value="{container.item.itemname}"/></td>
- * <td><netui:label
value="{container.item.quantityavailable}"/></td>
- * <td><netui:label
value="{container.item.price}"/></td>
- * </tr>
- * </netui-data:choice>
- * </netui-data:repeaterItem>
- * ...</pre>
*
* @netui:tag name="methodParameter" description="Use this tag to add an
argument to a method that will be called on some object."
* @netui.tldx:tag requiredparent="choiceMethod callPageFlow callControl
callMethod" requiredchild="#nothing"
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/Message.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/Message.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/Message.java
Tue Aug 3 16:19:50 2004
@@ -25,16 +25,7 @@
import java.util.List;
/**
- * <p>
- * <table border="1" cellspacing="0" cellpadding="5" width="75%">
- * <tr><th colspan="4">Attribute Descriptions</th></tr>
- * <tr><th>Attribute</th><th>Required</th><th>Runtime Expression
Evaluation</th><th>Data Bindable</th></tr>
- * <tr><th rowspan="2">resultId</th><td>Yes</td><td>No</td><td>No</td></tr>
- * <tr><td colspan="3">The Id of the resulting String.</td></tr>
- * <tr><th rowspan="2">value</th><td>Yes</td><td>No</td><td>Yes</td></tr>
- * <tr><td colspan="3">A <code>pageContext</code> or <code>request</code> data
binding expression.</td></tr>
- * </table>
- * </p>
+ * Tag handler class for the <netui-data:message> tag. Provides a message
schema, which can be parameterized with message content.
*
* @jsptagref.tagdescription
* This tag provides a message schema, which can be parameterized to
@@ -48,8 +39,8 @@
* <netui-data:message value="{pageContext.msgSkeleton}"
resultId="message"></pre>
*
* @example
- * The <netui-data:message> tag defines a message schema, while the
- * [EMAIL PROTECTED] com.bea.wlw.netui.tags.databinding.message.MessageArg}
tags
+ * Defines a message schema, while the
+ * [EMAIL PROTECTED]
org.apache.beehive.netui.tags.databinding.message.MessageArg} tags
* provide the parameters that plug values into the schema.
* In the following example, the <netui-data:message> tag
* uses the <code>value</code> attribute to bind to the message schema (which
@@ -68,7 +59,7 @@
* ...
* <netui:label value="{pageContext.message}"/></pre>
*
- * <p>The following message is output to the JSP page:
+ * <p>The following message is output to the JSP page:<p>
*
* <pre> To read about messaging, go to my web page.</pre>
*
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/MessageArg.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/MessageArg.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/message/MessageArg.java
Tue Aug 3 16:19:50 2004
@@ -27,16 +27,10 @@
// external imports
/**
- * <p>
- * <table border="1" cellspacing="0" cellpadding="5" width="75%">
- * <tr><th colspan="4">Attribute Descriptions</th></tr>
- * <tr><th>Attribute</th><th>Required</th><th>Runtime Expression
Evaluation</th><th>Data Bindable</th></tr>
- * <tr><th rowspan="2">value</th><td>Yes</td><td>No</td><td>No</td></tr>
- * <tr><td colspan="3">A String value for the argument.</td></tr>
- * </table>
- * </p>
+ * Tag handler class for the <netui-data:messageArg> tag. Provides message
for the [EMAIL PROTECTED] Message} tag.
+ *
* @jsptagref.tagdescription
- * This tag provides a parameter value to a message schema.
+ * Provides a parameter value to a message schema.
*
* <p>The message schema is defined by a [EMAIL PROTECTED] Message} tag.
*
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/pageinput/DeclarePageInput.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/pageinput/DeclarePageInput.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/pageinput/DeclarePageInput.java
Tue Aug 3 16:19:50 2004
@@ -57,7 +57,7 @@
*
* @jsptagref.tagdescription
* <p>
- * This tag declares variables that are passed from
+ * Declares variables that are passed from
* the Controller file to the JSP page.
*
* <p>
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/Repeater.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/Repeater.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/Repeater.java
Tue Aug 3 16:19:50 2004
@@ -92,7 +92,7 @@
* </p>
*
* @jsptagref.tagdescription
- * <p>The <netui-data:repeater> tag iterates over a data set to render it
as HTML.
+ * <p>Iterates over a data set to render it as HTML.
* The HTML is specified either directly within the the body of
* <netui-data:repeater> tag or within an associated set of "helper" tags.
* The "helper" tags are listed below.
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterFooter.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterFooter.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterFooter.java
Tue Aug 3 16:19:50 2004
@@ -37,7 +37,7 @@
* tag's [EMAIL PROTECTED] Repeater#FOOTER} rendering state.</p>
*
* @jsptagref.tagdescription
- * This tag is used to render the footer of a [EMAIL PROTECTED] Repeater} tag.
This
+ * Renders the footer of a [EMAIL PROTECTED] Repeater} tag. This
* header may contain any HTML markup that can be rendered to a page. In
* the case of closing a table, ordered list, or unordered list, the elements
* </table>, </ol>, and </ul> could respectively be rendered
inside
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterHeader.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterHeader.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/RepeaterHeader.java
Tue Aug 3 16:19:50 2004
@@ -36,7 +36,7 @@
* tag's [EMAIL PROTECTED] Repeater#HEADER} rendering state.</p>
*
* @jsptagref.tagdescription
- * This tag is used to render the header of a [EMAIL PROTECTED] Repeater} tag.
+ * Renders the header of a [EMAIL PROTECTED] Repeater} tag.
* This header may contain
* any any HTML markup that can be rendered to a page. In the case of
starting a
* table, ordered list, or unordered list, the HTML elements <table>,
<ol>,
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/pad/Pad.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/pad/Pad.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/repeater/pad/Pad.java
Tue Aug 3 16:19:50 2004
@@ -60,7 +60,7 @@
*
* @jsptagref.tagdescription
* <p>
- * This tag determines the number of items that are rendered by a
+ * Sets the number of items rendered by a
* [EMAIL PROTECTED] com.bea.wlw.netui.tags.databinding.repeater.Repeater} tag.
* The <netui-data:pad> tag has the ability to turn an irregular data set
in the
* <netui-data:repeater> tag
@@ -165,7 +165,7 @@
* If the size of the data set is smaller than this, the data set will
* be padded with value of the pad text attribute.
*
- * @param minRepeatString an integer or an expression that references
+ * @param minRepeat an integer or an expression that references
* an integer for the minimum number of items to render
*
* @jsptagref.attributedescription
Modified:
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/script/GetData.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/script/GetData.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/script/GetData.java
Tue Aug 3 16:19:50 2004
@@ -51,7 +51,7 @@
* </p>
*
* @jsptagref.tagdescription
- * This tag evaluates an expression and places the result in the
+ * Evaluates an expression and places the result in the
* [EMAIL PROTECTED] javax.servlet.jsp.PageContext
javax.servlet.jsp.PageContext} object,
* where the data is available to JSP scriptlets. This tag can be used to
extract data from
* forms, Controller files, and any data binding context and make it available
to scriptlets.
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/AbstractBaseTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/AbstractBaseTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/AbstractBaseTag.java
Tue Aug 3 16:19:50 2004
@@ -247,7 +247,7 @@
* @param dataSource
* @param attrName
* @param errorId
- * @return
+ * @return String
* @throws JspException
*/
protected String ensureValidExpression(String dataSource, String attrName,
String errorId)
@@ -363,7 +363,7 @@
/**
* @param expression
* @param attrName
- * @return
+ * @return Object
* @throws JspException
*/
protected Object evaluateExpression(String expression, String attrName)
@@ -895,7 +895,7 @@
* to the caller so they can output the script block.
* @param tagId
* @param value
- * @return
+ * @return String
*/
protected String addTagIdMapping(String tagId, String value)
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DataSourceTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DataSourceTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DataSourceTag.java
Tue Aug 3 16:19:50 2004
@@ -85,6 +85,39 @@
/**
* Sets the tag's data source (can be an expression).
* @param dataSource - the data source
+ *
+ * @jsptagref.attributedescription
+ * <p>The <code>dataSource</code> attribute determines both
+ * (1) the source of populating data for the tag and
+ * (2) the object to which the tag submits data.
+ *
+ * <p>For example, assume that the Controller file (= JPF file) contains
+ * a Form Bean with the property foo. Then the following
<netui:textBox> tag will
+ * (1) draw populating data from the Form Bean's foo property and (2)
+ * submit user defined data to the same property.
+ *
+ * <p> <code><netui:textBox
dataSource="{actionForm.foo}" /></code>
+ *
+ * <p>The <code>dataSource</code> attribute takes either a data binding
expression or
+ * the name of a Form Bean property. In the
+ * above example, <code><netui:textBox dataSource="foo" /></code>
+ * would have the exactly same behavior.
+ *
+ * <p>When the tag is used to submit data, the data binding expression must
+ * refer to a Form Bean property.
+ * In cases where the tag is not used to submit data, but is used for
+ * displaying data only, the data
+ * binding expression need not refer to a Form Bean property. For
example,
+ * assume that myIterativeData is a member variable on
+ * the Controller file ( = JPF file). The following
<netui-data:repeater>
+ * tag draws its data from myIterativeData.
+ *
+ * <p> <code><netui-data:repeater
dataSource="{pageFlow.myIterativeData}"></code>
+ *
+ * @jsptagref.databindable Read / Write
+ *
+ * @jsptagref.attributesyntaxvalue <i>expression_datasource</i>
+ *
* @netui:attribute required="true"
* @netui.tldx:attribute language="netuiexpression"
*/
@@ -104,7 +137,7 @@
/**
* Return the Object that is represented by the specified data source.
- * @return
+ * @return Object
* @throws JspException
*/
protected Object evaluateDataSource()
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DefaultableDataSourceTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DefaultableDataSourceTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/DefaultableDataSourceTag.java
Tue Aug 3 16:19:50 2004
@@ -45,6 +45,30 @@
/**
* Sets the default value (can be an expression).
* @param defaultValue - the default value
+ *
+ * @jsptagref.attributedescription
+ * <p><b>Use in <netui:checkBoxGroup>, <netui:checkBox>,
+ * <netui:radioButtonGroup>, and <netui:select> tags</b></p>
+ * <p>Sets the preselected value or values.
+ * <p>The <code>defaultValue</code> attribute takes either a String
literal or
+ * a data binding expression.
+ * <p>If the <code>defaultValue</code> attribute has a String value (or if
+ * the data binding expression points to a String), then a single value
+ * will be preselected.
+ * <p>If the <code>defaultValue</code> attribute points to a String[]
object
+ * (or any object which can be iterated over), then
+ * multiple values will be preselected.
+ *
+ *
+ * <p><b>Use in <netui:textArea> and <netui:textBox> tags</b></p>
+ * <p>Sets the initial display text.</p>
+ * <p>The <code>defaultValue</code> attribute takes either a String
literal or
+ * a data binding expression that points to a String.
+ *
+ * @jsptagref.databindable Read / Write
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_or_expression_default</i>
+ *
* @netui:attribute required="false"
*/
public void setDefaultValue(String defaultValue)
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/HtmlUtils.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/HtmlUtils.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/HtmlUtils.java
Tue Aug 3 16:19:50 2004
@@ -124,7 +124,7 @@
* @param url
* @param params
* @param encoding
- * @return
+ * @return String
* @throws JspException
*/
public static String addParams(String url, Map params, String encoding)
@@ -206,7 +206,7 @@
/**
* This method will determine if the value passed in contains an entity.
- * @return
+ * @return boolean
*/
public static boolean containsEntity(String value)
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Anchor.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Anchor.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Anchor.java
Tue Aug 3 16:19:50 2004
@@ -87,7 +87,7 @@
* </p>
* @jsptagref.tagdescription
* <p>
- * The <netui:anchor> tag generates a link to another document or invokes
an action method in the Controller file.
+ * Generates an anchor that can link to another document or invoke an action
method in the Controller file.
* The <netui:anchor> tag also supports JavaScript-based form submission
and URL re-writing.
* <p>
* An anchor must have one of five attributes to correctly create the
hyperlink:
@@ -236,6 +236,7 @@
* @jsptagref.attributesyntaxvalue <i>string_action</i>
*
* @netui:attribute required="false" rtexprvalue="true"
+ *
* @netui.tldx:attribute reftype="netui-action-url" category="general"
*/
public void setAction(String action)
@@ -246,7 +247,15 @@
/**
* Set the name of the action for the Anchor.
- * @param scope - the name of the action to set for the Anchor.
+ * @param scope - the name of the action to set for the Anchor
+ *
+ * @jsptagref.attributedescription
+ * The scope
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_scope</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="general"
*/
@@ -336,6 +345,14 @@
* Set a client action to run on the client. When set on an anchor, a
NetUI JavaScript action
* will be run. This attribute may not be set if <code>href</code> or
<code>action</code> is set.
* @param action an action to run on the client.
+ *
+ * @jsptagref.attributedescription
+ * The client action.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_client_action</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
*/
public void setClientAction(String action)
@@ -384,6 +401,14 @@
/**
* Sets <code>charset</code> attribute for the anchor.
* @param charSet - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The character set.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_charset</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -395,6 +420,14 @@
/**
* Sets <code>type</code> attribute for the anchor.
* @param type - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The type.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_type</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -406,6 +439,14 @@
/**
* Sets <code>hreflang</code> attribute for the anchor.
* @param hreflang - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The HREF lang.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_hreflang</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -417,6 +458,14 @@
/**
* Sets <code>rel</code> attribute for the anchor.
* @param rel - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The rel.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_rel</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -428,6 +477,14 @@
/**
* Sets <code>rev</code> attribute for the anchor.
* @param rev - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The rev.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_rev</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -439,6 +496,14 @@
/**
* Sets <code>shape</code> attribute for the anchor.
* @param shape - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The shape.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_shape</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -450,6 +515,14 @@
/**
* Sets <code>coords</code> attribute for the anchor.
* @param coords - the window target.
+ *
+ * @jsptagref.attributedescription
+ * The coordinates.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_coordinates</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Attribute.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Attribute.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Attribute.java
Tue Aug 3 16:19:50 2004
@@ -27,7 +27,7 @@
/**
* @jsptagref.tagdescription
- * <p>Adds an attribute to the parent tag when it is rendered in the
browser.</p>
+ * <p>Adds an attribute to the parent tag rendered in the browser.</p>
*
* <p>The following <netui:attribute> tags are rendered within the
<span> tag (since
* the <netui:label> tag is rendered as a <span> tag in the browser.
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java
Tue Aug 3 16:19:50 2004
@@ -48,6 +48,13 @@
* </table>
*
* </p>
+ *
+ * @jsptagref.tagdescription
+ * Renders the set of error messages found during the process of resolving
+ * data binding expressions ({pageFlow.firstname}, {request.firstname}, etc.).
+ * The tag is intended
+ * for development use, not for error reporting in deployed applications.
+ *
* @example In this first sample, because the <netui:bindingUpdateErrors/>
tag is unqualified,
* messages will be displayed if <b>any</b> data binding errors occurred when
a form was
* posted. The messages are displayed on the page and the command window.
@@ -77,6 +84,16 @@
* is set, only binding errors for that expression will be displayed.
* Otherwise, all errors will be displayed.
* @param expression The expression to match against.
+ *
+ * @jsptagref.attributedescription
+ * String. The data binding expression to match for binding errors. If an
data binding expression
+ * is specified, only binding errors for that expression will be displayed.
+ * Otherwise, all errors will be displayed.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_databinding_expression</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
*/
public void setExpression(String expression)
@@ -89,6 +106,15 @@
* errors in production mode.
* @param alwaysReport a boolean that if <code>true</code> will cause
* the errors to always be displayed. The default is
<code>false</code>
+ *
+ * @jsptagref.attributedescription
+ * Boolean. If <code>isAlwaysReport</code> is set to true, then the errors
will be displayed in Production mode
+ * as well as in Development mode. Otherwise, the errors will be
displayed only in Development mode.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>boolean_always_report</i>
+ *
* @netui:attribute required="false" rtexprvalue="true" type="boolean"
*/
public void setAlwaysReport(boolean alwaysReport)
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBox.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBox.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBox.java
Tue Aug 3 16:19:50 2004
@@ -243,7 +243,7 @@
}
/**
- * @return
+ * @return A boolean value.
*/
public boolean evaluateDefaultValue()
throws JspException
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxGroup.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxGroup.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxGroup.java
Tue Aug 3 16:19:50 2004
@@ -68,7 +68,7 @@
* <tr><td colspan="3">The ID of this button used by the enclosing html tag to
get the tag's real ID attribute for Javascript and focus purposes. The real ID
attribute id is generated based upon this name.</td></tr>
* </table>
* @jsptagref.tagdescription
- * Handles data binding for a collection of [EMAIL PROTECTED] CheckBoxOption}
tags.
+ * Handles data binding for a collection of checkboxes.
*
* <p><b>Submitting Data</b></p>
* <p>The <netui:checkBoxGroup> submits data in the form of a String[]
object.
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxOption.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxOption.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/CheckBoxOption.java
Tue Aug 3 16:19:50 2004
@@ -51,7 +51,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * The <netui:checkBoxOption> tag renders a single HTML checkbox within a
group of checkboxes.
+ * Renders a single HTML checkbox within a group of checkboxes.
*
* The <netui:checkBoxOption> tags must have a parent
* [EMAIL PROTECTED] CheckBoxGroup} tag (which
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Content.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Content.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Content.java
Tue Aug 3 16:19:50 2004
@@ -37,7 +37,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * The <netui:content> tag displays text or the result of an expression to
the page.
+ * Displays text or the result of an expression.
* Note that <netui:content> is similar to [EMAIL PROTECTED] Label}, except
for the way
* it processes HTML-sensitive text. The <netui:content> tag does not
escape
* HTML-sensitive characters, but the <netui:label> tag filters the input
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ErrorBaseTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ErrorBaseTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ErrorBaseTag.java
Tue Aug 3 16:19:50 2004
@@ -111,7 +111,7 @@
/**
* @param report
* @param bundle
- * @return
+ * @return message
* @throws JspException
*/
protected String getErrorMessage(ActionError report, String bundle)
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Exceptions.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Exceptions.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Exceptions.java
Tue Aug 3 16:19:50 2004
@@ -47,7 +47,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * This tag renders exception messages and stack traces inline on the JSP page.
+ * Renders exception messages and stack traces inline on the JSP page.
*
* @example
* In this sample, the <netui:exceptions> tag will output the exception
title and message,
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/FormatNumber.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/FormatNumber.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/FormatNumber.java
Tue Aug 3 16:19:50 2004
@@ -53,7 +53,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * A tag used to format numbers.
+ * A formatter used to format numbers.
*
* <p>The <netui:formatNumber> tag formats the output of its parent tag.
For example:
*
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Html.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Html.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Html.java
Tue Aug 3 16:19:50 2004
@@ -138,7 +138,7 @@
/**
* This method will return the TagRenderBase enum value for the document
type. The default
* value is HTML 4.01.
- * @return
+ * @return int
*/
public int getTargetDocumentType()
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlBaseTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlBaseTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlBaseTag.java
Tue Aug 3 16:19:50 2004
@@ -78,6 +78,14 @@
/**
* Sets the style of the rendered html tag.
* @param style - the html style.
+ *
+ * @jsptagref.attributedescription
+ * The style.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_style</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.JspStyleProperty"
category="format"
*/
@@ -92,6 +100,14 @@
/**
* Sets the style class of the rendered html tag.
* @param styleClass - the html style class.
+ *
+ * @jsptagref.attributedescription
+ * The style class.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_style_class</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="Format"
*/
@@ -106,6 +122,54 @@
/**
* Set the ID of the tag.
* @param tagId - the tagId. A value is required.
+ *
+ * @jsptagref.attributedescription
+ * <p>String value. Sets the <code>id</code> (or <code>name</code>)
attribute of the rendered HTML tag.
+ * Note that the real id attribute rendered in the browser may be
+ * changed by the application container (for example, Portal containers
may change
+ * the rendered id value to ensure the uniqueness of
+ * id's on the page). In this case, the real id rendered
+ * in the browser may be looked up
+ * through the JavaScript function getNetuiTagName( tagId, tag )</code>.
+ *
+ * <p>For example, assume that some tag's <code>tagId</code> attribute is
set to <code>foo</code>.
+ *
+ * <pre> <netui:textBox <b>tagId="foo"</b> /></pre>
+ *
+ * <p>Then the following JavaScript function will return the real id
attribute rendered in the browser:
+ *
+ * <pre> getNetuiTagName( "foo", this )</pre>
+ *
+ * <p>To get a <netui:form> element and all of its children elements in
JavaScript, use
+ * the same JavaScript function <code>getNetuiTagName( tagId, tag
)</code>. For example,
+ * assume that there is a <netui:form> whose
+ * tagId attribute is set to <code>bar</code>.
+ *
+ * <pre> <netui:form <b>tagId="bar"</b> ></pre>
+ *
+ * <p>Then the following JavaScript function will return the
<netui:form> element
+ * and its children (packaged as an array).
+ *
+ * <pre> document[getNetuiTagName( "bar", this )]</pre>
+ *
+ * <p>To retreive the value entered into a <netui:textBox> within the
<netui:form> tag, use the following
+ * JavaScript expression.
+ *
+ * <pre> document[getNetuiTagName("bar", this)][getNetuiTagName("foo",
this)].value</pre>
+ *
+ * <p>The second parameter ensures that the JavaScript function
+ * begins its search within the correct Portlet scope. Pass the
+ * JavaScript keyword <code>this</code> as the second parameter.
+ *
+ * For detailed information on using the function
+ * <code>getNetuiTagName( tagId, tag )</code> see
+ * <a href="[EMAIL
PROTECTED]/../guide/netui/guide/conUsingJavaScript.html">
+ * Using JavaScript in Page Flow and Portal Applications</a>.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_tagId</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="general"
*/
@@ -133,6 +197,14 @@
/**
* Sets the value of the title attribute.
* @param title
+ *
+ * @jsptagref.attributedescription
+ * The title.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_title</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="misc"
*/
@@ -146,6 +218,14 @@
/**
* Sets the lang attribute for the HTML element.
* @param lang
+ *
+ * @jsptagref.attributedescription
+ * The lang.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_lang</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="internationalization"
*/
@@ -158,6 +238,14 @@
/**
* Sets the lang attribute for the HTML element.
* @param dir
+ *
+ * @jsptagref.attributedescription
+ * The dir.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_dir</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute category="internationalization"
*/
@@ -181,6 +269,14 @@
/**
* Sets the onClick javascript event.
* @param onclick - the onClick event.
+ *
+ * @jsptagref.attributedescription
+ * The onClick JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onClick</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -193,6 +289,14 @@
/**
* Sets the onDblClick javascript event.
* @param ondblclick - the onDblClick event.
+ *
+ * @jsptagref.attributedescription
+ * The onDblClick JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -205,6 +309,14 @@
/**
* Sets the onKeyDown javascript event.
* @param onkeydown - the onKeyDown event.
+ *
+ * @jsptagref.attributedescription
+ * The onKeyDown JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -217,6 +329,14 @@
/**
* Sets the onKeyPress javascript event.
* @param onkeypress - the onKeyPress event.
+ *
+ * @jsptagref.attributedescription
+ * The onKeyPress JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -229,6 +349,14 @@
/**
* Sets the onKeyUp javascript event.
* @param onkeyup - the onKeyUp event.
+ *
+ * @jsptagref.attributedescription
+ * The onKeyUp JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -241,6 +369,14 @@
/**
* Sets the onMouseDown javascript event.
* @param onmousedown - the onMouseDown event.
+ *
+ * @jsptagref.attributedescription
+ * The onMouseDown JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -253,6 +389,14 @@
/**
* Sets the onMouseMove javascript event.
* @param onmousemove - the onMouseMove event.
+ *
+ * @jsptagref.attributedescription
+ * The onMouseMove JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -265,6 +409,14 @@
/**
* Sets the onMouseOut javascript event.
* @param onmouseout - the onMouseOut event.
+ *
+ * @jsptagref.attributedescription
+ * The onMouseOut JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -277,6 +429,14 @@
/**
* Sets the onMouseOver javascript event.
* @param onmouseover - the onMouseOver event.
+ *
+ * @jsptagref.attributedescription
+ * The onMouseOver JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -289,6 +449,14 @@
/**
* Sets the onMouseUp javascript event.
* @param onmouseup - the onMouseUp event.
+ *
+ * @jsptagref.attributedescription
+ * The onMouseUp JavaScript event.
+ *
+ * @jsptagref.databindable false
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
* @netui.tldx:attribute
propertyclass="workshop.jspdesigner.properties.EventPropertyClass"
category="event"
*/
@@ -402,7 +570,7 @@
* @param realName
* @param outputAsId
* @param addToForm
- * @return
+ * @return String
*/
protected final String renderTagId(AbstractHtmlState state, String
realName, boolean outputAsId,
boolean addToForm)
@@ -451,7 +619,7 @@
* to the caller so they can output the script block.
* @param tagId
* @param value
- * @return
+ * @return String
*/
protected String addTagIdMapping(String tagId, String value)
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDataSourceTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDataSourceTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDataSourceTag.java
Tue Aug 3 16:19:50 2004
@@ -40,6 +40,39 @@
/**
* Sets the tag's data source (can be an expression).
* @param dataSource the data source
+ *
+ * @jsptagref.attributedescription
+ * <p>The <code>dataSource</code> attribute determines both
+ * (1) the source of populating data for the tag and
+ * (2) the object to which the tag submits data.
+ *
+ * <p>For example, assume that the Controller file (= JPF file) contains
+ * a Form Bean with the property foo. Then the following
<netui:textBox> tag will
+ * (1) draw populating data from the Form Bean's foo property and (2)
+ * submit user defined data to the same property.
+ *
+ * <p> <code><netui:textBox
dataSource="{actionForm.foo}" /></code>
+ *
+ * <p>The <code>dataSource</code> attribute takes either a data binding
expression or
+ * the name of a Form Bean property. In the
+ * above example, <code><netui:textBox dataSource="foo" /></code>
+ * would have the exactly same behavior.
+ *
+ * <p>When the tag is used to submit data, the data binding expression must
+ * refer to a Form Bean property.
+ * In cases where the tag is not used to submit data, but is used for
+ * displaying data only, the data
+ * binding expression need not refer to a Form Bean property. For
example,
+ * assume that myIterativeData is a member variable on
+ * the Controller file ( = JPF file). The following
<netui-data:repeater>
+ * tag draws its data from myIterativeData.
+ *
+ * <p> <code><netui-data:repeater
dataSource="{pageFlow.myIterativeData}"></code>
+ *
+ * @jsptagref.databindable Read / Write
+ *
+ * @jsptagref.attributesyntaxvalue <i>expression_datasource</i>
+ *
* @netui:attribute required="true"
* @netui.tldx:attribute language="netuiexpression"
*/
@@ -61,7 +94,7 @@
/**
* Return the Object that is represented by the specified data source.
- * @return
+ * @return Object
* @throws JspException
*/
protected Object evaluateDataSource()
@@ -78,7 +111,7 @@
}
/**
- * @return
+ * @return String
*/
protected String doNaming()
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDefaultableDataSourceTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDefaultableDataSourceTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlDefaultableDataSourceTag.java
Tue Aug 3 16:19:50 2004
@@ -32,6 +32,30 @@
/**
* Sets the default value (can be an expression).
* @param defaultValue - the default value
+ *
+ * @jsptagref.attributedescription
+ * <p><b>Use in <netui:checkBoxGroup>, <netui:checkBox>,
+ * <netui:radioButtonGroup>, and <netui:select> tags</b></p>
+ * <p>Sets the preselected value or values.
+ * <p>The <code>defaultValue</code> attribute takes either a String
literal or
+ * a data binding expression.
+ * <p>If the <code>defaultValue</code> attribute has a String value (or if
+ * the data binding expression points to a String), then a single value
+ * will be preselected.
+ * <p>If the <code>defaultValue</code> attribute points to a String[]
object
+ * (or any object which can be iterated over), then
+ * multiple values will be preselected.
+ *
+ *
+ * <p><b>Use in <netui:textArea> and <netui:textBox> tags</b></p>
+ * <p>Sets the initial display text.</p>
+ * <p>The <code>defaultValue</code> attribute takes either a String
literal or
+ * a data binding expression that points to a String.
+ *
+ * @jsptagref.databindable Read / Write
+ *
+ * @jsptagref.attributesyntaxvalue <i>string_or_expression_default</i>
+ *
* @netui:attribute required="false" rtexprvalue="true"
type="java.lang.Object"
* @netui.tldx:attribute
*/
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlGroupBaseTag.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlGroupBaseTag.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/HtmlGroupBaseTag.java
Tue Aug 3 16:19:50 2004
@@ -87,7 +87,7 @@
/**
* @param value
- * @return
+ * @return boolean
*/
public abstract boolean isMatched(String value);
@@ -389,7 +389,7 @@
/**
* Return the Object that is represented by the specified data source.
- * @return
+ * @return Object
* @throws JspException
*/
protected Object evaluateDataSource()
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Image.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Image.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/Image.java
Tue Aug 3 16:19:50 2004
@@ -77,7 +77,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * Renders an <image> tag with the specified attributes
+ * Renders an HTML <image> tag with specified attributes.
*
* @example In this sample, an Image shows "friends.jpg" at 150 x 175 pixels,
with the id "Friends".
* <pre><netui:image src="friends.jpg" id="Friends" height="150"
width="175" /></pre>
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ScriptContainer.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ScriptContainer.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/ScriptContainer.java
Tue Aug 3 16:19:50 2004
@@ -416,7 +416,7 @@
/**
* This will write the script block.
- * @return
+ * @return String
*/
protected String writeScriptBlock()
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/NameInterceptor.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/NameInterceptor.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/NameInterceptor.java
Tue Aug 3 16:19:50 2004
@@ -42,7 +42,7 @@
*
* @param name
* @param currentTag
- * @return
+ * @return String
* @throws ExpressionEvaluationException
*/
public String rewriteName(String name,Tag currentTag) throws
ExpressionEvaluationException;
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/PrefixNameInterceptor.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/PrefixNameInterceptor.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/naming/PrefixNameInterceptor.java
Tue Aug 3 16:19:50 2004
@@ -29,8 +29,8 @@
* to the [EMAIL PROTECTED] org.apache.beehive.netui.pageflow.ProcessPopulate}
handler
* in order to update a bean property. This preprocessing is done by
* implementing a handler implementing the interface
- * [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.RequestParamterHandler}, registering
- * this interface with the [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.ProcessPopulate#registerPrefixHandler(String,
RequestParamterHandler)}
+ * [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.RequestParameterHandler}, registering
+ * this interface with the [EMAIL PROTECTED]
org.apache.beehive.netui.pageflow.ProcessPopulate#registerPrefixHandler(String,
RequestParameterHandler)}
* method, and adding a prefix which references this RequestParameterHandler
to the
* name of each paramter that should be handled by the implementation before
* updating the bean property.
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/package.html
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/package.html
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/package.html
Tue Aug 3 16:19:50 2004
@@ -20,7 +20,7 @@
<p>
<code>AbstractBaseTag</code> provides base features allowing the
implementation of <code>dataSource,
defaultValue</code>, and <code>optionsDataSource</code>. There are also
base classes in both this package
- and the [EMAIL PROTECTED] org.apache.beehive.netui.html} package which
support these attributes.
+ and the [EMAIL PROTECTED] org.apache.beehive.netui.tags.html} package
which support these attributes.
</p>
<p>
The primary base classes are:
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/rendering/TagRenderingBase.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/rendering/TagRenderingBase.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/rendering/TagRenderingBase.java
Tue Aug 3 16:19:50 2004
@@ -290,7 +290,7 @@
/**
* @param req
- * @return
+ * @return ConstantRendering
*/
public static ConstantRendering getConstantRendering(ServletRequest
req)
{
@@ -313,7 +313,7 @@
/**
* @param req
- * @return
+ * @return String
*/
public static String getAmp(ServletRequest req)
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/Tree.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/Tree.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/Tree.java
Tue Aug 3 16:19:50 2004
@@ -1183,7 +1183,7 @@
* write that <code>tagid</code> out as the <code>id</code> attribute of
the HTML tag being generated.
* @param tagId
* @param state
- * @return
+ * @return String
*/
protected final String renderTagId(String tagId, AbstractHtmlState state)
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeElement.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeElement.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeElement.java
Tue Aug 3 16:19:50 2004
@@ -328,7 +328,7 @@
/**
* Set the title attribute for the node.
- * @return
+ * @return String
*/
public String getTitle()
{
Modified:
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeItem.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeItem.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/tree/TreeItem.java
Tue Aug 3 16:19:50 2004
@@ -257,7 +257,7 @@
}
/**
- * @return
+ * @return TreeElement
*/
public TreeElement getNode()
{
Modified:
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Attribute.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Attribute.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Attribute.java
Tue Aug 3 16:19:50 2004
@@ -50,7 +50,7 @@
* </p>
* @jsptagref.tagdescription
*
- * The <netui-template:attribute> tag defines a placeholder within a
template. The
+ * Defines a property placeholder within a template. The
* value of these placeholders may be set
* from a content page.
*
Modified:
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/DivPanel.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/DivPanel.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/DivPanel.java
Tue Aug 3 16:19:50 2004
@@ -176,7 +176,7 @@
* to the actual name. The tagId is also run through the naming service
so it can be scoped. Some tags will
* write that <code>tagid</code> out as the <code>id</code> attribute of
the HTML tag being generated.
* @param buffer
- * @return
+ * @return String
*/
protected final String renderTagId(StringBuilder buffer)
{
Modified:
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/IncludeSection.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/IncludeSection.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/IncludeSection.java
Tue Aug 3 16:19:50 2004
@@ -60,7 +60,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * This tag is used within a template page to define placeholders for HTML
content.
+ * Defines a content placeholder within a template.
* Each placeholder must have a unique name identifying it.
* Different content pages adopt the template page, set properties
* on its placeholders (using the [EMAIL PROTECTED] Section} tag), and render
the
Modified:
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Section.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Section.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Section.java
Tue Aug 3 16:19:50 2004
@@ -60,8 +60,8 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * The <netui-template:section> tag sets HTML content inside placeholders
defined by
- * [EMAIL PROTECTED] IncludeSection} tags.
+ * Sets HTML content inside placeholders defined by a
+ * [EMAIL PROTECTED] IncludeSection} tag.
*
* <p>The <netui-template:section> tag must have a parent
* [EMAIL PROTECTED] Template} tag.
@@ -340,7 +340,7 @@
* to the actual name. The tagId is also run through the naming service
so it can be scoped. Some tags will
* write that <code>tagid</code> out as the <code>id</code> attribute of
the HTML tag being generated.
* @param buffer
- * @return
+ * @return String
*/
protected final String renderTagId(StringBuilder buffer)
throws JspException {
Modified:
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/SetAttribute.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/SetAttribute.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/SetAttribute.java
Tue Aug 3 16:19:50 2004
@@ -47,7 +47,7 @@
* </p>
* @jsptagref.tagdescription
*
- * The <netui-template:setAttribute> tag sets the value for a placeholder
in a template page.
+ * Sets a property value in a template page.
*
* <p>The <netui-template:setAttribute> tag must have a parent
* [EMAIL PROTECTED] Template} tag.
Modified:
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Template.java
==============================================================================
---
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Template.java
(original)
+++
incubator/beehive/trunk/netui/src/tags-template/org/apache/beehive/netui/tags/template/Template.java
Tue Aug 3 16:19:50 2004
@@ -73,7 +73,7 @@
* </table>
* </p>
* @jsptagref.tagdescription
- * This tag points a content page at its template page. A
+ * Points a content page at its template page. A
* content page interacts with its template page through children tags
* of the
* <netui-template:template> tag. The legal children are as follows:
Modified:
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/config/ConfigUtil.java
==============================================================================
---
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/config/ConfigUtil.java
(original)
+++
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/config/ConfigUtil.java
Tue Aug 3 16:19:50 2004
@@ -39,10 +39,10 @@
* Utility class for reading properties from the NetUI configuration file.
* <br/>
* <br/>
- * The webapp runtime is read from the InputStream passed to the [EMAIL
PROTECTED] init} method.
+ * The webapp runtime is read from the InputStream passed to the [EMAIL
PROTECTED] #init(InputStream)} method.
* The configuration should be initialized with this method and a valid [EMAIL
PROTECTED] java.io.InputStream}
- * before the first time the [EMAIL PROTECTED] getConfig} method is called.
If the configuration
- * has not been initialized, [EMAIL PROTECTED] getConfig} will initialize a
bare bones runtime
+ * before the first time the [EMAIL PROTECTED] #getConfig()} method is called.
If the configuration
+ * has not been initialized, [EMAIL PROTECTED] #getConfig()} will initialize a
bare bones runtime
* configuration. Depending on the web application, this default configuration
* may lead to runtime errors.
* <br/>
Modified:
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/BaseTypeConverter.java
==============================================================================
---
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/BaseTypeConverter.java
(original)
+++
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/BaseTypeConverter.java
Tue Aug 3 16:19:50 2004
@@ -33,7 +33,7 @@
{
/**
* Convert the String to a type. The base implementation
- * delegates to the [EMAIL PROTECTED] convertToObject(java.lang.String,
java.util.Locale)}
+ * delegates to the [EMAIL PROTECTED] #convertToObject(java.lang.String,
java.util.Locale)}
* method with <code>null</code> for the locale.
*/
public Object convertToObject(String value)
Modified:
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/TypeUtils.java
==============================================================================
---
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/TypeUtils.java
(original)
+++
incubator/beehive/trunk/netui/src/util/org/apache/beehive/netui/util/type/TypeUtils.java
Tue Aug 3 16:19:50 2004
@@ -78,7 +78,6 @@
*
* @param value the String to convert
* @param type the type to which to convert the String
- * @param locale the locale to use during conversion
* @throws TypeConverterNotFoundException if a TypeConverter for the
target type can not be found.
* @return the Object result of converting the String to the type.
*/
