標籤: USB CONNECTOR 

作者：HelloGitHub-追夢人物

我們的博客有一個側邊欄功能，分別列出博客文章的分類列表、標籤列表、歸檔時間列表，通過點擊側邊欄對應的條目，還可以進入相應的頁面。例如點擊某個分類，博客將跳轉到該分類下全部文章列表頁面。這些數據的展示都需要開發對應的接口，以便前端調用獲取數據。

分類列表、標籤列表實現比較簡單，我們這裏給出接口的設計規範，大家可以使用前幾篇教程中學到的知識點輕鬆實現（具體實現可參考 GtiHub 上的源代碼）。

分類列表接口： /categories/

標籤列表接口：/tags/

歸檔日期列表的接口實現稍微複雜一點，因為我們需要從已有文章中歸納文章發表日期。事實上，我們在上一部教程 HelloDjango – Django博客教程（第二版）的 頁面側邊欄：使用自定義模板標籤 已經講解了如何獲取歸檔日期列表，只是當時返回的歸檔日期列表直接用於模板的渲染，而這裏我們需要將歸檔日期列表序列化后通過 API 接口返回。

具體來說，獲取博客文章發表時間歸檔列表的方法是調用查詢集（QuerySet）的 dates 方法，提取記錄中的日期。核心代碼就一句：

Post.objects.dates('created_time', 'month', order='DESC')

這裏 Post.objects.dates 方法會返回一個列表，列表中的元素為每一篇文章（Post）的創建日期（已去重），日期都是 Python 的 date 對象，精確到月份，降序排列。

有了返回的歸檔日期列表，接下來就實現相應的 API 接口視圖函數：

blog/views.py

from rest_framework import mixins, status, viewsets
from rest_framework.decorators import action
from rest_framework.serializers import DateField

class PostViewSet(
    mixins.ListModelMixin, mixins.RetrieveModelMixin, viewsets.GenericViewSet
):
	# ...

    @action(
        methods=["GET"], detail=False, url_path="archive/dates", url_name="archive-date"
    )
    def list_archive_dates(self, request, *args, **kwargs):
        dates = Post.objects.dates("created_time", "month", order="DESC")
        date_field = DateField()
        data = [date_field.to_representation(date) for date in dates]
        return Response(data=data, status=status.HTTP_200_OK)

注意這裏我們涉及到了幾個以前沒有詳細講解過的用法。

一是 action 裝飾器，它用來裝飾一個視圖集中的方法，被裝飾的方法會被 django-rest-framework 的路由自動註冊為一個 API 接口。

回顧一下我們之前在使用視圖集 viewset 時提到過 action（動作）的概念，django-rest-framework 預定義了幾個標準的動作，分別為 list 獲取資源列表，retrieve 獲取單個資源、update 和 partial_update 更新資源、destroy 刪除資源，這些 action 具體的實現方法，分別由 mixins 模塊中的混入類提供。例如 用類視圖實現首頁 API 中我們介紹過 mixins.ListModelMixin，這個混入類提供了 list 動作對應的標準實現，即 list 方法。視圖集中所有以上提及的以標準動作命名的方法，都會被 django-rest-framework 的路由自動註冊為標準的 API 接口。

django-rest-framework 默認只能識別標準命名的視圖集方法並將其註冊為 API，但我們可以添加更多非標準的 action，而為了讓 django-rest-framework 能夠識別這些方法，就需要使用 action 裝飾器進行裝飾。

其實我們可以簡單地將 action 裝飾的方法看作是一個視圖函數的實現，因此可以看到方法傳入的第一個參數為 request 請求對象，函數體就是這個視圖函數需要執行的邏輯，顯然，方法最終必須要返回一個 HTTP 響應對象。

action 裝飾器通常用於在視圖集中添加額外的接口實現。例如這裏我們已有了 PostViewSet 視圖集，標準的 list 實現了獲取文章資源列表的邏輯。我們想添加一個獲取文章歸檔日期列表的接口，因此添加了一個 list_archive_dates 方法，並使用 action 進行裝飾。通常如果要在視圖集中添加額外的接口實現，可以使用如下的模板代碼：

@action(
    methods=["allowed http method name"], 
    detail=False or True, 
    url_path="url/path", 
    url_name="url name"
)
def method_name(self, request, *args, **kwargs):
    # 接口邏輯的具體實現，返回一個 Response

通常 action 裝飾器以下 4 個參數都會設置：

methods：一個列表，指定訪問這個接口時允許的 HTTP 方法（GET、POST、PUT、PATCH、DELETE）

detail：True 或者 False。設置為 True，自動註冊的接口 URL 中會添加一個 pk 路徑參數（請看下面的示例），否則不會。

url_path：自動註冊的接口 URL。

url_name：接口名，主要用於通過接口名字反解對應的 URL。

當然，我們還可以在 action 中設置所有 ViewSet 類所支持的類屬性，例如 serializer_class、pagination_class、permission_classes 等，用於覆蓋類視圖中設置的屬性值。

以上是 action 用法的一個基本介紹，現在來分析一下 list_archive_dates 這個 action 來加深理解。

methods 參數指定接口需要通過 GET 方法訪問，detail 為 False，url_path 設置為 archive/dates，因此最終自動生成的接口路由就是 /posts/archive/dates/。如果我們設置 detail 為 True，那麼生成的接口路由就是 /posts/<int:pk>/archive/dates/，生成的 URL 中就會多一個 pk 路徑參數。

list_archive_dates 具體的實現邏輯中，以下幾點需要注意：

一是獨立使用序列化字段（Field）。之前序列化字段都是在序列化器（Serializer）裏面使用的，因為通常來說接口需要序列化一個對象的多個字段。而這個接口中只需要序列化一個時間字段（類型為 Python 標準庫中的 datetime.date），所以沒必要單獨定義一個序列化器了，直接拿 django-rest-framework 提供的用於序列化時間類型的 DateField 就可以了。用法也很簡單，實例化序列化字段，調用其 to_representation 方法，將需要序列化的值傳入即可（其實序列化器在序列對象的多個字段時，內部也是分別調用對應序列化字段的 to_representation 方法）。

我們通過列表推導式生成一個序列化后的歸檔日期列表，這個列表是可被序列化的。接着我們在接口返回一個 Response， Response 將序列化后的結果包裝返回（保存在 data 屬性中），django-rest-framework 會進一步幫我們把這個 Response 中包含的數據解析為合適的格式（例如 JSON）。

status=status.HTTP_200_OK 指定這個接口返回的狀態碼，HTTP_200_OK 是一個預定義的常數，即 200。django-rest-framework 將常用 HTTP 請求的狀態碼常數預定義 status 模塊里，使用預定義的變量而不是直接使用数字的好處一是增強代碼可讀性，二是減少硬編碼。

由於 PostViewSet 視圖集已經通過 django-rest-framework 的路由進行了註冊，因此 list_archive_dates 也會被連帶着自動註冊為一個接口。啟動開發服務器，訪問 /posts/archive/dates/，就可以看到返回的文章歸檔日期列表。

![文章歸檔日期返回結果](https://blog-1253812787.cos.ap-chengdu.myqcloud.com/

.png)

注意到紅框圈出部分，django-rest-framework API 交互後台會識別到額外定義的 action 並將它們展示出來，點擊就可以進入到相應的 API 頁面。

現在，側邊欄所需要的數據接口就開發完成了，接下來實現返回某一分類、標籤或者歸檔日期下的文章列表接口。

在 使用視圖集簡化代碼 我們開發了獲取全部文章的接口。事實上，分類、標籤或者歸檔日期文章列表的 API，本質上還是返回一個文章列表資源，只不過比首頁 API 返回的文章列表資源多了個“過濾”，只過濾出了指定的部分文章而已。對於這樣的場景，我們可以在請求 API 時加上查詢參數，django-rest-framework 解析查詢參數，然後從全部文章列表中過濾出查詢所指定的文章列表再返回。

這在 RESTful API 的設計中肯定是會遇到的，因此第三方庫 django-filter 幫我們實現了上述所說的查詢過濾功能，而且和 django-rest-framework 有很好的集成，我們可以在 django-rest-framework 中非常方便地使用 django-filter。

既然要使用它，當然是先安裝它（已安裝跳過）：pipenv install django-filter

接着我們來配置 PostViewSet，為其設置用於過濾返回結果集的一些屬性，代碼如下：

from django_filters.rest_framework import DjangoFilterBackend
from .filters import PostFilter

class PostViewSet(
    mixins.ListModelMixin, mixins.RetrieveModelMixin, viewsets.GenericViewSet
):
    # ...
    filter_backends = [DjangoFilterBackend]
    filterset_class = PostFilter

非常的簡單，僅僅設置了 filter_backends 和 filterset_class 兩個屬性。其中 filter_backends 設置為 DjangoFilterBackend，這樣 API 在返回結果時， django-rest-framework 會調用設置的 backend（這裡是 DjangoFilterBackend） 的 filter 方法對 get_queryset 方法返回的結果進行進一步的過濾，而 DjangoFilterBackend 會依據 filterset_class（這裡是 PostFilter）中定義的過濾規則來過濾查詢結果集。

當然 PostFilter 還沒有定義，我們來定義它。首先在 blog 應用下創建一個 filters.py 文件，用於存放自定義 filter 的代碼，PostFilter 代碼如下：

from django_filters import rest_framework as drf_filters

from .models import Post


class PostFilter(drf_filters.FilterSet):
    created_year = drf_filters.NumberFilter(
        field_name="created_time", lookup_expr="year"
    )
    created_month = drf_filters.NumberFilter(
        field_name="created_time", lookup_expr="month"
    )

    class Meta:
        model = Post
        fields = ["category", "tags", "created_year", "created_month"]

PostFilter 的定義和序列化器 Serializer 非常類似。

category，tags 兩個過濾字段因為是 Post 模型中定義的字段，因此 django-filter 可以自動推斷其過濾規則，只需要在 Meta.fields 中聲明即可。

歸檔日期下的文章列表，我們設計的接口傳遞 2 個查詢參數：年份和月份。由於這兩個字段在 Post 中沒有定義，Post 記錄時間的字段為 created_time，因此我們需要显示地定義查詢規則，定義的規則是：

查詢參數名 = 查詢參數值的類型（查詢的模型字段，查詢表達式）

例如示例中定義的 created_year 查詢參數，查詢參數值的類型為 number，即数字，查詢的模型字段為 created_time，查詢表達式是 year。當用戶傳遞 created_year 查詢參數時，django-filter 實際上會將以上定義的規則翻譯為如下的 ORM 查詢語句：

Post.objects.filter(created_time__year=created_year傳遞的值)

現在回到 API 交互後台，先進到 /post/ 接口下，默認返回了全部文章列表。可以看到右上角多了個過濾器（紅框圈出部分）。

點擊會彈出過濾參數輸入的交互面板，在這裏可以交互式地輸入查詢過濾參數的值。

例如選擇如下的過濾參數，得到查詢的 URL 為：

http://127.0.0.1:10000/api/posts/?category=1&tags=1&created_year=2020&created_month=1

這條查詢返回創建於 2020 年 1 月，id 為 1 的分類下，id 為 1 的標籤下的全部文章。

通過不同的查詢參數組合，就可以得到不同的文章資源列表了。

關注公眾號加入交流群

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※帶您來了解什麼是 USB CONNECTOR  ?

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

※如何讓商品強力曝光呢? 網頁設計公司幫您建置最吸引人的網站，提高曝光率!

※綠能、環保無空污,成為電動車最新代名詞，目前市場使用率逐漸普及化

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※教你寫出一流的銷售文案?

本檔前部分翻譯自以太坊定義的節點發現協議（版本4），後半部分給出了源碼實現的大致流程，以幫助理解。

以太坊節點信息的存儲採用的是Kademlia分佈式哈希表。理解節點發現協議主要是理解分佈式哈希表的原理，再加上定義的節點間通信的報文格式，節點ID的定義，距離的計算，加在一起就是以太坊的節點發現協議了。以太坊不同語言版本代碼實現上具體細節可能不同但大致流程思想是相同的。

第一部分——節點發現協議定義

節點ID

每個節點都有一個secp256k1橢圓曲線密碼學ID。節點的公鑰作為標識或節點ID。節點之間的距離為公鑰按位異或或者是公鑰的哈希值按位異或。計算公式如下：

distance(n₁, n₂) = keccak256(n₁) XOR keccak256(n₂)

節點表

節點表在節點發現協議中用於保存鄰節點信息。鄰節點被存在一個包含有K桶的路由表中。協議中\(k=16\)，即每個K桶至多含有16個節點條目。每項按時間排序——最新發現更新的節點放在前，其他在後。

每當一個新節點\(N_1\)被發現，就可以插入相應的桶中。如果桶中少於\(k\)個條目，\(N_1\)可添加到桶中第一個條目。如果桶中已含有\(k\)項，桶中最早發現的節點\(N_2\)，需要通過發送ping包重新檢測其有效性。如果沒有收到來自\(N_2\)的回復則認為該節點已失效（下線），從路由表中移除並將\(N_1\)添加到桶的前部。

以太坊文檔中Node Table一節有部分內容錯誤， For each 0 ≤ i < 256, every node keeps a k-bucket for nodes of distance between 2i and 2i+1 from itself. ，應該是\([2^i,2^{i+1})\) 。建議閱讀論文Kademlia——A Peer-to-peer Information System Based on the XOR Metric。

端點驗證

為了預防流量放大攻擊，必須驗證查詢的發送者是否參与了發現協議。如果數據包的發送者在過去12小時內發送了具有匹配ping哈希的有效pong響應，則認為該數據包的發送者已經過驗證。

遞歸查找

一次查找會找到\(k\)個距離目標節點最近的節點。節點查找發起后先選取\(a\)個距離目標節點最近的已知節點。隨後同時向這些節點發送FindNode包。其中，\(a\)是一個參數，通常可設為3。發起者繼續向先前查詢到的節點發送FindNode，如此不斷進行遞歸。對獲知的\(k\)個離目標節點最近的節點，選取\(a\)個尚未查詢過的節點向其發送FindNode。無法快速響應的節點將被排除在外，除非他們做出響應。

如果一輪FindNode查詢失敗，即沒有返回任何一個比目前節點中更近的節點，那麼將會繼續向\(k\)個最近節點未被查詢過的節點中發送FindNode。

報文協議

節點發現協議報文都是UDP報文，報文中最大的是1280字節。

packet = packet-header || packet-data

數據包頭部：

packet-header = hash || signature || packet-type
hash = keccak256(signature || packet-type || packet-data)
signature = sign(packet-type || packet-data)

當在同一UDP端口上運行多個協議時，hash可使分組格式可識別。除此並無其他目的。每個包都由節點公鑰來簽名，簽名是一個編碼長度為65字節數組，簽名值r，s，簽名驗證值v。

消息類型packet-type占單字節。包有效數據在消息類型後面。數據包頭部之後的數據用RLP進行編碼。根據EIP-8，實現應忽略列表中的任何其他元素以及列表后的任何額外數據。

Ping Packet (0x01)

packet-data = [version, from, to, expiration]
version = 4
from = [sender-ip, sender-udp-port, sender-tcp-port]
to = [recipient-ip, recipient-udp-port, 0]packet-data = [ver

expiration字段是UNIX時間戳，如果一個數據包的時戳過期了可能會無法處理。收到ping數據包后，接收節點應回復pong數據包。並可考慮將發送節點添加到節點表中。

如果在過去12小時內未與發送方進行任何通信，則除了pong之外還應發送ping以驗證對端節點。

Pong Packet (0x02)

packet-data = [to, ping-hash, expiration]

Pong是ping的響應。ping-hash須與相應的ping包hash一致。實現時應該忽略那些不含有ping包hash的pong包。

FindNode Packet (0x03)

packet-data = [target, expiration]

FindNode包用於請求距離目的節點近的節點。目標節點ID是一個65字節長度的secp256k1橢圓曲線公鑰。當接收到FindNode，接收端需要回復在本地節點表中距離請求目的節點最近的16個節點。

為了對抗流量放大攻擊，只有被驗證過的FindNode發送者才會被回復鄰節點信息。

Neighbors Packet (0x04)

packet-data = [nodes, expiration]
nodes = [[ip, udp-port, tcp-port, node-id], ... ]

FindNode包的響應。

存在的問題及建議

凡含有expiration字段的數據包都是用於防止數據重放的。因為是絕對時間戳，節點時鐘必要要十分準確以正確驗證時戳的有效性。自從2016年協議發布後起，已經接收到無數的因為用戶的時鐘不準確造成的錯誤報告。

端點驗證是不嚴密是因為FindNode的發送方永遠法確定接收端十分接收到足夠的pong。Geth按如下方式處理：如果在最近12小時內未與收件人進行通信，請通過發送ping啟動該過程。等待來自另一方的ping，回復它然後發送FindNode。

第二部分——節點發現協議代碼實現流程

流程圖

節點如何加入到對應的K桶

計算節點之間的距離很簡單，直接按位異或后的值即為兩節點之間的距離值，但節點應該加入那個K桶呢？可以公鑰哈希值按位異或后最高位的值（例如： 異或值0000 ... 0000 0101，則桶距離為3 ），則將節點放入第3個桶中。

為什麼？

主要是要理解二叉樹的拆分過程：
對每一個節點，都可以按照自己的視角對整個二叉樹進行拆分。拆分的規則是：先從根節點開始，把不包含自己的那個子樹拆分出來；然後在剩下的子樹再拆分不包含自己的下一層子樹；以此類推，直到最後只剩下自己。

拆分的最後一個K桶（距離自己最近的那個K桶），只有最後1位不同，異或值為0000 ... 0000 0001，最高位為1，第一個K桶；拆分的倒數第二個K桶，異或值為0000 ... 0000 001x，最高位為2，第二個K桶；依此類推……

在具體實現細節上，以太坊節點節點公鑰是512位，計算距離時的ID是取節點公鑰的哈希，值為256位。所以節點路由表由256個K桶組成，每個K桶最多16個節點。

參考文檔：
Node Discovery Protocol v4
聊聊分佈式散列表（DHT）的原理——以 Kademlia（Kad） 和 Chord 為例
Kademlia——A Peer-to-peer Information System Based on the XOR Metric

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※USB CONNECTOR掌控什麼技術要點? 帶您認識其相關發展及效能

※台北網頁設計公司這麼多該如何選擇?

※智慧手機時代的來臨，RWD網頁設計為架站首選

※評比南投搬家公司費用收費行情懶人包大公開

※回頭車貨運收費標準

並且后懸架形式終於從“老掉牙”的雙連桿懸架換成了支撐性更高的雙A臂后懸架，運動性能更好。所以豐田將新一代凱美瑞作為了新的NSACAR比賽的賽車，該賽事被稱為是美國人的F1比賽。不過別想太多，美規車型最高有着3。5L V6發動機可以選擇，但在我國真正走量的應該會是它的2。

前言

說起豐田凱美瑞，很多人都會覺得它是一輛非常適合家用的中型車。省油、故障率低，但要是讓年輕人或者說是新晉奶爸選的話，凱美瑞很有可能會被排除在外。畢竟現款凱美瑞略有點“老氣橫秋”、缺乏個性，很多人都認為凱美瑞是一款中年人開的車，但新一代凱美瑞絕對能打破你現在的認知。

比起現款更為激進的外觀

新一代凱美瑞的設計比起現款年輕了不少，大燈更加細長。普通版本使用的是類似是雷克薩斯的紡錘式中網設計，或許買回來換成雷克薩斯標也不違和？原霧燈位置被兩個進氣口所代替，有着濃烈的運動感。

而混動版本則維持原來的大氣形象，使用着超大的下格柵設計，而且滿滿的鍍鉻橫向格柵設計是否是你的菜？筆者表示這種過多的鍍鉻裝飾反倒弄得有點low，還不如普通版本稍微增加一點鍍鉻要好看。

（上為普通版本、下為混動版本）

普通版本和混動版本在輪轂上的選擇也是不一樣，普通版本是用的是雙色雙五幅式輪轂，看着非常運動。而混動版本則是多幅式輪轂，樣式平淡但整車配合非常協調。

（上為普通版本、下為混動版本）

在尾部造型上兩者也有着稍微的不同，普通版本向LF-LC概念車借鑒，尾燈下有着淚流式的小裝飾件，後備廂蓋造型也與混動版本不同，用外加式的小“尾翼”代替了混動版本的小鴨尾。而且普通版本使用的是的雙邊兩出共四齣的排氣管設計，相比混動版本的單邊共雙出更好看。

大相徑庭的內飾

單單從內飾來看你應該想象不了這是凱美瑞的內飾，過往凱美瑞內飾都是非常常規的設計，而新款不規則的內飾非常個性，適當的鍍鉻裝飾讓它依然有着舊款的那種檔次感。這種設計風格改變不禁讓人想到，豐田難道把那個“老幹部”設計師辭退了換成了初生牛犢不怕虎的90後設計師？

不過感謝這位設計師並沒有大膽到使用那種反人類的全觸屏式中控面板，基本是按鈕式的設計方便了我們在駕車過程中進行盲操作。鋼琴漆的飾板非常大氣，但這絕對是個指紋收集器，處女座的朋友平時記得帶條手帕擦拭面板。

配置水平，終於玩起了堆配置

一直以來豐田在配置上並沒有給到我們多少的驚喜，但新一代凱美瑞卻是相當的良心，居然標配了Toyota Safety Sense主動安全系統，這是要和本田的安全超感系統硬“肝”的意思？這個系統包括了自適應巡航、自動頭燈、車道偏離系統以及主動剎車，不過這下要想下國產後還能不能保留“標配”的這個優點。

自動駐車以及电子手剎也被加入到新一代凱美瑞上，這下遇到紅綠燈終於不用粗魯地掛入空擋然後踩下左側的腳剎了，逼格明顯上升不少。而且有着駕駛模式選項，更好玩了。

全新平台配合全新動力總成，豐田又不豐田

這次凱美瑞使用了豐田全新的TNGA平台，是第三款使用該平台的車型，有着更輕、更低重心以及更高強度車身的特點。並且后懸架形式終於從“老掉牙”的雙連桿懸架換成了支撐性更高的雙A臂后懸架，運動性能更好。所以豐田將新一代凱美瑞作為了新的NSACAR比賽的賽車，該賽事被稱為是美國人的F1比賽。

不過別想太多，美規車型最高有着3.5L V6發動機可以選擇，但在我國真正走量的應該會是它的2.5L發動機以及混動車型，前者使用的是豐田最新研發的雙噴射發動機，匹配的將是8AT自動變速箱，油耗將比起現款下降不止一個層次。根據豐田的“惰性”，相信它肯定是“很家用”的調校，平穩省油為主。而想要動力更強的2.0T發動機？豐田表示才不要把渦輪增壓發動機放到凱美瑞上呢，畢竟凱美瑞是一款適合家用的中型車。

競爭對手：

本田雅閣

官方指導價：16.98-27.98萬

現款本田雅閣經過改款不算很久的時間，還有着一定的競爭實力，2.0L以及2.4L發動機油耗較低，關鍵的一點是市場優惠較大。但是這都難掩它競爭力下降、需要換代的事實，據外媒消息稱新一代雅閣將增大車身尺寸，並且基於全新平台打造。筆者只想說“本田大法好！”

全新別克君威（未上市）

官方指導價：暫本站聲明:網站內容來源於http://www.auto6s.com/,如有侵權,請聯繫我們,我們將及時處理

【其他文章推薦】

※帶您來了解什麼是 USB CONNECTOR  ?

※自行創業缺乏曝光? 網頁設計幫您第一時間規劃公司的形象門面

※如何讓商品強力曝光呢? 網頁設計公司幫您建置最吸引人的網站，提高曝光率!

※綠能、環保無空污,成為電動車最新代名詞，目前市場使用率逐漸普及化

※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益

※教你寫出一流的銷售文案?