Betterlife 学习手册

# 配置文件

  • 路径 :tools/tools/autocode/

  • 文件名称：autocode.config.xml

  • 一键生成所有代码地址: http://127.0.0.1/betterlife/tools/tools/autocode/db_onekey.php

# 初始化

  • 新创建的项目需将该文件删除，框架会自动生成新的配置文件，

  • 自动生成表五种关系的配置,条件查询的配置、关系主键显示属性的配置。

  • 其后可通过代码生成的策略实现配置文件的管理。

  • 初始化步骤如下

    • 修改配置文件: core/config/config/ConfigAutoCode.php
      • 修改配置: ALWAYS_AUTOCODE_XML_NEW = true
    • 一键生成所有代码地址: http://127.0.0.1/[项目名称]/tools/tools/autocode/db_onekey.php
      • 会生成配置文件: tools/tools/autocode/autocode.config.xml
    • 新建项目需将生成代码里的实体类复制到项目中 home/[项目名称]/src/domain 对应目录下
    • 再次运行一键生成所有代码地址: http://127.0.0.1/[项目名称]/tools/tools/autocode/db_onekey.php
      • 会再次覆盖配置文件: tools/tools/autocode/autocode.config.xml
      • 说明: 实体类关于数据对象之间关系配置是需要将实体类放置到项目中，生成代码引擎才能够认知到实体类之间的关系并将其生成到配置文件中的。
    • 再次将生成代码里的实体类覆盖复制到项目中 home/[项目名称]/src/domain 对应目录下
    • 还原配置。修改配置文件: core/config/config/ConfigAutoCode.php
      • 修改配置: ALWAYS_AUTOCODE_XML_NEW = false

# 自动生成

生成数据对象规格说明所需的配置，无需手动一个个配置；如不需要该配置，只需手动删除即可。

# 数据对象类配置

  • 配置文件的元节点为class，对每一个数据对象进行查询条件、表关系主键显示配置、数据对象之间关系配置

    <classes>
    <class name="Order">
</classes>
    • name :数据对象名称

# 查询条件配置[允许配置关系主键查询]

  • 配置文件的元节点为conditions

    <conditions>
    <condition>name</condition>
    <condition relation_class="Member" show_name="username">member_id</condition>
</conditions>
    • relation_class: 关系主键对应的表数据对象
    • show_name : 对应的表数据对象显示列
    • 值 : 在当前数据对象表中存在的关系主键名称

# 表关系主键显示配置

  • 配置文件的元节点为relationShows

    <relationShows>
   <show local_key="product_id" relation_class="Product">name</show>
</relationShows>
    • relation_class : 关系主键对应的表数据对象
    • local_key : 在当前数据对象表中存在的关系主键名称
    • 值 : 对应的表数据对象显示列

# 数据对象之间关系配置

# 数据对象之间关系类型

  • has_one【一对一】
  • belong_has_one【从属一对一】
  • has_many【一对多】
  • many_many【多对多】
  • belongs_many_many【从属多对多】

# 数据对象之间关系类型示例

  • 一对一: 用户和用户详情

    <class name="User">
    <has_one>
        <relationclass name="Userdetail">userDetail</relationclass>
    </has_one>
</class>

  • 从属一对一: 用户和部门

    <class name="User">
    <belong_has_one>
        <relationclass name="Department">department</relationclass>
    </belong_has_one>
</class>

  • 一对多：用户和评论

    <class name="User">
    <has_many>
        <relationclass name="Comment">comment</relationclass>
    </has_many>
</class>

  • 多对多：用户和角色 【表中间名最后一段是：userrole】

    <class name="User">
    <many_many>
        <relationclass name="Role">roles</relationclass>
    </many_many>
</class>

  • 从属多对多：角色和用户 【表中间名最后一段是：userrole】

    <class name="Role">
    <belongs_many_many>
        <relationclass name="User">users</relationclass>
    </belongs_many_many>
</class>

# 冗余字段配置

  • 主要用于中间表为了减少联表查询保存的冗余字段数据。
  • 需要配置告知是关联哪个数据对象的冗余字段。
    <class name="Themeshow">
    <redundancy>
        <table name="Theme">
            <field name="theme_name"/>
            <field name="introduce"/>
            <field name="image"/>
            <field name="parent_id"/>
            <field name="childcount"/>
            <field name="level"/>
        </table>
    </redundancy>
</class>

# 支持一选多[全部|已选|未选择]

  • 一选多中配置的是中间关系表才会生成

    <class name="User">
    <has_many>
        <relationclass name="Userrole">userrole</relationclass>
    </has_many>
</class>

  • 说明: 中间表对象类必须配置查询条件配置conditions才能正常使用

← 准备工作 →