WSO2 Mashup Server, Atom Publishing Protocol (APP) Host Object Guide

This document describes the set of host objects available for publishing using the Atom Publishing Protocol (APP). 

1.0 Introduction

The APP implementation consists of three main host objects, namely AtomFeed, AtomEntry and APPClient.
 

1.1 AtomFeed

The "AtomFeed" host object serves as the top level element of an Atom Feed Document, acting as a container for meta data and data associated with the feed. Its element children consist of meta data elements followed by zero or more "AtomEntry" child elements.

1.2 AtomEntry

The "AtomEntry" host object represents an individual entry, acting as a container for meta data and data associated with the entry. This element can appear as a child of the "AtomFeed" element, or it can appear as the document (i.e., top-level) element of a stand-alone Atom Entry Document.

1.3 APPClient

The "APPClient" host object acts as a client to an APP server. It is capable of authenticating using the given credentials and performing HTTP operations GET, POST, PUT and DELETE.


2.0 Examples


 
 //Creating an instance of APPClient
 var client = new APPClient(); 

 //Creating an instance of AtomFeed
 var feed = new AtomFeed(); 

 //Setting login credentials for the client 
 client.credentials={username:"you@email.com",password:"xxx",service:"blogger",authtype:"google"};

 //Retrieving and online feed
 feed = client.getFeed("http://www.blogger.com/feeds/000/posts/full/000"); 

 //Getting an array of individual entries from the feed 
 var entries = new Array();
 entries = feed.getEntries(); 

 //Writing the retrieved feed to a file 
 feed.writeTo("my-file-name.xml");


3.0 References