[李景山php]每天laravel-20160830|CallQueuedHandler

<?php

namespace Illuminate\Events;

use Illuminate\Contracts\Queue\Job;
use Illuminate\Contracts\Container\Container;

class CallQueuedHandler
{// Call Queued Handler
    /**
     * The container instance.
     *
     * @var \Illuminate\Contracts\Container\Container
     */
    protected $container;// a container instance.

    /**
     * Create a new job instance.
     *
     * @param  \Illuminate\Contracts\Container\Container  $container
     * @return void
     */
    public function __construct(Container $container)// this is a interface
    {
        $this->container = $container;// use this container that is Container
    }

    /**
     * Handle the queued job.
     *
     * @param  \Illuminate\Contracts\Queue\Job  $job
     * @param  array  $data
     * @return void
     */
    public function call(Job $job, array $data)// do some thing for this job, handle the queued job.
    {// Job $job is a interface , $data is a array,
        $handler = $this->setJobInstanceIfNecessary(// set Job Instance if necessary
            $job, $this->container->make($data['class'])
        );// this handler will be make if it necessary
        // $job, $this->container to make $data class

        call_user_func_array(
            [$handler, $data['method']], unserialize($data['data'])
        );// call_user_func_array

        if (! $job->isDeletedOrReleased()) {// if this job need be released or deleted
            $job->delete();
        }
    }

    /**
     * Set the job instance of the given class if necessary.
     *
     * @param  \Illuminate\Contracts\Queue\Job  $job
     * @param  mixed  $instance
     * @return mixed
     */
    protected function setJobInstanceIfNecessary(Job $job, $instance)
    {
        if (in_array('Illuminate\Queue\InteractsWithQueue', class_uses_recursive(get_class($instance)))) {
            $instance->setJob($job);
        }// if in the necessary array data, we will set this job.

        return $instance; // return this instance
    }//set the job be instance of the given class, if necessary.!

    /**
     * Call the failed method on the job instance.
     *
     * @param  array  $data
     * @return void
     */
    public function failed(array $data)
    {
        $handler = $this->container->make($data['class']);// make handler

        if (method_exists($handler, 'failed')) {// if has this function , to use it
            call_user_func_array([$handler, 'failed'], unserialize($data['data']));
        }
    }//call the failed method on the job instance.
}