Django下载使用、文件介绍-【二】项目文件介绍

【1】APP

  • 这并不是指手机上的app

(1)介绍

  • 在Django中,App(应用)是指一个可重用的模块,用于实现特定功能或业务逻辑的组件。
  • 每个Django项目由一个或多个App组成,每个App可以包含模型、视图、模板和静态文件等组件,用于处理特定的功能模块。

(2)作用

  • App用于将一个大型的Web应用程序拆分为多个小的、可重用的模块。
  • 每个App都负责处理特定的功能或业务逻辑,使得应用程序的开发和维护更加模块化和可扩展。

(3)组成

  • 模型(Models):模型定义了数据结构和数据库表之间的映射关系。每个App通常会包含自己的模型,用于处理和管理特定的数据。
  • 视图(Views):视图负责处理用户的请求和逻辑处理。每个App可以包含自己的视图,用于处理特定功能的请求和生成响应。
  • 模板(Templates):模板用于展示数据给用户。每个App可以包含自己的模板,用于定制和渲染特定功能的页面。
  • 静态文件(Static Files):静态文件包括CSS样式表、JavaScript脚本和图像等。每个App可以包含自己的静态文件,用于定制和美化特定功能的界面。

(4)结构

  • 每个App通常都有一个独立的目录,其中包含该App的相关组件和文件。
  • 在App的目录中,通常会包含一个models.py文件,用于定义该App的模型。
  • 可以在App的目录中创建views.py文件,用于定义该App的视图函数或类。
  • 可以在App的目录中创建templates目录,用于存放该App的模板文件。
  • 可以在App的目录中创建static目录,用于存放该App的静态文件。
  • 还可以在App的目录中创建其他辅助文件,如表单定义、URL配置等。

【2】文件结构

(1)空项目

├── Django项目名       				  # 整体项目名
  ├── db.sqlite3      				 	# Django默认的db数据库,sqlite3
  ├── manage.py				            # Django的服务控制文件,所有的Django命令都是基于manage.py 来执行的
  ├── templates.py				        # 专门存储html文件
  └── Django项目名					      # 项目名
      ├── __init__.py	                # 包初始化文件
      ├── __pycache__	                # 缓存编译后的模块代码,加快加载速度
      │   ├── __init__.cpython-310.pyc  # 编译后的文件
      │   ├── settings.cpython-310.pyc  # 编译后的文件
      │   ├── urls.cpython-310.pyc 		# 编译后的文件
      │   └── wsgi.cpython-310.pyc      # 编译后的文件
      ├── asgi.py                       # 支持异步请求处理的应用程序接口
      ├── settings.py                   # 配置文件
      ├── urls.py			            # 实现URL路由规则
      └── wsgi.py			            # Django项目的入口点,将HTTP请求传递给WSGI容器,以启动Django服务器。
  • Django项目名

    • 项目创建时指定的名称
    • 每个Django项目都有一个唯一的名称,并且在整个项目目录下作为*目录存在。
  • db.sqlite3

    • Django默认使用的SQLite数据库文件

    • SQLite是一个轻量级的关系型数据库管理系统,无需服务器运行,所有数据存储在一个文件中

      在这个项目中,SQLite被用作开发阶段的数据存储和本地测试环境的默认选项

  • manage.py

    • 这是Django的核心服务控制脚本,包含了各种用于管理和维护项目、应用程序以及运行Django服务器的内置命令。
    • 通过manage.py,您可以执行如创建数据库、迁移模型、创建超级用户、运行开发服务器等操作。
  • Django项目名

    • __init__.py
      
      • 这是一个空的Python模块文件,它告诉Python这是一个包含其他模块或包的目录。
      • 尽管对于Django项目来说,这通常不是必需的,但在一些情况下可能会用到。
    • __pycache__
      
      • Python会在此目录下缓存编译后的模块代码,以便加快后续加载速度。
      • 这些目录通常不应该直接修改或删除,而是由Python自动处理。
      • __init__.cpython-310.pyc: 编译后的初始化模块。
      • settings.cpython-310.pyc, urls.cpython-310.pyc, wsgi.cpython-310.pyc: 分别对应于settings.py、urls.py和wsgi.py这三个文件的编译版本。
    • asgi.py

      • 在Django 3.0及更高版本中,此文件允许将项目配置为ASGI应用(Asynchronous Server Gateway Interface),即支持异步请求处理的应用程序接口,适用于生产环境中部署长连接或WebSocket服务。
    • settings.py

      • 项目级别的设置文件,定义了诸如数据库连接、认证方式、中间件列表、静态文件托管、邮件配置等各种全局设置,以及其他项目自定义配置信息。
    • urls.py

      • 应用程序级别的URL配置文件,定义了项目内各个视图函数与URL模式之间的映射关系,实现了URL路由规则。
    • wsgi.py

      • Web Server Gateway Interface (WSGI) 实现文件,是Django项目的入口点,将HTTP请求传递给WSGI容器(如uWSGI, Gunicorn, uWSGI等)以启动Django服务器。
      • 在早期版本中,Django项目可能只有一个根WSGI应用;而在现代Django项目中,可能涉及多个WSGI应用组合。

(2)app目录

└── APP名称			   # APP名称
  ├── __init__.py  		# 包初始化文件
  ├── admin.py          # 注册管理后台界面中的模型
  ├── apps.py     		# 定义当前app相关的信息
  ├── migrations  		# 模型相关的数据迁移历史记录文件
  │   └── __init__.py   # 包初始化文件
  ├── models.py   		# 数据库模型
  ├── tests.py    		# 用于编写单元测试
  └── views.py    		# 主要逻辑处理模块,负责接收 HTTP 请求并返回响应
  • APP名称 是Django应用程序目录,它遵循Django应用组织的标准结构,用于组织可重用的功能模块。
    • __init__.py
      • 此文件是空的,但它表明当前目录 是一个Python包,里面包含其他子模块或文件。
    • admin.py
      • 如果应用需要注册管理后台界面(Admin Site)中的模型,则应在该文件中编写自定义的ModelAdmin类,以便管理和编辑数据库表中的记录。
      • 如果没有特定需求,可以保持为空或者注释掉。
    • apps.py
      • 此文件定义了 应用本身,包括应用的元数据(如名称、路径等)、是否启用该应用,以及与其他应用的关系(如有依赖)。
    • migrations
      • 存储与模型相关的数据迁移历史记录文件(.py)和应用状态文件(.pyc)。
      • 当更改了 “models.py” 中的模型结构时,Django会根据这些变更生成新的迁移文件,用于更新数据库结构以保持一致。
    • models.py
      • 该文件定义了的数据库模型(也称为数据结构或对象)。
      • 每个模型继承自 django.db.models.Model 并定义字段及其属性,例如字段类型、验证规则、外键关联等。它是实现业务逻辑的基础,并最终决定了数据库表的设计。
    • tests.py
      • 用于编写单元测试(Unit Tests)的模块,确保 应用中各个功能模块正确无误地工作。
      • 通过unittest.TestCase类或使用更高级别的测试框架如pytest进行测试用例编写。
    • views.py
      • 视图(Views)是 应用中的主要逻辑处理模块,负责接收 HTTP 请求并返回响应。
      • 它们是Django URL 路由系统与用户交互的核心部分,定义了如何解析请求、调用相应的业务逻辑以及构建最终返回的响应数据。
      • 每个视图通常与 URLconf 中的一个 URL 路由关联起来。
上一篇:【Node.js】zlib-gzip 和 deflate 的区别


下一篇:【深度学习】pytorch,MNIST手写数字分类