TologAbstractor

The TologAbstractor executes a tolog-query and returns the resultset as an abstract model.

Note

Since panckoucke 0.3, the TologAbstractor supports Tolog 1.0

Note

In panckoucke 0.3, the class org.tm4j.panckoucke.impl.abstraction.tolog.TologAbstractor is marked as deprecated. Use org.tm4j.panckoucke.impl.abstraction.tolog.TologMatrixAbstractor instead. The following documentation describes the situation for panckoucke 0.3

Calling the Abstractor

The query is passed to the abstractor as the value of an abstraction hint. The name of the hint is defined by the String constant TologAbstractor.HINT_TOLOG_QUERY.

You pass the Tolog Abstractor an AMMember that represents a TopicMapObject. This object must be either an instance of TopicMap or it must return an instance of TopicMap by a call to its getTopicMap()-Method.

The shape of the model

The model that the TologAbstractor returns is suitable to be displayed as a table. The center node of the model is of gestalt TologMatrixAbstractor.GESTALT_TOLOG_QUERY. The query-string is stored as the represented object of that node.

The center node has one outgoing arc of gestalt TologMatrixAbstractor.GESTALT_TOLOG_RESULT_MATRIX.

This arc contains one endnode of gestalt MatrixMolder.GESTALT_MATRIX. See MatrixPattern for a more complete discussion of the shape of matrix nodes.

The columns of the result set matrix have no represented object but only a label that indicates the name of the variables.

Example

The following figures illustrate the abstract model that is derived from executing the query "select $A, $B, $C from at-family($A:tt-father, $B:tt-mother, $C:tt-children)?" on panckouckes test topic map about john.

The result of the query, presented by TMNavs Touchgraph renderer.

The same model, displayed by TMNavs table renderer.

Tolog

Tolog is a Topic Map Query Language that was developed by Lars Marius Garshol / Ontopia. Please see the Ontopia Website for details about tolog.