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/07/25 17:58:03 UTC
svn commit: r871169 - in /websites/staging/isis/trunk: cgi-bin/ content/
content/core/about.html content/core/dynamic-layouts.html
content/core/services/about.html
content/core/services/developer-utilities-service.html
content/documentation.html
Author: buildbot
Date: Thu Jul 25 15:58:03 2013
New Revision: 871169
Log:
Staging update by buildbot for isis
Added:
websites/staging/isis/trunk/content/core/dynamic-layouts.html
websites/staging/isis/trunk/content/core/services/developer-utilities-service.html
Modified:
websites/staging/isis/trunk/cgi-bin/ (props changed)
websites/staging/isis/trunk/content/ (props changed)
websites/staging/isis/trunk/content/core/about.html
websites/staging/isis/trunk/content/core/services/about.html
websites/staging/isis/trunk/content/documentation.html
Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jul 25 15:58:03 2013
@@ -1 +1 @@
-1506860
+1507034
Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Jul 25 15:58:03 2013
@@ -1 +1 @@
-1506860
+1507034
Modified: websites/staging/isis/trunk/content/core/about.html
==============================================================================
--- websites/staging/isis/trunk/content/core/about.html (original)
+++ websites/staging/isis/trunk/content/core/about.html Thu Jul 25 15:58:03 2013
@@ -270,8 +270,10 @@
<li><a href="services/initializing-services.html">Initializing Services</a></li>
<li><a href="services/auditing-service.html">Auditing Service</a></li>
<li><a href="services/bookmark-service.html">Bookmark Service</a></li>
+<li><a href="services/developer-utilities-service.html">Developer Utilities Service</a> [1.3.0-SNAPSHOT]</li>
<li><a href="services/exception-recognizers.html">Exception Recognizers</a></li>
<li><a href="services/publishing-service.html">Publishing Service</a></li>
+<li><a href="services/settings-services.html">Settings Services</a> [1.3.0-SNAPSHOT]</li>
</ul>
<h3>Development</h3>
Added: websites/staging/isis/trunk/content/core/dynamic-layouts.html
==============================================================================
--- websites/staging/isis/trunk/content/core/dynamic-layouts.html (added)
+++ websites/staging/isis/trunk/content/core/dynamic-layouts.html Thu Jul 25 15:58:03 2013
@@ -0,0 +1,480 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+
+ <meta charset="utf-8">
+ <title>Dynamic Layouts
</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=Dynamic Layouts
",
+ '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="./../core/about.html">Core</a></p>
+<h1>Dynamic Layouts
+
+</h1>
+</div>
+
+<p>Because Isis implements the <a href="http://en.wikipedia.org/wiki/Naked_objects">naked objects pattern</a>, the domain objects are rendered in the UI based only metadata gleaned from the domain classes themselves.</p>
+
+<h2>Specifying layout using Annotations</h2>
+
+<h3><code>@MemberOrder</code></h3>
+
+<p>To specify the relative order of domain class properties and classes, the <code>@MemberOrder</code> annotation is used. For example:</p>
+
+<pre><code>public class ToDoItem {
+ @MemberOrder(sequence="1")
+ public String getDescription() { ... }
+
+ @MemberOrder(sequence="2")
+ public String getCategory() { ... }
+
+ @MemberOrder(sequence="3")
+ public boolean isComplete() { ... }
+
+ @MemberOrder(name="Detail", sequence="1")
+ public LocalDate getDueBy() { ... }
+
+ @MemberOrder(name="Detail", sequence="2")
+ public BigDecimal getCost() { ... }
+
+ @MemberOrder(name="Detail", sequence="4")
+ public String getNotes() { ... }
+
+ @MemberOrder(name="Misc", sequence="99")
+ public Long getVersionSequence() { ... }
+
+ ...
+
+}
+</code></pre>
+
+<p>defines three property (or member) groups, "General", "Detail" and "Misc"; "General" is the default if no <code>name</code> attribute is specified. Properties in the same member group are rendered together, as a fieldset. </p>
+
+<p>In addition, actions can optionally be associated (rendered close to) either properties or actions. This is done by overloading the <code>@MemberOrder</code>'s <code>name</code> attribute, holding the value of the property or collection.</p>
+
+<p>For example:</p>
+
+<pre><code>public class ToDoItem {
+
+ @MemberOrder(sequence="3")
+ public boolean isComplete() { ... }
+
+ @MemberOrder(sequence="1")
+ public SortedSet<ToDoItem> getDependencies() { ... }
+
+
+ @MemberOrder(name="complete", sequence="1")
+ public ToDoItem completed() { ...}
+
+ @MemberOrder(name="complete", sequence="2")
+ public ToDoItem notYetCompleted() { ...}
+
+
+ @MemberOrder(name="dependencies", sequence="1")
+ public ToDoItem add(ToDoItem t) { ...}
+
+ @MemberOrder(name="dependencies", sequence="2")
+ public ToDoItem remove(ToDoItem t) { ...}
+
+}
+</code></pre>
+
+<p>will associate the <code>completed()</code> and <code>notYetCompleted()</code> actions with the <code>complete</code> property, and will associate the <code>add()</code> and <code>remove()</code> actions with the <code>dependencies</code> collection.</p>
+
+<p>If the <code>name</code> attribute is omitted, then the action is rendered near the header.</p>
+
+<p>Finally, note that the <code>@MemberOrder</code>'s <code>name</code> attribute has no meaning for collections.</p>
+
+<h3><code>@MemberGroupLayout</code></h3>
+
+<p>The <code>@MemberGroupLayout</code> annotation specifies the relative positioning of property groups as being either in a left column, a middle column or in a right column. It also specifies the relative width: </p>
+
+<pre><code>@MemberGroupLayout(
+ columnSpans={3,3,0,6}, left={"General", "Misc"}, middle="Detail")
+public class ToDoItem {
+ ...
+}
+</code></pre>
+
+<p>Four values are given in the <code>columnSpans</code> attribute. The first three are the relative widths of the three columns of property groups. The fourth, meanwhile, indicates the width of a final column that holds all the collections of the object.</p>
+
+<p>The values of these spans are taken as proportions of 12 virtual columns across the page (this taken from the <a href="http://twitter.github.io/bootstrap/">Bootstrap</a> library).</p>
+
+<p>For example:</p>
+
+<ul>
+<li><code>{3,3,0,6}</code> indicates:
+<ul>
+<li>a left column of properties taking up 25% of the width</li>
+<li>a middle column of properties taking up 25% of the width</li>
+<li>a right column of collections taking up 50% of the width</li>
+</ul></li>
+<li><code>{2,6,0,4}</code> indicates:
+<ul>
+<li>a left column of properties taking up ~16% of the width</li>
+<li>a middle column of properties taking up 50% of the width</li>
+<li>a right column of collections taking up ~33% of the width</li>
+</ul></li>
+<li><code>{2,3,3,4}</code> indicates:
+<ul>
+<li>a left column of properties taking up ~16% of the width</li>
+<li>a middle column of properties taking up 25% of the width</li>
+<li>a right column of properties taking up 25% of the width</li>
+<li>a far right column of collections taking up ~33% of the width</li>
+</ul></li>
+</ul>
+
+<p>If the sum of all the columns exceeds 12, then the collections are placed underneath the properties, taking up the full span. For example:</p>
+
+<ul>
+<li>{4,4,4,12} indicates:
+<ul>
+<li>a left column of properties taking up ~33% of the width</li>
+<li>a middle column of properties taking up ~33% of the width</li>
+<li>a right column of properties taking up ~33% of the width</li>
+<li>the collections underneath the property columns, taking up the full width</li>
+</ul></li>
+</ul>
+
+<h2>Dynamic Layouts</h2>
+
+<p>While the use of annotations to specify layout metadata is typesafe, it does have the disadvantage that changing the layout means recompiling the code and redeploying.</p>
+
+<p>So, instead, the layout metadata can be specified using a JSON layout file. The <a href="services/developer-utilities-service.html"><code>DeveloperUtilitiesService</code></a> can then be used to refresh the layout (rebuilding the metamodel for the domain class in question).</p>
+
+<p>The JSON layout file takes the name <code>Xxx.layout.json</code>, where <code>Xxx</code> is the class name, and resides in the same package as the class. For example, the layout for the <a href="https://github.com/apache/isis/blob/f38fdb92941172eabb12e0943509f239e6d5925f/example/application/quickstart_wicket_restful_jdo/dom/src/main/java/dom/todo/ToDoItem.java"><code>ToDoItem</code></a> class is <a href="https://github.com/apache/isis/blob/f38fdb92941172eabb12e0943509f239e6d5925f/example/application/quickstart_wicket_restful_jdo/dom/src/main/java/dom/todo/ToDoItem.layout.json"><code>ToDoItem.layout.json</code></a> </p>
+
+<p>The format of the <code>.layout.json</code> file is:</p>
+
+<pre><code>{
+ columns: [ // list of columns
+ {
+ span: 6, // span of the left-hand property column
+ memberGroups: { // ordered map of member (property) groups
+ General: { // member group name
+ members: {
+ description: {}, // property, no associated actions
+ category: {},
+ complete: { // property, with associated actions
+ actions: {
+ completed: {}, // associated actions
+ notYetCompleted: {}
+ }
+ }
+ }
+ },
+ Misc: {
+ members: {
+ versionSequence: {}
+ }
+ }
+ }
+ },
+ {
+ span: 6, // span of the middle property column
+ memberGroups: { ... }
+ },
+ {
+ span: 0 // span of the right property column (if any)
+ },
+ {
+ span: 6,
+ collections: { // ordered map of collections
+ dependencies: { // collection, with associated actions
+ actions: {
+ add:{},
+ delete: {}
+ }
+ },
+ similarItems: {} // collection, no associated actions
+ }
+ }
+ ],
+ actions: { // actions not associated with any member
+ delete: {},
+ duplicate: {}
+ }
+}
+</code></pre>
+
+<p>Although advisable, it is not necessary to list all class members in this file. Any members not listed with be ordered according either to annotations (if present) or fallback/default values.</p>
+
+
+
+ </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>
Modified: websites/staging/isis/trunk/content/core/services/about.html
==============================================================================
--- websites/staging/isis/trunk/content/core/services/about.html (original)
+++ websites/staging/isis/trunk/content/core/services/about.html Thu Jul 25 15:58:03 2013
@@ -258,6 +258,7 @@
<li><a href="initializing-services.html">Initializing Services</a></li>
<li><a href="auditing-service.html">Auditing Service</a></li>
<li><a href="bookmark-service.html">Bookmark Service</a></li>
+<li><a href="developer-utilities-service.html">Developer Utilities Service</a> [1.3.0-SNAPSHOT]</li>
<li><a href="exception-recognizers.html">Exception Recognizers</a></li>
<li><a href="publishing-service.html">Publishing Service</a></li>
<li><a href="settings-services.html">Settings Services</a> [1.3.0-SNAPSHOT]</li>
Added: websites/staging/isis/trunk/content/core/services/developer-utilities-service.html
==============================================================================
--- websites/staging/isis/trunk/content/core/services/developer-utilities-service.html (added)
+++ websites/staging/isis/trunk/content/core/services/developer-utilities-service.html Thu Jul 25 15:58:03 2013
@@ -0,0 +1,323 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+
+ <meta charset="utf-8">
+ <title>Developer Utilities Service</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=Developer Utilities Service",
+ '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="./../../core/about.html">Core</a> » <a href="./../../core/services/about.html">Services</a></p>
+<h1>Developer Utilities Service
+
+</h1>
+</div>
+
+<p>The <code>DeveloperUtilitiesService</code> service is intended to make the developer's job easier in a number of aspects:</p>
+
+<ul>
+<li>using the <code>downloadMetaModel()</code> action, the developer can download a CSV spreadsheet of the Isis metamodel.</p>
+
+<p>This allows the developer to review the metadata that has Isis has captured about each domain type: for example whether a business rule (hide/disable/validate) has been implemented for each member (also indicating the implementation) </li>
+<li>using the <code>downloadLayouts()</code> action, the developer can download a ZIP file of <code>Xxx.layout.json</code> files for each domain type in the Isis metamodel. </p>
+
+<p>This is useful if converting a domain model to use <a href="../dynamic-layouts.html">dynamic layouts</a>.</li>
+<li>using the <code>downloadLayout()</code> contributed action, the developer can download the <code>Xxx.layout.json</code> for an individual object</li>
+<li>using the <code>refreshLayout()</code> contributed action, the developer can reload the current object. The metamodel will be rebuilt and the object's layout may change accordingly.</p>
+
+<blockquote>
+ <p>(If using the <a href="../../components/viewers/wicket/about.html">Wicket viewer</a>) it is necessary to invoke <code>refreshLayout()</code> <em>twice</em>. This is to do with the relationship between the point at which the metamodel being invalidated, and the point the Wicket viewer builds up its UI.</p>
+</blockquote></li>
+</ul>
+
+<p>All of the above actions are annotated as <code>@Prototype</code>; they will therefore not appear in a running production application.</p>
+
+<h3>Register the Service</h3>
+
+<p>The service is registered, like any other, in <code>isis.properties</code>:</p>
+
+<pre>
+isis.services=<i>...other services...</i>,\
+ org.apache.isis.core.metamodel.services.devutils.DeveloperUtilitiesServiceDefault,\
+ ...
+</pre>
+
+
+
+ </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>
Modified: websites/staging/isis/trunk/content/documentation.html
==============================================================================
--- websites/staging/isis/trunk/content/documentation.html (original)
+++ websites/staging/isis/trunk/content/documentation.html Thu Jul 25 15:58:03 2013
@@ -328,13 +328,15 @@
<li><a href="core/services/initializing-services.html">Initializing Services</a></li>
<li><a href="core/services/auditing-service.html">Auditing Service</a></li>
<li><a href="core/services/bookmark-service.html">Bookmark Service</a></li>
+<li><a href="core/services/developer-utilities-service.html">Developer Utilities Service</a> [1.3.0-SNAPSHOT]</li>
<li><a href="core/services/exception-recognizers.html">Exception Recognizers</a></li>
<li><a href="core/services/publishing-service.html">Publishing Service</a></li>
-<li><a href="core/services/settings-services.html">Settings Services</a> [1.3.0-SNAPSHOT]
-</div>
-<div class="span-one-third"></li>
+<li><a href="core/services/settings-services.html">Settings Services</a> [1.3.0-SNAPSHOT]</li>
</ul>
+<p></div>
+<div class="span-one-third"></p>
+
<h3>Dev Support</h3>
<ul>