参考文档 https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Tutorial+-+A+Beginners+Development+Guide
创建、更新和删除操作一个实体将由minilang 写成的服务实现。为了更好的理解这些内容,我们写自己的服务来完成这些操作,之后我们将通过调用已经实现的服务来完成。
要做这些,我们将采用会员模型的实体:
--Party
--Person
一个人是一会员,所以创建一个人先得创建一类型是partyTypeId="PERSON"的会员。
所以有两种方式做这些:
1. 创建一个服务来进行带有类型Person 的会员创建工作。
2. 在服务中先创建一个会员,再创建个人。
1. Writing Services
a. 在practice下创建目录servicedef,此目录将包含所有服务定义文件,如:services.xml,secas.xml。
注:如果一个服务用java编写,应放到src目录,如果是用minilang编写,应放到script目录。
比如java applications/party/src/org/ofbiz/party/party/PartyServices.java和minilangapplications/party/script/org/ofbiz/party/party/PartyInvitationServices.xml;
各自的类路径和文件路径将在服务定义中体现。
b. 在控制器(controller.xml)中你必须创建一个入口为执行服务的请求和设置响应:
c. 现在所有写好的服务必须在服务器启动时装载,因此需要在ofbiz-component.xml为服务定义(service definition)创建一个条目(entry)
注意:对服务定义的任何修改均需要重启服务器才能生效。
2.Writing CRUD Operations for Party Entity
开始我们将为会员写服务,然后当写创建Person 服务时将调用会员的服务。
a. 在servicedef 下创建文件services.xml
b. 为Party实体定义CRUD操作的服务。服务的名称是createPracticeParty, updatePracticeParty, deletePracticeParty,并且指定正确的路径到这些服务实现的文件,例如/framework/example/script/org/ofbiz/example/example/ExampleServices.xml。
c. 为这些服务的实现在你的组件目录中创建目录结构和PracticeServices.xml文件。
(实现可参考Example组件的services.xml和ExampleServices.xml文件。)
注意:不要使用标签,它在教程随后的介绍中。
从这里开始,你想运行这些服务的话,可以通过webtools 运行这些服务:webtools--> Run Service . 这样你可以测试你的服务。
这功能近来已经增加,与对实体写CRUD操作的传统方式不同。
新功能让你仅定义这些服务,通过说起你想运行的操作。基本上设计引挚属性为"entity-auto"和调用(invoke)属性为"create", "update", or "delete"。你可以看下example 组件的services.xml 中的下列代码:
Create a Example
engine="entity-auto" invoke="create"为缺省实体"Example."做创建记录的角色。
作为练习你可以做更进一步,这些步骤在帮助你理解概念,你仅能在你的代码中练习上面所给模式。
3. Writing CRUD Operations for Person Entity
为个人person 实体创建记录需要有partyId,因此首先调用createPracticeParty服务得到partyId后再去创建person记录。
我们将在person 实体列表表单下面增加一个附加的表单。这个表单将调用这个服务来创建一个person 记录。
a. 创建用于创建person的附加表单,并且把下面的person 表单加在同一个screen 中。
b. 为 person 实体写CRUD 操作,这个就是在services.xml 中createPracticePerson 的代码。
Create a Person
Update和Delete与上面类似。
c. 用可编辑的字段转换List 表单 (参考: ListExampleItems from ExampleForms.xml) ,在里面加入更新和删除选项,也把附加的表单加入同一screen 中。
d. 为这些服务增加控制项,是通过这表单来调用的。
e. 运行应用,查看效果