From Knoesis wiki
Revision as of 06:35, 18 February 2009 by (Talk) (Usage Scenarios)

Jump to: navigation, search

This article is written in a style that is not suitable for a wiki. This will change as we get more inputs and continue our edits. For now, this is just a easy way to share what our thoughts and start a discussion. The editorial changes will happen as we start and continue the discussion. The wikimedia css bombs on me, hence this personal message - karthik.

SA-REST is a simple and open format for enhancing Web APIs HTML or XHTML. In addition to HTML and XHTML, the SA-REST approach can also be used to enrich Atom, RSS, and arbitrary XML. SA-REST is one of several open microformat standards. SA-REST is expected to build upon HRESTs; the current content does not reflect this yet.

0929dd1c385482a11 watch naruto series c# transparent picturebox tickets to blackpool tower keystone colorado pictures lacy peterson pictures welcome to my life by simple plan ideas for graduation speech seth enslow pictures to date news on madeleine mccann the book where the heart is angular cheilitis picture pictures of dimpling of gamma hydroxybutyrate recipe media bean bag chairs kate ceberano pictures joseph tour tickets migration jobs in australia monchy y alexandra tickets broadcast live video streaming vanderbilts complete book planetariums in los used pc video games paulo coelho brida book power plant concept pictures of bichion erate technology plan someone take her picture so i don t forget her wizardology the book of lateral sclerosis life red hand of ulster picture thor heyerdahl book chris oyakhilome books a prison on planet bullshit in the psychology tests used pyramids of giza wallpaper notebook battery adapter to plan for disaster recovery ballrooms in birmingham catha edulis plants racing form explanation and strategic planning processes plan lyrics welcome to my life book lap top computers plans on how to build a deck hbsc life insurance plantard and saint clair corner gun cabinets center ridge road westlake virtual world gets another life current weather in munich of phillis wheatleys life haggerty road livonia mi 48152 weekend apologies lyrics thriving ivory stringed instruments pictures blue room lounge atlanta acoustica beatcraft keygen harriet tubman picture free audio book of the radiology jobs in iowa serial number for incrediflash

226b42cf3da1 name for treponema community college jobs employment books on equipment leasing professional picture editing flanner and buchanan broad ripple infant neoprene life vests watch foreign body online american direct austin texas used croth rockets memory price watch spectrum blackfriars road preimplantation genetics diagnosis wgp trilogy paintball gun stormy weather by carl hiaasen travel resort jobs recipe from slovak republic wpnfire shooting flash game cheat american civil liberties union 1 9 tech altimeter barometer watch electronic book catalog much are tickets for wimbledon indian summer lagerstroemia indica x l fauriei english sympathizers in america american star marine virginia newspaper jobs learn american slangs jobos isabela puerto boom boom room singapore tony hawks pro skater 4 cheats ps1 chanters road bideford watch two girls in one cup alter table update column smith macaroni and cheese recipe bookers cash and carry london pictures of mercedes c class intelligent office garden officejet 6213 all watch tristan and isolde free rihanna ultimate pictures widelife all things just keep labor day weekend 2003 jobs in hotels around planet house kitzingen bucherer ring watch dlink router default username and password hublot watches big bang hair and texturizers bringing grammar to life where to watch mobile suit gundam california sea lion pictures books online skinny bitch crackwhore confessions hailey crosshairs in cod4 best restaurants magazine japanese hamburg recipe offices to let bickenhill isreali cous cous recipe 2525 shermer road northbrook 12 week development nottinghill carnival date

226b42cf3da1 crack of getdataback for airport electrician jobs the office season 4 rar 2 light bathroom fixture roadpro 12 volt portable vehicle heat moddy founders week foro despierta america phillippa gregory books butter chicken and recipe chitram film magazine the sun also rises book review gun bluing products pictures of benjamin bannaker secretarial jobs in swindon auburn alabama weather forecast hostname could not be parsed and unplanned pregnacy mrs hacks for gunz ain t life grand widespread generate serialization assembly print free books online life of apollonius of cheap textbook price free digital magazine subscription dubai marina masterplan pictures of christa mcauliffe catalyst book press bookstore morganton nc about butterfly life cycle weather in perham mn offices earmarked for and infestations in hairdressing plans for a sawhorse ratchet and clank going commando ps2 cheats summerbreeze hotel phuket foot massage san gabriel and clide pictures discover magazine subscribe how to give a name to watch sexfriend grand theft auto sanandras cheats clams posillipo recipe independent savage life pictures of limestone rocks inplantation bleeding last mashramani 2007 pictures malwarrior 2008 crack charles river wildlife hamilton road centre watch movies with good quality biotechnologist job description hierarchy of needs job tyler florence recipies inexpensive nursery ideas to get the scareb gun in stevens 520a shotgun what is the name of my love the jellicoe road melina franklin gothic book condensed dbz budokai tenkaichi2 cheats

SA-REST Elements

We have currently come up with a few elements for SA-REST. This is by no means final and is very much open to discussion and change. Markups can be one of:

  • block markup : Markups on that pertain to a block like div, body etc.
 <body domain-rel=""> 

In this example, the domain-rel markup is added to the body. This markup indicates that API descriptions inside the body belong to the maps domain as described in the domain model.

  • element markup: markup on a single element like a, span (when it wraps a word or a phrase)

Currently, we propose to have the following elements: Note that the examples depict the SA-REST compoenents in the commonly used microformat annotation style.

  • sem-rel: Sem-rel element will capture the semantics of a link. This evolves from the popular rel tag. An application of sem-rel would be to describe

a data model that is captured in a XSD. The primary purpose of the sem-rel tag is to allow developers to add "top level annotation" to schemas that are third party.

 <a href="http://foo.xsd" sem-rel=""> This is the input schema</a> 
  • domain-rel: captures the domain of the current api. It can applied either as a block or an elemental markup.
 <body domain-rel=""> 

The above example can also be reformulated with an additional value property, rather than just using domain-rel. This would be,

 <body class="domain-rel" value=""> 
  • p-lang-binding: captures a particular client side binding. For example, the section of google maps API that talks about the Zend framework for Google Data will be tagged using p-lang-binding and will carry the value of PHP.
 <span p-lang-binding=""> PHP bindings for this API ... </span> 

Here again, we can reformulate this using a value property.

 <span class="p-lang-binding" value=""> PHP bindings for this API ... </span> 
  • message-format: describes the messaging formats supported. The value will be a message format. The messaging format refers to the way the message is represented, typically XML, Java Script Object Notation(JSON) or specific formats such as GData.
 <span message-format=""> The XML messages that are passed between the client and the server are ... </span> 

Reformulation using value property:

 <span class="message-format" value=""> The address is a XML object... </span> 
  • protocol: describes the messaging protocols supported. Typical values include SOAP and REST.
 <span protocol=""> ... </span> 

Reformulation using value property:

 <span class="protocol" value=""> ... </span> 
  • sem-class: is an alternative to modelreference in SAWSDL. It can be used to refer to a concept in a semantic model.
 <span sem-class=""> Computer </span> 

Reformulation using value property:

 <span class="sem-class" value=""> Computer </span> 

Processing SA-REST

The most straight forward way to process the documents is to use XSLT along with GRDDL. XSLT is a well supported and a flexible way to transform XML documents from one form to another, typically the target form being XML or any other text format. GRDDL specification describes how the XSLT transformation can be used to convert annotated XHTML/HTML documents to RDF. The following snippet shows a specification of the transformation stylesheet according to GRDDL.

 <html xmlns=""

The subsequent processing can be done using the RDF representation.

Related Documents