HTTP 与 Web 标准 / 系统课时

梳理订单数据的层级关系

梳理订单数据的层级关系

设计订单 XML 时,最先要解决的不是标签名称,而是数据之间的包含关系。本节从一张订单出发,确定订单、客户、商品明细和金额信息的层级,让后续元素与属性设计都有稳定的结构基础。

学习目标

  • 根据业务对象之间的包含关系确定 XML 根元素和主要子元素
  • 区分订单级信息与商品明细级信息,避免层级混乱
  • 用一份完整 XML 骨架验证订单数据结构是否清晰

从业务对象确定根元素

一份 XML 文档只能有一个根元素。当前文档描述的是“一张订单”,因此可以使用 order 作为根元素,把订单编号、状态、客户、商品明细和金额信息统一放在它的内部。

先不要急着决定每个字段究竟是属性还是元素。结构设计的第一步只回答一个问题:哪些信息属于谁。

订单数据可以先拆成四组:客户信息描述下单人;商品明细描述本次购买的一个或多个商品;金额信息描述商品合计、运费和订单总额;订单自身还拥有编号、状态等整体信息。

订单 XML 的层级关系

区分订单级与明细级数据

最容易出错的是把商品字段直接放到订单根元素下。订单可以包含多件商品,而商品名称、数量和单价都属于某一条具体明细,因此需要先建立 items 集合,再让其中出现多个 item。

例如,客户姓名只出现一次,可以放在 customer 中;而两件不同商品分别有自己的数量和单价,应各自放在独立的 item 中。如果把 productName、quantity 等字段直接平铺到 order 下,就很难自然表达第二件、第三件商品。

金额也适合单独形成 amounts 层。这样既能把订单级金额与商品单价区分开,也方便同时表达商品小计、运费和最终总额。

写出订单的结构骨架

下面先使用元素表示各项数据,重点观察包含关系,不讨论属性选择:

xml
<?xml version="1.0" encoding="UTF-8"?>
<order>
  <orderId>ORD-1001</orderId>
  <status>paid</status>
  <customer>
    <name>Chen Ming</name>
    <email>chen@example.com</email>
  </customer>
  <items>
    <item>
      <productName>Mechanical Keyboard</productName>
      <quantity>1</quantity>
      <unitPrice>399.00</unitPrice>
    </item>
    <item>
      <productName>USB-C Cable</productName>
      <quantity>2</quantity>
      <unitPrice>39.00</unitPrice>
    </item>
  </items>
  <amounts>
    <subtotal>477.00</subtotal>
    <shipping>12.00</shipping>
    <total>489.00</total>
  </amounts>
</order>

这是一份数据结构示例,不依赖程序运行。验证时可以检查三个要点:整个文档只有一个 order 根元素;每个开始标签都有对应结束标签;多个商品都位于 items 下,并分别拥有自己的 item 节点。

检查层级是否合理

判断层级时,可以从“对象能否独立重复”和“字段属于哪个对象”两个方向检查。item 可以重复,因此需要单独的明细层;quantity 属于某一个 item,不能提升为整个订单的数量;total 描述整张订单,因此不应放进任何单个商品内部。

一个实用原则是:如果将来增加第二个同类对象时必须复制一组字段,那么这组字段通常应该被一个父元素包装起来。按照这个原则组织后,订单 XML 即使增加更多商品、客户字段或金额项,也能保持清晰稳定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

梳理订单数据的层级关系

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通