Apache OFBiz 学习笔记之实体引擎

最新推荐文章于 2024-06-20 16:17:06 发布

原创最新推荐文章于 2024-06-20 16:17:06 发布 · 365 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#数据库 #ldap #测试

OFBIZ 专栏收录该内容

27 篇文章

订阅专栏

本文深入解析EntityEngine框架，介绍其独特之处、数据建模方法及实体类型的定义方式，并演示如何使用GenericValue对象进行数据库操作。

1、概述

entity engine和常见的ORM有一点很大的不同，他的mapping object只有一个 GenericEntity，称它的entity engine 为adaptive object model更为合适一些，是一种比较灵活，代码量非常少的独特的持久化方案。使用entity engine做的项目和其他的ORM相比有一个很明显的特征：非常少的对象

基于Entity Engine 对数据库进行建模完全屏蔽了各种数据库的差别，可以支持从MySql到Oracle几乎所有的关系数据库

Entity Engine提供了简单有效的数据建模方式，通过简单的XML文件来描述实体，不需要写任何代码就能实现实体的创建，存储，删除，查找，排序，再也不需要写任何代码就能实现实体的创建，存储，删除，查找，排序，再也不需要编写和维护数据持久化的代码，通过JDBC支持任意种类的数据库

1.1 实体引擎的概念

DataSource：数据源，在一个数据库实体中可以有多个数据库schema，不同的schema覆盖各自的实体。数据源定义和配置在entityengine.xml中

Entity Delegators：实体代理，使用实体代理来访问数据库

例：framework/entity/config/entityengine.xml

  <delegator name="default-no-eca" entity-model-reader="main" entity-group-reader="main" entity-eca-reader="main" entity-eca-enabled="false" distributed-cache-clear-enabled="false">
        <group-map group-name="org.ofbiz" datasource-name="localderby"/>
        <group-map group-name="org.ofbiz.olap" datasource-name="localderbyolap"/>
        <group-map group-name="org.ofbiz.tenant" datasource-name="localderbytenant"/>
    </delegator>

Entity Group：就是在组名下的一组实体，组名用来指示实体代理类确定这些实体使用哪个数据源

实体定义

例：applications/product/entitydef/entitymodel.xml

    <entity entity-name="ProdCatalog"
            package-name="org.ofbiz.product.catalog"
            title="Catalog Entity" default-resource-name="ProductEntityLabels">
      <field name="prodCatalogId" type="id-ne"></field>
      <field name="catalogName" type="name"></field>
      <field name="useQuickAdd" type="indicator"></field>
      <field name="styleSheet" type="url"></field>
      <field name="headerLogo" type="url"></field>
      <field name="contentPathPrefix" type="long-varchar"></field>
      <field name="templatePathPrefix" type="long-varchar"></field>
      <field name="viewAllowPermReqd" type="indicator"></field>
      <field name="purchaseAllowPermReqd" type="indicator"></field>
      <prim-key field="prodCatalogId"/>
    </entity>

1.2实体类型

entity：标准实体，是MVC架构中的模型（MODEL）的基本单元；简单的说，就是一个数据库表。

view-entity：视图，通常是成员实体通过一系列关系连接起来的集合

extend-view：扩展实体，实体能够通过<extend-entity>元素来扩展

2.1标准实体（entity）

属性：

entity-name：实体名
table-name：表名

package-name：包名

default-resource-name：缺省资源文件名

dependent-on：指定父级实体和依赖的实体，仅用来指定层次化实体结构

sequence-bank-size：序列号步长

enable-lock：是否在这个实体上使用优化锁

子元素：

description：说明
field：字段

prim-key：主键

relation：关系

copyright：版权

index：索引

例：framework/security/entitydef/entitymodel.xml

<entity entity-name="UserLogin"
            package-name="org.ofbiz.security.login"
            title="User Login Entity">
      <field name="userLoginId" type="id-vlong-ne"></field>
      <field name="currentPassword" type="short-varchar"></field>
      <field name="passwordHint" type="description"></field>
      <field name="isSystem" type="indicator"></field>
      <field name="enabled" type="indicator"></field>
      <field name="hasLoggedOut" type="indicator"></field>
      <field name="requirePasswordChange" type="indicator"></field>
      <field name="lastCurrencyUom" type="id"></field>
      <field name="lastLocale" type="very-short"></field>
      <field name="lastTimeZone" type="id-long"></field>
      <field name="disabledDateTime" type="date-time"></field>
      <field name="successiveFailedLogins" type="numeric"></field>
      <field name="externalAuthId" type="id-vlong-ne">
          <description>For use with external authentication; the userLdapDn should be replaced with this</description>
      </field>
      <field name="userLdapDn" type="id-vlong-ne">
          <description>The user's LDAP Distinguished Name - used for LDAP authentication</description>
      </field>
      <prim-key field="userLoginId"/>
 
    </entity>

2.2视图（view-entity）

属性：

entity-name：实体名

package-name:包名

dependent-on：依赖关系

default-resource-name：缺省资源名

never-cache：从不缓存

auto-clear-cache：自动清除缓存

title：标题

copyright：版权

author：作者

version：版本

子元素：

description：说明

member-entity：成员实体

alias-all：所有别名

alias：别名

view-link：试图连接

relation：关系

例：applications/party/entitydef/entitymodel.xml

    <view-entity entity-name="PartyAndUserLogin"
            package-name="org.ofbiz.party.party"
            title="Party and Contact Mech View Entity">
      <member-entity entity-alias="PTY" entity-name="Party"/>
      <member-entity entity-alias="ULN" entity-name="UserLogin"/>
      <alias entity-alias="PTY" name="partyId"/>
      <alias entity-alias="PTY" name="partyTypeId"/>
      <alias entity-alias="ULN" name="userLoginId"/>
      <alias entity-alias="ULN" name="currentPassword"/>
      <alias entity-alias="ULN" name="passwordHint"/>
      <alias entity-alias="ULN" name="enabled"/>
      <alias entity-alias="ULN" name="disabledDateTime"/>
      <alias entity-alias="ULN" name="successiveFailedLogins"/>
      <view-link entity-alias="PTY" rel-entity-alias="ULN">
        <key-map field-name="partyId"/>
      </view-link>
      <relation type="one-nofk" rel-entity-name="Party">
        <key-map field-name="partyId"/>
      </relation>
      <relation type="one-nofk" rel-entity-name="UserLogin">
        <key-map field-name="userLoginId"/>
      </relation>
    </view-entity>

2.3扩展试图（extend-entity）

属性：

entiy-name：实体名

子元素

field：字段

relation：关系

index：索引

例：applications/party/entitydef/entitymodel.xml

    <extend-entity entity-name="UserLogin">
        <field name="partyId" type="id"></field>
        <relation type="one" fk-name="USER_PARTY" rel-entity-name="Party">
            <key-map field-name="partyId"/>
        </relation>
        <relation type="one-nofk" rel-entity-name="Person">
            <key-map field-name="partyId"/>
        </relation>
        <relation type="one-nofk" rel-entity-name="PartyGroup">
            <key-map field-name="partyId"/>
        </relation>
    </extend-entity>

3、GenericValue对象

一个GenericValue对象就是数据库实体的一条记录

4、创建、更新、删除、数据库记录

4、1创建实体

1、获取GenericValue实体对象

OFBiz中提供了多种获取实体对象的方式，推荐使用下面的方式

GenericValue tempValue = delegator.makeValue("EntityName");

4、2更新实体

4、3删除实体

5、几种取数据库记录

5.1几个常用的查询方法

通过主键查询：public GenericValue findByPrimaryKey(String entityName,Map<String ,? extends Object> fields)

指定字段（and组合）查询：public List<GenericValue> findByAnd(String entityName,Map<String,? extends Object> fields)

条件查询：public List<GenericValue> findList(String entityName,EntityCondition entityCondition,Set<String> fieldsToSelect,List<String> orderBy,EntityFindOptions findOptions,boolean useCache)

查询列表：public List<GenericValue> findList(String entityName,EntityCondition entityCondition,Set<String> fieldsToSelect,List<String> orderBy,EntityFindOptions findOptions,boolean useCache)

参数说明：

String entityName:要查询及记录的实体

EntityCondition entityCondition ：限制获取的条件

Set fieldsToSelect :返回记录获取的字段，null为全部

List orderBy ：排序字段，null为排序

EntityFindOptions findOptions 查找选项

boolean useCache 是否使用缓存

6、动态视图实体

DynamicViewEntity 动态视图

EntityCondition条件

EntityFunction 函数

EntityOperator 操作