Django swagger介面文件

2021-10-10 08:55:00 字數 1609 閱讀 4397

pip install django-rest-swagger
加入

[...

'rest_framework_swagger',.

..]

swagger_settings =},

# 如果需要登入才能夠檢視介面文件, 登入的鏈結使用restframework自帶的.

'login_url'

:'rest_framework:login'

,# todo 使用rest的登入頁,不然沒地方登入

'logout_url'

:'rest_framework:logout'

,# 'doc_expansion': none,

# 'show_request_headers':true,

# 'use_session_auth': true,

# 'doc_expansion': 'list',

# 介面文件中方法列表以首字母公升序排列

'apis_sorter'

:'alpha'

,# 如果支援json提交, 則介面文件中包含json輸入框

'json_editor'

:true

,# 方法列表字母排序

'operations_sorter'

:'alpha'

,'validator_url'

:none

,}

# 路由

router = routers.defaultrouter(

)router.register(r'users'

,views.userviewset,base_name=

'user'

)router.register(r'groups'

,views.groupviewset,base_name=

'group'

)# 重要的是如下三行

from rest_framework.schemas import get_schema_view

from rest_framework_swagger.renderers import swaggeruirenderer, openapirenderer

schema_view = get_schema_view(title=

'users api'

, renderer_classes=

[openapirenderer, swaggeruirenderer]

)urlpatterns =

[# swagger介面文件路由

path(r'docs/'

, schema_view, name=

"docs"),

path(r'admin/'

, admin.site.urls)

, path(r''

,include(router.urls)),

path(r'api-auth/'

,include(

'rest_framework.urls'

,namespace=

'rest_framework'))

]

List介面 Set介面和Map介面

1 list和set介面自collection介面,而map不是繼承的collection介面 collection表示一組物件,這些物件也稱為collection的元素 一些 collection允許有重複的元素,而另一些則不允許 一些collection是有序的,而另一些則是無序的 jdk中不提...

介面 四 訪問介面

對介面成員的訪問 對介面方法的呼叫和採用索引指示器訪問的規則與類中的情況也是相同的。如果底層成員的命名與繼承而來的高層成員一致,那麼底層成員將覆蓋同名的高層成員。但由於介面支援多繼承,在多繼承中,如果兩個父介面含有同名的成員,這就產生了二義性 這也正是c 中取消了類的多繼承機制的原因之一 這時需要進...

C 介面 介面作用

可簡單的這樣理解介面 介面是方法的抽象,如果不同的類有同樣的方法,那麼就應該考慮使用介面。例如,人和車都有 跑 的方法,那麼就可以定義乙個介面irun 注意,定義介面時,裡面的方法不能有方法體 應該在類裡再去實現 而具介面的成員全是公有的,不應有修飾符 public inte ce irun 人實現...