[seam-commits] Seam SVN: r15259 - in branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui: component and 4 other directories.

Author: manaRH Date: 2012-10-11 10:29:38 -0400 (Thu, 11 Oct 2012) New Revision: 15259 Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java Log: backported JBSEAM-4958 Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/DocumentStoreUtils.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -19,6 +19,12 @@ import org.jboss.seam.navigation.Pages; import org.jboss.seam.ui.component.UIResource; +/** + * Helper class for DocumentStore + * + * @author mnovotny + * + */ public class DocumentStoreUtils { private static final int BUFFER_SIZE = 32768; Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIAction.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -27,7 +27,7 @@ import org.jboss.seam.navigation.Pages; import org.jboss.seam.navigation.SafeActions; -/* +/** * This is a support component and is not processed by the CDK (doesn't appear in faces-config) * */ Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UICache.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -32,7 +32,7 @@ /** - * JSF component class + * JSF component class for Seam UICache * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Cache&quot;,value=&quot;Cache the rendered page fragment using the installed cache provider."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationId.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -35,10 +35,10 @@ /** - * JSF component class + * JSF component class which addd the conversation id to JSF link or button (e.g. &lt;h:commandLink/&gt;, &lt;s:button/&gt;) * */ -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.ConversationId&quot;,value=&quot;Add the conversation id to JSF link or button (e.g. <h:commandLink />, <s:button />)."), +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.ConversationId&quot;,value=&quot;Add the conversation id to JSF link or button (e.g. &lt;h:commandLink/&gt;, &lt;s:button/&gt;)."), family="org.jboss.seam.ui.ConversationId", type="org.jboss.seam.ui.ConversationId",generate="org.jboss.seam.ui.component.html.HtmlConversationId", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="conversationId"), attributes = {"javax.faces.component.UIParameter.xml", "conversationId.xml"}) Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIConversationPropagation.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -31,7 +31,8 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * JSF component class for customization of the conversation propagation in a command link or a button + * * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.ConversationPropagation&quot;,value=&quot;Customize the conversation propagation for a command link or button (or similar JSF control)."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorate.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -13,6 +13,11 @@ import org.richfaces.cdk.annotations.Tag; +/** + * "Decorates" a JSF input field when validation fails or when required="true" is set + * @author mnovotny + * + */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Decorate&quot;,value=&quot;\&quot;Decorate\&quot; a JSF input field when validation fails or when required=\"true\" is set."), family="org.jboss.seam.ui.Decorate", type="org.jboss.seam.ui.Decorate",generate="org.jboss.seam.ui.component.html.HtmlDecorate", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="decorate", handler="org.jboss.seam.ui.handler.DecorateHandler"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDecorateAware.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -3,7 +3,8 @@ /** * Component that is aware of being used from a facet by s:decorate */ -public interface UIDecorateAware { +public interface UIDecorateAware +{ /** * Method called by DecorateRendererBase when it's about to render a subtree containing this component. */ Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDefaultAction.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -11,10 +11,12 @@ import org.richfaces.cdk.annotations.Tag; /** + * Simulates pressing the action source when 'enter' is pressed + * * @author mnovotny * */ -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.DefaultAction&quot;,value=&quot;Simulate pressing the action source when 'enter' is pressed."), +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.DefaultAction&quot;,value=&quot;Simulates pressing the action source when 'enter' is pressed."), family="org.jboss.seam.ui.DefaultAction", type="org.jboss.seam.ui.DefaultAction",generate="org.jboss.seam.ui.component.html.HtmlDefaultAction", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="defaultAction"), renderer = @JsfRenderer(type="org.jboss.seam.ui.DefaultActionRenderer", family="org.jboss.seam.ui.DefaultActionRenderer")) Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIDownload.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -7,11 +7,12 @@ import org.richfaces.cdk.annotations.Tag; /** + * JSF Component for Link which is able to download a file * * @author Daniel Roth * */ -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Download&quot;,value=&quot;Link for downloading a file"), +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Download&quot;,value=&quot;JSF Component for Link which is able to download a file"), family="org.jboss.seam.ui.Download", type="org.jboss.seam.ui.Download",generate="org.jboss.seam.ui.component.html.HtmlDownload", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="download"), renderer = @JsfRenderer(type="org.jboss.seam.ui.DownloadRenderer", family="org.jboss.seam.ui.DownloadRenderer"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEnumItem.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -10,7 +10,7 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * JSF component class for creating SelectItem from an enum value * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.EnumItem&quot;,value=&quot;Creates a SelectItem from an enum value."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIEqualityValidator.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,7 +9,7 @@ import org.richfaces.cdk.annotations.Tag; /** - * UIComponent for validator + * JSF Component for validation of all child JSF input fields against the bound properties using Bean Validation * * @author Daniel Roth */ Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFileUpload.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -15,7 +15,8 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * JSF component class which renders a file upload control. + * This control must be used within a form with an encoding type of multipart/form-data * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.FileUpload&quot;,value=&quot;Renders a file upload control. This control must be used within a form with an encoding type of multipart/form-data"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFormattedText.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -39,10 +39,10 @@ import antlr.RecognitionException; /** - * JSF component class + * JSF component class which outputs Seam Text. Parse errors generate WARN level log messages. * */ -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.FormattedText&quot;,value=&quot;Output Seam Text. Parse errors generate WARN level log messages."), +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.FormattedText&quot;,value=&quot;Outputs Seam Text. Parse errors generate WARN level log messages."), family="org.jboss.seam.ui.FormattedText", type="org.jboss.seam.ui.FormattedText",generate="org.jboss.seam.ui.component.html.HtmlFormattedText", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="formattedText"), renderer = @JsfRenderer(type="org.jboss.seam.ui.FormattedTextRenderer", family="org.jboss.seam.ui.FormattedTextRenderer"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIFragment.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -30,7 +30,7 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * JSF component class which surrounds a page fragment and allows you to apply render/not render without any html output * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Fragment&quot;,value=&quot;Surround a page fragment, allows you to apply render/not render without any html output."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILabel.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -8,7 +8,13 @@ import org.richfaces.cdk.annotations.JsfComponent; import org.richfaces.cdk.annotations.Tag; -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Label&quot;,value=&quot;A label associated with the nearest JSF input component"), +/** + * JSF Component which renders a label associated with the nearest JSF input component + * + * @author mnovotny + * + */ +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Label&quot;,value=&quot;A label associated with the nearest JSF input component."), family="javax.faces.Output", type="org.jboss.seam.ui.Label",generate="org.jboss.seam.ui.component.html.HtmlLabel", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="label"), attributes = {"label.xml" }) Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UILink.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -29,7 +29,8 @@ /** - * JSF component class + * JSF component class which renders a link that supports invocation of an action with control over conversation propagation. + * It does not submit the form. * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Link&quot;,value=&quot;A link that supports invocation of an action with control over conversation propagation. Does not submit the form."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIMessage.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -30,7 +30,8 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * + * JSF component class which decorates a JSF input field with the validation error message. * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Message&quot;,value=&quot;Decorate a JSF input field with the validation error message."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIResource.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -13,6 +13,8 @@ import org.richfaces.cdk.annotations.Tag; /** + * JSF Component which can use a data in form as inputstream, + * java.util.File or byte[] and a content-type, this tag sends the data to the browser * @author Daniel Roth */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Resource&quot;,value=&quot;Given a data in form of an inputstream, java.util.File or byte[] and a content-type, this tag sends the data to the browser"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISeamCommandBase.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -20,8 +20,13 @@ import org.jboss.seam.core.PropagationType; import org.jboss.seam.navigation.Pages; import org.jboss.seam.ui.util.ViewUrlBuilder; -import org.jboss.seam.ui.util.cdk.MethodBindingToMethodExpression; +/** + * Parent of all Seam command like JSF components + * + * @author mnovotny + * + */ public abstract class UISeamCommandBase extends UIOutput implements ActionSource2 { Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelectItems.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -23,7 +23,9 @@ /** - * @auth Pete Muir + * JSF Component which creates a List<SelectItem> from a List, Set, DataModel or Array. + * + * @author Pete Muir * */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.SelectItems&quot;,value=&quot;Creates a List<SelectItem> from a List, Set, DataModel or Array."), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISelection.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -32,10 +32,10 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * JSF component class which inserts a parameter that can be bound to a data model * */ -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Selection&quot;, value=""), +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Selection&quot;, value="It inserts a parameter that can be bound to a data model"), family="org.jboss.seam.ui.Selection", type="org.jboss.seam.ui.Selection",generate="org.jboss.seam.ui.component.html.HtmlSelection", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="selection"), attributes = {"selection.xml" }) Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UISpan.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -6,7 +6,12 @@ import org.richfaces.cdk.annotations.JsfRenderer; import org.richfaces.cdk.annotations.Tag; -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Span&quot;,value=&quot;Render a HTML <span>"), +/** + * Renders a HTML &lt;span&gt; + * @author mnovotny + * + */ +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Span&quot;,value=&quot;Render a HTML &lt;span&gt;"), family="org.jboss.seam.ui.Span", type="org.jboss.seam.ui.Span",generate="org.jboss.seam.ui.component.html.HtmlSpan", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="span"), renderer = @JsfRenderer(type="org.jboss.seam.ui.SpanRenderer", family="org.jboss.seam.ui.SpanRenderer"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIStyle.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -8,7 +8,12 @@ import org.richfaces.cdk.annotations.JsfRenderer; import org.richfaces.cdk.annotations.Tag; -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Div&quot;,value=&quot;&lt;![CDATA[Render a HTML <div>.]]>"), +/** + * JSF Component which renders a HTML &lt;div&gt; + * @author mnovotny + * + */ +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.Div&quot;,value=&quot;Render a HTML &lt;div&gt;"), family="org.jboss.seam.ui.Div", type="org.jboss.seam.ui.Div",generate="org.jboss.seam.ui.component.html.HtmlDiv", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="div"), renderer = @JsfRenderer(type="org.jboss.seam.ui.DivRenderer", family="org.jboss.seam.ui.DivRenderer")) Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/component/UIValidateAll.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -8,10 +8,10 @@ import org.richfaces.cdk.annotations.Tag; /** - * JSF component class + * JSF component class which validates all child JSF input fields against the bound properties using Bean validation * */ -@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.ValidateAll&quot;,value=&quot;&lt;![CDATA[Validate all child JSF input fields against the bound propertys using Hibernate Validator.]]>"), +@JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.ValidateAll&quot;,value=&quot;Validate all child JSF input fields against the bound propertys using Hibernate Validator."), family="org.jboss.seam.ui.ValidateAll", type="org.jboss.seam.ui.ValidateAll",generate="org.jboss.seam.ui.component.html.HtmlValidateAll", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="validateAll"), renderer = @JsfRenderer(type="org.jboss.seam.ui.ValidateAllRenderer", family="org.jboss.seam.ui.ValidateAllRenderer")) Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicBooleanConverter.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -10,6 +10,7 @@ import javax.faces.convert.FacesConverter; /** + * Converter for java.util.concurrent.atomic.AtomicBoolean * @author Dennis Byrne */ @FacesConverter(value="org.jboss.seam.ui.AtomicBooleanConverter") Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicIntegerConverter.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,6 +9,7 @@ import javax.faces.convert.FacesConverter; /** + * Converter for java.util.concurrent.atomic.AtomicInteger * @author Dennis Byrne */ @FacesConverter(value="org.jboss.seam.ui.AtomicIntegerConverter") Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/AtomicLongConverter.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,6 +9,8 @@ import javax.faces.convert.FacesConverter; /** + * Converter for java.util.concurrent.atomic.AtomicLong + * * @author Dennis Byrne */ @FacesConverter(value="org.jboss.seam.ui.AtomicLongConverter") Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/DateTimeConverter.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -26,7 +26,12 @@ import javax.faces.convert.FacesConverter; import org.jboss.seam.contexts.Contexts; - +/** + * Extended DateTimeConverter which set Timezone from Seam web application config + * + * @author mnovotny + * + */ @FacesConverter("org.jboss.seam.ui.DateTimeConverter") public class DateTimeConverter extends javax.faces.convert.DateTimeConverter{ Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/EnumConverter.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -8,6 +8,12 @@ import javax.faces.convert.ConverterException; import javax.faces.convert.FacesConverter; +/** + * Converter for Enums + * + * @author mnovotny + * + */ @FacesConverter(value="org.jboss.seam.ui.EnumConverter") public class EnumConverter implements javax.faces.convert.Converter { Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/converter/NoSelectionConverter.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -6,6 +6,12 @@ import javax.faces.convert.ConverterException; import javax.faces.convert.FacesConverter; +/** + * Converter for no selection value item + * + * @author mnovotny + * + */ @FacesConverter(value="org.jboss.sema.ui.NoSelectionConverter") public class NoSelectionConverter implements Converter { Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/GraphicImageRendererBase.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -11,6 +11,12 @@ import org.jboss.seam.ui.util.cdk.RendererBase; import org.richfaces.cdk.annotations.JsfRenderer; +/** + * Renderer for image based components + * + * @author mnovotny + * + */ @JsfRenderer(type="org.jboss.seam.ui.graphicImage.GraphicImageRenderer", family="org.jboss.seam.ui.GraphicImageRenderer") public class GraphicImageRendererBase extends RendererBase { Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UIGraphicImage.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -8,6 +8,11 @@ import org.richfaces.cdk.annotations.JsfRenderer; import org.richfaces.cdk.annotations.Tag; +/** + * Outputs an image to the view. You can specify the file as a path, a java.io.File, java.io.InputStream, java.net.URL or byte[] + * @author mnovotny + * + */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.graphicImage.GraphicImage&quot;,value=&quot;Output an image to the view. You can specify the file as a path, a java.io.File, java.io.InputStream, java.net.URL or byte[]"), family="org.jboss.seam.ui.graphicImage.GraphicImage", type="org.jboss.seam.ui.graphicImage.GraphicImage",generate="org.jboss.seam.ui.component.html.HtmlGraphicImage", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="graphicImage"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageBlur.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,6 +9,12 @@ import org.richfaces.cdk.annotations.JsfComponent; import org.richfaces.cdk.annotations.Tag; +/** + * JSF Component which nestes in a &lt;s:graphicImage&gt;.Transforms an image by applying a blur. + * + * @author mnovotny + * + */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.graphicImage.TransformImageBlur&quot;,value=&quot;Nested in a s:graphicImage. Transform an image by applying a blur."), family="org.jboss.seam.ui.graphicImage.TransformImageBlur", type="org.jboss.seam.ui.graphicImage.TransformImageBlur",generate="org.jboss.seam.ui.component.html.HtmlTransformImageBlur", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="transformImageBlur"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageSize.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,6 +9,13 @@ import org.richfaces.cdk.annotations.JsfComponent; import org.richfaces.cdk.annotations.Tag; +/** + * + * JSF Component which nestes in a &lt;s:graphicImage&gt;.Transforms an image by altering the size. + * + * @author mnovotny + * + */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.graphicImage.TransformImageSize&quot;,value=&quot;Nested in a s:graphicImage. Transform an image by altering the size."), family="org.jboss.seam.ui.graphicImage.TransformImageSize", type="org.jboss.seam.ui.graphicImage.TransformImageSize",generate="org.jboss.seam.ui.component.html.HtmlTransformImageSize", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="transformImageSize"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/graphicImage/UITransformImageType.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,6 +9,12 @@ import org.richfaces.cdk.annotations.JsfComponent; import org.richfaces.cdk.annotations.Tag; +/** + * JSF Component which nestes in a &lt;s:graphicImage&gt;.Transform an image by changing it's type. + * + * @author mnovotny + * + */ @JsfComponent(description=(a)Description(displayName=&quot;org.jboss.seam.ui.graphicImage.TransformImageType&quot;,value=&quot;Nested in a s:graphicImage. Transform an image by changing it's type."), family="org.jboss.seam.ui.graphicImage.TransformImageType", type="org.jboss.seam.ui.graphicImage.TransformImageType",generate="org.jboss.seam.ui.component.html.HtmlTransformImageType", tag = @Tag(baseClass="org.jboss.seam.ui.util.cdk.UIComponentTagBase", name="transformImageType"), Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/CommandButtonParameterComponentHandler.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,7 +9,7 @@ import static org.jboss.seam.ui.util.cdk.RendererBase.getUtils; /** - * If user didn't specify id on button, do it for them (we need one rendered) + * Command button based parameter handler. If user didn't specify id on button, do it for them (we need one rendered) * * @author Pete Muir * Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/handler/DecorateHandler.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -9,6 +9,12 @@ import javax.faces.view.facelets.ComponentHandler; import javax.faces.view.facelets.FaceletContext; +/** + * Decorating handler + * + * @author mnovotny + * + */ public class DecorateHandler extends ComponentHandler { private com.sun.faces.facelets.tag.ui.DecorateHandler delegate; Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/EqualityValidator.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -22,7 +22,7 @@ import org.jboss.seam.ui.component.UIDecorate; /** - * Validate two fields are equal + * Validates two fields are equal * * @author pmuir * @author Daniel Roth Modified: branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java =================================================================== --- branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java 2012-10-11 14:22:58 UTC (rev 15258) +++ branches/enterprise/WFK-2_1/jboss-seam-ui/src/main/java/org/jboss/seam/ui/validator/ModelValidator.java 2012-10-11 14:29:38 UTC (rev 15259) @@ -15,7 +15,7 @@ import javax.validation.ConstraintViolation; /** - * Validates using Hibernate Validator model-based annotations. + * Validates model using Bean Validation annotations . * * @author Gavin King * @author Jacob Hookom