What is the difference between RTC Work Item JAVA API and REST API?
Both APIs are listed here: https://jazz.net/wiki/bin/view/Main/RtcSdk20
In what scenarios should I use one over the other? Thanks.
|
Accepted answer
Geoffrey Clemm (30.1k●3●30●35)
| answered Aug 19 '13, 11:15 a.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER
The "Rest API" is an HTTP API, while the "Java API" is (as you would expect) a Java API.
There are two flavors of HTTP API's ... those that are OSLC-based, and those that are not. The OSLC-based HTTP API's have the advantage that you can use them to talk to a wider range of servers (any server that supports OSLC). The advantage of the Java API's are that they cover the full product functionality, but some of the Java API's are not public, which means that there is a higher risk that they may change in a subsequent release. So the general guidance would be use the OSLC-based HTTP API's when you can, but if the functionality you need is not available there, then use the non-OSLC-based HTTP API's when you want to use HTTP, and use the Java APIs when you want to use Java. Clement Liu selected this answer as the correct answer
Comments Thank you. Can you explain a little bit about the non-OSLC-based HTTP API? I thought RTC only provides the OSLC-based HTTP API and Java API. Were you actually referring to the REST API? 1
Geoffrey Clemm
commented Aug 19 '13, 4:40 p.m.
FORUM ADMINISTRATOR / FORUM MODERATOR / JAZZ DEVELOPER
There are RTC HTTP APIs that are not defined by OSLC. For example, all of the RTC SCM APIs used by the RTC web client fall in this category, because there is not yet an approved OSLC API for the SCM domain.
Thank you, Sir! |