国产xxxx99真实实拍_久久不雅视频_高清韩国a级特黄毛片_嗯老师别我我受不了了小说

資訊專欄INFORMATION COLUMN

Swoft 源碼剖析 - Swoft 中的注解機制

zzbo / 2186人閱讀

摘要:中的注解注解是里面很多重要功能特別是,容器的基礎。主流的框架中使用的注解都是借用型注釋塊型注釋中的定義自己的注解機制。在中是注解信息的最終裝載容器。使用的信息構造實例或獲取現有實例以上就是注解機制的整體實現了。源碼剖析系列目錄

作者:bromine
鏈接:https://www.jianshu.com/p/ef7...
來源:簡書
著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。
Swoft Github: https://github.com/swoft-clou...

PHP中的注解

注解(Annotations)是Swoft里面很多重要功能特別是AOP,IoC容器的基礎。
注解的定義是:“附加在數據/代碼上的元數據(metadata)。”框架可以基于這些元信息為代碼提供各種額外功能。

以另一個框架PHPUnit為例,注解@dataProvider聲明一個方法作為測試用例方法的數據提供器。當PHPUnit框架執行到某一個測試用例方法時,會迭代該數據提供器,并將其返回的數據作為參數傳入測試用例方法,為測試用例方法提供一套用例所需的測試數據。

//摘自phpseclib庫的單元測試
public function formatLogDataProvider()
{
    return array(
        array(
            //該參數會作為$message_log參數傳到testFormatLog()測試用例方法中
            array("hello world"),            
            array("<--"),               //$message_number_log     
            "<--
00000000  68:65:6c:6c:6f:20:77:6f:72:6c:64                 hello world

"http://$expected
        ),
        array(
            array("hello", "world"),
            array("<--", "<--"),
            "<--
00000000  68:65:6c:6c:6f                                   hello

" .
            "<--
00000000  77:6f:72:6c:64                                   world

"
        ),
    );
}

/**
 * @dataProvider formatLogDataProvider
 */
public function testFormatLog(array $message_log, array $message_number_log, $expected)
{
     $ssh = $this->createSSHMock();

    $result = $ssh->_format_log($message_log, $message_number_log);
    $this->assertEquals($expected, $result);
}

一般而言,在編程屆中注解是一種和注釋平行的概念。
注釋提供對可執行代碼的說明,單純用于開發人員閱讀,不影響代碼的執行;而注解往往充當著對代碼的聲明和配置的作用,為可執行代碼提供機器可用的額外信息,在特定的環境下會影響程序的執行。

但是由于官方對PHP的Annotation方案遲遲沒有達成一致(最新進展可以在 PHP: rfc 看到),目前PHP沒有對注解的官方實現。主流的PHP框架中使用的注解都是借用T_DOC_COMMENT型注釋塊(/*型注釋/)中的@Tag,定義自己的注解機制。

想對PHP注解的發展史要有更多了解的朋友可以參考Rafael Dohms的這個PPT:https://www.slideshare.net/rd...

Doctrine注解引擎

Swoft沒有重新造輪子,搞一個新的的注解方案,而是選擇使用 Doctrine的注解引擎

Doctrine的注解方案也是基于T_DOC_COMMENT型注釋的,Doctrine使用反射獲取代碼的T_DOC_COMMENT型注釋,并將注釋中的特定類型@Tag映射到對應注解類。為此,Swoft首先要為每一個框架自定義的注解定義注解類。

注解定義

@Breaker注解的注解類定義如下。

name = $values["value"];
        }
        if (isset($values["name"])) {
            $this->name = $values["name"];
        }
    }

     //按需寫的getter setter code....
}

簡單幾行,一個@Breaker的注解類的定義工作就完成了。

注解類加載器的注冊

在框架的bootstap階段,swoft會掃描所有的PHP源碼文件獲取并解析注解信息。

使用Doctrine首先需要提供一個類的自動加載方法,這里直接使用了swoft當前的類加載器。Swoft的類加載器由Composer自動生成,這意味著注解類只要符合PSR-4規范即可自動加載。

//SwoftBeanResourceAnnotationResource.php
/**
 * 注冊加載器和掃描PHP文件
 *
 * @return array
 */
protected function registerLoaderAndScanBean()
{
        // code code....

        AnnotationRegistry::registerLoader(function ($class) {
            if (class_exists($class) || interface_exists($class)) {
                return true;
            }

            return false;
        });

        // code code....

    return array_unique($phpClass);
}
使用Doctrine獲取注解對象

掃描各源碼目錄獲取PHP類后,Sworft會遍歷類列表加載類,獲取類級別,方法級別,屬性級別的所有注解對象。結果存放在AnnotationResource的$annotations成員中。

//SwoftBeanResourceAnnotationResource.php
/**
 * 解析bean注解
 *
 * @param string $className
 * @return null
 */
public function parseBeanAnnotations(string $className)
{
    if (!class_exists($className) && !interface_exists($className)) {
        return null;
    }

    // 注解解析器
    $reader           = new AnnotationReader();
    $reader           = $this->addIgnoredNames($reader);//跳過Swoft內部注解
    $reflectionClass  = new ReflectionClass($className);
    $classAnnotations = $reader->getClassAnnotations($reflectionClass);

    // 沒有類注解不解析其它注解
    if (empty($classAnnotations)) {
        return;
    }

    foreach ($classAnnotations as $classAnnotation) {
        $this->annotations[$className]["class"][get_class($classAnnotation)] = $classAnnotation;
    }

    // 解析屬性
    $properties = $reflectionClass->getProperties();
    foreach ($properties as $property) {
        if ($property->isStatic()) {
            continue;
        }
        $propertyName        = $property->getName();
        $propertyAnnotations = $reader->getPropertyAnnotations($property);
        foreach ($propertyAnnotations as $propertyAnnotation) {
            $this->annotations[$className]["property"][$propertyName][get_class($propertyAnnotation)] = $propertyAnnotation;
        }
    }

    // 解析方法
    $publicMethods = $reflectionClass->getMethods(ReflectionMethod::IS_PUBLIC);
    foreach ($publicMethods as $method) {
        if ($method->isStatic()) {
            continue;
        }

        $methodName = $method->getName();

        // 解析方法注解
        $methodAnnotations = $reader->getMethodAnnotations($method);

        foreach ($methodAnnotations as $methodAnnotation) {
            $this->annotations[$className]["method"][$methodName][get_class($methodAnnotation)][] = $methodAnnotation;
        }
    }
}
注解的解析

doctrine完成的功能僅僅是將注解映射到將用@Annotation聲明的注解類。swoft需要自行處理注解對象獲取注解中的信息。這一步有兩個重要功能:

掃描搜集Bean的所有信息包括Bean名,類名以及該Bean各個需要注入的屬性信息等,存放到ObjectDefinition數組中。

//SwoftBeanWrapperAbstractWrapper.php
/**
 * 封裝注解
 *
 * @param string $className
 * @param array  $annotations 注解3劍客,包含了類級別,方法級別,屬性級別的注解對象,注解解析流程你會一直看到他
 *
 * @return array|null
 */
public function doWrapper(string $className, array $annotations)
{
    $reflectionClass = new ReflectionClass($className);

    // 解析類級別的注解
    $beanDefinition = $this->parseClassAnnotations($className, $annotations["class"]);

    //code...

    // parser bean annotation
    list($beanName, $scope, $ref) = $beanDefinition;

    // 初始化Bean結構,并填充該Bean的相關信息
    $objectDefinition = new ObjectDefinition();
    $objectDefinition->setName($beanName);
    $objectDefinition->setClassName($className);
    $objectDefinition->setScope($scope);
    $objectDefinition->setRef($ref);

    if (!$reflectionClass->isInterface()) {
        // 解析屬性,并獲取屬性相關依賴注入的信息
        $properties = $reflectionClass->getProperties();
        $propertyAnnotations = $annotations["property"]??[];
        $propertyInjections = $this->parseProperties($propertyAnnotations, $properties, $className);
        $objectDefinition->setPropertyInjections($propertyInjections);//PropertyInjection對象
    }

    // 解析方法
    $publicMethods = $reflectionClass->getMethods(ReflectionMethod::IS_PUBLIC);
    $methodAnnotations = $annotations["method"] ??[];
    $this->parseMethods($methodAnnotations, $className, $publicMethods);
   
    return [$beanName, $objectDefinition];
}

在注解解析時Parser會調用相關的Collector搜集功能所需的信息,譬如進行事件注冊。

舉個例子,BootstrapParser的解析僅僅就是搜集注解。Collector在Swoft中是注解信息的最終裝載容器。一般而言@XXXX注解對應的Parser和Collect就是XXXXParser和XXXXCollect,知道這個慣例會大大方便你對Swoft源碼的閱讀。

//SwoftBeanParserBootstrapParser.php
class BootstrapParser extends AbstractParser
{
    /**
     * @param string    $className
     * @param Bootstrap $objectAnnotation
     * @param string    $propertyName
     * @param string    $methodName
     * @param mixed     $propertyValue
     *
     * @return array
     */
    public function parser(string $className, $objectAnnotation = null, string $propertyName = "", string $methodName = "", $propertyValue = null)
    {
        $beanName = $className;
        $scope    = Scope::SINGLETON;

        BootstrapCollector::collect($className, $objectAnnotation, $propertyName, $methodName, $propertyValue);

        return [$beanName, $scope, ""];
    }
}

由于框架執行前必須完整的獲取各種注解到Collertor和生成Bean定義集合,所以Swoft是不進行lazyload的。

注解的使用

現在我們終于可以用一個的例子來講解注解是如何運行。InitMbFunsEncoding是一個實現了Bootable的類,他的作用是在應用啟動時候設定系統的編碼。但是僅僅實現了Bootable接口并不會讓框架在啟動時自動調用他。
因此我們需要InitMbFunsEncoding為添加一個@Bootstrap(order=1)類注解,讓他成為一個Bootstrap型的Bean。

//SwoftBootstrapBoots.InitMbFunsEncoding.php

我們在上文已經提過框架啟動時會掃描PHP源碼

將Bean的定義信息存放到ObjectDefinition數組中

將注解信息存放到各個Collector中

因此在框架的Bootstrap階段,可以從BootstrapCollector中直接獲取所有@Bootstrap型的Bean,實例化并Bean執行。

 $name){
        //使用Bean的ObjectDefinition信息構造實例或獲取現有實例
        /* @var Bootable $bootstrap*/
        $bootstrap = App::getBean($bootstrapBeanName);
        $bootstrap->bootstrap();
    }
}

//code ...

以上就是Swoft注解機制的整體實現了。

Swoft源碼剖析系列目錄:https://segmentfault.com/a/11...

文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。

轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/30704.html

相關文章

  • Swoft 源碼剖析 - 目錄

    摘要:作者鏈接來源簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。同時順手整理個人對源碼的相關理解,希望能夠稍微填補學習領域的空白。系列文章只會節選關鍵代碼輔以思路講解,請自行配合源碼閱讀。 作者:bromine鏈接:https://www.jianshu.com/p/2f6...來源:簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。Swoft...

    qpwoeiru96 評論0 收藏0
  • Swoft 源碼剖析 - Swoole和Swoft的那些事 (Http/Rpc服務篇)

    摘要:和服務關系最密切的進程是中的進程組,絕大部分業務處理都在該進程中進行。隨后觸發一個事件各組件通過該事件進行配置文件加載路由注冊。事件每個請求到來時僅僅會觸發事件。服務器生命周期和服務基本一致,詳情參考源碼剖析功能實現 作者:bromine鏈接:https://www.jianshu.com/p/4c0...來源:簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。S...

    張漢慶 評論0 收藏0
  • Swoft 源碼剖析 - 代碼自動更新機制

    摘要:作者鏈接來源簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。文件重載管理進程注冊了一個名為的該進程會在系統引導的最后一個階段,即啟動前啟動。 作者:bromine鏈接:https://www.jianshu.com/p/e63...來源:簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。Swoft Github: https://githu...

    iflove 評論0 收藏0
  • Swoft 源碼剖析 - Swoole和Swoft的那些事(Task投遞/定時任務篇)

    摘要:作為定時任務的執行者,通過每喚醒自身一次,然后把執行表遍歷一次,挑選當下需要執行的任務,通過投遞出去并更新該任務執行表中的狀態。 作者:bromine鏈接:https://www.jianshu.com/p/b44...來源:簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。Swoft Github: https://github.com/swoft-clou.....

    vvpvvp 評論0 收藏0
  • Swoft 源碼剖析 - 連接池

    摘要:基于擴展實現真正的數據庫連接池這種方案中,項目占用的連接數僅僅為。一種是連接暫時不再使用,其占用狀態解除,可以從使用者手中交回到空閑隊列中這種我們稱為連接的歸隊。源碼剖析系列目錄 作者:bromine鏈接:https://www.jianshu.com/p/1a7...來源:簡書著作權歸作者所有,本文已獲得作者授權轉載,并對原文進行了重新的排版。Swoft Github: https:...

    rozbo 評論0 收藏0

發表評論

0條評論

zzbo

|高級講師

TA的文章

閱讀更多
最新活動
閱讀需要支付1元查看
<