Debian Codegraph @

lib/Gearman/Server/Job.pm

raw
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;