GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
XML::Atom::Client(3) User Contributed Perl Documentation XML::Atom::Client(3)

XML::Atom::Client - A client for the Atom API

    use XML::Atom::Client;
    use XML::Atom::Entry;
    my $api = XML::Atom::Client->new;
    $api->username('Melody');
    $api->password('Nelson');

    my $entry = XML::Atom::Entry->new;
    $entry->title('New Post');
    $entry->content('Content of my post.');
    my $EditURI = $api->createEntry($PostURI, $entry);

    my $feed = $api->getFeed($FeedURI);
    my @entries = $feed->entries;

    my $entry = $api->getEntry($EditURI);

XML::Atom::Client implements a client for the Atom API described at http://bitworking.org/projects/atom/draft-gregorio-09.html, with the authentication scheme described at http://www.intertwingly.net/wiki/pie/DifferentlyAbledClients.

NOTE: the API, and particularly the authentication scheme, are still in flux.

XML::Atom::Client supports both the REST and SOAP-wrapper versions of the Atom API. By default, the REST version of the API will be used, but you can turn on the SOAP wrapper--for example, if you need to connect to a server that supports only the SOAP wrapper--by calling use_soap with a value of 1:

    $api->use_soap(1);

If called without arguments, returns the current value of the flag.

If called with an argument, sets the username for login to $username .

Returns the current username that will be used when logging in to the Atom server.

If called with an argument, sets the password for login to $password .

Returns the current password that will be used when logging in to the Atom server.

Creates a new entry.

$entry must be an XML::Atom::Entry object.

Retrieves the entry with the given URL $EditURI.

Returns an XML::Atom::Entry object.

Updates the entry at URL $EditURI with the entry $entry, which must be an XML::Atom::Entry object.

Returns true on success, false otherwise.

Deletes the entry at URL $EditURI.

Retrieves the feed at $FeedURI.

Returns an XML::Atom::Feed object representing the feed returned from the server.

Methods return "undef" on error, and the error message can be retrieved using the errstr method.

Please see the XML::Atom manpage for author, copyright, and license information.
2021-04-28 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.