This is an automated email from the ASF dual-hosted git repository.
lukaszlenart pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/main by this push:
new 06cb18801 docs: add missing validators to @Validations annotation docs
(#283)
06cb18801 is described below
commit 06cb18801964087e39a09a70684177bb297ad6e7
Author: Lukasz Lenart <[email protected]>
AuthorDate: Fri Nov 21 11:08:37 2025 +0100
docs: add missing validators to @Validations annotation docs (#283)
* docs: add missing validators to @Validations annotation docs
Add longRangeFields, shortRangeFields, and doubleRangeFields to the
Parameters table and add doubleRangeFields example in the Examples section.
Relates to WW-5579
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <[email protected]>
* style: convert HTML table to Markdown in validations-annotation.md
Also sort parameters alphabetically and fix pluralization consistency.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <[email protected]>
---------
Co-authored-by: Claude <[email protected]>
---
source/core-developers/validations-annotation.md | 96 +++++-------------------
1 file changed, 20 insertions(+), 76 deletions(-)
diff --git a/source/core-developers/validations-annotation.md
b/source/core-developers/validations-annotation.md
index c49091d59..dca15b95d 100644
--- a/source/core-developers/validations-annotation.md
+++ b/source/core-developers/validations-annotation.md
@@ -16,82 +16,24 @@ Used at METHOD level.
## Parameters
-<p> <table class='confluenceTable' summary=''>
-
- <tr>
- <th class='confluenceTh'> Parameter </th>
- <th class='confluenceTh'> Required </th>
- <th class='confluenceTh'> Notes </th>
- </tr>
- <tr>
- <td class='confluenceTd'> requiredFields </td>
- <td class='confluenceTd'> no </td>
-
- <td class='confluenceTd'> Add list of RequiredFieldValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> customValidators </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of CustomValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> conversionErrorFields </td>
-
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of ConversionErrorFieldValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> dateRangeFields </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of DateRangeFieldValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> emails </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of EmailValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> fieldExpressions </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of FieldExpressionValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> intRangeFields </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of IntRangeFieldValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> requiredStrings </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of RequiredStringValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> stringLengthFields </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of StringLengthFieldValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> urls </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of UrlValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> visitorFields </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of VisitorFieldValidators </td>
- </tr>
- <tr>
- <td class='confluenceTd'> regexFields </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of RegexFieldValidator </td>
- </tr>
- <tr>
- <td class='confluenceTd'> expressions </td>
- <td class='confluenceTd'> no </td>
- <td class='confluenceTd'> Add list of ExpressionValidator </td>
- </tr>
- </table>
-</p>
+| Parameter | Required | Notes |
+|-----------|----------|-------|
+| requiredFields | no | Add list of RequiredFieldValidators |
+| customValidators | no | Add list of CustomValidators |
+| conversionErrorFields | no | Add list of ConversionErrorFieldValidators |
+| dateRangeFields | no | Add list of DateRangeFieldValidators |
+| doubleRangeFields | no | Add list of DoubleRangeFieldValidators |
+| emails | no | Add list of EmailValidators |
+| expressions | no | Add list of ExpressionValidators |
+| fieldExpressions | no | Add list of FieldExpressionValidators |
+| intRangeFields | no | Add list of IntRangeFieldValidators |
+| longRangeFields | no | Add list of LongRangeFieldValidators |
+| regexFields | no | Add list of RegexFieldValidators |
+| requiredStrings | no | Add list of RequiredStringValidators |
+| shortRangeFields | no | Add list of ShortRangeFieldValidators |
+| stringLengthFields | no | Add list of StringLengthFieldValidators |
+| urls | no | Add list of UrlValidators |
+| visitorFields | no | Add list of VisitorFieldValidators |
## Examples
@@ -113,6 +55,8 @@ Used at METHOD level.
{ @LongRangeFieldValidator(type = ValidatorType.SIMPLE,
fieldName = "intfield", min = "6", max = "10", message = "bar must be between
${min} and ${max}, current value is ${bar}.")},
shortRangeFields =
{ @ShortRangeFieldValidator(type = ValidatorType.SIMPLE,
fieldName = "shortfield", min = "1", max = "128", message = "bar must be
between ${min} and ${max}, current value is ${bar}.")},
+ doubleRangeFields =
+ { @DoubleRangeFieldValidator(type = ValidatorType.SIMPLE,
fieldName = "doublefield", minInclusive = "0.0", maxInclusive = "100.0",
message = "bar must be between ${minInclusive} and ${maxInclusive}, current
value is ${bar}.")},
dateRangeFields =
{@DateRangeFieldValidator(type = ValidatorType.SIMPLE,
fieldName = "datefield", min = "-1", max = "99", message = "bar must be between
${min} and ${max}, current value is ${bar}.")},
expressions = {
