You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2014/12/05 15:52:46 UTC
svn commit: r1643304 - in /isis/site/trunk/content: ./ more-advanced-topics/
more-advanced-topics/images/ reference/recognized-annotations/
Author: danhaywood
Date: Fri Dec 5 14:52:45 2014
New Revision: 1643304
URL: http://svn.apache.org/r1643304
Log:
new page on suppressing contributions
Added:
isis/site/trunk/content/more-advanced-topics/How-to-suppress-contributions.md
- copied, changed from r1630348, isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md
isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-foodstuff.png (with props)
isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-person.png (with props)
Modified:
isis/site/trunk/content/documentation.md
isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md
isis/site/trunk/content/reference/recognized-annotations/about.md
Modified: isis/site/trunk/content/documentation.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/documentation.md?rev=1643304&r1=1643303&r2=1643304&view=diff
==============================================================================
--- isis/site/trunk/content/documentation.md (original)
+++ isis/site/trunk/content/documentation.md Fri Dec 5 14:52:45 2014
@@ -269,6 +269,7 @@ For both:
* [Are you sure?](./more-advanced-topics/are-you-sure-idiom.html)
* [Singleton & request-scoped services](./more-advanced-topics/how-to-09-020-How-to-write-a-typical-domain-service.html)
* [Decoupling dependencies using contributions](./more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.html)
+* [How to suppress contributions](./more-advanced-topics/how-to-suppress-contributions.html)
* [Bulk actions, acting upon lists](./more-advanced-topics/how-to-01-065-How-to-add-an-action-to-be-called-on-every-object-in-a-list.html)
* [Bidirectional relationships](./more-advanced-topics/how-to-04-060-How-to-set-up-and-maintain-bidirectional-relationships.html)
* [View models](./more-advanced-topics/ViewModel.html)
Copied: isis/site/trunk/content/more-advanced-topics/How-to-suppress-contributions.md (from r1630348, isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md)
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/How-to-suppress-contributions.md?p2=isis/site/trunk/content/more-advanced-topics/How-to-suppress-contributions.md&p1=isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md&r1=1630348&r2=1643304&rev=1643304&view=diff
==============================================================================
--- isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md (original)
+++ isis/site/trunk/content/more-advanced-topics/How-to-suppress-contributions.md Fri Dec 5 14:52:45 2014
@@ -1,49 +1,48 @@
-How to decouple dependencies using contributions
+How to suppress contributions to action parameters
------------------------------------------------
-In a small application (a dozen or less entities, say) there is little risk in having cyclic
-dependencies between entities, but as your application gets larger this coupling will cause problems - the inevitable [big ball of mud](http://en.wikipedia.org/wiki/Big_ball_of_mud).
+If a contributed action has multiple parameters, then that action will be contributed to each of the parameter types.
+While this will often be what you want (or at least harmless), on some occasions you may want to suppress the contributed
+action on one of those parameter types.
-You should, therefore, use packages to group related entities together, and then make sure that the package dependencies are acyclic. There are tools available that can help you visualize this and detect violations. Some tools can even plug into your build so that your build can fail if the architectural layering defined between your packages is violated. In DDD terms we are grouping our entities into [module](http://domainlanguage.com/ddd/patterns)s.
+The [kitchen sink app](https://github.com/isisaddons/isis-app-kitchensink) (part of [isisaddons.org](http://www.isisaddons.org/)
+includes an example showing how this can be done.
-On the other hand, although the dependencies between your modules should be well-defined and acyclic, you might want the UI to show the relationship as if it were bidirectional.
+In its `contrib` package there are three entities:
-For example, suppose we have an `communicationChannels` module that defines various subtypes of `CommunicationChannel` entity: `PostalAddress`, `PhoneNumber`, `EmailAddress` and so on. Each such `CommunicationChannel` is associated with (owned by) a `CommunicationChannelOwner`, defined as an interface.
+* [Person](https://github.com/isisaddons/isis-app-kitchensink/tree/d4fd4e8b799af42c343b7e451bbf6f5d218869a1/dom/src/main/java/org/isisaddons/app/kitchensink/dom/contrib/contributee/Person.java)
+* [Preference](https://github.com/isisaddons/isis-app-kitchensink/tree/d4fd4e8b799af42c343b7e451bbf6f5d218869a1/dom/src/main/java/org/isisaddons/app/kitchensink/dom/contrib/contributed/Preference.java)
+* [FoodStuff](https://github.com/isisaddons/isis-app-kitchensink/tree/d4fd4e8b799af42c343b7e451bbf6f5d218869a1/dom/src/main/java/org/isisaddons/app/kitchensink/dom/contrib/contributee/FoodStuff.java)
-In the `customers` module, we have the `Customer` entity that implements `CommunicationChannel`, while in the `assets` module we have `FixedAsset` that also implements this entity. Thus, a given `Customer` and a given `FixedAsset` could both - logically, at least - have a collection of `CommunicationChannel`s.
-
-For both `Customer` and `FixedAsset` (and any other future implementation) we would want to have some means to add and remove `CommunicationChannel`s). Rather than having very similar collections and actions in each, we can implement the requirement by defining the behaviour in the `communicationChannels` module, through a domain service. It would look something like:
-
- public class CommunicationChannelContributions {
-
- @NotInServiceMenu
- public CommunicationChannelOwner addPostalAddress(
- final CommunicationChannelOwner owner,
- final @Named("Address line 1") String addressLine1,
- ...
- final @Named("Zipcode") String zipCode) {
- ...
- }
-
- @NotInServiceMenu
- @NotContributed(As.ACTION)
- public Collection<CommunicationChannel> communicationChannels(
- final CommunicationOwner owner) {
- ...
- }
-
- @NotInServiceMenu
- @NotContributed(As.ACTION)
- public CommunicationChannel preferredCommunicationChannels(
- final CommunicationOwner owner) {
- ...
- }
+eg Mary LIKEs Apple, Mungo HATEs Banana, Midge LOVEs Oranges
+Neither `Person` nor `FoodStuff` knows about `Preference`s; the `Preference` is the tuple that associates the two together.
+
+The [PreferenceContributions](https://github.com/isisaddons/isis-app-kitchensink/tree/d4fd4e8b799af42c343b7e451bbf6f5d218869a1/dom/src/main/java/org/isisaddons/app/kitchensink/dom/contrib/contributed/PreferenceContributions.java) service contributes the following:
+
+* "likes" - a contributed collection to `Person`
+* "firstLove" - contributed property, also to `Person`
+* "addPreference" - a contributed action to both `Person` and `FoodStuff`
+* "removePreference" - a contributed action to both `Person` and `FoodStuff`
+
+However, although "addPreference" and "removePreference" *are* contributed to both `Person` and `FoodStuff`, this can be hidden using the `.layout.json` file. Thus, in [FoodStuff,layout.json](https://github.com/isisaddons/isis-app-kitchensink/tree/d4fd4e8b799af42c343b7e451bbf6f5d218869a1/dom/src/main/java/org/isisaddons/app/kitchensink/dom/contrib/contributee/FoodStuff.layout.json#L57-57) we have:
+
+ "actions": {
+ ...
+ "removePreference": {
+ "actionLayout": {
+ "cssClass": "btn-warn",
+ "hidden": "EVERYWHERE"
+ }
}
+ }
+
+which means that the "removePreference" action cannot be seen when viewing a FoodStuff entity.
-The first action, `addPostalAddress` will be rendered seemingly as a regular action for all implementations of `CommunicationChannelOwner`, but with that parameter omitted. This is a contributed action.
+You can see this in the screenshots below; `Person` has both actions:
-The second action - whose implementation will be some repository query to search for all `CommunicationChannel`s for the given owner - will be rendered as a collection of the owner; this is a contributed collection. The `@NotContributed(As.ACTION)` suppresses the action from being contributed as an action also.
+<img src="images/suppressing-contributions-person.png" width="400px"/>
-Finally, the third action - that again will be some sort of repository query - will be rendered as a property o fhte owner; this is a contributed property. Again, the `@NotContributed(As.ACTION)` suppresses the action from being contributed as an action also.
+while `FoodStuff` has only one:
+<img src="images/suppressing-contributions-foodstuff.png" width="400px"/>
Modified: isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md?rev=1643304&r1=1643303&r2=1643304&view=diff
==============================================================================
--- isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md (original)
+++ isis/site/trunk/content/more-advanced-topics/how-to-01-062-How-to-decouple-dependencies-using-contributions.md Fri Dec 5 14:52:45 2014
@@ -47,3 +47,8 @@ The second action - whose implementation
Finally, the third action - that again will be some sort of repository query - will be rendered as a property o fhte owner; this is a contributed property. Again, the `@NotContributed(As.ACTION)` suppresses the action from being contributed as an action also.
+
+## See also
+
+For another example of contributions, see [this page](./how-to-suppress-contributions.html) describing how to suppress contributions for one action parameter but not another.
+
Added: isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-foodstuff.png
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-foodstuff.png?rev=1643304&view=auto
==============================================================================
Binary file - no diff available.
Propchange: isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-foodstuff.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-person.png
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-person.png?rev=1643304&view=auto
==============================================================================
Binary file - no diff available.
Propchange: isis/site/trunk/content/more-advanced-topics/images/suppressing-contributions-person.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: isis/site/trunk/content/reference/recognized-annotations/about.md
URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/about.md?rev=1643304&r1=1643303&r2=1643304&view=diff
==============================================================================
--- isis/site/trunk/content/reference/recognized-annotations/about.md (original)
+++ isis/site/trunk/content/reference/recognized-annotations/about.md Fri Dec 5 14:52:45 2014
@@ -7,7 +7,7 @@ go back to: [documentation](../../docume
<th>Annotation</th>
<th>Layer</th>
<th>Purpose</th>
- <th><a href="../../components/viewers/wicket/dynamic-layouts.html">.layout.json</a> ?</th>
+ <th><a href="../../components/viewers/wicket/dynamic-layouts.html">.layout.json</a>?</th>
</tr>
<tr>
<td><a href="./ActionInteraction.html">@ActionInteraction</a></td>
@@ -19,7 +19,7 @@ go back to: [documentation](../../docume
<td><a href="./ActionLayout.html">@ActionLayout</a></td>
<td>UI</td>
<td>User interface hints for actions</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./ActionSemantics.html">@ActionSemantics</a></td>
@@ -70,7 +70,7 @@ go back to: [documentation](../../docume
<td><a href="./ClassLayout.html">@ClassLayout</a></td>
<td>UI</td>
<td>User interface hints for domain classes</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./CollectionInteraction.html">@CollectionInteraction</a></td>
@@ -83,7 +83,7 @@ go back to: [documentation](../../docume
<td><a href="./CollectionLayout.html">@CollectionLayout</a></td>
<td>UI</td>
<td>User interface hints for collections</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./Command.html">@Command</a></td>
@@ -109,7 +109,7 @@ go back to: [documentation](../../docume
<td>UI, Domain</td>
<td>Object property cannot be edited, an object collection cannot be added to/removed from, or an
object action cannot be invoked.</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./DomainService.html">@DomainService</a></td>
@@ -160,18 +160,6 @@ go back to: [documentation](../../docume
<td></td>
</tr>
<tr>
- <td><a href="./PropertyLayout.html">@PropertyLayout</a></td>
- <td>UI</td>
- <td>Layout hints for a property (currently: its label position either to top or the left).</td>
- <td></td>
- </tr>
- <tr>
- <td><a href="./ParameterLayout.html">@PropertyLayout</a></td>
- <td>UI</td>
- <td>Layout hints for an action parameter (currently: its label position either to top or the left).</td>
- <td></td>
- </tr>
- <tr>
<td><a href="./MaxLength.html">@MaxLength</a></td>
<td>Domain</td>
<td>Maximum length of a property value (strings).</td>
@@ -181,14 +169,14 @@ go back to: [documentation](../../docume
<td><a href="./MemberGroupLayout.html">@MemberGroupLayout</a></td>
<td>UI</td>
<td>Grouping of properties into groups, and organizing of properties, collections into columns.</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./MemberOrder.html">@MemberOrder</a></td>
<td>UI</td>
<td>Ordering of properties, collections and actions, and also associating actions with either a property or a
collection.</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./MinLength.html">@MinLength</a></td>
@@ -244,12 +232,24 @@ go back to: [documentation](../../docume
<td></td>
</tr>
<tr>
+ <td><a href="./ParameterLayout.html">@PropertyLayout</a></td>
+ <td>UI</td>
+ <td>Layout hints for an action parameter (currently: its label position either to top or the left).</td>
+ <td>Yes</td>
+ </tr>
+ <tr>
<td><a href="./Parseable.html">@Parseable</a></td>
<td>UI/domain</td>
<td>Indicates that a (value) class can be reconstructed from a string.</td>
<td></td>
</tr>
<tr>
+ <td><a href="./Programmatic.html">@Programmatic</a></td>
+ <td>Domain</td>
+ <td>Ignore a public method, excluded from the Isis metamodel.</td>
+ <td></td>
+ </tr>
+ <tr>
<td><a href="./PropertyInteraction.html">@PropertyInteraction</a></td>
<td>Domain</td>
<td>Enable subscribers to either veto, validate or take further steps before/after a property has been modified or
@@ -257,10 +257,10 @@ go back to: [documentation](../../docume
<td></td>
</tr>
<tr>
- <td><a href="./Programmatic.html">@Programmatic</a></td>
- <td>Domain</td>
- <td>Ignore a public method, excluded from the Isis metamodel.</td>
- <td></td>
+ <td><a href="./PropertyLayout.html">@PropertyLayout</a></td>
+ <td>UI</td>
+ <td>Layout hints for a property (currently: its label position either to top or the left).</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./PublishedAction.html">@PublishedAction</a></td>
@@ -308,7 +308,6 @@ go back to: [documentation](../../docume
<td>Specify that a class has value-semantics.
</td>
<td></td>
- <td></td>
</tr>
<tr>
<td><a href="./ViewModel.html">@ViewModel</a></td>
@@ -316,7 +315,6 @@ go back to: [documentation](../../docume
<td>Specify that a class is a view model (as opposed to an entity or domain service).
</td>
<td></td>
- <td></td>
</tr>
</table>
@@ -328,10 +326,10 @@ go back to: [documentation](../../docume
<th>Annotation</th>
<th>Layer</th>
<th>Purpose</th>
- <th><a href="../../components/viewers/wicket/dynamic-layouts.html">.layout.json</a> ?</th>
+ <th><a href="../../components/viewers/wicket/dynamic-layouts.html">.layout.json</a>?</th>
</tr>
<tr>
- <td><a href="./ActionOrder-deprecated.html" style="text-decoration: line-through;" >@ActionOrder</a></td>
+ <td><a href="./ActionOrder-deprecated.html" >@ActionOrder</a></td>
<td>UI</td>
<td>Order of buttons and menu items representing actions.
</td>
@@ -343,7 +341,7 @@ go back to: [documentation](../../docume
<td>Allow visual representation of individual objects or object members layout to be customized by application-specific CSS.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@ClassLayout</code>, <code>@PropertyLayout</code>, <code>@CollectionLayout</code>, <code>@ActionLayout</code> and <code>@ParameterLayout</code>
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./CssClassFa-deprecated.html">@CssClassFa</a></td>
@@ -351,10 +349,10 @@ go back to: [documentation](../../docume
<td>So that font awesome icons can be applied to action buttons/menu items and optionally as an object icon.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@ActionLayout</code>
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
- <td><a href="./Debug-deprecated.html" style="text-decoration: line-through;" >@Debug</a></td>
+ <td><a href="./Debug-deprecated.html" >@Debug</a></td>
<td>UI</td>
<td>Action only invocable in debug mode.
</td>
@@ -366,10 +364,10 @@ go back to: [documentation](../../docume
<td>Provide a longer description/tool-tip of an object or object member.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@ClassLayout</code>, <code>@PropertyLayout</code>, <code>@CollectionLayout</code>, <code>@ActionLayout</code> and <code>@ParameterLayout</code>
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
- <td><a href="./Exploration-deprecated.html" style="text-decoration: line-through;" >@Exploration</a></td>
+ <td><a href="./Exploration-deprecated.html" >@Exploration</a></td>
<td>UI</td>
<td>Action available in special 'exploration' mode.
<br/>Deprecated in 1.8.0-SNAPSHOT
@@ -377,7 +375,7 @@ go back to: [documentation](../../docume
<td></td>
</tr>
<tr>
- <td><a href="./FieldOrder-deprecated.html" style="text-decoration: line-through;" >@FieldOrder</a></td>
+ <td><a href="./FieldOrder-deprecated.html" >@FieldOrder</a></td>
<td>UI</td>
<td>Order of properties and collections
</td>
@@ -389,17 +387,17 @@ go back to: [documentation](../../docume
<td>Object member is not visible.
<br/>Deprecated in 1.8.0-SNAPSHOT
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
- <td><a href="./Idempotent-deprecated.html" style="text-decoration: line-through;" >@Idempotent</a></td>
+ <td><a href="./Idempotent-deprecated.html" >@Idempotent</a></td>
<td>Domain</td>
<td>Replaced by @ActionSemantics.
</td>
<td></td>
</tr>
<tr>
- <td><a href="./Ignore-deprecated.html" style="text-decoration: line-through;" >@Ignore</a></td>
+ <td><a href="./Ignore-deprecated.html" >@Ignore</a></td>
<td>Domain</td>
<td>Replaced by @Programmatic.
</td>
@@ -416,7 +414,7 @@ go back to: [documentation](../../docume
<td><a href="./MemberGroups-deprecated.html">@MemberGroups</a></td>
<td>UI</td>
<td>Replaced by @MemberGroupLayout</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./MultiLine-deprecated.html">@MultiLine</a></td>
@@ -424,7 +422,7 @@ go back to: [documentation](../../docume
<td>Render string property over multiple lines (a textarea rather than a textbox).
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@PropertyLayout</code> and <code>@ParameterLayout</code>
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./Named-deprecated.html">@Named</a></td>
@@ -432,14 +430,14 @@ go back to: [documentation](../../docume
<td>Override name inferred from class. Required for parameter names (prior to Java8).
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@ClassLayout</code>, <code>@PropertyLayout</code>, <code>@CollectionLayout</code>, <code>@ActionLayout</code> and <code>@ParameterLayout</code>
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./Paged-deprecated.html">@Paged</a></td>
<td>UI</td>
<td>Number of instances to display in tables representing (parented or standalone) collections.
<br/>Deprecated in 1.8.0-SNAPSHOT</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./Plural-deprecated.html">@Plural</a></td>
@@ -450,12 +448,11 @@ go back to: [documentation](../../docume
<td></td>
</tr>
<tr>
- <td><a href="./PostsPropertyChangedEvent-deprecated.html" style="text-decoration: line-through;" >@PostsPropertyChangedEvent</a></td>
+ <td><a href="./PostsPropertyChangedEvent-deprecated.html" >@PostsPropertyChangedEvent</a></td>
<td>Domain</td>
<td>Replaced by @PropertyInteraction
</td>
<td></td>
- <td>Y</td>
</tr>
<tr>
<td><a href="./Prototype-deprecated.html">@Prototype</a></td>
@@ -463,10 +460,10 @@ go back to: [documentation](../../docume
<td>Indicates that an action should only be visible in 'prototype' mode.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@ActionLayout</code>
</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
- <td><a href="./QueryOnly-deprecated.html" style="text-decoration: line-through;" >@QueryOnly</a></td>
+ <td><a href="./QueryOnly-deprecated.html" >@QueryOnly</a></td>
<td>Domain</td>
<td>Replaced by @ActionSemantics.</td>
<td></td>
@@ -477,7 +474,7 @@ go back to: [documentation](../../docume
<td>Eagerly (or lazily) render the contents of a collection.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@CollectionLayout</code>
</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./RenderedAsDayBefore-deprecated.html">@RenderedAsDayBefore</a></td>
@@ -488,10 +485,10 @@ go back to: [documentation](../../docume
<td></td>
</tr>
<tr>
- <td><a href="./Resolve-deprecated.html" style="text-decoration: line-through;" >@Resolve</a></td>
+ <td><a href="./Resolve-deprecated.html" >@Resolve</a></td>
<td>UI</td>
<td>Replaced by <code>@Render</code>.</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./SortedBy-deprecated.html">@SortedBy</a></td>
@@ -499,7 +496,7 @@ go back to: [documentation](../../docume
<td>Display instances in collections in the order determined by the provided Comparator.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@CollectionLayout</code>
</td>
- <td></td>
+ <td>Yes</td>
</tr>
<tr>
<td><a href="./TypicalLength-deprecated.html">@TypicalLength</a></td>
@@ -507,6 +504,6 @@ go back to: [documentation](../../docume
<td>The typical length of a string property, eg to determine a sensible length for a textbox.
<br/>Deprecated in 1.8.0-SNAPSHOT, see <code>@PropertyLayout</code> and <code>@ParameterLayout</code>
</td>
- <td>Y</td>
+ <td>Yes</td>
</tr>
</table>