Difference between revisions of "Ackis2.0/Protocol"

From Makers Local 256
Jump to: navigation, search
(message: added message types)
m (=type: fix title)
Line 21: Line 21:
 
===data===
 
===data===
 
* contents of message
 
* contents of message
===type==
+
===type===
 
* type of message
 
* type of message
 
** targeted
 
** targeted

Revision as of 22:13, 15 July 2008

Packet

responseid

  • Typically the only attribute in the <packet> tag
  • String of a reasonable length

register

  • There can be more then one of these for components

type

  • typically client or module or resource but not limited to such

callback

  • regular expressions for messages without previous responseids

mime

  • the mimetype for the types of messages that can be sent to this client.

message

mime

  • the mimetype of the message, common values are:
    • text/plain
    • image/jpeg

data

  • contents of message

type

  • type of message
    • targeted
    • triggered
    • emote
    • topic
    • mode
    • quit
    • join
    • part
    • none

components?

action

  • list
    • returns a list of all of the components of type
  • type
    • module or resource or something the core will have listed.

resource

type

  • something like database or image

action

  • something like query for the database resource or convert for the image resource

results

  • rides on the responseid back to the calling component
  • maybe this is just a subset of <message>s?

variable

  • lets a component retrieve a variable from an other component that initiated a message
  • utilizes the same responseid that the originating message came in on?

name

  • contains the name of the variable to be returned

value

  • contains the value of the variable to be returned

error

  • describes an error encountered by either the core or a component and will close the connection in most cases.

type

  • describes the type of error such as "protocol" or whatever may be appropriate

message

  • detailed description of the failure
    • "ResponseID not found in lookup table"
    • "Duplicate responseid detected"
    • "Malformed XML".