RAA - xcapclient/1.0

Description

XCAP (RFC 4825) is a protocol on top of HTTP which allows a client to manipulate the contents of Presence Information Data Format (PIDF) based presence documents. These documents are stored in a server in XML format and are fetched, modified, replaced or deleted by the client. The protocol allows multiple clients to manipulate the data, provided that they are authorized to do so. XCAP is already used in SIMPLE-based presence systems for manipulation of presence lists and presence authorization policies.

XCAPClient library implements the XCAP protocol in client side, allowing the applications to get, store, modify and delete XML documents in the server.

Features

The library implements the following features:

• Fetch, create/replace and delete a document.
• Fetch, create/replace and delete a document element (XML node).
• Fetch, create/replace and delete an element attribute.
• Full configurable parameters allowing customized fields for each XCAP application, such auid, XML namespace, MIME-Type, scope (:user or :global) and default document name ("index" if not set).
• Fetch the namespaces and prefixes of a document node as they are used in the server.
• Manage of multiple documents per XCAP application.
• Fetch the XCAP server auids, extensions and namespaces ("xcap-caps" application).
• SSL.
• Digest and Basic HTTP authentication.
• Raise custom Ruby exception for each HTTP error response.

Ruby XCAPClient works in Ruby 1.8 and 1.9.