OFBiz进阶之HelloWorld（五）创建新实体

参考文档 https://cwiki.apache.org/confluence/display/OFBIZ/OFBiz+Tutorial+-+A+Beginners+Development+Guide

1 Creating Custom Entity

新实体的创建你可以再参考 example 组件，为此你可以看下 example 组件的 entitymodel.xml 文件。你可以按下列步骤创建新的实体：

a. 在 hot-deploy/practice/  下创建一个 entitydef 的子目录。

b. 创建一个 entitymodel.xml 文件。这个文件包括你想定义的实体定义。

c. 要装载定义，你需要在 ofbiz-component.xml 文件中定义一个条目，如下：

<entity-resource type="model" reader-name="main" loader="main" location="entitydef/entitymodel.xml"/>

   可以看出必须重启服务器才能让那些修改生效。
   详细请参考：http://docs.ofbiz.org/display/OFBTECH/General+Entity+Overview.
   实际应用中将很少去定义新的实体，因为在 OFBiz 已经存在对业务处理有很大作用的实体定义。虽然你可能感觉在某些地方要给存在的实体增加更多字段，你能如何做那些呢？下一步将告诉你方法，为你的客户化需要扩展一个实体。
   先前我们通常在相同目录中需要一个或更多 entitygroup.xml 文件，这个不再需要，因为代码已经检入到 trunk 中（because code is checked in to the trunk for this）。

2 Extending an Existing OOTB Entity

是的，你可以扩展已存在的实体满足你客户化的需要。按下列方式完成： 

a. 在你的客户化应用的 entitydef/entitymodel.xml 文件中按以下方式扩展你的实体。

<extend-entity entity-name="">
    <field name="" type=""/>
</extend-entity>

作为例子，你可以参考 party 组件的 entitymodel.xml 文件。

这是一个最简单的表单，它也能变得更复杂，增加一个或更多字段到已存在的实体中，这个依赖于你想要进行客户化需求的字段。这儿你也能定义与其它实体的关系。但在做这些之前，你得特别地搜索下，可能你要加的字段作为其它目的已经存在。也要去进行数据模型的扩展学习然后再做。

实体引擎配置可参考：Entity Engine Configuration Guide。

3 Preparing Data For Custom Application

你的 practice 应用准备数据可按下列步骤：

a. 在 practice 创建一个目录"data"，在这创建一个 PracticeData.xml 文件。

b. 我们给一个用户创建数据，我必须为一个会员按指定顺序准备好，如下：

<?xml version="1.0" encoding="UTF-8"?>
<entity-engine-xml>
    <Party partyId="DemoUser" partyTypeId="PERSON"/>
    <Person partyId="DemoUser" firstName="Practice" lastName="Person"/>
    <PartyRole partyId="DemoUser" roleTypeId="VISITOR"/>
    <ContactMech contactMechId="5000" contactMechTypeId="EMAIL_ADDRESS" infoString="practice.person@gmail.com"/>
    <PartyContactMech partyId="DemoUser" contactMechId="5000" fromDate="2001-05-13 00:00:00.000" allowSolicitation="Y"/>
    <PartyContactMechPurpose partyId="DemoUser" contactMechId="5000" contactMechPurposeTypeId="PRIMARY_EMAIL" fromDate="2001-05-13 00:00:00.000"/>
</entity-engine-xml>

目的是创建一个带有VISITOR 角色的个人会员，然后为那个会员创建一个电子邮件地址作为主要的电子邮件地址。

更多信息请参考：Handling of External data#Preparexmlfile 

c. 现在也可以添加网站数据，如下：

<WebSite webSiteId="PRACTICE" siteName="Practice Application" visualThemeSetId="BACKOFFICE"/>

d. This data is used for theme setup of a specific application and logged in user can change his theme for the back office application.

e. 现在我们需要在ofbiz-component.xml 中加入一个如下条目：

<entity-resource type="data" reader-name="demo" loader="main" location="data/PracticeData.xml"/>

在完成这些后，你运行命令ant run-install 会导入demo 数据，从这个文件的数据将作为demo 数据导入。一旦你
启动服务器，在practice 应用的Person 表单里你能看到为个人增加的记录，或者你可以访问
https://localhost:8443/webtools/control/entitymaint ，查找每一个实体检查这些记录是否加入到数据库中。