Django Import/Export 框架入门教程

1. 项目目录结构及介绍

Django Import/Export 是一个用于数据导入和导出的Django应用，其目录结构如下：

django-import-export/
├── docs/           # 文档源代码
│   ├── _build/      # 文档构建结果
│   └── ...          # 其他文档相关文件
├── import_export/  # 应用核心代码
│   ├── admin/       # 管理界面集成代码
│   ├── fields/      # 自定义字段
│   ├── resources/   # 资源类
│   ├── tests/       # 测试用例
│   └── ...          # 其他模块
├── requirements/    # 依赖包列表
├── runtests.sh      # 测试脚本
├── setup.py         # Python 包设置文件
└── ...              # 其他辅助文件

• docs/: 包含项目文档的Markdown源文件。
• import_export/: 主要的代码库，包含了资源（Resources）、字段（Fields）和其他关键组件。
• admin/: 提供了与Django管理后台集成的功能。
• fields/: 定义自定义字段类型以处理特定的数据。
• resources/: 用户定义数据导入导出逻辑的地方。
• requirements/: 列出了项目运行所需的依赖库。
• setup.py: Python 包的安装文件，用于安装项目。

2. 项目的启动文件介绍

在Django中，启动文件通常是manage.py，它位于项目根目录下。然而，对于django-import-export这个库本身，它并没有提供直接运行的命令，因为它是一个Django应用，用于在你的Django项目中作为组件使用。

要在你的Django项目中启用django-import-export，你需要将其添加到你的settings.INSTALLED_APPS列表中，然后可以在你的模型上创建资源，并通过Django的管理接口或自定义视图来实现导入和导出功能。

例如，在settings.py中添加应用:

INSTALLED_APPS = [
    ...
    'import_export',
    ...
]

之后，你可以创建资源并定义导入和导出的行为：

from import_export import resources

class MyModelResource(resources.ModelResource):
    class Meta:
        model = MyModel
        fields = ('field1', 'field2')

3. 项目的配置文件介绍

django-import-export主要通过Django项目的settings.py文件进行配置，配置包括以下方面：

• INSTALLED_APPS: 需要把import_export添加进这个列表，使应用可用。
• IMPORT_EXPORT_USE_TRANSACTIONS: 默认为True，意味着在导入时，所有操作都会在一个事务里执行。若不想这样，可以将该值设为False。
• IMPORT_EXPORT_TMP_STORAGE_CLASS: 可选地指定临时存储类，用于在导入期间保存中间文件。

另外，你还可以在资源类（Resource）中定义各种配置选项，如哪些字段应该被导出（fields），如何处理数据验证（dehydrated_function），以及如何关联到其他模型（ForeignKeyField和ManyToManyField等）。

例如，如果你想要更改默认的错误处理行为，可以在资源类的Meta选项中定义：

class MyModelResource(resources.ModelResource):
    class Meta:
        model = MyModel
        import_id_fields = ['id']
        fail_silently = False

这将会在遇到导入错误时抛出异常而不是默默忽略。

通过上述配置和资源定义，你可以利用django-import-export在你的Django应用中轻松实现数据的导入导出功能。