Core API: remove "fetchComposite" parameter

[jri]

The fetchComposite parameter is omnipresent in the Core (and other) APIs and make them cumbersome to use/remember.

The fetchComposite parameter should be dropped. Instead topics/associations should be always retrieved *without* their "composite value" (= child topics). The child topics should be retrieved selectively and on-demand, that is once accessed, e.g. via comp.getTopic().

The only spot where the fetchComposite parameter should appear is the REST APIs. This is because selective on-demand loading is not efficient via the network.

See also #411

[Jörg Richter]

APIs: remove "fetchComposite" paramter (#699).

BREAKING CHANGE

The "fetchComposite" paramter is removed from Core and other APIs.

Not yet functional.

See #699.

• Changeset: b3f9374b23b002c3d1979367de456e085f7f6504
• URL: ​https://github.com/jri/deepamehta/commit/b3f9374b23b002c3d1979367de456e085f7f6504

[Jörg Richter]

Load child topics in response filter (#699).

BREAKING CHANGE

Core REST API: if the fetch_composite query parameter is not present in the request false is assumed. That is, by deafult the response entity contains no child topics. If child topics are wanted fetch_composite=true must be stated explicitely.
(In DM 4.3 and before fetch_composite=true was the default for single item responses and fetch_composite=false was the default for item collections responses. These differentiation is no abolished in favor of better remembrance.)

All REST APIs: if the request has a fetch_composite=true query parameter the child topics of the response entity are loaded automatically. For standard cases the plugin developer must not care about child topic loading. Child topic loading is performed generically by the Core's JerseyResponseFilter.

Automatic child topic loading works for responses of these types:

• Topic
• Association
• Iterable<Topic>

If the response is not of one of these types the plugin developer must care about manual child topic loading. She does so by using DeepaMehtaObject's loadChildTopics() methods.

See #699.

• Changeset: 70e07770d653d2024af76481f8848cde6cc5c662
• URL: ​https://github.com/jri/deepamehta/commit/70e07770d653d2024af76481f8848cde6cc5c662

[Jörg Richter]

Core API: loadChildTopics() returns object (#699).

The loadChildTopics() methods return the object itself, thus allowing call chaining (formerly void).

DeepaMehtaObject
    DeepaMehtaObject loadChildTopics();
    DeepaMehtaObject loadChildTopics(String childTypeUri);

Topic
    Topic loadChildTopics();
    Topic loadChildTopics(String childTypeUri);

Association
    Association loadChildTopics();
    Association loadChildTopics(String childTypeUri);

See #699.

• Changeset: 4fd777603b6dbb88ea183e4d4c33b73bfc770d4c
• URL: ​https://github.com/jri/deepamehta/commit/4fd777603b6dbb88ea183e4d4c33b73bfc770d4c

[Jörg Richter]

Webclient: adapt to Core changes (#699).

Fix: detail panel shows object along with its child topics.

See #699.

• Changeset: 6bcb6c2ab360a83f24106cd20a925a6ddb84ea23
• URL: ​https://github.com/jri/deepamehta/commit/6bcb6c2ab360a83f24106cd20a925a6ddb84ea23

[Jörg Richter]

Type loading: adapt to Core changes pt.2 (#699).

Core fix: view configs are loaded properly.

Core API:

ResultList? has a new method

ResultList<T> loadChildTopics()

It loads the child topics of all the objects contained in the result list.

See #699.

• Changeset: dea7f2b54b98c00e7786b0d16c51c6521057e70c
• URL: ​https://github.com/jri/deepamehta/commit/dea7f2b54b98c00e7786b0d16c51c6521057e70c

[Jörg Richter]

Label building: adapt to Core changes pt.3 (#699).

Topicmaps fix: topicmaps keep their name once translated.

See #699.

• Changeset: 4fabd028134d6735ae7d7f68d1c0aa9197d3b829
• URL: ​https://github.com/jri/deepamehta/commit/4fabd028134d6735ae7d7f68d1c0aa9197d3b829

[Jörg Richter]

Webclient: adapt to Core changes pt.4 (#699).

Fix: when navigating via "what's related" the revealed topic is displayed along with its childs.

See #699.

• Changeset: 8ec97bc55ab1c89a7541db8fb9069a5a10149416
• URL: ​https://github.com/jri/deepamehta/commit/8ec97bc55ab1c89a7541db8fb9069a5a10149416

[Jörg Richter]

Geomaps: adapt to Core changes pt.4 (#699).

Geomaps are functional again.

BREAKING CHANGE

Geomaps API:

The topic returned by the getDomainTopic() service call does *not* include its child topics.
When you need the child topics:

• Java API:
  • on-demand loading (selectively): just call the accessors of the topic's composite value, e.g. topic.getCompositeValue().getString(...). The respective child topics are loaded on-demand.
  • explicit loading:
    • topic.loadChildTopics() loads all child topics
    • topic.loadChildTopics(childTypeUri) loads child topics selectively
• REST API: add fetch_composite=true to the query parameters. All child topics are included in the response.

See #699.

• Changeset: 0ce01717f80cf4b8eb400ec421a3735e22cadcf9
• URL: ​https://github.com/jri/deepamehta/commit/0ce01717f80cf4b8eb400ec421a3735e22cadcf9

[Jörg Richter]

Facets module: adapt to Core changes pt.6 (#699).

Core's DeepaMehtaUtils:

toTopicModels() takes an Iterable instead of a List. This allows e.g. to pass a ResultList directly (instead of calling getItems() on it before).

BREAKING CHANGES

Facets API:

1. The topics returned by the getFacet() and getFacets() service calls do *not* include their child topics.

When you need the child topics:

• Java API:
  • on-demand loading (selectively): just call the accessors of the topic's composite value, e.g. topic.getCompositeValue().getString(...). The respective child topics are loaded on-demand.
  • explicit loading:
    • topic.loadChildTopics() loads all child topics
    • topic.loadChildTopics(childTypeUri) loads child topics selectively
• REST API: add fetch_composite=true to the query parameters. All child topics will be included in the response then.

2. The topic returned by the getFacettedTopic() service call does *not* include its child topics.

When you need the child topics: see 1.

3. The getFacets() service calls return a ResultList (formerly List). This allows to call loadChildTopics() on it (see 1.) to load all child topics of all items contained in the result list.

See #699.

• Changeset: 87aeb213f49410b14ea4ee54364065dd047cc7b5
• URL: ​https://github.com/jri/deepamehta/commit/87aeb213f49410b14ea4ee54364065dd047cc7b5

[Jörg Richter]

Access Control: adapt to Core changes pt.7 (#699).

See #699.

• Changeset: f5addf12172c74375d2a001d301f82e988c17daf
• URL: ​https://github.com/jri/deepamehta/commit/f5addf12172c74375d2a001d301f82e988c17daf

[Jörg Richter]

Topicmaps: adapt to Core changes pt.8 (#699).

Retrieving a topicmap including the topic's child child topics works again.
Needed for the Import Export plugin.

The "remove fetchComposite parameter" related work should be complete now. Ready for merging into master.

2 things remain to investigate (see "FIXME: had fetchComposite=true"):

• Files API.
• Create/Update? requests containing topic references (see #614). In conjunction with Malte's Wikidata plugin.

See #699.

• Changeset: 678a4fa104770eb1aa1651fd0c59654bedcaa54d
• URL: ​https://github.com/jri/deepamehta/commit/678a4fa104770eb1aa1651fd0c59654bedcaa54d

[Jörg Richter]

APIs: remove "fetchComposite" paramter (#699).

BREAKING CHANGE

The "fetchComposite" paramter is removed from Core and other APIs.

Not yet functional.

See #699.

• Changeset: b3f9374b23b002c3d1979367de456e085f7f6504
• URL: ​https://github.com/jri/deepamehta/commit/b3f9374b23b002c3d1979367de456e085f7f6504

[Jörg Richter]

Load child topics in response filter (#699).

BREAKING CHANGE

Core REST API: if the fetch_composite query parameter is not present in the request false is assumed. That is, by deafult the response entity contains no child topics. If child topics are wanted fetch_composite=true must be stated explicitely.
(In DM 4.3 and before fetch_composite=true was the default for single item responses and fetch_composite=false was the default for item collections responses. These differentiation is no abolished in favor of better remembrance.)

All REST APIs: if the request has a fetch_composite=true query parameter the child topics of the response entity are loaded automatically. For standard cases the plugin developer must not care about child topic loading. Child topic loading is performed generically by the Core's JerseyResponseFilter.

Automatic child topic loading works for responses of these types:

• Topic
• Association
• Iterable<Topic>

If the response is not of one of these types the plugin developer must care about manual child topic loading. She does so by using DeepaMehtaObject's loadChildTopics() methods.

See #699.

• Changeset: 70e07770d653d2024af76481f8848cde6cc5c662
• URL: ​https://github.com/jri/deepamehta/commit/70e07770d653d2024af76481f8848cde6cc5c662

[Jörg Richter]

Core API: loadChildTopics() returns object (#699).

The loadChildTopics() methods return the object itself, thus allowing call chaining (formerly void).

DeepaMehtaObject
    DeepaMehtaObject loadChildTopics();
    DeepaMehtaObject loadChildTopics(String childTypeUri);

Topic
    Topic loadChildTopics();
    Topic loadChildTopics(String childTypeUri);

Association
    Association loadChildTopics();
    Association loadChildTopics(String childTypeUri);

See #699.

• Changeset: 4fd777603b6dbb88ea183e4d4c33b73bfc770d4c
• URL: ​https://github.com/jri/deepamehta/commit/4fd777603b6dbb88ea183e4d4c33b73bfc770d4c

[Jörg Richter]

Webclient: adapt to Core changes (#699).

Fix: detail panel shows object along with its child topics.

See #699.

• Changeset: 6bcb6c2ab360a83f24106cd20a925a6ddb84ea23
• URL: ​https://github.com/jri/deepamehta/commit/6bcb6c2ab360a83f24106cd20a925a6ddb84ea23

[Jörg Richter]

Type loading: adapt to Core changes pt.2 (#699).

Core fix: view configs are loaded properly.

Core API:

ResultList? has a new method

ResultList<T> loadChildTopics()

It loads the child topics of all the objects contained in the result list.

See #699.

• Changeset: dea7f2b54b98c00e7786b0d16c51c6521057e70c
• URL: ​https://github.com/jri/deepamehta/commit/dea7f2b54b98c00e7786b0d16c51c6521057e70c

[Jörg Richter]

Label building: adapt to Core changes pt.3 (#699).

Topicmaps fix: topicmaps keep their name once translated.

See #699.

• Changeset: 4fabd028134d6735ae7d7f68d1c0aa9197d3b829
• URL: ​https://github.com/jri/deepamehta/commit/4fabd028134d6735ae7d7f68d1c0aa9197d3b829

[Jörg Richter]

Webclient: adapt to Core changes pt.4 (#699).

Fix: when navigating via "what's related" the revealed topic is displayed along with its childs.

See #699.

• Changeset: 8ec97bc55ab1c89a7541db8fb9069a5a10149416
• URL: ​https://github.com/jri/deepamehta/commit/8ec97bc55ab1c89a7541db8fb9069a5a10149416

[Jörg Richter]

Geomaps: adapt to Core changes pt.4 (#699).

Geomaps are functional again.

BREAKING CHANGE

Geomaps API:

The topic returned by the getDomainTopic() service call does *not* include its child topics.
When you need the child topics:

• Java API:
  • on-demand loading (selectively): just call the accessors of the topic's composite value, e.g. topic.getCompositeValue().getString(...). The respective child topics are loaded on-demand.
  • explicit loading:
    • topic.loadChildTopics() loads all child topics
    • topic.loadChildTopics(childTypeUri) loads child topics selectively
• REST API: add fetch_composite=true to the query parameters. All child topics are included in the response.

See #699.

• Changeset: 0ce01717f80cf4b8eb400ec421a3735e22cadcf9
• URL: ​https://github.com/jri/deepamehta/commit/0ce01717f80cf4b8eb400ec421a3735e22cadcf9

[Jörg Richter]

Facets module: adapt to Core changes pt.6 (#699).

Core's DeepaMehtaUtils:

toTopicModels() takes an Iterable instead of a List. This allows e.g. to pass a ResultList directly (instead of calling getItems() on it before).

BREAKING CHANGES

Facets API:

1. The topics returned by the getFacet() and getFacets() service calls do *not* include their child topics.

When you need the child topics:

• Java API:
  • on-demand loading (selectively): just call the accessors of the topic's composite value, e.g. topic.getCompositeValue().getString(...). The respective child topics are loaded on-demand.
  • explicit loading:
    • topic.loadChildTopics() loads all child topics
    • topic.loadChildTopics(childTypeUri) loads child topics selectively
• REST API: add fetch_composite=true to the query parameters. All child topics will be included in the response then.

2. The topic returned by the getFacettedTopic() service call does *not* include its child topics.

When you need the child topics: see 1.

3. The getFacets() service calls return a ResultList (formerly List). This allows to call loadChildTopics() on it (see 1.) to load all child topics of all items contained in the result list.

See #699.

• Changeset: 87aeb213f49410b14ea4ee54364065dd047cc7b5
• URL: ​https://github.com/jri/deepamehta/commit/87aeb213f49410b14ea4ee54364065dd047cc7b5

[Jörg Richter]

Access Control: adapt to Core changes pt.7 (#699).

See #699.

• Changeset: f5addf12172c74375d2a001d301f82e988c17daf
• URL: ​https://github.com/jri/deepamehta/commit/f5addf12172c74375d2a001d301f82e988c17daf

[Jörg Richter]

Topicmaps: adapt to Core changes pt.8 (#699).

Retrieving a topicmap including the topic's child child topics works again.
Needed for the Import Export plugin.

The "remove fetchComposite parameter" related work should be complete now. Ready for merging into master.

2 things remain to investigate (see "FIXME: had fetchComposite=true"):

• Files API.
• Create/Update? requests containing topic references (see #614). In conjunction with Malte's Wikidata plugin.

See #699.

• Changeset: 678a4fa104770eb1aa1651fd0c59654bedcaa54d
• URL: ​https://github.com/jri/deepamehta/commit/678a4fa104770eb1aa1651fd0c59654bedcaa54d

[Jörg Richter]

APIs: remove "fetchComposite" paramter (#699).

BREAKING CHANGE

The "fetchComposite" paramter is removed from Core and other APIs.

Not yet functional.

See #699.

• Changeset: b3f9374b23b002c3d1979367de456e085f7f6504
• URL: ​https://github.com/jri/deepamehta/commit/b3f9374b23b002c3d1979367de456e085f7f6504

[Jörg Richter]

Load child topics in response filter (#699).

BREAKING CHANGE

Core REST API: if the fetch_composite query parameter is not present in the request false is assumed. That is, by deafult the response entity contains no child topics. If child topics are wanted fetch_composite=true must be stated explicitely.
(In DM 4.3 and before fetch_composite=true was the default for single item responses and fetch_composite=false was the default for item collections responses. These differentiation is no abolished in favor of better remembrance.)

All REST APIs: if the request has a fetch_composite=true query parameter the child topics of the response entity are loaded automatically. For standard cases the plugin developer must not care about child topic loading. Child topic loading is performed generically by the Core's JerseyResponseFilter.

Automatic child topic loading works for responses of these types:

• Topic
• Association
• Iterable<Topic>

If the response is not of one of these types the plugin developer must care about manual child topic loading. She does so by using DeepaMehtaObject's loadChildTopics() methods.

See #699.

• Changeset: 70e07770d653d2024af76481f8848cde6cc5c662
• URL: ​https://github.com/jri/deepamehta/commit/70e07770d653d2024af76481f8848cde6cc5c662

[Jörg Richter]

Core API: loadChildTopics() returns object (#699).

The loadChildTopics() methods return the object itself, thus allowing call chaining (formerly void).

DeepaMehtaObject
    DeepaMehtaObject loadChildTopics();
    DeepaMehtaObject loadChildTopics(String childTypeUri);

Topic
    Topic loadChildTopics();
    Topic loadChildTopics(String childTypeUri);

Association
    Association loadChildTopics();
    Association loadChildTopics(String childTypeUri);

See #699.

• Changeset: 4fd777603b6dbb88ea183e4d4c33b73bfc770d4c
• URL: ​https://github.com/jri/deepamehta/commit/4fd777603b6dbb88ea183e4d4c33b73bfc770d4c

[Jörg Richter]

Webclient: adapt to Core changes (#699).

Fix: detail panel shows object along with its child topics.

See #699.

• Changeset: 6bcb6c2ab360a83f24106cd20a925a6ddb84ea23
• URL: ​https://github.com/jri/deepamehta/commit/6bcb6c2ab360a83f24106cd20a925a6ddb84ea23

[Jörg Richter]

Type loading: adapt to Core changes pt.2 (#699).

Core fix: view configs are loaded properly.

Core API:

ResultList? has a new method

ResultList<T> loadChildTopics()

It loads the child topics of all the objects contained in the result list.

See #699.

• Changeset: dea7f2b54b98c00e7786b0d16c51c6521057e70c
• URL: ​https://github.com/jri/deepamehta/commit/dea7f2b54b98c00e7786b0d16c51c6521057e70c

[Jörg Richter]

Label building: adapt to Core changes pt.3 (#699).

Topicmaps fix: topicmaps keep their name once translated.

See #699.

• Changeset: 4fabd028134d6735ae7d7f68d1c0aa9197d3b829
• URL: ​https://github.com/jri/deepamehta/commit/4fabd028134d6735ae7d7f68d1c0aa9197d3b829

[Jörg Richter]

Webclient: adapt to Core changes pt.4 (#699).

Fix: when navigating via "what's related" the revealed topic is displayed along with its childs.

See #699.

• Changeset: 8ec97bc55ab1c89a7541db8fb9069a5a10149416
• URL: ​https://github.com/jri/deepamehta/commit/8ec97bc55ab1c89a7541db8fb9069a5a10149416

[Jörg Richter]

Geomaps: adapt to Core changes pt.4 (#699).

Geomaps are functional again.

BREAKING CHANGE

Geomaps API:

The topic returned by the getDomainTopic() service call does *not* include its child topics.
When you need the child topics:

• Java API:
  • on-demand loading (selectively): just call the accessors of the topic's composite value, e.g. topic.getCompositeValue().getString(...). The respective child topics are loaded on-demand.
  • explicit loading:
    • topic.loadChildTopics() loads all child topics
    • topic.loadChildTopics(childTypeUri) loads child topics selectively
• REST API: add fetch_composite=true to the query parameters. All child topics are included in the response.

See #699.

• Changeset: 0ce01717f80cf4b8eb400ec421a3735e22cadcf9
• URL: ​https://github.com/jri/deepamehta/commit/0ce01717f80cf4b8eb400ec421a3735e22cadcf9

[Jörg Richter]

Facets module: adapt to Core changes pt.6 (#699).

Core's DeepaMehtaUtils:

toTopicModels() takes an Iterable instead of a List. This allows e.g. to pass a ResultList directly (instead of calling getItems() on it before).

BREAKING CHANGES

Facets API:

1. The topics returned by the getFacet() and getFacets() service calls do *not* include their child topics.

When you need the child topics:

• Java API:
  • on-demand loading (selectively): just call the accessors of the topic's composite value, e.g. topic.getCompositeValue().getString(...). The respective child topics are loaded on-demand.
  • explicit loading:
    • topic.loadChildTopics() loads all child topics
    • topic.loadChildTopics(childTypeUri) loads child topics selectively
• REST API: add fetch_composite=true to the query parameters. All child topics will be included in the response then.

2. The topic returned by the getFacettedTopic() service call does *not* include its child topics.

When you need the child topics: see 1.

3. The getFacets() service calls return a ResultList (formerly List). This allows to call loadChildTopics() on it (see 1.) to load all child topics of all items contained in the result list.

See #699.

• Changeset: 87aeb213f49410b14ea4ee54364065dd047cc7b5
• URL: ​https://github.com/jri/deepamehta/commit/87aeb213f49410b14ea4ee54364065dd047cc7b5

[Jörg Richter]

Access Control: adapt to Core changes pt.7 (#699).

See #699.

• Changeset: f5addf12172c74375d2a001d301f82e988c17daf
• URL: ​https://github.com/jri/deepamehta/commit/f5addf12172c74375d2a001d301f82e988c17daf

[Jörg Richter]

Topicmaps: adapt to Core changes pt.8 (#699).

Retrieving a topicmap including the topic's child child topics works again.
Needed for the Import Export plugin.

The "remove fetchComposite parameter" related work should be complete now. Ready for merging into master.

2 things remain to investigate (see "FIXME: had fetchComposite=true"):

• Files API.
• Create/Update? requests containing topic references (see #614). In conjunction with Malte's Wikidata plugin.

See #699.

• Changeset: 678a4fa104770eb1aa1651fd0c59654bedcaa54d
• URL: ​https://github.com/jri/deepamehta/commit/678a4fa104770eb1aa1651fd0c59654bedcaa54d

[jri]

Replying to Jörg Richter:

All REST APIs: if the request has a fetch_composite=true query parameter the child topics of the response entity are loaded automatically. For standard cases the plugin developer must not care about child topic loading. Child topic loading is performed generically by the Core's JerseyResponseFilter.

Automatic child topic loading works for responses of these types:

• Topic
• Association
• Iterable<Topic>

Obviously Iterable<Association> is missing here.
This should be added.

If the response is not of one of these types the plugin developer must care about manual child topic loading. She does so by using DeepaMehtaObject's loadChildTopics() methods.

[Jörg Richter]

Core: include_childs for association lists (#699).

All REST APIs: the Core's JerseyResponseFilter processes the fetch_composite query parameter also for Iterable<Association> responses.

In particular this works for the GET /core/topic/{id}/related_assocs request (see #672, see #707).

See #699.

• Changeset: 29264e454710c893e9b42ab062ae8f5a51a00905
• URL: ​https://github.com/jri/deepamehta/commit/29264e454710c893e9b42ab062ae8f5a51a00905

[jri]

Replying to Jörg Richter:

All REST APIs: the Core's JerseyResponseFilter processes the fetch_composite query parameter also for Iterable<Association> responses.

CORRECTION: meanwhile the fetch_composite query parameter is named include_childs, see #702.

[Jörg Richter]

Core: include_childs for association lists (#699).

All REST APIs: the Core's JerseyResponseFilter processes the fetch_composite query parameter also for Iterable<Association> responses.

In particular this works for the GET /core/topic/{id}/related_assocs request (see #672, see #707).

See #699.

• Changeset: 29264e454710c893e9b42ab062ae8f5a51a00905
• URL: ​https://github.com/jri/deepamehta/commit/29264e454710c893e9b42ab062ae8f5a51a00905

[Malte]

Just for the record:
Since fetchRelatingComposite vanished too having support for an include_assoc_childs parameter when returning RelatedTopic?(s) and RelatedAssociation?(s) over the REST API would be nice.