Jens Rehsack > Net-Radio-Location-SUPL-Test > Net::Radio::Location::SUPL::MainLoop

Download:
Net-Radio-Location-SUPL-Test-0.001.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.001   Source  

NAME ^

Net::Radio::Location::SUPL::MainLoop - Net::DBus::Reactor wrapper for SUPL Tests

DESCRIPTION ^

This package wraps Net::DBus::Reactor for controlled D-Bus objects and test instances. I/O handles of controlled objects are added to the watch list of Net::DBus::Reactor on adding and remove on removing of objects.

METHODS ^

new

Instantiates new Net::Radio::Location::SUPL::MainLoop. Thus it's a singleton, always the same instance is returned. The behavior in multi-threaded programs is undefined.

add

  Net::Radio::Location::SUPL::MainLoop->add($obj);

Adds a new object to be controlled.

If the added object wants to be triggered when a handle is ready for read ($obj->can("trigger_read")), the appropriate handle is passed to Net::DBus::Reactor/METHODS method of net::DBus::Reactor.

remove

  Net::Radio::Location::SUPL::MainLoop->remove($obj);

Removes an object from the list of controlled objects.

If the added object wants to be triggered when a handle is ready for read ($obj->can("trigger_read")), the appropriate handle is passed to Net::DBus::Reactor/METHODS method of net::DBus::Reactor.

When the last object is removed, the reactor is shut down.

run

Start's the main loop via Net::DBus::Reactor.

When Net::Radio::Location::SUPL::MainLoop hasn't been instantiated or no objects are controlled, it dies with exception.

BUGS ^

Please report any bugs or feature requests to bug-supl-test at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=SUPL-Test. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

If you think you've found a bug then please read "How to Report Bugs Effectively" by Simon Tatham: http://www.chiark.greenend.org.uk/~sgtatham/bugs.html.

SUPPORT ^

You can find documentation for this module with the perldoc command.

    perldoc Net::Radio::Location::SUPL::Test

You can also look for information at:

Where can I go for help with a concrete version?

Bugs and feature requests are accepted against the latest version only. To get patches for earlier versions, you need to get an agreement with a developer of your choice - who may or not report the issue and a suggested fix upstream (depends on the license you have chosen).

Business support and maintenance

For business support you can contact Jens via his CPAN email address rehsackATcpan.org. Please keep in mind that business support is neither available for free nor are you eligible to receive any support based on the license distributed with this package.

ACKNOWLEDGEMENTS ^

AUTHOR ^

Jens Rehsack, <rehsack at cpan.org>

LICENSE AND COPYRIGHT ^

Copyright 2012 Jens Rehsack.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

syntax highlighting: