Modified: isis/site/trunk/content/how-tos/how-to-01-070-How-to-specify-the-icon-for-a-domain-entity.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/how-tos/how-to-01-070-How-to-specify-the-icon-for-a-domain-entity.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/how-tos/how-to-01-070-How-to-specify-the-icon-for-a-domain-entity.md (original) +++ isis/site/trunk/content/how-tos/how-to-01-070-How-to-specify-the-icon-for-a-domain-entity.md Mon Feb 23 22:40:08 2015 @@ -9,7 +9,7 @@ In the [Wicket viewer](../components/vie * if the icon is dynamically specified, then it attempts to load an image file (`.png`, `.gif` or `.jpg`) from a well-known location on the classpath; else -* (1.8.0-SNAPSHOT onwards) if the icon is statically specified, then it: +* (1.8.0 onwards) if the icon is statically specified, then it: * first attempts to load a [font awesome](http://fortawesome.github.io/Font-Awesome/) icon if defined; else * otherwise attempts to load an image file (`.png`, `.gif`, `.jpeg` or `.jpg`) from a well-known location on the classpath @@ -30,7 +30,7 @@ For example, to indicate that a `com.myc If the method returns "complete", then the viewer will look for an icon file on the classpath as follows: -* first, it will search in the same package as the domain class (1.8.0-SNAPSHOT): +* first, it will search in the same package as the domain class (1.8.0): * com/mycompany/todoapp/dom/TodoItem-complete.png * com/mycompany/todoapp/dom/TodoItem-complete.gif @@ -46,7 +46,7 @@ If the method returns "complete", then t The viewer stops searching as soon as a image file is found. -## Statically-specified font awesome icon (1.8.0-SNAPSHOT) +## Statically-specified font awesome icon (1.8.0) If a dynamic icon has not been specified, then the viewer will next attempt to load a [font awesome](http://fortawesome.github.io/Font-Awesome/) icon. @@ -63,7 +63,7 @@ If neither an `iconName()` nor an `@CssC For example, a `com.mycompany.todoapp.dom.TodoItem` object will search: -* first, in the same package as the domain class (1.8.0-SNAPSHOT): +* first, in the same package as the domain class (1.8.0): * com/mycompany/todoapp/dom/TodoItem.png * com/mycompany/todoapp/dom/TodoItem.gif
Modified: isis/site/trunk/content/how-tos/how-to-01-140-How-to-specify-names-or-descriptions-for-an-action-parameter.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/how-tos/how-to-01-140-How-to-specify-names-or-descriptions-for-an-action-parameter.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/how-tos/how-to-01-140-How-to-specify-names-or-descriptions-for-an-action-parameter.md (original) +++ isis/site/trunk/content/how-tos/how-to-01-140-How-to-specify-names-or-descriptions-for-an-action-parameter.md Mon Feb 23 22:40:08 2015 @@ -7,13 +7,13 @@ will be labelled only with the type of t 'String:' or 'Customer:) If you want a parameter to have a different name (as is usually the case for value types such as strings and ints) -then that parameter should be annotated with the `@Named` annotation (prior to 1.8.0-SNAPSHOT) or its replacement, -the `@ParameterLayout(named=...)` annotation (as of 1.8.0-SNAPSHOT). +then that parameter should be annotated with the `@Named` annotation (prior to 1.8.0) or its replacement, +the `@ParameterLayout(named=...)` annotation (as of 1.8.0). Similarly, any parameter may be given a short user-description using the -`@DescribedAs` annotation (prior to 1.8.0-SNAPSHOT) or its replacement, `@ParameterLayout(describedAs=...)`. +`@DescribedAs` annotation (prior to 1.8.0) or its replacement, `@ParameterLayout(describedAs=...)`. -For example (as of 1.8.0-SNAPSHOT): +For example (as of 1.8.0): public class Customer { public Order placeOrder( @@ -28,7 +28,7 @@ For example (as of 1.8.0-SNAPSHOT): ... } -or (prior to 1.8.0-SNAPSHOT): +or (prior to 1.8.0): public class Customer { public Order placeOrder( Modified: isis/site/trunk/content/how-tos/how-to-customize-styling-for-a-domain-object.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/how-tos/how-to-customize-styling-for-a-domain-object.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/how-tos/how-to-customize-styling-for-a-domain-object.md (original) +++ isis/site/trunk/content/how-tos/how-to-customize-styling-for-a-domain-object.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -title: How to customize the styling of a domain object (1.8.0-SNAPSHOT) +title: How to customize the styling of a domain object (1.8.0) The [Wicket viewer](../components/viewers/wicket/about.html) will query each object when being rendered to determine if any instance-specific CSS class name should be used to wrap the HTML representing that domain object. Modified: isis/site/trunk/content/intro/getting-started/simpleapp-archetype.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/intro/getting-started/simpleapp-archetype.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/intro/getting-started/simpleapp-archetype.md (original) +++ isis/site/trunk/content/intro/getting-started/simpleapp-archetype.md Mon Feb 23 22:40:08 2015 @@ -11,7 +11,7 @@ Then run the following command: mvn archetype:generate \ -D archetypeGroupId=org.apache.isis.archetype \ -D archetypeArtifactId=simpleapp-archetype \ - -D archetypeVersion=1.7.0 \ + -D archetypeVersion=1.8.0 \ -D groupId=com.mycompany \ -D artifactId=myapp \ -D version=1.0-SNAPSHOT \ @@ -34,7 +34,7 @@ The process is almost identical to that mvn archetype:generate \ -D archetypeGroupId=org.apache.isis.archetype \ -D archetypeArtifactId=simpleapp-archetype \ - -D archetypeVersion=1.8.0-SNAPSHOT \ + -D archetypeVersion=1.9.0-SNAPSHOT \ -D groupId=com.mycompany \ -D artifactId=myapp \ -D version=1.0-SNAPSHOT \ Modified: isis/site/trunk/content/intro/getting-started/todoapp-archetype.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/intro/getting-started/todoapp-archetype.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/intro/getting-started/todoapp-archetype.md (original) +++ isis/site/trunk/content/intro/getting-started/todoapp-archetype.md Mon Feb 23 22:40:08 2015 @@ -1,164 +1,4 @@ Title: TodoApp Archetype -> as of 1.8.0-SNAPSHOT the todoapp is no longer released; the example app has instead moved to [Isis addons](https://github.com/isisaddons/isis-app-todoapp) (not ASF). This allows us to provide a more fully-fledged example that integrates with other Isis addons modules. +> as of 1.8.0 the todoapp is no longer released; the example app has instead moved to [Isis addons](https://github.com/isisaddons/isis-app-todoapp) (not ASF). This allows us to provide a more fully-fledged example that integrates with other Isis addons modules. -<hr/> - -The TodoApp archetype will generate a reasonably complete application for tracking to-do items, based around a single domain class `ToDoItem` and repository, `ToDoItems`. - -While not quite a "kitchen-sink" example (there is, after all, just a single domain class), the app nevertheless demonstrates a good number of Isis' capabilities. In particular, the use of contributed actions etc is demonstrated by `ToDoItemContributions`; view models are demonstrated by `ToDoItemsByCategoryViewModel` and `ToDoItemsByDateRangeViewModel`; a dashboard is demonstrated by `ToDoAppDashboard`. - -The archetype also demonstrates Isis' support for in-built profiling, auditing, event publishing and background actions. The last of these integrates with the Quartz scheduler, executing queued-up actions every 10 seconds. - -Running this archetype is a good way to get familiar with the structure of a not-too-complex Isis application. However, to get started with your own application, we generally recommend that you run the alternative [simple archetype](./simple-archetype.html). This will generate a completely stripped back and minimal application for you to refactor and extend; you can then use this ToDo app to guide your own development. - -## <a name="screencast"></a>Screencasts - -#### How to use the TodoApp archetype... - -How to use the Apache Isis TodoApp archetype to generate your first Apache Isis application. - -<i>nb: previously the TodoApp archetype was called the 'quickstart archetype', which is how it is referred to in the screencast)</i> - -<iframe width="420" height="315" src="http://www.youtube.com/embed/RH6J4gx8OoA" frameborder="0" allowfullscreen></iframe> - -#### ... and what it generates - -A run-through of the main features of the todo application generated by the Apache Isis TodoApp archetype (as of v1.4.0). - -<i>nb: previously the TodoApp archetype was called the 'quickstart archetype', which is how it is referred to in the screencast)</i> - -<iframe width="560" height="315" src="//www.youtube.com/embed/2leQwavWxeg" frameborder="0" allowfullscreen></iframe> - -An earlier screencast, relating to v1.2.0, is available [here](https://www.youtube.com/watch?v=1_vc01LIBUU).> - -### Generating the App (stable release) - -Create a new directory, and `cd` into that directory. - -Then run the following command: - - mvn archetype:generate \ - -D archetypeGroupId=org.apache.isis.archetype \ - -D archetypeArtifactId=todoapp-archetype \ - -D archetypeVersion=1.7.0 \ - -D groupId=com.mycompany \ - -D artifactId=myapp \ - -D version=1.0-SNAPSHOT \ - -B - -where: - -- `groupId` represents your own organization, and -- `artifactId` is a unique identifier for this app within your organization. -- `version` is the initial (snapshot) version of your app. - -The archetype generation process will then run; it only takes a few seconds. - - -## Generating the App (snapshot release) - -We also maintain the archetype for the most current `-SNAPSHOT`; an app generated with this archetype will contain the latest features of Isis, but the usual caveats apply: some features still in development may be unstable. - -The process is almost identical to that for stable releases, however the `archetype:generate` goal is called with slightly different arguments: - - mvn archetype:generate \ - -D archetypeGroupId=org.apache.isis.archetype \ - -D archetypeArtifactId=todoapp-archetype \ - -D archetypeVersion=1.8.0-SNAPSHOT \ - -D groupId=com.mycompany \ - -D artifactId=myapp \ - -D version=1.0-SNAPSHOT \ - -D archetypeRepository=http://repository-estatio.forge.cloudbees.com/snapshot/ \ - -B - -where as before: - -- `groupId` represents your own organization, and -- `artifactId` is a unique identifier for this app within your organization. -- `version` is the initial (snapshot) version of your app - -but also: - -- `archetypeVersion` is the SNAPSHOT version of Isis. -- `archetypeRepository` specifies the location of our snapshot repo (hosted on [CloudBees](http://www.cloudbees.com)), and - -The archetype generation process will then run; it only takes a few seconds. - - -## Building the App - -Switch into the root directory of your newly generated app, and build your app: - - cd myapp - mvn clean install - -where `myapp` is the `artifactId` entered above. - -## Running the App - -The `todoapp` archetype generates a single WAR file, configured to run both the [Wicket viewer](../../components/viewers/wicket/about.html) and the [Restful Objects viewer](../../components/viewers/wicket/about.html). The archetype also configures the [JDO Objectstore](../../components/objectstores/jdo/about.html) to use an in-memory HSQLDB connection. - -Once you've built the app, you can run the WAR in a variety of ways. - -The recommended approach when getting started is to run the self-hosting version of the WAR, allowing Isis to run as a standalone app; for example: - - java -jar webapp/target/myapp-webapp-1.0-SNAPSHOT-jetty-console.jar - -This can also be accomplished using an embedded Ant target provided in the build script: - - mvn -P self-host antrun:run - -> prior to v1.5.0, this was simply: mvn antrun:run - -The first is to simply deploying the generated WAR (`webapp/target/myapp-webapp-1.0-SNAPSHOT.war`) to a servlet container. - -Alternatively, you could run the WAR in a Maven-hosted Jetty instance, though you need to `cd` into the `webapp` module: - - cd webapp - mvn jetty:run -D jetty.port=9090 - -In the above, we've passed in a property to indicate a different port from the default port (8080). - -Note that if you use `mvn jetty:run`, then the context path changes; check the console output (eg [http://localhost:9090/myapp-webapp](http://localhost:9090/myapp-webapp)). - -Finally, you can also run the app by deploying to a standalone servlet container such as [Tomcat](http://tomcat.apache.org). - -## Running the App with Fixtures (1.7.0) - -It is also possible to start the application with a pre-defined set of data; useful for demos or manual exploratory -testing. This is done by specifying a _fixture script_ on the command line: - - java -jar webapp/target/myapp-webapp-1.0-SNAPSHOT-jetty-console.jar \ - --initParam isis.persistor.datanucleus.install-fixtures=true \ - --initParam isis.fixtures=fixture.todo.scenarios.RecreateToDoItemsAndCompleteSeveralForCurrent - -where (in the above example) `fixture.todo.scenarios.RecreateToDoItemsAndCompleteSeveralForCurrent` is the fully -qualified class name of the fixture script to be run. - -## Using the App - -The archetype provides a welcome page that explains the classes and files generated, and provides detailed guidance and what to do next. - -The app itself is configured to run using shiro security, as configured in the `WEB-INF/shiro.ini` config file. To log in, use `sven/pass`. - -## Modifying the App - -Once you are familiar with the generated app, you'll want to start modifying it. There is plenty of guidance on this site; check out the 'programming model how-tos' section on the main [documentation](../../documentation.html) page first). - -If you use Eclipse, do also install the [Eclipse templates](../resources/editor-templates.html); these will help you follow the Isis naming conventions. - -## App Structure - -As noted above, the generated app is a reasonably complete application for tracking to-do items. It consists of the following modules: - -<table class="table table-striped table-bordered table-condensed"> -<tr><th>Module</th><th>Description</th></tr> -<tr><td>myapp</td><td>The parent (aggregator) module</td></tr> -<tr><td>myapp-dom</td><td>The domain object model, consisting of <tt>ToDoItem</tt> and <tt>ToDoItems</tt> (repository) domain service.</td></tr> -<tr><td>myapp-fixture</td><td>Domain object fixtures used for initializing the system when being demo'ed or for unit testing.</td></tr> -<tr><td>myapp-integtests</td><td>End-to-end <a href="../../core/integtestsupport.html">integration tests</a>, that exercise from the UI through to the database</td></tr> -<tr><td>myapp-webapp</td><td>Run as a webapp (from <tt>web.xml</tt>) using either the Wicket viewer or the RestfulObjects viewer</td></tr> -</table> - -If you run into issues, please don't hesitate to ask for help on the [users mailing list](../../support.html). Modified: isis/site/trunk/content/intro/tutorials/apacheconeu-2014.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/intro/tutorials/apacheconeu-2014.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/intro/tutorials/apacheconeu-2014.md (original) +++ isis/site/trunk/content/intro/tutorials/apacheconeu-2014.md Mon Feb 23 22:40:08 2015 @@ -22,12 +22,12 @@ You'll need: ## Run the archetype -As per the [Isis website](http://isis.apache.org/intro/getting-started/simpleapp-archetype.html), run the simpleapp archetype to build an empty Isis application. We recommend you use the snapshot release: +As per the [Isis website](http://isis.apache.org/intro/getting-started/simpleapp-archetype.html), run the simpleapp archetype to build an empty Isis application: mvn archetype:generate \ -D archetypeGroupId=org.apache.isis.archetype \ -D archetypeArtifactId=simpleapp-archetype \ - -D archetypeVersion=1.8.0-SNAPSHOT \ + -D archetypeVersion=1.8.0 \ -D groupId=com.mycompany \ -D artifactId=myapp \ -D version=1.0-SNAPSHOT \ @@ -346,7 +346,7 @@ The Wicket UI doesn't allow collections ## CSS UI Hints -(In 1.8.0-SNAPSHOT), CSS classes can be associated with any class member (property, collection, action). But for actions in particular: +(In 1.8.0), CSS classes can be associated with any class member (property, collection, action). But for actions in particular: - the bootstrap "btn" CSS classes can be used using [@CssClass](http://isis.apache.org/reference/recognized-annotations/CssClass.html) annotation - the [Font Awesome](http://fortawesome.github.io/Font-Awesome/icons/) icons can be used using the [@CssClassFa](http://isis.apache.org/reference/recognized-annotations/CssClassFa-deprecated.html) annotation @@ -485,7 +485,7 @@ Using the guidance in [these docs](http: * Bulk actions (and the ScratchPad) -Bulk actions are actions that can be invoked on a collection of actions, that is on collections returned by invoking an action. Actions are specified as being bulk actions using the [@Bulk](http://isis.apache.org/reference/recognized-annotations/Bulk.html) annotation. Note that currently (1.8.0-SNAPSHOT) only no-arg actions can be specified as bulk actions. +Bulk actions are actions that can be invoked on a collection of actions, that is on collections returned by invoking an action. Actions are specified as being bulk actions using the [@Bulk](http://isis.apache.org/reference/recognized-annotations/Bulk.html) annotation. Note that currently (1.8.0) only no-arg actions can be specified as bulk actions. * Write a no-arg action for your domain entity, annotate with `@Bulk` * Inject the [Bulk.InteractionContext](http://isis.apache.org/reference/services/bulk-interaction.html) (request-scoped) service @@ -615,7 +615,7 @@ Isis has great support for writing [inte ## Customising the REST API -The REST API generated by Isis conforms to the Restful Objects specification. Isis 1.8.0-SNAPSHOT provides experimental support to allow the representations to be customized. +The REST API generated by Isis conforms to the Restful Objects specification. Isis 1.8.0 provides experimental support to allow the representations to be customized. * as per [these docs](http://isis.apache.org/components/viewers/restfulobjects/simplified-object-representation.html), configure the Restful Objects viewer to generate a simplified object representation: Modified: isis/site/trunk/content/intro/tutorials/screencasts.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/intro/tutorials/screencasts.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/intro/tutorials/screencasts.md (original) +++ isis/site/trunk/content/intro/tutorials/screencasts.md Mon Feb 23 22:40:08 2015 @@ -24,7 +24,7 @@ We've prepared some screencasts to help <br/><br/> Learn how to generate this app <a href="../getting-started/todoapp-archetype.html#screencast">here</a> <br/><br/> - <i>nb: the todoapp has (in 1.8.0-SNAPSHOT) moved to <a href="https://github.com/isisaddons/isis-app-todoapp">Isis addons</a> (not ASF).</i> + <i>nb: the todoapp has (in 1.8.0) moved to <a href="https://github.com/isisaddons/isis-app-todoapp">Isis addons</a> (not ASF).</i> <br/><br/> <i>nb: the todoapp was previously called the 'quickstart' app</i> </td> @@ -37,7 +37,7 @@ We've prepared some screencasts to help <br/><br/> Learn how to use the <a href="../getting-started/todoapp-archetype.html#screencast">quickstart archetype</a> here <br/><br/> - <i>nb: the todoapp has (in 1.8.0-SNAPSHOT) moved to <a href="https://github.com/isisaddons/isis-app-todoapp">Isis addons</a> (not ASF).</i> + <i>nb: the todoapp has (in 1.8.0) moved to <a href="https://github.com/isisaddons/isis-app-todoapp">Isis addons</a> (not ASF).</i> <br/><br/> <i>nb: the todoapp was previously called the 'quickstart' app</i> </td> Modified: isis/site/trunk/content/intro/tutorials/step-by-step-petclinic.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/intro/tutorials/step-by-step-petclinic.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/intro/tutorials/step-by-step-petclinic.md (original) +++ isis/site/trunk/content/intro/tutorials/step-by-step-petclinic.md Mon Feb 23 22:40:08 2015 @@ -45,12 +45,12 @@ You'll need: git checkout [249abe476797438d83faa12ff88365da2c362451](https://github.com/danhaywood/isis-app-petclinic/commit/249abe476797438d83faa12ff88365da2c362451) } -As per the [Isis website](http://isis.apache.org/intro/getting-started/simpleapp-archetype.html), run the simpleapp archetype to build an empty Isis application. We recommend you use the snapshot release: +As per the [Isis website](http://isis.apache.org/intro/getting-started/simpleapp-archetype.html), run the simpleapp archetype to build an empty Isis application: mvn archetype:generate \ -D archetypeGroupId=org.apache.isis.archetype \ -D archetypeArtifactId=simpleapp-archetype \ - -D archetypeVersion=1.8.0-SNAPSHOT \ + -D archetypeVersion=1.8.0 \ -D groupId=com.mycompany \ -D artifactId=petclinic \ -D version=1.0-SNAPSHOT \ Modified: isis/site/trunk/content/more-advanced-topics/Fixture-Scripts.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/Fixture-Scripts.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/more-advanced-topics/Fixture-Scripts.md (original) +++ isis/site/trunk/content/more-advanced-topics/Fixture-Scripts.md Mon Feb 23 22:40:08 2015 @@ -129,7 +129,7 @@ implementation of the `execute(Execution The `ExecutionContext` provides three main capabilities to the fixture script: -* the script can execute other child fixture scripts (eg a scenario script calling an action script) (1.8.0-SNAPSHOT) +* the script can execute other child fixture scripts (eg a scenario script calling an action script) (1.8.0) <pre> executionContext.executeChild(this, someObject); @@ -145,7 +145,7 @@ The `ExecutionContext` provides three ma executionContext.addResult(this, someObject); </pre> -> Prior to 1.8.0-SNAPSHOT, child fixture scripts were executed using the inherited `FixtureScript#executeChild(FixtureScript, ExecutionContext)` method. That has now been deprecated). +> Prior to 1.8.0, child fixture scripts were executed using the inherited `FixtureScript#executeChild(FixtureScript, ExecutionContext)` method. That has now been deprecated). The script can do whatever is necessary within its `execute` method to set up the state of the system (read: insert data into the database). One way of doing this would be simple SQL INSERT or UPDATE statements, or calling stored procs to @@ -267,7 +267,7 @@ execution context itself, otherwise will As you can probably guess, scenario scripts should only call `defaultParam(...)`, whereas action scripts can also call `checkParam(...)` for any mandatory parameters. -### Example Usage (1.8.0-SNAPSHOT) +### Example Usage (1.8.0) The [simpleapp](../intro/getting-started/simpleapp-archetype.html) has fixtures that follow this pattern: Modified: isis/site/trunk/content/more-advanced-topics/ViewModel.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/ViewModel.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/more-advanced-topics/ViewModel.md (original) +++ isis/site/trunk/content/more-advanced-topics/ViewModel.md Mon Feb 23 22:40:08 2015 @@ -60,8 +60,8 @@ The view model's memento will be derived Only properties supported by the configured [MementoService](../reference/services/memento-service.html) can be used. The default implementation supports all the value types and persisted entities. -(As of 1.8.0-SNAPSHOT) there are some limitations: -* view models cannot reference other view models +(As of 1.8.0) there are some limitations: +* view models cannot hold collections other view models (simple properties *are* supported, though) * collections (of either view models or entities) are ignored. Modified: isis/site/trunk/content/more-advanced-topics/multi-tenancy.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/more-advanced-topics/multi-tenancy.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/more-advanced-topics/multi-tenancy.md (original) +++ isis/site/trunk/content/more-advanced-topics/multi-tenancy.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: Multi-Tenancy support (1.8.0-SNAPSHOT) +Title: Multi-Tenancy support (1.8.0) ## Theory @@ -36,7 +36,7 @@ could envisage this as a graph: Not only does all data belong to a particular node ("tenancy") within this graph, so is each user associated. -## Support within Isis (1.8.0-SNAPSHOT) +## Support within Isis (1.8.0) The Isis core framework provides the infrastructure to implement multi-tenancy, while the [Isis addons security module](https://github.com/isisaddons/isis-module-security) provides a full implementation for you to use out-of-the-box or to fork and adapt as you require. Modified: isis/site/trunk/content/reference/recognized-annotations/Action.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Action.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/Action.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/Action.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @Action (1.8.0-SNAPSHOT) +Title: @Action (1.8.0) > stub Modified: isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/ActionLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @ActionLayout (1.8.0-SNAPSHOT) +Title: @ActionLayout (1.8.0) The `@ActionLayout` annotation applies to actions, collecting together all UI hints within a single annotation. Modified: isis/site/trunk/content/reference/recognized-annotations/Collection.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Collection.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/Collection.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/Collection.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @Collection (1.8.0-SNAPSHOT) +Title: @Collection (1.8.0) > stub Modified: isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/CollectionLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @CollectionLayout (1.8.0-SNAPSHOT) +Title: @CollectionLayout (1.8.0) The `@CollectionLayout` annotation applies to collections, collecting together all UI hints within a single annotation. Modified: isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/CssClass-deprecated.md Mon Feb 23 22:40:08 2015 @@ -50,7 +50,7 @@ can be specified, eg: Note that this (currently) only supports class members, not classes -## See also (1.8.0-SNAPSHOT) +## See also (1.8.0) The similar [CssClassFa](./CssClassFa-deprecated.html) annotation is also used as a hint to apply CSS, but in particular to allow [Font Awesome icons](http://fortawesome.github.io/Font-Awesome/icons/) Modified: isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/CssClassFa-deprecated.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @CssClassFa (1.8.0-SNAPSHOT) +Title: @CssClassFa (1.8.0) > Deprecated, use instead > [@DomainObjectLayout#cssClassFa()](./DomainObjectLayout.html), > [@PropertyLayout#cssClassFa()](./PropertyLayout.html), > [@CollectionLayout#cssClassFa()](./CollectionLayout.html), > [@ActionLayout#cssClassFa()](./ActionLayout.html) and > [@ParameterLayout#cssClassFa()](./ParameterLayout.html), or use [dynamic > layouts](../../components/viewers/wicket/dynamic-layouts.html). Modified: isis/site/trunk/content/reference/recognized-annotations/DomainObject.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainObject.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/DomainObject.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/DomainObject.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @DomainObject (1.8.0-SNAPSHOT) +Title: @DomainObject (1.8.0) > stub Modified: isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/DomainObjectLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @DomainObjectLayout (1.8.0-SNAPSHOT) +Title: @DomainObjectLayout (1.8.0) The `@DomainObjectLayout` annotation applies to domain classes, collecting together all UI hints within a single annotation. Modified: isis/site/trunk/content/reference/recognized-annotations/DomainService.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainService.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/DomainService.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/DomainService.md Mon Feb 23 22:40:08 2015 @@ -7,11 +7,11 @@ discovered automatically on the CLASSPAT The following attributes can be specified: -* `nature` - the nature of this service: providing actions for menus, contributed actions, or neither (1.8.0-SNAPSHOT) +* `nature` - the nature of this service: providing actions for menus, contributed actions, or neither (1.8.0) * `repositoryFor` - if this domain service acts as a repository for an entity type, specify that entity type. (This is currently informational only) -* `menuOrder` - the order of the service's menu with respect to other service's (deprecated in 1.8.0-SNAPSHOT) +* `menuOrder` - the order of the service's menu with respect to other service's (deprecated in 1.8.0) For example: Modified: isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/DomainServiceLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @DomainServiceLayout (1.8.0-SNAPSHOT) +Title: @DomainServiceLayout (1.8.0) The `@DomainServiceLayout` annotation applies to domain services, collecting together all view layout semantics within a single annotation. Modified: isis/site/trunk/content/reference/recognized-annotations/Parameter.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Parameter.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/Parameter.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/Parameter.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @Parameter (1.8.0-SNAPSHOT) +Title: @Parameter (1.8.0) > stub Modified: isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/ParameterLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @ParameterLayout (1.8.0-SNAPSHOT) +Title: @ParameterLayout (1.8.0) The `@ParameterLayout` annotation applies to action parameters, collecting together all UI hints within a single annotation. Modified: isis/site/trunk/content/reference/recognized-annotations/Property.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/Property.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/Property.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/Property.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @Property (1.8.0-SNAPSHOT) +Title: @Property (1.8.0) > stub Modified: isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/PropertyLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @PropertyLayout (1.8.0-SNAPSHOT) +Title: @PropertyLayout (1.8.0) The `@PropertyLayout` annotation applies to properties collecting together all UI hints within a single annotation: Modified: isis/site/trunk/content/reference/recognized-annotations/ViewModel.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ViewModel.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/ViewModel.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/ViewModel.md Mon Feb 23 22:40:08 2015 @@ -30,8 +30,8 @@ The view model's memento will be derived Only properties supported by the configured [MementoService](../reference/services/memento-service.html) can be used. The default implementation supports all the value types and persisted entities. -(As of 1.8.0-SNAPSHOT) there are some limitations: -* view models cannot reference other view models +(As of 1.8.0) there are some limitations: +* view models cannot hold collections other view models (simple properties *are* supported, though) * collections (of either view models or entities) are ignored. Modified: isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/ViewModelLayout.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: @ViewModelLayout (1.8.0-SNAPSHOT) +Title: @ViewModelLayout (1.8.0) > stub 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=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/recognized-annotations/about.md (original) +++ isis/site/trunk/content/reference/recognized-annotations/about.md Mon Feb 23 22:40:08 2015 @@ -2,7 +2,7 @@ title: Recognized Annotations go back to: [documentation](../../documentation.html) -### Domain objects, services and members (as of 1.8.0-SNAPSHOT) +### Domain objects, services and members (as of 1.8.0) `@Xxx` specify domain-layer metadata, `@XxxLayout` specify view-layer metadata @@ -192,7 +192,7 @@ go back to: [documentation](../../docume </table> -### Deprecated Annotations (since 1.8.0-SNAPSHOT) +### Deprecated Annotations (since 1.8.0) <table class="table table-bordered table-condensed table-hover"> <tr> Modified: isis/site/trunk/content/reference/services/deep-link-service.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/deep-link-service.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/deep-link-service.md (original) +++ isis/site/trunk/content/reference/services/deep-link-service.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: Deep Link Service (1.8.0-SNAPSHOT) +Title: Deep Link Service (1.8.0) The `DeepLinkService` provides the ability to obtain a `java.net.URI` that links to a representation of any (persisted) domain entity or view model. Modified: isis/site/trunk/content/reference/services/email-notification-service.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/email-notification-service.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/email-notification-service.md (original) +++ isis/site/trunk/content/reference/services/email-notification-service.md Mon Feb 23 22:40:08 2015 @@ -1,11 +1,11 @@ -Title: Email Notification Service (1.8.0-SNAPSHOT) +Title: Email Notification Service (1.8.0) The email notification service supports the user registration process whereby a user can sign-up to access an application by providing a valid email address. The Wicket viewer will check whether an implementation of this service (and also the [user registration service](./user-registration-service.html)) is available, and if so will (unless configured not to) expose a sign-up page where the user enters their email address. A verification email is sent using this service; the email includes a link back to the running application. The user then completes the registration process (choosing a user name, password and so on) and the Wicket viewer creates an account for them (using the aforementioned [user registration service](./user-registration-service.html)). The framework provides both an API and a default implementation of this service. The implementation depends in turn on the [email service](./email-service.html). ## API - + The API for the service is: public interface EmailNotificationService extends Serializable { Modified: isis/site/trunk/content/reference/services/email-service.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/email-service.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/email-service.md (original) +++ isis/site/trunk/content/reference/services/email-service.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: Email Service (1.8.0-SNAPSHOT) +Title: Email Service (1.8.0) The email service provides the ability to send emails to one or more recipients. The framework also provides a default implementation that sends email as an HTML message, using an external SMTP provider. Modified: isis/site/trunk/content/reference/services/event-bus-service.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/event-bus-service.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/event-bus-service.md (original) +++ isis/site/trunk/content/reference/services/event-bus-service.md Mon Feb 23 22:40:08 2015 @@ -28,18 +28,18 @@ If a subscriber throws an exception in t The event class that is raised can be specified using an annotation: -* as of 1.8.0-SNAPSHOT, using: +* as of 1.8.0, using: * `@Property(domainEvent=...)` * `@Collection(domainEvent=...)` * `@Action(domainEvent=...)` -* as of 1.7.0 (but deprecated in 1.8.0-SNAPSHOT), using : +* as of 1.7.0 (but deprecated in 1.8.0), using : * `@PropertyInteraction` * `@CollectionInteraction` * `@ActionInteraction` -* as of 1.6.0 (but deprecated in 1.8.0-SNAPSHOT), using : +* as of 1.6.0 (but deprecated in 1.8.0), using : * `@PostsPropertyChangedEvent` * `@PostsCollectionAddedToEvent`/`@PostsCollectionRemovedFromEvent` * `@PostsActionInvokedEvent` @@ -95,7 +95,7 @@ where: The are for domain services to call to register themselves with the event bus. This should be done in the -As of 1.8.0-SNAPSHOT, the `register` and `unregister` methods should be called in the `@PostConstruct` and `@PreDestroy` lifecycle methods: +As of 1.8.0, the `register` and `unregister` methods should be called in the `@PostConstruct` and `@PreDestroy` lifecycle methods: @DomainService public class MySubscribingDomainService { Modified: isis/site/trunk/content/reference/services/exception-recognizers.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/exception-recognizers.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/exception-recognizers.md (original) +++ isis/site/trunk/content/reference/services/exception-recognizers.md Mon Feb 23 22:40:08 2015 @@ -25,7 +25,7 @@ coarse-grained as it wishes. Typically implementations of `ExceptionRecognizer` are registered as services (in the `isis.properties` configuration file). More than one recognizer can be registered; all we be checked if an exception is thrown. -## Extended API (1.8.0-SNAPSHOT) +## Extended API (1.8.0) The `ExceptionRecognizer2` interface extends the original `ExceptionRecognizer` interface, being defined as: @@ -106,7 +106,7 @@ composite implementation that bundles up In 1.7.0, only the [Wicket viewer](../../components/viewers/wicket/about.html) supported this API. -In 1.8.0-SNAPSHOT, some checking of exception recognizers has moved deeper into core, specifically the (JDO) objectstore. +In 1.8.0, some checking of exception recognizers has moved deeper into core, specifically the (JDO) objectstore. In particular, if an exception is raised from the loading of an individual object, then this is passed by the registered ExceptionRecognizers. If any of these recognize the exception as representing a not-found exception, then a Isis `ObjectNotFoundException` is raised. Both the viewers interprets this correctly (the Modified: isis/site/trunk/content/reference/services/user-profile-service.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/user-profile-service.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/user-profile-service.md (original) +++ isis/site/trunk/content/reference/services/user-profile-service.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: User Profile Service (1.8.0-SNAPSHOT) +Title: User Profile Service (1.8.0) The user profile service API provides the ability for the domain application to return supplementary metadata about the current user. This information is used (by the Wicket viewer) to customize the appearance of the tertiary Modified: isis/site/trunk/content/reference/services/user-registration-service.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/reference/services/user-registration-service.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/reference/services/user-registration-service.md (original) +++ isis/site/trunk/content/reference/services/user-registration-service.md Mon Feb 23 22:40:08 2015 @@ -1,4 +1,4 @@ -Title: User Registration Service (1.8.0-SNAPSHOT) +Title: User Registration Service (1.8.0) The user registration service API provides the ability for users to sign-up to access an application by providing a valid email address. The Wicket viewer will check whether an implementation of this service (and also the [email notification service](./email-notification-service.html)) is available, and if so will (unless configured not to) expose a sign-up page where the user enters their email address. A verification email is sent (using the aforementioned [email notification service](./email-notification-service.html)) which includes a link back to the running application; this allows the user then to complete their registration process (choose user name, password and so on). When the user has provided the additional details, the Wicket viewer calls this service in order to create an account for them, and then logs the user on. Modified: isis/site/trunk/content/release-matrix.md URL: http://svn.apache.org/viewvc/isis/site/trunk/content/release-matrix.md?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/content/release-matrix.md (original) +++ isis/site/trunk/content/release-matrix.md Mon Feb 23 22:40:08 2015 @@ -2,7 +2,14 @@ Title: Release Matrix {release-matrix -The table below lists dependencies between core, components and archetypes. +As of 1.8.0, all components are incorporated into Isis core. The only dependency is that the [simpleapp archetype](intro/getting-started/simpleapp-archetype.html) depends on core. + +Prior to 1.8.0, one or more of the components were released separately to core. The table below details those dependencies, but in summary: +* in 1.7.0, the Wicket viewer depended on Core 1.7.0 (and all other components were bundled into Core) +* in 1.6.0, the Wicket viewer depended on Core 1.6.0 (and all other components were bundled into Core) +* in 1.5.0 and earlier, the Wicket viewer, Restful Objects viewer, Shiro security and JDO ObjectStore all depended on Core 1.5.0. + +In more detail: <table class="table table-striped table-bordered table-condensed"> <tr class="heading"> Modified: isis/site/trunk/templates/isis-in-pictures.html URL: http://svn.apache.org/viewvc/isis/site/trunk/templates/isis-in-pictures.html?rev=1661807&r1=1661806&r2=1661807&view=diff ============================================================================== --- isis/site/trunk/templates/isis-in-pictures.html (original) +++ isis/site/trunk/templates/isis-in-pictures.html Mon Feb 23 22:40:08 2015 @@ -8,7 +8,7 @@ <div class="row"> <div class="col-md-12"> <div align="center"> - <h4>The carousel below provides a tutorial by screenshot of many of the core features of Apache Isis™, v1.3.0. Note that there have been many improvements in more recent releases, in particular the forthcoming v1.8.0-SNAPSHOT.</h4> + <h4>The carousel below provides a tutorial by screenshot of many of the core features of Apache Isis™, v1.3.0. Note that there have been many improvements in more recent releases, in particular the v1.8.0.</h4> <h4>When you are done here, either get started with our <a href="../getting-started/simple-archetype.html">simple archetype</a>, or read more at our <a href="../../documentation.html">documentation</a> page.</h4> </div> </div>
