Putting topic maps to rest.tmra2010

1

Putting Topic Maps to

REST

David Damen, Maria Patrickson

September 30th 2010Putting Topic Maps to REST

What did we want?

• Remote access:

– Manipulate topic maps

– Manipulate topics

– Search

• RESTful


2

What is out there?

• TMRAP:

– Part of Ontopia

– Limited in functionality

– Not exactly RESTful

• Topincs:

– Better in functionality, but not entirely

• TMIP:

– Built on top of path expression Topic Maps query language

– Complicated


3


4

Resources Representations

Self-descriptive messages

HATEOAS

REST

HATEOAS

• Hypermedia As The Engine Of Application State

– RESTful webapp should be modelled as a state machine

– Client transitions from state to state

– Representations contain valid state transitions


5

HATEOAS – online book store

• Book 1

• Book 2

• Book 3

Fill basket

• Credit card

• Address

Add payment information • Shipping

method

• Gift options

Confirm order


6


7

REST

Topic Maps

engine

Community support

Tropics

Tropics – resources

• Topic Maps

• Topics

• Associations

• Query results

IRIs as item identifiers

IRIs as occurrences in a navigation ontology


8

Tropics – identifying resources

• /topics/earth

• /topics/earth?ti=/topicmaps/astronomy

• /topics/earth?ti=/groups/space

September 30th 2010Putting Topic Maps To REST

9

Tropics – representations

• As a Topic Map:

– XTM 2.0/2.1

– CXTM

– JTM

• Other formats can support most (but not all) resources:

– CTM

– LTM


10

Tropics – messages

• HTTP:

– GET

– PUT

– POST

– DELETE


11

Tropics - HATEOAS

• Application state in a Topic Maps engine?

• What is a Topic Maps engine is used for?


12

Tropics - HATEOAS

• Information extraction:

– Querying

– Navigation

• Application state for a Topic Maps engine:

– The piece of information retrieved

• State transition for a Topic Maps engine client:

– Traversal from one piece of information to the next

– Querying

– Administrative functions


13

Knowledge navigation – example


14

Planet

Earth

Mars

Star

Celestial

Body

Sun

weight weight

Planet

Earth

Mars

Sattelite

ATLAS

picture

Knowledge navigation – intra Topic Map navigation


15

Planet

Earth

Mars

Star

Celestial

Body

Sun

weight weight

Planet

Earth

Mars

Sattelite

ATLAS

picture

Knowledge navigation – extra Topic Map navigation


16

Planet

Earth

Mars

Star

Celestial

Body

Sun

weight weight

Planet

Earth

Mars

Sattelite

ATLAS

picture

Knowledge navigation – merged Topic Map navigation


17

Planet

Earth

Mars

Star

Celestial

Body

Sun

weight weight

Planet

Earth

Mars

Sattelite

ATLAS

picture

Earth

picture

weight

Tropics – navigation ontology


18

Tropics – example – Earth Topic


19

Planet

Earth

Link

Parameter

Search the

engine

query

weight

http://.../searchuri

GETmethod

queryalias

qalias

Xsd:stringdata

type

Create

Topic

Tropics – Is HATEOAS worth it?

• Open question…

September 30th 2010Putting Topic Maps To REST

20

Tropics – proposed URI space

• /topicmaps/{id}

• /groups/{id}

• /topics/{id}

• /associations/{id}

• /search

• Query/filter parameters

• Versioning

=> More detailed info in the API definition at http://j.mp/tropics-api


21

Tropics – current status

• /topicmaps – GET

• /topicmaps/{id} – GET, PUT

• /groups/all – GET

• /topics – GET (only ‘has-type’)

• /topics/{id} - GET

• /search - GET (supports ‘tolog’)

• (Will be) part of Ontopia Sandbox

• Open for participation!


22

Acknowledgement


23

• Tropics:

• David Damen

• Maria Patriksson

This work has received funding from the European Commission through the

Seventh Framework Programme (FP7/2007-2013) under the Space Theme, under

grant agreement n◦218815 within the ULISSE Project (USOCs KnowLedge

Integration and Dissemination for Space Science Experimentation).

Questions?

Thank you for your time!


24

Education

Putting topic maps to rest.tmra2010