Revision: 1067
http://stripes.svn.sourceforge.net/stripes/?rev=1067&view=rev
Author: bengunter
Date: 2009-02-27 13:45:58 +0000 (Fri, 27 Feb 2009)
Log Message:
-----------
Updated Javadocs to explain the preferred method of applying @Validate to
properties to enable binding for those properties.
Modified Paths:
--------------
branches/1.5.x/stripes/src/net/sourceforge/stripes/action/StrictBinding.java
Modified:
branches/1.5.x/stripes/src/net/sourceforge/stripes/action/StrictBinding.java
===================================================================
---
branches/1.5.x/stripes/src/net/sourceforge/stripes/action/StrictBinding.java
2009-02-27 13:44:11 UTC (rev 1066)
+++
branches/1.5.x/stripes/src/net/sourceforge/stripes/action/StrictBinding.java
2009-02-27 13:45:58 UTC (rev 1067)
@@ -20,15 +20,22 @@
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
+import net.sourceforge.stripes.validation.Validate;
+import net.sourceforge.stripes.validation.ValidateNestedProperties;
+
/**
* <p>
- * When applied to an {...@link ActionBean}, this annotation indicates that
binding access controls
- * are in effect. Property binding can be enabled or disabled on a
case-by-case basis through the
- * use of the {...@link #allow()} and {...@link #deny()} elements.
+ * When applied to an {...@link ActionBean}, this annotation turns on binding
access controls. The
+ * default policy is to deny binding to all properties. To enable binding on
any given property, the
+ * preferred method is to apply a {...@link Validate} annotation to the
property. (For nested
+ * properties, use {...@link ValidateNestedProperties}.) Even if validation is
not necessary for the
+ * property in question, a naked {...@link Validate} annotation may still be
used to enable binding.
+ * Alternatively, binding can be enabled or disabled through the use of the
{...@link #allow()} and
+ * {...@link #deny()} elements of this annotation.
* </p>
* <p>
- * Property may be named explicitly or by using globs. A single star (*)
matches any property of an
- * element. Two stars (**) indicate any property of an element, including
properties of that
+ * Properties may be named explicitly or by using globs. A single star (*)
matches any property of
+ * an element. Two stars (**) indicate any property of an element, including
properties of that
* property and so on. For security reasons, partial matches are not allowed
so globs like
* user.pass* will never match anything. Some examples:
* <ul>
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
Open Source Business Conference (OSBC), March 24-25, 2009, San Francisco, CA
-OSBC tackles the biggest issue in open source: Open Sourcing the Enterprise
-Strategies to boost innovation and cut costs with open source participation
-Receive a $600 discount off the registration fee with the source code: SFAD
http://p.sf.net/sfu/XcvMzF8H
_______________________________________________
Stripes-development mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/stripes-development
