| 1 |
package Gearman::Server::Job; |
| 2 |
use version; |
| 3 |
$Gearman::Server::Job::VERSION = qv("v1.130.1"); |
| 4 |
|
| 5 |
use strict; |
| 6 |
use warnings; |
| 7 |
|
| 8 |
use Gearman::Server::Client; |
| 9 |
use Scalar::Util; |
| 10 |
use Sys::Hostname; |
| 11 |
|
| 12 |
use fields ( |
| 13 |
'func', |
| 14 |
'uniq', |
| 15 |
'argref', |
| 16 |
'listeners', # arrayref of interested Clients |
| 17 |
'worker', |
| 18 |
'handle', |
| 19 |
'status', # [1, 100] |
| 20 |
'require_listener', |
| 21 |
'server', # Gearman::Server that owns us |
| 22 |
); |
| 23 |
|
| 24 |
sub new { |
| 25 |
my Gearman::Server::Job $self = shift; |
| 26 |
my ($server, $func, $uniq, $argref, $highpri) = @_; |
| 27 |
|
| 28 |
$self = fields::new($self) unless ref $self; |
| 29 |
|
| 30 |
# if they specified a uniq, see if we have a dup job running already |
| 31 |
# to merge with |
| 32 |
if (length($uniq)) { |
| 33 |
# a unique value of "-" means "use my args as my unique key" |
| 34 |
$uniq = $$argref if $uniq eq "-"; |
| 35 |
if (my $job = $server->job_of_unique($func, $uniq)) { |
| 36 |
# found a match |
| 37 |
return $job; |
| 38 |
} |
| 39 |
# create a new key |
| 40 |
$server->set_unique_job($func, $uniq => $self); |
| 41 |
} |
| 42 |
|
| 43 |
$self->{'server'} = $server; |
| 44 |
$self->{'func'} = $func; |
| 45 |
$self->{'uniq'} = $uniq; |
| 46 |
$self->{'argref'} = $argref; |
| 47 |
$self->{'require_listener'} = 1; |
| 48 |
$self->{'listeners'} = []; |
| 49 |
$self->{'handle'} = $server->new_job_handle; |
| 50 |
|
| 51 |
$server->enqueue_job($self, $highpri); |
| 52 |
return $self; |
| 53 |
} |
| 54 |
|
| 55 |
sub add_listener { |
| 56 |
my Gearman::Server::Job $self = shift; |
| 57 |
my Gearman::Server::Client $li = shift; |
| 58 |
|
| 59 |
push @{$self->{listeners}}, $li; |
| 60 |
Scalar::Util::weaken($self->{listeners}->[-1]); |
| 61 |
} |
| 62 |
|
| 63 |
sub relay_to_listeners { |
| 64 |
my Gearman::Server::Job $self = shift; |
| 65 |
foreach my Gearman::Server::Client $c (@{$self->{listeners}}) { |
| 66 |
next if !$c || $c->{closed}; |
| 67 |
$c->write($_[0]); |
| 68 |
} |
| 69 |
} |
| 70 |
|
| 71 |
sub relay_to_option_listeners { |
| 72 |
my Gearman::Server::Job $self = shift; |
| 73 |
my $option = $_[1]; |
| 74 |
foreach my Gearman::Server::Client $c (@{$self->{listeners}}) { |
| 75 |
next if !$c || $c->{closed}; |
| 76 |
next unless $c->option($option); |
| 77 |
$c->write($_[0]); |
| 78 |
} |
| 79 |
|
| 80 |
} |
| 81 |
|
| 82 |
sub clear_listeners { |
| 83 |
my Gearman::Server::Job $self = shift; |
| 84 |
$self->{listeners} = []; |
| 85 |
} |
| 86 |
|
| 87 |
sub listeners { |
| 88 |
my Gearman::Server::Job $self = shift; |
| 89 |
return @{$self->{listeners}}; |
| 90 |
} |
| 91 |
|
| 92 |
sub uniq { |
| 93 |
my Gearman::Server::Job $self = shift; |
| 94 |
return $self->{uniq}; |
| 95 |
} |
| 96 |
|
| 97 |
sub note_finished { |
| 98 |
my Gearman::Server::Job $self = shift; |
| 99 |
my $success = shift; |
| 100 |
|
| 101 |
$self->{server}->note_job_finished($self); |
| 102 |
|
| 103 |
if ($Gearmand::graceful_shutdown) { |
| 104 |
Gearmand::shutdown_if_calm(); |
| 105 |
} |
| 106 |
} |
| 107 |
|
| 108 |
# accessors: |
| 109 |
sub worker { |
| 110 |
my Gearman::Server::Job $self = shift; |
| 111 |
return $self->{'worker'} unless @_; |
| 112 |
return $self->{'worker'} = shift; |
| 113 |
} |
| 114 |
sub require_listener { |
| 115 |
my Gearman::Server::Job $self = shift; |
| 116 |
return $self->{'require_listener'} unless @_; |
| 117 |
return $self->{'require_listener'} = shift; |
| 118 |
} |
| 119 |
|
| 120 |
# takes arrayref of [numerator,denominator] |
| 121 |
sub status { |
| 122 |
my Gearman::Server::Job $self = shift; |
| 123 |
return $self->{'status'} unless @_; |
| 124 |
return $self->{'status'} = shift; |
| 125 |
} |
| 126 |
|
| 127 |
sub handle { |
| 128 |
my Gearman::Server::Job $self = shift; |
| 129 |
return $self->{'handle'}; |
| 130 |
} |
| 131 |
|
| 132 |
sub func { |
| 133 |
my Gearman::Server::Job $self = shift; |
| 134 |
return $self->{'func'}; |
| 135 |
} |
| 136 |
|
| 137 |
sub argref { |
| 138 |
my Gearman::Server::Job $self = shift; |
| 139 |
return $self->{'argref'}; |
| 140 |
} |
| 141 |
|
| 142 |
1; |