You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by bu...@apache.org on 2013/09/12 08:14:55 UTC
svn commit: r878108 - in /websites/staging/isis/trunk: cgi-bin/ content/
content/applib-guide/how-tos/
Author: buildbot
Date: Thu Sep 12 06:14:54 2013
New Revision: 878108
Log:
Staging update by buildbot for isis
Added:
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-029-How-to-specify-conditional-choices-for-action-parameters.html
Removed:
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-01-000-How-to-write-a-basic-Domain-Entity-or-Service.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-02-000-How-to-add-business-rules.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-000-How-to-provide-drop-downs-and-default-values.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-05-000-How-to-provide-additional-UI-hints.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-06-000-How-to-deal-with-errors.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-07-000-How-to-handle-entity-persistence-lifecycle.html
Modified:
websites/staging/isis/trunk/cgi-bin/ (props changed)
websites/staging/isis/trunk/content/ (props changed)
websites/staging/isis/trunk/content/applib-guide/how-tos/about.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-010-How-to-specify-a-set-of-choices-for-a-property.html
websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-020-How-to-specify-a-set-of-choices-for-an-action-parameter.html
Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Sep 12 06:14:54 2013
@@ -1 +1 @@
-1519563
+1522455
Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Sep 12 06:14:54 2013
@@ -1 +1 @@
-1519563
+1522455
Modified: websites/staging/isis/trunk/content/applib-guide/how-tos/about.html
==============================================================================
--- websites/staging/isis/trunk/content/applib-guide/how-tos/about.html (original)
+++ websites/staging/isis/trunk/content/applib-guide/how-tos/about.html Thu Sep 12 06:14:54 2013
@@ -321,15 +321,28 @@ drop-down list box.</p>
<p>In a similar vein, there may be a default value for an action parameter;
this can also be specified.</p>
+<p>For properties:</p>
+
<ul>
<li><a href="./how-to-03-010-How-to-specify-a-set-of-choices-for-a-property.html">How to specify a set of choices for a property</a></li>
<li><a href="./how-to-03-015-How-to-specify-an-autocomplete-for-a-property.html">How to specify an auto-complete for a property</a></li>
<li><a href="./how-to-03-017-How-to-specify-default-value-of-an-object-property.html">How to specify the default value of an object property</a></li>
+</ul>
+
+<p>For actions:</p>
+
+<ul>
<li><a href="./how-to-03-020-How-to-specify-a-set-of-choices-for-an-action-parameter.html">How to specify a set of choices for an action parameter</a></li>
<li><a href="./how-to-03-025-How-to-specify-an-autocomplete-for-an-action-parameter.html">How to specify an auto-complete for an action parameter</a></li>
-<li><a href="./how-to-03-030-How-to-specify-that-a-class-of-objects-has-a-limited-number-of-instances.html">How to specify that a class of objects has a limited number of instances</a></li>
-<li><a href="./how-to-03-040-How-to-find-an-entity-(for-an-action-parameter-or-property)-using-auto-complete.html">How to find an entity (for an action parameter or property) using auto-complete</a></li>
<li><a href="./how-to-03-050-How-to-specify-default-values-for-an-action-parameter.html">How to specify default values for an action parameter</a></li>
+<li><a href="./how-to-03-029-How-to-specify-conditional-choices-for-action-parameters.html">How to specify conditional choices for action parameters (eg category/subcategory</a></li>
+</ul>
+
+<p>For both:</p>
+
+<ul>
+<li><a href="./how-to-03-030-How-to-specify-that-a-class-of-objects-has-a-limited-number-of-instances.html">How to specify (for an action parameter or property) that a class has a limited number of instances</a></li>
+<li><a href="./how-to-03-040-How-to-find-an-entity-(for-an-action-parameter-or-property)-using-auto-complete.html">How to find an entity (for an action parameter or property) using auto-complete</a></li>
</ul>
<h2>How to derive properties and collections, and other side-effects</h2>
@@ -396,11 +409,13 @@ get visibility into and influence this b
<li><a href="./how-to-07-070-How-to-hook-into-the-object-lifecycle-using-callbacks.html">How to hook into the object lifecycle using callbacks</a></li>
</ul>
-<h2>How to handle security concerns</h2>
+<h2>How to control access to entity features</h2>
+
+<p><em>Isis</em> allows you to control access to entities either using application logic or through a pluggable authorisation manager.</p>
<ul>
-<li><a href="./how-to-08-010-Hiding,-disabling-or-validating-for-specific-users-or-roles.html">Hiding, disabling or validating for specific users or roles</a></li>
-<li><a href="./how-to-08-020-How-to-use-Isis-authorization-manager.html">How to use Isis authorization manager</a></li>
+<li><a href="./how-to-08-010-Hiding,-disabling-or-validating-for-specific-users-or-roles.html">How to write application logic to hide, disable and validate for specific users/roles</a></li>
+<li><a href="./how-to-08-020-How-to-use-Isis-authorization-manager.html">How to use Isis' authorization manager</a></li>
</ul>
Modified: websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-010-How-to-specify-a-set-of-choices-for-a-property.html
==============================================================================
--- websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-010-How-to-specify-a-set-of-choices-for-a-property.html (original)
+++ websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-010-How-to-specify-a-set-of-choices-for-a-property.html Thu Sep 12 06:14:54 2013
@@ -273,7 +273,7 @@ Customer, with the most recently-used ad
<pre><code>public PropertyType[] choicesPropertyName()
</code></pre>
-<p>where <code>PropertyType</code> is the same type as that of the property itself.</p>
+<p>where <code>PropertyType</code> is the same type as that of the property itself. Any subtype of <code>Collection</code> may also be used.</p>
<p>For example:</p>
Modified: websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-020-How-to-specify-a-set-of-choices-for-an-action-parameter.html
==============================================================================
--- websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-020-How-to-specify-a-set-of-choices-for-an-action-parameter.html (original)
+++ websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-020-How-to-specify-a-set-of-choices-for-an-action-parameter.html Thu Sep 12 06:14:54 2013
@@ -274,7 +274,7 @@ ways to specify parameters; either per p
<pre><code>public List<ParameterType> choicesNActionName()
</code></pre>
-<p>where N indicates the 0-based parameter number.</p>
+<p>where N indicates the 0-based parameter number. Any subtype of <code>Collection</code> may also be used.</p>
<p>For example:</p>
Added: websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-029-How-to-specify-conditional-choices-for-action-parameters.html
==============================================================================
--- websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-029-How-to-specify-conditional-choices-for-action-parameters.html (added)
+++ websites/staging/isis/trunk/content/applib-guide/how-tos/how-to-03-029-How-to-specify-conditional-choices-for-action-parameters.html Thu Sep 12 06:14:54 2013
@@ -0,0 +1,326 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+
+ <meta charset="utf-8">
+ <title></title>
+ <meta name="description" content="">
+ <meta name="author" content="">
+
+ <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+ <!--[if lt IE 9]>
+ <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+ <![endif]-->
+
+ <!-- Le styles -->
+ <link href="./../../bootstrap.css" rel="stylesheet">
+ <link href="./../../prettify.css" rel="stylesheet">
+
+ <style type="text/css">
+ body {
+ padding-top: 60px;
+ }
+ .sprite {
+ display: inline-block;
+ height: 20px;
+ margin: 0 auto 4px;
+ outline: medium none;
+ text-indent: -999em;
+ width: 24px;
+ background-image: url('./../../images/sprites.png');
+ background-repeat: no-repeat;
+ overflow: hidden;
+ cursor: pointer;
+ }
+ .edit-page {
+ display: inline-block;
+ height: 20px;
+ margin: 0 auto 4px;
+ outline: medium none;
+ text-indent: -999em;
+ width: 24px;
+ background-image: url('./../../images/edit.png');
+ background-repeat: no-repeat;
+ overflow: hidden;
+ cursor: pointer;
+ }
+ .fb-share {
+ background-position: 0px -40px;
+ }
+ .gp-share {
+ background-position: 0px 0px;
+ }
+ .tw-share {
+ background-position: 0px -80px;
+ }
+ .markdown-content {
+ min-height: 500px;
+ }
+ .book-image img {
+ border: 1px;
+ border-style: solid;
+ }
+ .release-matrix .heading {
+ background-color: #eeeeee;
+ }
+ .release-matrix .new {
+ color: #dd0000;
+ font-weight: bolder;
+ }
+ .stub,.note {
+ position: relative;
+ padding: 7px 15px;
+ margin-bottom: 18px;
+ color: #404040;
+ background-color: #eedc94;
+ background-repeat: repeat-x;
+ background-image: -khtml-gradient(linear, left top, left bottom, from(#fceec1), to(#eedc94));
+ background-image: -moz-linear-gradient(top, #fceec1, #eedc94);
+ background-image: -ms-linear-gradient(top, #fceec1, #eedc94);
+ background-image: -webkit-gradient(linear, left top, left bottom, color-stop(0%, #fceec1), color-stop(100%, #eedc94));
+ background-image: -webkit-linear-gradient(top, #fceec1, #eedc94);
+ background-image: -o-linear-gradient(top, #fceec1, #eedc94);
+ background-image: linear-gradient(top, #fceec1, #eedc94);
+ filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#fceec1', endColorstr='#eedc94', GradientType=0);
+ text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25);
+ border-color: #eedc94 #eedc94 #e4c652;
+ border-color: rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);
+ text-shadow: 0 1px 0 rgba(255, 255, 255, 0.5);
+ border-width: 1px;
+ border-style: solid;
+ -webkit-border-radius: 4px;
+ -moz-border-radius: 4px;
+ border-radius: 4px;
+ -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.25);
+ -moz-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.25);
+ box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.25);
+ }
+ </style>
+ <script type="text/javascript">
+ function fbshare () {
+ window.open(
+ "http://www.facebook.com/sharer/sharer.php?u="+document.URL,
+ 'Share on Facebook',
+ 'width=640,height=426');
+ };
+ function gpshare () {
+ window.open(
+ "https://plus.google.com/share?url="+document.URL,
+ 'Share on Google+',
+ 'width=584,height=385');
+ };
+ function twshare () {
+ window.open(
+ "https://twitter.com/intent/tweet?url="+document.URL+"&text=",
+ 'Share on Twitter',
+ 'width=800,height=526');
+ };
+ </script>
+
+ <!-- Le fav and touch icons -->
+ <link rel="shortcut icon" href="./../../images/favicon.ico">
+ <!--
+ <link rel="apple-touch-icon" href="./../../images/apple-touch-icon.png">
+ <link rel="apple-touch-icon" sizes="72x72" href="./../../images/apple-touch-icon-72x72.png">
+ <link rel="apple-touch-icon" sizes="114x114" href="./../../images/apple-touch-icon-114x114.png">
+ -->
+
+ <script src="./../../javascript/prettify.js" type="text/javascript"></script>
+ <script src="./../../javascript/jquery-latest.js"></script>
+
+
+ <script src="http://platform.twitter.com/widgets.js" type="text/javascript"></script>
+ <script src="./../../javascript/common.js"></script>
+ <script src="./../../javascript/prettyprint.js"></script>
+
+ <script src="./../../javascript/bootstrap-alert.js"></script>
+ <script src="./../../javascript/bootstrap-dropdown.js"></script>
+ <script src="./../../javascript/bootstrap-tooltip.js"></script>
+ <!--
+ <script src="./../../javascript/bootstrap-alerts.js"></script>
+ -->
+ <script src="./../../javascript/bootstrap-modal.js"></script>
+ <script src="./../../javascript/bootstrap-transition.js"></script>
+ <script src="./../../javascript/bootstrap-button.js"></script>
+ <script src="./../../javascript/bootstrap-popover.js"></script>
+ <script src="./../../javascript/bootstrap-scrollspy.js"></script>
+ <script src="./../../javascript/bootstrap-typeahead.js"></script>
+ <script src="./../../javascript/bootstrap-carousel.js"></script>
+ <script src="./../../javascript/bootstrap-tab.js"></script>
+ <script src="./../../javascript/bootstrap-collapse.js"></script>
+
+
+
+
+
+ <script>
+ $(function () { prettyPrint() })
+ $().dropdown()
+ </script>
+
+ <!-- GAQ stuff removed here -->
+
+
+ </head>
+
+ <body>
+
+ <div class="topbar">
+ <div class="fill">
+ <div class="container">
+ <a class="brand" href="./../../index.html">Apache Isis™</a>
+ <ul class="nav">
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Apache <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li>
+ <a href="http://www.apache.org/">Apache Homepage <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/licenses/">Licenses <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/security/">Security <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="http://www.apache.org/foundation/thanks.html">Thanks <i class="icon-share-alt"></i></a>
+ </li>
+ <li>
+ <a href="./../../more-thanks.html">More thanks <i class="icon-share-alt"></i></a>
+ </li>
+ </ul>
+ </li>
+ <li><a href="./../../index.html">Home</a></li>
+ <li><a href="./../../download.html">Download</a></li>
+ <li class="dropdown">
+ <a href="#" class="dropdown-toggle" data-toggle="dropdown">Screenshots<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="./../../getting-started/screenshots.html">Screenshots</a></li>
+ <li><a href="./../../getting-started/screencasts.html">Screencasts</a></li>
+ <li><a href="./../../getting-started/powered-by.html">Powered by</a></li>
+ <!--
+ <li><a href="#">Online Demo</a></li>
+ -->
+ </ul>
+ </li>
+ <li><a href="./../../documentation.html">Documentation</a></li>
+ <li><a href="./../../support.html">Support</a></li>
+
+ </ul>
+
+ <!-- Google CSE Search Box Begins -->
+ <div style="float: right; position: relative; ">
+
+ <!--
+ <form action="http://www.google.com/cse" id="cse-search-box" _lpchecked="1">
+ <div>
+ <input type="hidden" name="cx" value="012614087480249044419:dn-q5gtwxya">
+ <input type="hidden" name="ie" value="UTF-8">
+ <input type="text" name="q" placeholder="Search" size="31" style="border: 1px solid rgb(126, 157, 185); padding: 2px; background-color: rgb(255, 255, 255); background-position: 0% 50%; background-repeat: no-repeat no-repeat;">
+ <input type="submit" name="sa" value="Search">
+ </div>
+ <input name="siteurl" type="hidden" value="isis.apache.org">
+ <input name="ref" type="hidden" value="">
+ <input name="ss" type="hidden" value="677j458329j2">
+ </form>
+ -->
+
+ <FORM class="pull-right" id="searchbox_012614087480249044419:dn-q5gtwxya" action="http://www.google.com/cse">
+ <input type="hidden" name="cx" value="012614087480249044419:dn-q5gtwxya">
+ <INPUT type="hidden" name="cof" value="FORID:0">
+ <INPUT name="q" type="text" placeholder="Search">
+ </FORM>
+
+ </div>
+ <!-- Google CSE Search Box Ends -->
+
+ </div>
+ </div>
+ </div>
+
+ <div class="container">
+ <div class="markdown-content">
+
+
+<div class="page-header">
+<p><a href="./../../documentation.html">Docs</a> » <a href="./../../applib-guide/about.html">Applib Guide</a> » <a href="./../../applib-guide/how-tos/about.html">How Tos</a></p>
+<h1>
+
+</h1>
+</div>
+
+<h2>How to specify conditional choices for action parameters</h2>
+
+<p>Sometimes there is a dependency between the value of one parameter and the set of values to another. For example, if selecting a particular category, then this implies a set of subcategories belonging to that category. Or, if selecting a particular country, then this implies a set of states/counties within that country.</p>
+
+<p>To specify such a dependency, the <code>choicesNActionName()</code> can be overloaded with the <code>N-1</code> preceding parameters. </p>
+
+<p>The syntax is:</p>
+
+<pre><code>public Collection<ParameterType> choicesNActionName(arg0, arg1, ..., argN-1)
+</code></pre>
+
+<p>where N indicates the 0-based parameter number. Any subtype of <code>Collection</code> may also be used.</p>
+
+<p>For example:</p>
+
+<pre><code>public class Book {
+ public void categorize(
+ Genre genre,
+ Subgenre subgenre) {
+ ...
+ }
+ public Collection<Subgenre> choices1Categorize(Genre genre) {
+ return genre.getSubgenres();
+ }
+ ....
+}
+</code></pre>
+
+<blockquote>
+ <p>NOTE: at this writing this capability does not exist for properties that have dependencies. Instead, make the properties read-only (using <code>@Disabled</code>) and provide an action to update them instead. </p>
+</blockquote>
+
+
+
+ </div>
+
+ <div id="edit" class="modal hide fade in" style="display: none; ">
+ <div class="modal-header">
+ <a class="close" data-dismiss="modal">x</a>
+
+ <h3>Thank you for contributing to the documention!</h3>
+ </div>
+ <div class="modal-body">
+ <h4>Any help with the documentation is greatly appreciated.</h4>
+ <p>All edits are reviewed before going live, so feel free to do much more than fix typos or links. If you see a page that could benefit from an entire rewrite, we'd be thrilled to review it. Don't be surprised if we like it so much we ask you for help with other pages :)</p>
+ <small>NOTICE: unless indicated otherwise on the pages in question, all editable content available from apache.org is presumed to be licensed under the Apache License (AL) version 2.0 and hence all submissions to apache.org treated as formal Contributions under the license terms.</small>
+ <!--[if gt IE 6]>
+ <h4>Internet Explorer Users</h4>
+ <p>If you are not an Apache committer, click the Yes link and enter a <i>anonymous</i> for the username and leave the password empty</p>
+ <![endif]-->
+
+ </div>
+ <div class="modal-footer">
+ Do you have an Apache ID?
+ <a href="javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))" class="btn">Yes</a>
+ <a href="javascript:void(location.href='https://anonymous:@cms.apache.org/redirect?uri='+escape(location.href))" class="btn">No</a>
+ </div>
+ </div>
+ <script src="./../../javascript/bootstrap-modal.js"></script>
+
+ <footer>
+ <p>
+ Copyright © 2012~2013 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.
+ <br/>
+ Apache Isis, Isis, Apache, the Apache feather logo, and the Apache Isis project logo are trademarks of The Apache Software Foundation.
+ </p>
+ </footer>
+
+ </div> <!-- /container -->
+
+ </body>
+</html>