...

_packages/bookshop-enhanced/app/index.cds

@@ -0,0 +1 @@
+using from '@sap/capire-bookshop/app';

_packages/bookshop-enhanced/db/schema.cds

@@ -0,0 +1,25 @@
+/*
+  In this model we demonstrate how to add Genres to Books in
+  as if it was an external extension. For example we use
+  CDS Aspects' to extend the core domain model's Books entity
+  as well as the AdminService.
+ */
+
+namespace sap.capire.bookshop;
+using { sap.capire.reviews.ReviewsService as external } from '@sap/capire-reviews';
+using { sap.capire.bookshop.Books } from '@sap/capire-bookshop/db/schema';
+using { sap.common.CodeList } from '@sap/cds/common';
+
+// Extending Books by Reviews and Genres
+extend Books with {
+  reviews : Composition of many external.Reviews on reviews.subject = ID;
+  rating : external.Reviews.rating;
+  genre : Association to Genres;
+}
+
+// Hierarchical Code List for Genres
+entity Genres : CodeList {
+  key ID : Integer;
+  children : Composition of many Genres on children.parent = $self;
+  parent : Association to Genres;
+}

_packages/bookshop-enhanced/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@sap/capire-bookshop-enhanced",
+  "version": "1.0.0",
+  "description": "A sample for extending a base application package, in this case bookshop, e.g. in context of verticalization or customization.",
+  "repository": "https://github.com/SAP-samples/cloud-cap-samples.git",
+  "license": "SAP SAMPLE CODE LICENSE",
+  "dependencies": {
+    "@sap/capire-bookshop": "^1.0.0",
+    "@sap/capire-reviews": "^1.0.0",
+    "@sap/cds": "latest",
+    "express": "*"
+  },
+  "scripts": {
+    "reviews-service": "PORT=5005 cds run ../reviews-service --bind --in-memory?",
+    "start": "cds run --in-memory?",
+    "watch": "cds watch"
+  },
+  "cds": {
+    "requires": {
+      "sap.capire.reviews.ReviewsService": {
+        "kind": "odata",
+        "model": "@sap/capire-reviews"
+      },
+      "messaging": {
+        "kind": "file-based-messaging"
+      }
+    }
+  }
+}

_packages/bookshop-enhanced/srv/services.cds

@@ -0,0 +1,9 @@
+namespace sap.capire.bookshop;
+
+using { AdminService } from '@sap/capire-bookshop/srv/admin-service';
+using { sap.capire.bookshop } from '../db/schema';
+
+@impl:'srv/services'
+extend service AdminService with {
+  entity Genres as projection on bookshop.Genres;
+}

_packages/bookshop-enhanced/srv/services.js

@@ -0,0 +1,30 @@
+const cds = require ('@sap/cds')
+
+module.exports = cds.service.impl (async()=>{
+
+    const ReviewsService = await cds.connect.to ('sap.capire.reviews.ReviewsService')
+    const CatalogService = await cds.connect.to ('CatalogService')
+    const db = await cds.connect.to ('db')
+    // import model definitions from connected services to work with subsequently
+    const { Books } = db.entities
+    const { Reviews } = ReviewsService.entities
+
+    CatalogService.impl (srv => {
+        // delegate requests to read reviews to ReviewsService
+        srv.on ('READ', 'Books/reviews', (req) => {
+            const [ subject ] = req.params
+            const tx = ReviewsService.transaction (req)
+            return tx.run (SELECT.from (Reviews) .where ({subject}))
+        })
+    })
+
+    // react on event messages from reviews service
+    ReviewsService.on ('reviewed', (msg) => {
+        console.debug ('> received:', msg.event, msg.data)
+        const { subject, rating } = msg.data
+        const tx = db // TODO: db.transaction (msg)
+        return tx.run (UPDATE (Books, subject) .with ({rating}))
+        // return tx.update (Books, subject) .with ({rating})
+    })
+
+})

_packages/bookshop-enhanced/tests/genres.http

@@ -0,0 +1,33 @@
+#################################################
+#
+#   Genres
+#
+
+GET http://localhost:4004/admin/Genres?
+###
+
+POST http://localhost:4004/admin/Genres?
+Content-Type: application/json
+
+{ "ID":100, "name":"Some Sample Genres...", "children":[
+    { "ID":101, "name":"Cat", "children":[
+        { "ID":102, "name":"Kitty", "children":[
+            { "ID":103, "name":"Kitty Cat", "children":[
+                { "ID":104, "name":"Aristocat" } ]},
+            { "ID":105, "name":"Kitty Bat" } ]},
+        { "ID":106, "name":"Catwoman", "children":[
+            { "ID":107, "name":"Catalina" } ]} ]},
+    { "ID":108, "name":"Catweazle" }
+]}
+###
+
+GET http://localhost:4004/admin/Genres(100)?
+# &$expand=children
+# &$expand=children($expand=children($expand=children($expand=children)))
+###
+
+DELETE http://localhost:4004/admin/Genres(103)
+###
+
+DELETE http://localhost:4004/admin/Genres(100)
+###

_packages/bookshop-enhanced/tests/reviews.http

@@ -0,0 +1,32 @@
+#################################################
+#
+#   Reviews Service
+#
+
+
+### Use this one for ReviewsService running as a separate process
+# Note: use 5005 instead of 4004 in case of separate service
+POST http://localhost:5005/reviews/Reviews
+# POST http://localhost:4004/reviews/Reviews
+Content-Type: application/json;IEEE754Compatible=true
+
+{"subject":"201", "rating":"5", "title":"boo"}
+
+### Direct Request to ReviewsService
+# Note: use 5005 instead of 4004 in case of separate service
+GET http://localhost:5005/reviews/Reviews?
+# GET http://localhost:4004/reviews/Reviews?
+# &$filter=subject eq '201'
+
+
+### Request to CatalogService > delegated to ReviewsService
+GET http://localhost:4004/browse/Books(201)/reviews
+
+### Alternative OData URL
+GET http://localhost:4004/browse/Books/201/reviews
+
+###
+GET http://localhost:4004/browse/Books(201)?
+&$select=ID,title,rating
+# &$expand=reviews
+# Note: the latter only works in case of ReviewsService in same process