Workflows
工作流是复杂的forms(表单)和tabs,每一个workflow必须包含 Workflow,Step 和 Action
下面举例讲解workflow用法:
接下来的例子讲解了数据是如何从urls、views、workflows、templates之间互相传递的
在 urls.py中, 定义了一个参数. 例如. resource_class_id.
1
2
3
4
5
|
RESOURCE_CLASS = r '^(?P<resource_class_id>[^/]+)/%s$'
urlpatterns = patterns(
'' ,
url(RESOURCE_CLASS % 'update' , UpdateView.as_view(), name= 'update' ))
|
在views.py中,我们可以传递数据到template(模板)和action(form)中。(action 也能够传递数据到get_context_data 方法或者template中)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
class UpdateView(workflows.WorkflowView):
workflow_class = UpdateResourceClass
def get_context_data(self, **kwargs):
context = super(UpdateView, self).get_context_data(**kwargs)
# url中的数据通常在self.kwargs中,这里我们可以将数据传递给template.url
context[ "resource_class_id" ] = self.kwargs[ 'resource_class_id' ]
# 数据来源于Workflow's Steps,且保存在context['workflow'].context列表中,我们同样可以在template 中使用它们
return context
def _get_object(self, *args, **kwargs):
#url中的数据通常在self.kwargs中,我们能够在这里加载感兴趣的对象
resource_class_id = self.kwargs[ 'resource_class_id' ]
# eg:my_objects = api.nova.get_by_id(resource_class_id)
def get_initial(self):
resource_class = self._get_object()
# 此处的数据可以被Action的方法以及Workflow's handle方法使用,但是steps必须depend on该值
return { 'resource_class_id' : resource_class. id ,
'name' : resource_class.name,
'service_type' : resource_class.service_type}
|
在workflows.py中,我们处理数据,workflows本质就是一个更加复杂的django form(表单)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
class ResourcesAction(workflows.Action):
# 下述定义的name域值 在所有的action 方法中都可以获取
# 假若我们期望此值能够在其他steps或者其他workflow中使用,它必须来源于当前step,且建立depend on在其他step中
name = forms.CharField(max_length=255,
label=_( "Testing Name" ),
help_text= "" ,
required=True)
def handle(self, request, data):
pass
# 如果想使用url中参数值,在该Action对应的step中必须建立depend on关系
# 可以self.initial['resource_class_id'] or data['resource_class_id']获取值
# 如果我们想使用其他step中的数据,那么其他step 必须contribute 数据,且两个step之间是有序的
class UpdateResources(workflows.Step):
# 此处传递Workflow 的数据到action方法handle/clean中,action中想要使用的值,此处depends_on 必须要定义
# Workflow 的context 数据包括url中的数据以及从其他step中contributed 过来的数据
depends_on = ( "resource_class_id" ,)
# 通过contributes 参数,此处的数据可以被其他workflow或者其他step使用,值得注意的是,object_ids key需要手动添加到contributes 中
contributes = ( "resources_object_ids" , "name" )
def contribute(self, data, context):
# 此处能获取workflow的http request数据
request = self.workflow.request
if data:
# 只有在action中定义的数据此处才能获取,如果想获取其他值,则需要覆盖contribute 方法,手动添加到字典里
context[ "resources_object_ids" ] =\
request.POST.getlist( "resources_object_ids" )
# 合并上面传递来的数据,也可以交给父类去合并
context.update(data)
return context
class UpdateResourceClass(workflows.Workflow):
default_steps = (UpdateResources,)
def handle(self, request, data):
pass
# 这个方法在最后执行(所有Action的handle方法之后)
# 此处可以使用step中所有'contributes=' 和'depends_on=' 的数据
# 此处可以处理复杂的业务逻辑
#此处可用值: data["resources_object_ids"], data["name"] data["resources_class_id"]
|
感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!