Askemos 2000 (Archive)
home · features · download · archive

CoreAPI

The core API defines how applications, (which reside on places) interact wich each other and modify their attributes. See AskemosDVM for definition of the virtual machine. TODO:provide something like a WSDL description of the core API here.

The Reply Element

In the simple case of a read type request, the reply to be returned from an actors invocation is just the output returned to the requestor.

Things are more compilicated for mutating requests (type write).

A write type request returns an element reply from the XML namespace http://www.askemos.org/2000/CoreAPI#. The children of this element describe the effect of the process step, along the axis

TODO:link from here to detailed information about the list items.

  • Hierachical structured data values, the become element.
  • interconnection: subscription, naming and growth; (networks, sozietäres Prinzip)

  • rights, relations
  • entry points: secrets etc.
  • sugar; (relations [tables], forwarding, email (TrustedCode etc.)

TODO describe the API from the code. CAUTION small changes ahead.

Data Values

One mandatory child is the become element. It contains the new state of the place. In other words it's the new data value stored conveyed. for example: if the place stores constant data, this data is returned as content of replies given to read requests. Low level slot: mind-body and corresponding xml-parse'd representation body/parsed-xml.

remark The become element is usually the 1st, since it was historically the only positional return parameter. Futhermore an alternate name "continue" is supported, which stems from the Scheme inheritance of the project. However reading http://www-sop.inria.fr/oasis/caromel/TDO/ASP-DistributedCalculi.pdf page 4 (top) was convincing to find "become" the better name.)

Optionally any number of other elements can follow. These effect the other (all but the first) axis.

An element output can be used to specify more details about the output, i.e, narrow it or generate answers with a content type other than XML.

A good application design puts everything, which is efficient decribed by the hierarchial principle (english?) at that axis.

interconnection

TODO subscription (not yet implemented)

read

To resolve the name of a link originating from a place, call the accessor (which is passed as the first argument see ActionDocument) like this: (place name)

To resolve a public name see: public-context

To read data from another place see fetch.

write

The interconnection axis is used to convey information on societal relations.

Rights

protection and capabilities see AskemosProtection. grant rights to other users.

entry points

The secret element is used to control credentials for user authorisation.

TODO document EntryPoint to create new entry points.

Sugar

forward is equivalent to an unchanged data value and a message to send to the next step of the path as decribed by the destination slot of the message. The location in the resulting message extended by an element reflecting this next step.

TODO document let, letseq etc.

See also xsql.





border
last modification: Fri, 05 May 2006 12:13:45 +0200
authors: jfw,
document identifier: A849640f672ed0df0958abc0712110f3c
delivered to public at Tue, 21 Nov 2017 01:36:46 +0100
short comments


rss

pdf :: context view

search



www.jangoo.de
24 Apr 2004 DefineInsecureMode
12 Dez 2010 FreeBSD
07 Dez 2010 BALLFeatures
05 Dez 2010 ByzantineAgreement
04 Dez 2010 SQLITE
03 Dez 2010 SRS
12 Okt 2010 WebDAV
12 Sep 2010 SQL
16 Jun 2010 BALL
16 Jun 2010 CouchDB
16 Jun 2010 AskemosServer
07 Mai 2010 SystemRequirements
30 Mar 2010 ProjectsOnThePlate
30 Mar 2010 AskemosResources
30 Mar 2010 RSchemeInstall
30 Mar 2010 INSTALL
30 Mar 2010 ChickenScheme
debug-access.scm
27 Nov 2009 subscriber
development
12 Jul 2009 test
01 Jul 2009 TrustCenter
27 Dez 2008 JKomG
26 Dez 2008 FanOut
26 Dez 2008 MIME
NetBSD
NOTE
02 Mai 2006 AskemosTopMenu
18 Nov 2008 StorageAdaptor
18 Nov 2008 PStoreStorageAdapt
18 Nov 2008 OperationTips
15 Nov 2008 PCRE
04 Nov 2008 ProgrammingLanguag
09 Sep 2008 RelatedProjects
23 Jul 2008 ModuleStructure05
17 Jun 2008 NEWS
17 Jun 2008 HTML
17 Jun 2008 ACM
22 Mai 2008 HTTP
22 Mai 2008 BOSH
10 Mai 2008 AskemosBibliograph
10 Mai 2008 JerrysDreamAbstrac
20 Apr 2008 XSLT
11 Mar 2008 CodingStyle
10 Mar 2008
09 Mar 2008 MIMEConverter
BSD
07 Mar 2008 XML
06 Mar 2008 SRFI
01 Mar 2008 RFC4810






Add


home · features · download · archive