NAME

Padre::Service - persistent Padre::Task API

SYNOPSIS

  # Create your service, default implementation warns to output
  #  sleeps 1 second and loops over.
  my $service = Padre::Service->new();
  Wx::Event::EVT_COMMAND(
        $main , -1 , $service->event ,
        \&receive_data_from_service
  );
  $service->schedule;
  $service->
  
  
  # Later
  $service->shutdown; # Your show_my_dialog will be called...,eventually

DESCRIPTION

Padre::Service extends Padre::Task to provide a means to launch and control a long running background service, without blocking the editor.

EXTENDING

To extend this class, inherit it and implement service_loop and preferabbly hangup

service_loop should not block forever. If there is no work for the service to do then return immediately, allowing the <Task-run>> loop to continue.

  package Padre::Service::HTTPD
  use base qw( Padre::Service );
  
  sub prepare { # Build a dummy httpd.conf from $self , "BREAK" if error }
  
  sub service_start { # Launch httpd binary goodness, IPC::Run3 maybe? }
  
  sub service_shutdown { # Clean shutdown httpd binary }
  
  sub service_loop { # ->select($timeout) on your IPC handles }
  
  sub hangup { ->service_shutdown ?!?}
  
  sub terminate { # Stop everything, brutally }
  

METHODS

run

Overrides Padre::Task::run providing a non-blocking loop around the TaskManager to Service shared queue. run will call ->hangup or ->terminate on your service if instructed by the main thread, otherwise service_loop is called in void context with no arguments IN A TIGHT LOOP.

start

consider start the background_thread analog of prepare and will be called in the service thread immediatly prior to the service loop starting.

hangup

Called on your service when the editor requests a hangup. Your service is obliged to gracefully stop what it is doing and return from this method as soon as possible

terminate

Called on your service when TaskManager believes your service is hung or not responding to a <-hangup>. Your service is obliged to IMMEDIATELY stop everything and to hell with the consequences.

service_loop

Called in a loop while the service is believed to be running The default implementation emits output to the editor and sleeps for a second before returning control to the loop.

event

Accessor for this service's instance event, in the running service data may be posted to this event and the Wx subscribers will be notified

queue

accessor for the shared queue the service thread is polling for input. Calling enqueue on reference sends data to the service thread. Storable serialization rules apply. See also "event" for receiving data from the service thread

tell

Accepts a reference as it's argument, this is serialized and sent to the service thread

COPYRIGHT

Copyright 2009 The Padre develoment team as listed in Padre.pm

This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5 itself.