如何轻松了解Python必学的django框架

您当前的位置:环亚科技网新闻正文
放大字体  缩小字体 2019-09-07 作者:责任编辑NO。蔡彩根0465

django 结构配有一个功用强大的办理站点,里边现已预界说了许多办理站点需求进行的操作,可是有时或许默许的操作不能满意需求,...

django 结构配有一个功用强大的办理站点,里边现已预界说了许多办理站点需求进行的操作,可是有时或许默许的操作不能满意需求,如需求批量更新选中的目标,这需求编写自界说 action 完成。本文根据 django 官方英文文档梳理了一下自界说办理操作需求做的作业,便利快速了解自界说办理操作的完成进程。

作者 | 单雨,责编 | 黄浩然

出品 | CSDN(ID:CSDNnews)

Admin actions 简介

admin actions 是一些在 admin 站点下拉列表中能够挑选履行的简略函数,比方删去一个目标操作。

编写 Admin actions

下面举例说明怎么编写Admin action。例如批量更新一个名为 Article 的模型:

fromdjango.dbimportmodels

STATUS_CHOICES = [

('d','Draft'),

('p','Published'),

('w','Withdrawn'),

]

classArticle(models.Model):

title = models.CharField(max_length=100)

body = models.TextField()

status = models.CharField(max_length=1,choices=STATUS_CHOICES)

def__str__(self):

returnself.title

下面来编写 action 函数,这个函数承受三个函数:

当时的 ModelAdmin

一个代表当时 HTTP 恳求的 HttpRequest 目标

一个包括用户选定的目标的 QuerySet (数据库检索目标)。

defmake_published(modeladmin, request,queryset):

queryset.update(status='p')

为了到达最佳功用,引荐运用 QuerySet 的 update 办法,

forobjinqueryset:

do_something_with(obj)

默许情况下,该操作将以“ Make published ”的方式呈现在操作列表中,便是函数名,下划线将由空格替换。为了让这个办法更简单被人了解,咱们能够给它增加一个 short_description 特点。

defmake_published(modeladmin, request,queryset):

queryset.update(status='p')

make_published.short_description ="Markselected stories as published"

增加 action 到 ModelAdmin

完好程序如下:

fromdjango.contribimportadmin

frommyapp.modelsimportArticle

defmake_published(modeladmin, request, queryset):

queryset.update(status='p')

make_published.short_description ="Markselected stories as published"

classArticleAdmin(admin.ModelAdmin):

list_display = ['title','status']

ordering = ['title']

actions = [make_published]

admin.site.register(Article, ArticleAdmin)

效果如下:

处理 action 中的过错

将 action 界说为 ModelAdmin 的内部办法

上述界说的 action 存在一个不足之处便是它和 Article 目标严密耦合,这会导致很多的重复代码呈现,即便这些 action 的功用都相同。将 action 界说为 ModelAdmin 的办法能够防止呈现这个问题。

修正上述 ArticleAdmin:

classArticleAdmin(admin.ModelAdmin):

...

actions = ['make_published']

defmake_published(self, request, queryset):

queryset.update(status='p')

make_published.short_description ="Mark selected stories aspublished"

留意 make_published 变为 ArticleAdmin 的内部办法,第一个参数变为了 self。将 action 变为 ModelAdmin 的办法,使得它能够调用任何admin 供给的办法。例如向用户发送音讯:

classArticleAdmin(admin.ModelAdmin):

...

defmake_published(self, request, queryset):

rows_updated = queryset.update(status='p')

ifrows_updated ==1:

message_bit ="1 story was"

else:

message_bit ="%s stories were"%rows_updated

self.message_user(request,"%s successfully marked as published."%message_bit)

这使得 action 履行成功之后主动将 action 的行为和 admin 站点的行为相匹配。

效果如下:

供给中心页的 action

在一些情况下,action 需求供给一个中心页来提示用户是否承认履行操作,比方删去目标时提示用户是否承认履行操作:

要供给中心页,只需求回来一个 HttpResponse 或许子类即可。例如一个导出选中目标 json 文件的操作:

fromdjango.coreimportserializers

fromdjango.httpimportHttpResponse

defexport_as_json(modeladmin, request, queryset):

response = HttpResponse(content_type="application/json")

serializers.serialize("json", queryset, stream=response)

returnresponse

可是这样或许会使 action 的逻辑非常杂乱,引荐做法是回来一个 HTTP 重定向,重定向到一个新的页面上,这样能够在页面的视图中履行更杂乱的逻辑,防止 action 中充溢杂乱的逻辑。

fromdjango.contribimportadmin

fromdjango.contrib.contenttypes.modelsimportContentType

fromdjango.httpimportHttpResponseRedirect

defexport_selected_objects(modeladmin, request, queryset):

selected =request.POST.getlist(admin.ACTION_CHECKBOX_NAME)

ct = ContentType.objects.get_for_model(queryset.model)

returnHttpResponseRedirect("/export/?ct=%s&ids=%s"% (ct.pk,",".join(selected)))

让 actions 在整个站点中都有用

假如想要让上述中的导出操作在整个办理站点中都能运用,能够这样做:

为了便利办理这个操作,比方运用代码移除这个操作,能够给它一个称号

禁用 action

禁用站点规模效果的的 action:

这将在整个办理站点规模内禁用该 action。

假如需求复用现已禁用的 action。只需求在相应的 ModelAdmin 的actions 特点中增加这个 action即可。例如复用上述禁用的 action:

# This one will

classAnotherModelAdmin(admin.ModelAdmin):

actions=['delete_selected']

在某个 ModelAdmin 中禁用一切的 action,只需求将 action 特点设置为None 即可。

classMyModelAdmin(admin.ModelAdmin):

actions =None

有条件的启用或许禁用 action

经过重写 ModelAdmin的get_actions() 办法能够完成有条件的启用或许禁用 action。该办法回来一个答应运用的 actions 字典,键是操作称号,值是(函数、称号、short_description)元组。例如,假如您只期望称号以“J”最初的用户能够批量删去目标:

设置 action 的权限

action 能够经过设置 allowed_permissions 特点来约束具有特定权限的用户的可用性:

efmake_published(modeladmin, request, queryset):

queryset.update(status='p')

make_published.allowed_permissions = ('change',)

假如 allowed_permissions 具有多个权限,则只需用户经过至少一个权限查看,该操作就可用。allowed_permissions 可用值为:

add

change

delete

view

假如需求指定其他值,需求在ModelAdmin中界说一个haspermission( self, request )办法,例如:

fromdjango.contribimportadmin

fromdjango.contrib.authimportget_permission_codename

classArticleAdmin(admin.ModelAdmin):

actions = ['make_published']

defmake_published(self, request, queryset):

queryset.update(status='p')

make_published.allowed_permissions = ('publish',)

defhas_publish_permission(self, request):

"""Does the user have the publishpermission?"""

opts =self.opts

codename = get_permission_codename('publish', opts)

returnrequest.user.has_perm('%s.%s'% (opts.app_label, codename))

最终附上官方文档地址:https://docs.djangoproject.com/zh-hans/2.2/ref/contrib/admin/actions/

【END】