odoo17 | 模型和基本字段-编程知识

前言

在上一章的最后，我们能够创建一个Odoo模块。然而，在这一点上，它仍然是一个空壳，不允许我们这样做存储任何数据。在我们的房地产模块中，我们希望存储与数据库中的属性（名称、描述、价格、居住面积等）。Odoo框架提供促进数据库交互的工具。

在继续练习之前，请确保已安装estate房地产模块，即必须在“应用”列表中显示为“已安装”。(点击启动即可)
在这里插入图片描述

模型对象关系映射

目标：使用odoo模型在数据库中创建表：estate_property

$ psql -d rd-demo
rd-demo=# SELECT COUNT(*) FROM estate_property;
count
-------0
(1 row)

Odoo的一个关键组件是ORM层。该层避免了手动编写大多数 SQL，并提供可扩展性和安全性服务。
业务对象被声明为扩展Model的Python类，后者将它们集成到自动化持久化系统中。
可以通过在模型定义中设置属性来配置模型。最重要的属性是_name，它是必需的，并定义了Odoo系统中模型的名称。这是一个模型的最小定义:

from odoo import modelsclass EstateProperty(models.Model):_name = 'estate.property'_description = '房地产模块'

这个定义足以让ORM生成一个名为estate_property的数据库表。按照惯例，所有模型都位于models目录中，每个模型都在自己的Python文件中定义。
_name = ‘estate.property’ 标识的是模型名称，会在posgres数据库中转化为estate_property表
_description = ‘房地产模块’ 是模型的描叙信息，可以不写，但是不写的话，启动会出现警告信息。

模型字段

字段用于定义模型可以存储的内容及其存储位置。字段是在模型类中定义为属性：
简单代码示例

from odoo import models,fieldsclass EstateProperty(models.Model):_name = 'estate.property'_description = '房地产模块'name = fields.Char()

name字段是一个Char，它将被表示为Python unicode str（即对象的属性）和SQL VARCHAR（即在数据库estate_property 增加名为name类型为VARCHAR的字段）。

模型是如何定义的，以及对应的 Python 是如何定义的文件导入

模型在文件estate/models/estate_property.py中定义(代码如下)

from odoo import models,fieldsclass EstateProperty(models.Model):_name = 'estate.property'_description = '房地产模块'name = fields.Char()

在estate/models/__init__.py中导入文件crm_recurring_plan.py(见这里)

from . import estate_property

在estate/__init__.py中导入文件夹模型(见这里)

from . import models

字段类型

字段有两大类:

“简单”的基本字段，它们是直接存储在模型表中的原子值
以及“关系”字段，它们链接(相同或不同模型的)记录（后面会讲到模型的关系字段）。

简单的字段示例有Boolean, Float, Char, Text, Date和Selection。

目标：按照下图将几个基本字段添加到表中：estate_property中

 Column       |            Type             | Collation | Nullable |                  Default
--------------------+-----------------------------+-----------+----------+---------------------------------------------
id                 | integer                     |           | not null | nextval('estate_property_id_seq'::regclass)
create_uid         | integer                     |           |          |
create_date        | timestamp without time zone |           |          |
write_uid          | integer                     |           |          |
write_date         | timestamp without time zone |           |          |
name               | character varying           |           |          |
description        | text                        |           |          |
postcode           | character varying           |           |          |
date_availability  | date                        |           |          |
expected_price     | double precision            |           |          |
selling_price      | double precision            |           |          |
bedrooms           | integer                     |           |          |
living_area        | integer                     |           |          |
facades            | integer                     |           |          |
garage             | boolean                     |           |          |
garden             | boolean                     |           |          |
garden_area        | integer                     |           |          |
garden_orientation | character varying           |           |          |
Indexes:"estate_property_pkey" PRIMARY KEY, btree (id)
Foreign-key constraints:"estate_property_create_uid_fkey" FOREIGN KEY (create_uid) REFERENCES res_users(id) ON DELETE SET NULL"estate_property_write_uid_fkey" FOREIGN KEY (write_uid) REFERENCES res_users(id) ON DELETE SET NULL

完整代码如下：

from odoo import models, fieldsclass EstateProperty(models.Model):_name = 'estate.property'_description = '房地产模块'name = fields.Char(string="名称")description = fields.Text(string="描述")postcode = fields.Char(string="邮编")date_availability = fields.Date(string="可用时间")expected_price = fields.Float(string="预期价格")selling_price = fields.Float(string="销售价格")bedrooms = fields.Integer(string="卧室")living_area = fields.Integer(string="居住面积")facades = fields.Integer(string="外立面（外墙）")garage = fields.Boolean(string="是否有车库")garden = fields.Boolean(string="是否有花园")garden_area = fields.Integer(string="花园面积")garden_orientation = fields.Integer(string="花园朝向")