物品管道

在一个项目被蜘蛛刮下之后，它被发送到项目管道，它通过顺序执行的几个组件进行处理。

每个项目管道组件（有时也称为“项目管道”）是一个实现简单方法的Python类。他们收到一个项目并对其执行操作，还决定该项目是否应该继续通过管道或被丢弃并且不再被处理。

项目管道的典型用途是：

清理HTML数据

验证刮取的数据（检查项目是否包含某些字段）

检查重复（并删除它们）

将刮取的项目存储在数据库中

编写自己的物料管道

每个项目管道组件是一个Python类，必须实现以下方法：

process_item（self，item，spider）

每个项目管道组件都调用此方法。 process_item（）必须：返回带数据的dict，返回一个Item（或任何后代类）对象，返回一个Twisted Deferred或者提高DropItem异常。丢弃物品不再被进一步的管道组件处理。

参数：

item（Item对象或dict） - 被刮取的项目

蜘蛛（蜘蛛对象） - 蜘蛛刮的物品

此外，他们还可以执行以下方法：

open_spider（self，spider）

当蜘蛛打开时调用此方法。

参数：spider（Spider对象） - 打开的蜘蛛

close_spider（自我，蜘蛛）

当蜘蛛关闭时调用此方法。

参数：蜘蛛（Spider对象） - 被关闭的蜘蛛

from_crawler（cls，crawler）

如果存在，则调用此类方法从Crawler创建管道实例。它必须返回管道的新实例。履带式对象提供对所有Scrapy核心组件的访问，如设置和信号;它是管道访问它们并将其功能挂钩到Scrapy中的一种方式。

参数：crawler（Crawler object） - 使用此管道的爬网程序

项目管道示例

价格验证和丢弃物品没有价格

我们来看看以下假设管道，调整不包括增值税（price_excludes_vat属性）的项目的价格属性，并删除不包含价格的项目：

from scrapy.exceptions import DropItem

class PricePipeline(object):

    vat_factor = 1.15

    def process_item(self, item, spider):
        if item['price']:
            if item['price_excludes_vat']:
                item['price'] = item['price'] * self.vat_factor
            return item
        else:
            raise DropItem("Missing price in %s" % item)

将项目写入JSON文件

以下管道将所有已刮取的项目（从所有蜘蛛）存储到单个items.jl文件中，其中包含以JSON格式序列化的每行一个项目：

import json

class JsonWriterPipeline(object):

    def open_spider(self, spider):
        self.file = open('items.jl', 'w')

    def close_spider(self, spider):
        self.file.close()

    def process_item(self, item, spider):
        line = json.dumps(dict(item)) + "\n"
        self.file.write(line)
        return item

注意

JsonWriterPipeline的目的只是介绍如何编写项目管道。如果您真的想将所有已查找的项目存储到JSON文件中，您应该使用Feed导出。

将项目写入MongoDB

在这个例子中，我们将使用pymongo将项目写入MongoDB。 MongoDB地址和数据库名称在Scrapy设置中指定; MongoDB集合以项目类命名。

此示例的主要内容是显示如何使用from_crawler（）方法以及如何正确清理资源：

import pymongo

class MongoPipeline(object):

    collection_name = 'scrapy_items'

    def __init__(self, mongo_uri, mongo_db):
        self.mongo_uri = mongo_uri
        self.mongo_db = mongo_db

    @classmethod
    def from_crawler(cls, crawler):
        return cls(
            mongo_uri=crawler.settings.get('MONGO_URI'),
            mongo_db=crawler.settings.get('MONGO_DATABASE', 'items')
        )

    def open_spider(self, spider):
        self.client = pymongo.MongoClient(self.mongo_uri)
        self.db = self.client[self.mongo_db]

    def close_spider(self, spider):
        self.client.close()

    def process_item(self, item, spider):
        self.db[self.collection_name].insert_one(dict(item))
        return item

拍摄项目的截图

此示例演示如何从process_item（）方法返回Deferred。它使用Splash来呈现项目URL的屏幕截图。流水线要求本地运行Splash的实例。下载请求后，延迟回调触发，它将项目保存到文件中，并将文件名添加到项目中。

import scrapy
import hashlib
from urllib.parse import quote


class ScreenshotPipeline(object):
    """Pipeline that uses Splash to render screenshot of
    every Scrapy item."""

    SPLASH_URL = "http://localhost:8050/render.png?url={}"

    def process_item(self, item, spider):
        encoded_item_url = quote(item["url"])
        screenshot_url = self.SPLASH_URL.format(encoded_item_url)
        request = scrapy.Request(screenshot_url)
        dfd = spider.crawler.engine.download(request, spider)
        dfd.addBoth(self.return_item, item)
        return dfd

    def return_item(self, response, item):
        if response.status != 200:
            # Error happened, return item.
            return item

        # Save screenshot to file, filename will be hash of url.
        url = item["url"]
        url_hash = hashlib.md5(url.encode("utf8")).hexdigest()
        filename = "{}.png".format(url_hash)
        with open(filename, "wb") as f:
            f.write(response.body)

        # Store filename in item.
        item["screenshot_filename"] = filename
        return item

重复过滤

一个过滤器，用于查找重复项目，并删除已处理的项目。假设我们的项目有一个唯一的id，但是我们的蜘蛛会返回具有相同id的多个项目：

from scrapy.exceptions import DropItem

class DuplicatesPipeline(object):

    def __init__(self):
        self.ids_seen = set()

    def process_item(self, item, spider):
        if item['id'] in self.ids_seen:
            raise DropItem("Duplicate item found: %s" % item)
        else:
            self.ids_seen.add(item['id'])
            return item

激活物料管道组件

要激活项目管道组件，您必须将其类添加到ITEM_PIPELINES设置中，如下例所示：

ITEM_PIPELINES = {
    'myproject.pipelines.PricePipeline': 300,
    'myproject.pipelines.JsonWriterPipeline': 800,
}

您在此设置中分配给类的整数值决定了它们的运行顺序：项目从低值到高价值类。通常在0-1000范围内定义这些数字。