django文檔學習之applications使用詳解

本文研究的主要是Django1.10文檔的深入學習，Applications基礎部分的相關內容，具體介紹如下。

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')

總結

在我看來，對官方文檔的學習是一方面，找一些不錯的實例去實踐一下也很重要。

以上就是本文關于Python文檔學習之applications使用詳解的全部內容，希望對大家有所幫助。感興趣的朋友可以繼續參閱本站其他相關專題，如有不足之處，歡迎留言指出。感謝朋友們對本站的支持！