NAME

Zing::Watcher - Watcher Process

ABSTRACT

Watcher Process

SYNOPSIS


            
              
              package MyApp;
use parent 'Zing::Watcher';
sub perform {
  time;
}
sub receive {
  my ($self, $from, $data) = @_;
  [$from, $data];
}
sub scheme {
  ['MyApp::Handler', [], 1];
}
package main;
my $myapp = MyApp->new;
# $myapp->execute;

DESCRIPTION

This package provides a Zing::Process which forks a scheme using Zong::Fork and maintains the desired active processes. The standard process perform and receive methods operate as expected.

INHERITS

This package inherits behaviors from:

Zing::Process

LIBRARIES

This package uses type constraints from:

Zing::Types

SCENARIOS

This package supports the following scenarios:

perform


            
              
              # given: synopsis
$myapp->perform;

The perform method is meant to be implemented by a subclass and is automatically invoked iteratively by the event-loop.

receive


            
              
              # given: synopsis
$myapp->receive($myapp->name, { status => 'ok' });

The receive method is meant to be implemented by a subclass and is automatically invoked iteratively by the event-loop.

scheme


            
              
              # given: synopsis
$myapp->scheme;

The scheme method is meant to be implemented by a subclass and is automatically invoked when the process is executed.

ATTRIBUTES

This package has the following attributes:

on_scheme


            
              
              on_scheme(Maybe[CodeRef])

This attribute is read-only, accepts (Maybe[CodeRef]) values, and is optional.

METHODS

This package implements the following methods:

scheme


            
              
              scheme(Any @args) : Scheme

The scheme method, when not overloaded, executes the callback in the "on_scheme" attribute and expects a process scheme to be processed.

scheme example #1


            
              
              my $watcher = Zing::Watcher->new(
  on_scheme => sub {
    ['MyApp::Handler', [], 1]
  },
);
$watcher->scheme;

AUTHOR

Al Newkirk, awncorp@cpan.org

LICENSE

This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file".