基于 Django1.10 文档的深入学习(25)—— Applications 之 基础部分
2017-04-30 11:07
731 查看
Applications应用
Django包含一个安装的应用程序的注册表,存储配置并提供内省。 它还保留了可用模型的列表。这个注册表简单称为应用程序,它可以在
django.apps中使用:
>>> from django.apps import apps >>> apps.get_app_config('admin').verbose_name 'Admin'
Projects and applications项目和应用程序
术语项目描述了一个Django Web应用程序。项目
Python包主要由设置模块定义,但通常包含其他内容。例如,当您运行
django-admin startproject mysite时,您将得到一个
mysite项目目录,其中包含一个具有
settings.py,
urls.py和
wsgi.py的
mysite Python包。项目包通常被扩展到包括与特定应用程序无关的诸如固定装置,CSS和模板之类的东西。
项目的根目录(包含
manage.py)的根目录通常是未单独安装的所有项目应用程序的容器。
术语应用程序描述了一个提供一些功能的
Python包。申请可以在各种项目中重复使用。
应用程序包括
模型,
视图,
模板,
模板标签,
静态文件,
URL,
中间件等的一些组合。它们通常连接到具有
INSTALLED_APPS设置的项目中,并且可选地使用其他机制,例如
URLconfs,
MIDDLEWARE设置或模板继承。
重要的是要了解Django应用程序只是一组与框架的各个部分进行交互的代码。没有应用程序对象这样的东西。但是,Django需要与安装的应用程序进行交互,主要用于配置和内省操作。这就是为什么应用程序注册表在每个安装的应用程序的AppConfig实例中维护元数据的原因。
没有限制项目包不能被认为是应用程序,并且有模型等(这将需要将其添加到
INSTALLED_APPS)。
Configuring applications配置应用程序
要配置一个应用程序,子类AppConfig,并将虚线路径放在
INSTALLED_APPS中的该子类中。
当
INSTALLED_APPS只包含应用程序模块的虚线路径时,
Django会检查该模块中的
default_app_config变量。
如果定义了它,那该应用程序的
AppConfig子类的虚线路径。
如果没有
default_app_config,
Django使用基础
AppConfig类。
default_app_config允许早于
Django 1.7的应用程序(如
django.contrib.admin)选择加入
AppConfig功能,而不需要用户更新其
INSTALLED_APPS。
新的应用程序应该避免使用
default_app_config。 相反,它们应该要求在
INSTALLED_APPS中明确配置适当的
AppConfig子类的虚线路径。
对于应用程序作者
如果您正在创建一个名为
“Rock'n'roll”的可插拔应用程序,那么您将如何为管理员提供一个正确的名称:
# rock_n_roll/apps.py from django.apps import AppConfig class RockNRollConfig(AppConfig): name = 'rock_n_roll' verbose_name = "Rock ’n’ roll"
您可以使您的应用程序默认加载此
AppConfig子类,如下所示:
# rock_n_roll/__init__.py default_app_config = 'rock_n_roll.apps.RockNRollConfig'
当
INSTALLED_APPS只包含
'rockphasroll'时,这将导致使用
RockNRollConfig。 这允许您使用
AppConfig功能,而不需要您的用户更新其
INSTALLED_APPS设置。 除了这个用例之外,最好避免使用
default_app_config,而是如下所述在
INSTALLED_APPS中指定
app config类。
当然,您也可以告诉用户将
“rock_n_roll.apps.RockNRollConfig”放在
INSTALLED_APPS设置中。 您甚至可以提供不同行为的几个不同的
AppConfig子类,并允许用户通过其
INSTALLED_APPS设置来选择一个。
推荐的约定是将配置类放在名为
apps的应用程序的子模块中。 但是,Django并不执行此操作。
您必须包含
Django的
name属性,以确定此配置应用于哪个应用程序。 您可以定义
AppConfig API参考中记录的任何属性。
注意
如果您的代码在应用程序的
__init__.py中导入应用程序注册表,应用程序的名称将与应用程序子模块冲突。最佳做法是将该代码移动到子模块并将其导入。 解决方法是以不同的名称导入注册表:
from django.apps import apps as django_apps
For application users对于应用程序用户
如果您在一个名为选集的项目中使用
“Rock ’n’ roll”,但您希望将其显示为
“Jazz Manouche”,则可以提供自己的配置:
# anthology/apps.py from rock_n_roll.apps import RockNRollConfig class JazzManoucheConfig(RockNRollConfig): verbose_name = "Jazz Manouche" # anthology/settings.py INSTALLED_APPS = [ 'anthology.apps.JazzManoucheConfig', # ... ]
再次,在名为apps的子模块中定义项目特定的配置类是一个约定,而不是一个要求。
Application configuration应用程序配置
class AppConfig[source]:
应用程序配置对象存储应用程序的元数据。一些属性可以在
AppConfig子类中配置。其他由
Django设置,只读。
Configurable attributes可配置属性
AppConfig.name:
完整的Python路径到应用程序,例如
'django.contrib.admin'。
此属性定义配置应用于哪个应用程序。它必须在所有
AppConfig子类中设置。
它在Django项目中必须是独一无二的。
AppConfig.label:
应用程序的简称,例如
'admin'
当两个应用程序具有冲突的标签时,此属性允许重新标签应用程序。它默认为名称的最后一个组件。它应该是一个有效的Python标识符。
它在Django项目中必须是独一无二的。
AppConfig.verbose_name:
应用程序的可读名称,例如
“Administration”。
此属性默认为
label.title()。
AppConfig.path:
文件系统到应用程序目录的路径,例如
'/usr/lib/python3.4/dist-packages/django/contrib/admin'。
在大多数情况下,
Django可以自动检测并设置,但您也可以在
AppConfig子类中提供显式覆盖作为类属性。在一些情况下,这是必需的;例如,如果应用程序包是具有多个路径的命名空间包。
Read-only attributes只读属性
AppConfig.module:
应用程序的根模块,例如
'django.contrib.admin'from'django / contrib / admin / __ init __。pyc'>。
AppConfig.models_module:
包含模型的模块,例如 来自
'django / contrib / admin / models.pyc'的<module'django.contrib.admin.models'。
如果应用程序不包含模型模块,则可能为
None。 请注意,数据库相关信号(如
pre_migrate和
post_migrate)仅适用于具有模型模块的应用程序。
Methods
AppConfig.get_models()[source]
Returns an iterable of Model classes for this application.
AppConfig.get_model(model_name)[source]
Returns the Model with the given model_name. Raises LookupError if no such model exists in this application. model_name is case-insensitive.
AppConfig.ready()[source]
Subclasses can override this method to perform initialization tasks such as registering signals. It is called as soon as the registry is fully populated.
Although you can’t import models at the module-level where AppConfig classes are defined, you can import them in ready(), using either an import statement or get_model().
If you’re registering model signals, you can refer to the sender by its string label instead of using the model class itself.
Example:
from django.db.models.signals import pre_save def ready(self): # importing model classes from .models import MyModel # or... MyModel = self.get_model('MyModel') # registering signals with the model's string label pre_save.connect(receiver, sender='app_label.MyModel')
相关文章推荐
- 基于 Django1.10 文档的深入学习(32)—— The Django admin site 之 基础
- 基于 Django1.10 文档的深入学习(26)—— Creating forms from models 之 基础
- 基于 Django1.10 文档的深入学习(34)—— Customizing authentication in Django 之 基础
- 基于 Django1.10 文档的深入学习(8)—— Model field reference 之 choices
- 基于 Django1.10 文档的深入学习(16)——Authentication backends 之 class ModelBackend
- 基于 Django1.10 文档的深入学习(15)——django.contrib.auth.hashers
- 基于 Django1.10 文档的深入学习(29)——Built-in Views 之 static.serve()
- 基于 Django1.10 文档的深入学习(9)—— Extra instance methods 之 get_FOO_display()
- 基于 Django1.10 文档的深入学习(19)——Working with forms
- 基于 Django1.10 文档的深入学习(21)——The Forms API 之 Form.errors
- 基于 Django1.10 文档的深入学习(23)—— QuerySet API reference 之 icontains
- 基于 Django1.10 文档的深入学习(3)—— models.py 之 FileField
- 基于 Django1.10 文档的深入学习(2)—— Settings.py 之 STATIC_*
- 基于 Django1.10 文档的深入学习(13)—— Making queries 之 Q objects
- 基于 Django1.10 文档的深入学习(27)—— django.conf.urls utility functions 之 url(),include(),static()
- 基于 Django1.10 文档的深入学习(6)—— Translation 之 short_description
- 基于 Django1.10 文档的深入学习(12)—— django.shortcuts 之 redirect()
- 基于 Django1.10 文档的深入学习(13)—— django.core.urlresolvers 之 reverse()
- 基于 Django1.10 文档的深入学习(10)—— django.contrib.auth 之 User model
- 基于 Django1.10 文档的深入学习(24)—— Form and field validation 之 cleaned_data