®
IBM Software Group
Jazz Storage Service
Thomas
IBM Software Group | Rational software
Some questions to start…




What is Jazz Storage Service
What is Storage Area
How to create/delete a storage area
What is the format/representation of the data stored in Storage Area?
Atom,RDF,or can be self-defined?
 Are there any data transform when save/retrieve data(object) into/from
Storage Area
 How to CRUD a resource on the Storage Area
 What is the detail to save data into storage area?
2
IBM Software Group | Rational software
Overview of Storage Service
 What is storage service?
Jazz Storage Service is used to store and retrieve resource in Jazz storage
Provided by JFS component(com.ibm.team.jfs)
Definition of Storage Service
 URL of the storage service
The url is published as a part of the rootservices
• rootservices url: https://localhost:9443/jazz/rootservices
• Storage service url:<jfs:storage rdf:resource="https://localhost:9443/jazz/storage"/>
3
IBM Software Group | Rational software
Overview of Storage Area
 What is storage area?
We can think of storage area as a namespace of resources for an
application. Any resources must be bound to a storage area
Storage area is also a kind of resource,and we can access this storage
area with a url
• Storage area has a name,and the url is {storage service url}/{storage
area name}
• Storage name should be unique,e.g,we can
use,<com.ibm.team.process.storagearea>
4
IBM Software Group | Rational software
How to Create a Storage Area
 Issue a POST request to create a storage area
Request URL
• The request URL is the url of the storage service
Specify the storage area Name
• For example, com.ibm.team.process.storagearea
• The storage area name is stored in the “Name” header in the POST request
The URL of the Storage Area(After created)
• {Storage Area URL}/{Storage Area Name}
Define RDF XML representation for the storage area in the request body
• RDF format
• This xml document is used as the representation of the storage area
• e.g
5
IBM Software Group | Rational software
How to create a Storage Area(contd)
 Code Sample
6
IBM Software Group | Rational software
How to delete a Storage Area
 Specify the url of the storage area
 Issue a Delete request
 Code sample:
url: the url for the storage area
7
IBM Software Group | Rational software
How to create resource in the Storage Area
 Create Resource and stored in the storage area
 specify the storage area url
• <storage service url>+ “/” + <storage area name>
 specify the resource name
 specify the resource content
• transform the resource to XML/RDF/Atom format
 Sample
8
IBM Software Group | Rational software
How to retrieve resource from the Storage Area
 Retrive Resource from storage area
Specify the resource url
• https://localhost:9444/jfsSamples/tasks/__WyJ4eVlEd65H48ovyPB9Q
Call the Storage Service to get the RDF format data
• Transform the RDF format data to the Resource Object
Code sample
9
IBM Software Group | Rational software
How to update resource in the Storage Area
 Update resource in the storage area
Specify the resource url
• https://localhost:9444/jfsSamples/tasks/__WyJ4eVlEd65H48ovyPB9Q
Request body
• RDF format data to update
10
IBM Software Group | Rational software
How to delete resource in the storage area
 The URL of the Resource
https://localhost:9444/jfsSamples/tasks/__WyJ4eVlEd65H48ovyPB9Q
 Call the Storage Service to delete the resource
 Code Sample
11
IBM Software Group | Rational software
Apache Http API to process request
12
IBM Software Group | Rational software
Comments for request method and URL
13
IBM Software Group | Rational software
Meanings and Comments for the response code
14
IBM Software Group | Rational software
© Copyright IBM Corporation 2009. All rights reserved. The information contained in these materials is provided for informational purposes only, and is provided AS IS without warranty of any kind,
express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials. Nothing contained in these materials is intended to, nor shall have
the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM
software. References in these materials to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities
referenced in these materials may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature
availability in any way. IBM, the IBM logo, Rational, the Rational logo, Telelogic, the Telelogic logo, and other IBM products and services are trademarks of the International Business Machines
Corporation, in the United States, other countries or both. Other company, product, or service names may be trademarks or service marks of others.
15