--- title: October 2024 versions: cdsjs: 8.4.1 cdsdk: 8.4.1 cdsc: 5.4.2 cdsmtxs: 2.3.0 java: 3.4.0 --- # October 2024 [[toc]] ## Richer Configuration Properties in cap≽ire In cap≽ire, configuration keys are now specially highlighted with a symbol. They also open a popover that shows how to set them in various ways. Hover over the sample properties below and switch the different tabs in the popover. You can conveniently copy the configuration snippets using the copy button. - cds.requires.db: sqlite (Node.js) - cds.odata-v4.endpoint.path: /api (Java) Let us know what you think of this feature and which configuration properties we have missed to adjust in cap≽ire. ## CDS Language & Compiler {#cds} ### New Type: cds.Map We have introduced the [built-in type](/@external/cds/types) `cds.Map` for representing an unspecified JSON Object structure. ```cds service People { entity Person { key ID : UUID; name : String; details : Map; } } ``` In OData V4 EDMX, an element of type `cds.Map` is represented as an empty, open complex type. On SAP HANA, the `Map` type is mapped to `NCLOB`, on SQLite it is mapped to `JSON_TEXT`, on H2 to `JSON`, and on Postgres it is mapped to `JSONB`. :::warning Currently restricted to CAP Java with OData V4 The type `cds.Map` currently is [only supported by the CAP Java runtime](#basic-support-for-cdsmap) with OData v4. ::: ## Node.js {#cds-js} ### Customizing OData $batch Request Limits We introduced a new configuration option that enables you to specifically raise the limit for the individual requests in a `$batch` request with content-type `multipart/mixed` and not for the server in general. This limit can be set with the new configuration option cds.odata.max_batch_header_size:64KiB which comes with a default value of 64 KiB. To maximize performance, the [new OData protocol adapter](/releases/2024/jun24#new-protocol-adapters-ga) utilizes Node.js' native HTTP parser when parsing the body of `$batch` requests. By default, the parser has a limit of 16 KiB as described in [`http.maxHeaderSize`](https://nodejs.org/api/http.html#httpmaxheadersize). > The limit for [`maxHeaderSize`](https://nodejs.org/api/http.html#httpmaxheadersize) applies to the headers but also to the [request line](https://developer.mozilla.org/en-US/docs/Web/HTTP/Messages#request_line). In OData requests where the filters in the request target become very long, the request line can exceed the default limit. The common workaround is to wrap GET requests with URLs exceeding the server's limit into `$batch` requests. Our new configuration option enables you to use this workaround while preserving a reasonable limit. ## Java {#cds-java} ### Important Changes ❗️ { .important #important-changes-in-java} #### Removed Dependency to Deprecated Multitenant Library To support multitenancy, CAP Java internally consumes APIs offered by SAP BTP [multitenant libraries](https://central.sonatype.com/namespace/com.sap.cloud.mt) (Maven group ID `com.sap.cloud.mt`). These libraries have been put into maintenance mode, so starting with this version, CAP Java has removed these dependencies and adopted the base implementation. :::details I used multitenancy APIs directly. What can I do? If you made *explicitly* use of these multitenancy APIs, you can continue to offer most of them through new packages CAP Java offers. The new packages are `com.sap.cds.feature.mt.lib` and `com.sap.cds.services.utils.lib` respectively. You need to adapt package names in your custom code accordingly. :::warning Direct usage of these multitenant APIs is deprecated and might be removed in future versions. Consume public APIs offered by CAP instead. ::: #### Hardened Authorization of Tenant Lifecycle Endpoints By default, internal user access to tenant lifecycle endpoints, that is subscribe, unsubscribe or upgrade, is rejected in production profile now. You can control internal user access by property cds.multi-tenancy.security.internal-user-access.enabled:true. :::warning Important Note for applications on DwC Make sure to adopt at least version `2.3.15` of `utils-cap`. ::: ### Basic Support for cds.Map You can now use the new [built-in `cds.Map` type](/@external/cds/types) for storing and retrieving arbitrary structured data. Values of elements with type `Map` are represented in CAP Java as `Map`. - On write, the map data is *serialized* to a JSON object and stored on the database. - On read, the JSON object is deserialized into a Java Map. Since the map is serialized to a JSON object, the type of elements inside `Map` is limited to what is supported by JSON: strings, numbers, Boolean values and null, as well as nested maps and lists. Given the CDS model using the new `Map` type for `Person.details`: ```cds entity Person { key ID : UUID; name : String; details : Map; } ``` You can store arbitrary data in `details`: ```java Map person = Map.of("name", "Peter", "details", Map.of( "age", 40, "address", Map.of( "city", "Walldorf", "street", "Hauptstraße"))); Insert.into("Person").entry(person); ``` When you read the `Person` entity, `details` is deserialized into a Java map: ```java Person p = db.run(Select.from(PERSON).byId(1024)).single(Person.class); CdsData details = p.getDetails(); Integer age = details.get("age"); // 40 String city = details.getPath("address.city"); // Walldorf ``` You can also extract data from within a map using paths: ```java Select.from("Person").byId(1024).columns("details.address"); // -> { address : { city : 'Walldorf', street: 'Hauptstraße' } } Select.from("Person").byId(1024).columns("details.address.city"); // -> { city : 'Walldorf' } ``` :::info Temporary Limitations Filters on `cds.Map` elements, as well as partial updates and deletes are not yet supported. ::: ### Enhancements for CDS QL #### `IN` Subqueries Use an in-subquery predicate to test if an element or a tuple of elements is contained in the result of a subquery. In the following, we select all authors, with the same name as a journalist: ```java import static bookshop.Bookshop_.AUTHORS; import static socialmedia.Journalists_.JOURNALISTS; // fluent style Select.from(AUTHORS).where(author -> author.name().in( Select.from(JOURNALISTS).columns(journalist -> journalist.name()) )); ``` You may also use `CQL.in` to create an in-subquery predicate. In the following, we search for matches of the element pair `(firstName, lastName)`: ```java // tree style CqnListValue fullName = CQL.list(CQL.get("firstName"), CQL.get("lastName")); CqnSelect subquery = Select.from("socialmedia.Journalists").columns("firstName", "lastName"); Select.from("bookshop.Authors").where(CQL.in(fullName, subquery)); ``` [Learn more about `IN` subqueries.](/@external/java/working-with-cql/query-api#in-subquery-predicate){.learn-more} #### Case-When-Then Expressions You can now use a convenient API to compose case expressions: ```java Select.from(PERSONS).columns( p -> p.name(), p -> p.when(p.age().lt(25)).then("young") .when(p.age().ge(75)).then("elderly") .orElse("adult").as("ageTxt").type(CdsBaseType.String)); ``` This query converts a person's numeric `age` value to a textual `ageTxt` representation. ### Enhancements for OData v4 #### Content Disposition Type For stream properties, you may now use the `@Core.ContentDisposition.Type` annotation to indicate whether the content is expected to be displayed *inline* in the browser, or as an attachment that is downloaded and saved locally. ```cds entity Books : uuid { ... @Core.MediaType: 'image/jpeg' @Core.ContentDisposition.Type: 'inline' coverImage : LargeBinary ; } ``` When downloading the `coverImage` the runtime will set a `Content-Disposition: inline` header to advise the browser to display the cover image in the browser. #### Omitting Null Values In a GET request, the client may now specify a `Prefer: omit-values=nulls` header to indicate that the server may omit `null` value in the response. ### Tool Support for AMS Use the [add](../../java/assets/cds-maven-plugin-site/add-mojo.html){target="_blank"} goal of the [CDS Maven Plugin](/@external/java/developing-applications/building#cds-maven-plugin) to add [AMS](/@external/guides/security/cap-users#roles-assignment-ams) integration to a CAP Java project: ```sh mvn cds:add -Dfeature=AMS ``` ## Tools { #tools} ### Renaming CDS Files in VS Code When you rename a *.cds* file or a folder which contains CDS files, this automatically updates usages in other *.cds* files.