python工业互联网应用实战12—客户端操作
本章节我们将实现与admin里类似的列操作“下达”功能，演示客户端是如何实现操作功能，同时，演示也会强调一点，何时合并你的功能代码，避免相同功能使用不同的代码段来实现，在企业开发中非常重要，良好的编程习惯会让你在未来的维护和扩展中体会到什么叫“好的代码”。
1.1. Table增加操作列
本例中我们采用url http://localhost:8001/task/1/start/ 来相应对某行任务执行“下达”操作，类似RESTful的接口模式后面的动词代码某个操作，现在在table中增加一列操作，每行显示下达操作链接，代码如下：
<!DOCTYPE html> <html lang="en" xmlns="http://www.w3.org/1999/xhtml"> <head> <meta charset="utf-8" /> <title></title> </head> <body> <table> <tr> <th>ID</th> <th>任务号</th> <th>源地址</th> <th>目标地址</th> <th>条码</th> <th>状态</th> <th>优先级</th> <th>开始时间</th> <th>结束时间</th> <th>作业数量</th> <th>操作</th> </tr> {% for task in tasks %} <tr> <td>{{task.TaskId }}</td> <td>{{task.TaskNum}}</td> <td>{{task.Source}}</td> <td>{{task.Target}}</td> <td>{{task.Barcode}}</td> <td>{{task.get_State_display}}</td> <td>{{task.get_Priority_display}}</td> <td>-</td> <td>-</td> <td>{{task.job_set.count}}</td> <td><a href="{{task.TaskId }}/start/">下达</a></td> </tr> {%endfor%} </table> </body> </html>
运行效果：
1.2. Task APP增加相应url和views函数
接下来在Task urls.py文件里增加“/1/start/”发布下达的url，代码如下：
from django.urls import path,re_path from Task import views urlpatterns = [ path('', views.view_list,name='view_list'), re_path('^(?P<pk>\d+)/start/$',views.start,name='start'),#① ]
标注①：正则表达式，来实现Task_id/start/，针对某个对象标识id执行下达命令。
接下来在Task/views.py文件里添加start函数代码。
from django.shortcuts import get_object_or_404 from django.shortcuts import redirect from django.db.transaction import atomic from .TaskBiz import TaskBiz,Task @atomic def start(request,pk): obj = get_object_or_404(Task, pk=pk)#① biz= TaskBiz() biz.task_start(obj)#② #重新刷新列表界面 co_path = request.path.split('/') new_path=co_path[0:2] new_path='/'.join(new_path) request.path = new_path return redirect(new_path)
标注①：通过主键获取到任务对象。
标注②：对获取的任务对象，执行业务逻辑层的task_start函数，这里的业务逻辑直接沿用admin重构组织的那个TaskBiz.py业务逻辑类里的任务“下达”函数。
章节到这里我希望读者能够体会到代码重用的好处，把业务抽象出一个单独的层，比放在admin里是不是有优势多了，不需要在客户端的“下达”时重新再实现一遍这个功能。
点击操作列里的下达链接，任务就会从“处理成功”改成“下达”状态。
1.3. 修改操作和详情页面
依据“下达”方式，url:http://localhost:8001/Task/1/change/就是跳到修改/详情界面查看和修改该任务详情数据。同样，我们还是采用渐进的原则的来推进这个功能的实现。
首先，增加Task/urls.py 增加change url。
from django.urls import path,re_path from Task import views urlpatterns = [ path('', views.view_list,name='view_list'), re_path('^(?P<pk>\d+)/start/$',views.start,name='start'),#① re_path('^(?P<pk>\d+)/change/$',views.change,name='change'),#② ]
标注②：change函数与start函数类似的写法，通过传入pk来获取需要修改的对象。
然后，我们修改Task/views.py文件内容，增加change函数。
... def change(request,pk): obj = get_object_or_404(Task, pk=pk) return render(request,'Task/taskChange.html',{"task":obj})
其次，我们采用模板页把task对象数据渲染到html上，这里我采用先加载显示出来。
<!DOCTYPE html> <html lang="en" xmlns="http://www.w3.org/1999/xhtml"> <head> <meta charset="utf-8" /> <title></title> </head> <body> <div>{{task.TaskId }}</div> <div>{{task.TaskNum}}</div> <div>{{task.Source}}</div> <div>{{task.Target}}</div> <div>{{task.Barcode}}</div> <div>{{task.get_State_display}}</div> <div>{{task.get_Priority_display}}</div> <div>{{task.BeginDate}}</div> <div>{{task.EndDate}}</div> <div>{{task.job_set.count}}</div> </body> </html>
运行结果
最后，我们把模板页面修改成html input输入框，实现可以向后台post数据。本例我们假定未处理状态的任务可以修改源地址和目标地址信息。
<!DOCTYPE html> <html lang="en" xmlns="http://www.w3.org/1999/xhtml"> <head> <meta charset="utf-8" /> <title></title> </head> <body> <h1>任务详情</h1> <div>{{task.TaskId }}</div> <div>{{task.TaskNum}}</div> {% if task.State == 1%} <!--①--> <form method="post"> <input name="source" id="id_source" value="{{task.Source}}" /> <input name="target" id="id_target" value="{{task.Target}}" /> <input type="submit" value="提交"> </form> {% else %} <div>{{task.Source}}</div> <div>{{task.Target}}</div> {% endif %} <div>{{task.get_State_display}}</div> <div>{{task.get_Priority_display}}</div> <div>{{task.BeginDate}}</div> <div>{{task.EndDate}}</div> <div>{{task.job_set.count}}</div> </body> </html>
标注①：模板增加了 {% if %}判断，状态等于1 待处理状态的我们才能修改任务的源和目标地址，已经处理完成的任务就只能查看详情了，否则，job数据与task的数据逻辑就不一致了。
企业开发过程中，确保数据逻辑的前后一致性是非常关键和重要的。
运行效果：
1.4. 把post数据更新到数据库
现在修改数据后尝试点击提交按钮，通常情况下你会得到下面得错误提示页面，CSRF错误提示页面。
Django针对CSRF得保护措施是在生成得每个表单中放置一个自动生成的令牌，通过这个令牌判断POST请求是否来自同一个网站。我们在<form></form>内放置一个{% csrf_token %} 即可，更多CSRF内容参考官网文档。
运行结果
现在报后台错误了，接下来我们实现views.py change函数。
@atomic def change(request,pk): if request.method=='GET': #① obj = get_object_or_404(Task, pk=pk) return render(request,'Task/taskChange.html',{"task":obj}) elif request.method=='POST': #② data={"Source":request.POST['source'],"Target":request.POST['target']} Task.objects.filter(pk=model.pk).update(**data) #重新刷新列表界面 #③ co_path = request.path.split('/') new_path=co_path[0:2] new_path='/'.join(new_path) request.path = new_path return redirect(new_path)
①：change函数get请求情况下返回查看详情页面；
②：post请求情况下，使用post过来的参数更新对象属性；
③: 数据更新完成后重定向到列表页（也会重新加载列表数据，从而显示更新后的值）；
列表及时反映对象属性的变更是企业开发中常见的操作方式，否则用户就不知道这次修改和调整状态是否完成，不断的来回点击修改。
这里本人也讲述一下使用VS 2019常用到的一种调试方式就是在代码上打上断点，debug模式运行当程序执行到断点时会中断当前执行，便于开发人员验证过程的变量是否符合预期。
好的，现在就在change函数内部打上断点，debug运行我们的工程，点击提交按钮在IDE里调试我们的代码，修正错误的写法。
数据修改成功！
1.5. 代码重复
上面的代码中，笔者通过copy的方式把重定向到列表界面代码段在分别在start和change函数中重复了。遇到这种情况大多数开发人员尤其新手都会忽略，对于重复代码我们到底该怎么办？“事不过三”如果重复三次了一定得封装到一个函数里，这里我们直接把这段代码封装成__reloadTasksPage函数。
... #重定向到列表界面 #③ co_path = request.path.split('/') new_path=co_path[0:2] new_path='/'.join(new_path) request.path = new_path return redirect(new_path)
重构后的代码
... @atomic def start(request,pk): #pk=request.GET.get('pk') obj = get_object_or_404(Task, pk=pk)#① biz= TaskBiz() biz.task_start(obj) #② return __reloadTasksPage(request) @atomic def change(request,pk): if request.method=='GET': #① obj = get_object_or_404(Task, pk=pk) return render(request,'Task/taskChange.html',{"task":obj}) elif request.method=='POST': #② data={"Source":request.POST['source'],"Target":request.POST['target']} Task.objects.filter(pk=pk).update(**data) return __reloadTasksPage(request) def __reloadTasksPage(request): #重新刷新列表界面 #③ co_path = request.path.split('/') new_path=co_path[0:2] new_path='/'.join(new_path) request.path = new_path return redirect(new_path)
代码是不是简洁了好多，可能这个段代码重构会多花我们一点时间，长远来看这点时间事非常值得的，尤其后面如果调整到reloadTasksPage函数里的具体实现，大量散落和重复的代码是后期维护和扩展的噩梦!“敏捷”模式不提倡过度设计，但是如果“重复三次”，请重构你的代码。
1.6. 小结
本章我们详细的说明了如何实现客户端操作，读者可以自己试一试增加“处理”操作，实现对未处理状态的任务进行作业分解。客户端的操作会存在两种一种就是直接改变任务的状态，另外一种就是类似查看详情操作，这个种操作我们需要通过模板把数据加载处理，任务分解和下达之类的操作，更新完数据后重新加载数据即可。django对于这两种模式可以都是使用url和view组合来完成，这样在技术上两种模式就不存区别了，大大提高了开发效率。
