You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2016/01/02 07:50:05 UTC

isis git commit: ISIS-1243: updating migration notes for the RoutingService (and removing the paragraph on JAXB view models, as no actual migration is required).

Repository: isis
Updated Branches:
  refs/heads/master 839df6a38 -> 9742a7c90


ISIS-1243: updating migration notes for the RoutingService (and removing the paragraph on JAXB view models, as no actual migration is required).


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/9742a7c9
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/9742a7c9
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/9742a7c9

Branch: refs/heads/master
Commit: 9742a7c90b8c400851ae684c1cea72b030982dea
Parents: 839df6a
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Dec 29 15:58:11 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Dec 29 15:58:11 2015 +0000

----------------------------------------------------------------------
 .../_migration-notes_1.10.0-to-1.11.0.adoc      | 43 +++++++++++++-------
 1 file changed, 28 insertions(+), 15 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/9742a7c9/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
index 1b31335..f154f07 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.10.0-to-1.11.0.adoc
@@ -16,21 +16,6 @@ At the time of writing `1.11.0` has not been released; these notes relate to `1.
 ====
 
 
-== JAXB view models
-
-Classes annotated with xref:guides/rgant.adoc#_rgant-XmlRootElement[`@XmlRootElement`] are now recognized
-as view models.  These are serialized out into XML and converted into URL.
-
-The xref:guides/rgsvc.adoc#_rgsvc_api_JaxbService[`JaxbService`] is responsible for performing the XML conversion.
-The default implementation is located in the `org.apache.isis.core:isis-core-schema` module, specifically under the
-`org.apache.isis.core.schema.services` package.
-
-If your application is bootstrapped using an `AppManifest` (recommended;
-xref:guides/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[here]) then the `JaxbService` will automatically be discovered and
- registered.  However, if you are still using the older `isis.properties` configuration file to explicitly register
- services then you will need to add in this service.
-
-
 == Swagger UI
 
 The new xref:guides/rgsvc.adoc#_rgsvc_api_SwaggerService[`SwaggerService`] allows link:http://swagger.io[Swagger] spec files
@@ -81,6 +66,34 @@ There is also an HTML page to load the Swagger UI itself; this resides in `src/m
 
 The text of the simple app's `about/index.html` has also changed (the `<li`> for the `/restful` URL has been replaced with a `/swagger-ui` URL).  If you use link:https://github.com/apache/isis/blob/master/example/application/simpleapp/webapp/src/main/webapp/about/index.html[this file], then update it.
 
+If your application is bootstrapped using an `AppManifest` (recommended;
+xref:guides/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[here]) then the default implementation of the
+`SwaggerService` will automatically be discovered and registered.  However, if you are still using the older
+`isis.properties` configuration file to explicitly register services then you will need to add in this service.
+
+
+
+== `RoutingService`
+
+The new xref:guides/rgsvc.adoc#_rgsvc_spi_RoutingService[`RoutingService`] SPI service provides a plugin point to the
+xref:guides/ugvw.adoc#[Wicket viewer] so that a different object than that returned from an action invocation can be
+rendered.
+
+The framework provides a default implementation of this service that will - instead of a void or a `null` result -
+render the home page (as per the xref:guides/rgant.adoc#_rgant_HomePage[`@HomePage`] annotation) if there is one.  This
+is therefore a subtle change in the UI.  If you wish to retain the original behaviour (to return the "no results" page
+instead), then you should implement your own no-op implementation of this service:
+
+[source,java]
+----
+@DomainService
+@DomainServiceLayout(menuOrder="1")
+public class IdentityRoutingService implements RoutingService {
+    public boolean canRoute(Object original) { return true; }
+    public Object route(Object original) { return original; }
+}
+----
+
 
 == Wicket Viewer i18n