Вход Регистрация
Файл: vendor/laravel/framework/src/Illuminate/Bus/PendingBatch.php
Строк: 284
<?php

namespace IlluminateBus;

use 
Closure;
use 
IlluminateBusEventsBatchDispatched;
use 
IlluminateContractsContainerContainer;
use 
IlluminateContractsEventsDispatcher as EventDispatcher;
use 
IlluminateSupportArr;
use 
IlluminateSupportCollection;
use 
LaravelSerializableClosureSerializableClosure;
use 
Throwable;

class 
PendingBatch
{
    
/**
     * The IoC container instance.
     *
     * @var IlluminateContractsContainerContainer
     */
    
protected $container;

    
/**
     * The batch name.
     *
     * @var string
     */
    
public $name '';

    
/**
     * The jobs that belong to the batch.
     *
     * @var IlluminateSupportCollection
     */
    
public $jobs;

    
/**
     * The batch options.
     *
     * @var array
     */
    
public $options = [];

    
/**
     * Create a new pending batch instance.
     *
     * @param  IlluminateContractsContainerContainer  $container
     * @param  IlluminateSupportCollection  $jobs
     * @return void
     */
    
public function __construct(Container $containerCollection $jobs)
    {
        
$this->container $container;
        
$this->jobs $jobs;
    }

    
/**
     * Add jobs to the batch.
     *
     * @param  iterable|object|array  $jobs
     * @return $this
     */
    
public function add($jobs)
    {
        
$jobs is_iterable($jobs) ? $jobs Arr::wrap($jobs);

        foreach (
$jobs as $job) {
            
$this->jobs->push($job);
        }

        return 
$this;
    }

    
/**
     * Add a callback to be executed after all jobs in the batch have executed successfully.
     *
     * @param  callable  $callback
     * @return $this
     */
    
public function then($callback)
    {
        
$this->options['then'][] = $callback instanceof Closure
                        
? new SerializableClosure($callback)
                        : 
$callback;

        return 
$this;
    }

    
/**
     * Get the "then" callbacks that have been registered with the pending batch.
     *
     * @return array
     */
    
public function thenCallbacks()
    {
        return 
$this->options['then'] ?? [];
    }

    
/**
     * Add a callback to be executed after the first failing job in the batch.
     *
     * @param  callable  $callback
     * @return $this
     */
    
public function catch($callback)
    {
        
$this->options['catch'][] = $callback instanceof Closure
                    
? new SerializableClosure($callback)
                    : 
$callback;

        return 
$this;
    }

    
/**
     * Get the "catch" callbacks that have been registered with the pending batch.
     *
     * @return array
     */
    
public function catchCallbacks()
    {
        return 
$this->options['catch'] ?? [];
    }

    
/**
     * Add a callback to be executed after the batch has finished executing.
     *
     * @param  callable  $callback
     * @return $this
     */
    
public function finally($callback)
    {
        
$this->options['finally'][] = $callback instanceof Closure
                    
? new SerializableClosure($callback)
                    : 
$callback;

        return 
$this;
    }

    
/**
     * Get the "finally" callbacks that have been registered with the pending batch.
     *
     * @return array
     */
    
public function finallyCallbacks()
    {
        return 
$this->options['finally'] ?? [];
    }

    
/**
     * Indicate that the batch should not be cancelled when a job within the batch fails.
     *
     * @param  bool  $allowFailures
     * @return $this
     */
    
public function allowFailures($allowFailures true)
    {
        
$this->options['allowFailures'] = $allowFailures;

        return 
$this;
    }

    
/**
     * Determine if the pending batch allows jobs to fail without cancelling the batch.
     *
     * @return bool
     */
    
public function allowsFailures()
    {
        return 
Arr::get($this->options'allowFailures'false) === true;
    }

    
/**
     * Set the name for the batch.
     *
     * @param  string  $name
     * @return $this
     */
    
public function name(string $name)
    {
        
$this->name $name;

        return 
$this;
    }

    
/**
     * Specify the queue connection that the batched jobs should run on.
     *
     * @param  string  $connection
     * @return $this
     */
    
public function onConnection(string $connection)
    {
        
$this->options['connection'] = $connection;

        return 
$this;
    }

    
/**
     * Get the connection used by the pending batch.
     *
     * @return string|null
     */
    
public function connection()
    {
        return 
$this->options['connection'] ?? null;
    }

    
/**
     * Specify the queue that the batched jobs should run on.
     *
     * @param  string  $queue
     * @return $this
     */
    
public function onQueue(string $queue)
    {
        
$this->options['queue'] = $queue;

        return 
$this;
    }

    
/**
     * Get the queue used by the pending batch.
     *
     * @return string|null
     */
    
public function queue()
    {
        return 
$this->options['queue'] ?? null;
    }

    
/**
     * Add additional data into the batch's options array.
     *
     * @param  string  $key
     * @param  mixed  $value
     * @return $this
     */
    
public function withOption(string $key$value)
    {
        
$this->options[$key] = $value;

        return 
$this;
    }

    
/**
     * Dispatch the batch.
     *
     * @return IlluminateBusBatch
     *
     * @throws Throwable
     */
    
public function dispatch()
    {
        
$repository $this->container->make(BatchRepository::class);

        try {
            
$batch $repository->store($this);

            
$batch $batch->add($this->jobs);
        } catch (
Throwable $e) {
            if (isset(
$batch)) {
                
$repository->delete($batch->id);
            }

            throw 
$e;
        }

        
$this->container->make(EventDispatcher::class)->dispatch(
            new 
BatchDispatched($batch)
        );

        return 
$batch;
    }

    
/**
     * Dispatch the batch after the response is sent to the browser.
     *
     * @return IlluminateBusBatch
     */
    
public function dispatchAfterResponse()
    {
        
$repository $this->container->make(BatchRepository::class);

        
$batch $repository->store($this);

        if (
$batch) {
            
$this->container->terminating(function () use ($batch) {
                
$this->dispatchExistingBatch($batch);
            });
        }

        return 
$batch;
    }

    
/**
     * Dispatch an existing batch.
     *
     * @param  IlluminateBusBatch  $batch
     * @return void
     *
     * @throws Throwable
     */
    
protected function dispatchExistingBatch($batch)
    {
        try {
            
$batch $batch->add($this->jobs);
        } catch (
Throwable $e) {
            if (isset(
$batch)) {
                
$batch->delete();
            }

            throw 
$e;
        }

        
$this->container->make(EventDispatcher::class)->dispatch(
            new 
BatchDispatched($batch)
        );
    }
}
Онлайн: 1
Реклама