odoo17开发教程（4）：模块module和model中的字段类型

之前的文章我们已经了解了模块的基础构成，然而，此时它仍然是一个空壳，无法存储任何数据。在我们的房地产模块中，我们希望在数据库中存储与房产相关的信息（名称、描述、价格、居住面积......）。Odoo 框架提供了促进数据库交互的工具。

对象关系映射

Odoo的一个关键组件是ORM层。该层可避免手动编写大多数 SQL，并提供可扩展性和安全服务。

业务对象被声明为扩展 Model 的 Python 类，从而将它们集成到自动持久化系统中。

模型可通过在定义中设置属性进行配置。最重要的属性是 _name，这是必填项，它定义了模型在 Odoo 系统中的名称。以下是模型的最低定义：

from odoo import models

class TestModel(models.Model):
    _name = "test_model"

这个定义足以让 ORM 生成一个名为 test_model 的数据库表。按照惯例，所有模型都位于 models 目录中，每个模型都在自己的 Python 文件中定义。
 

model中的字段

字段用于定义模型可以存储的内容和存储位置。字段在模型类中定义为属性，例如：

from odoo import fields, models

class TestModel(models.Model):
    _name = "test_model"
    _description = "Test Model"

    name = fields.Char()

name 字段是一个 Char，它将表示为 Python unicode str 和 SQL VARCHAR。

字段分为两大类：“简单”字段（直接存储在模型表中的原子值）和“关系”字段用来链接记录（相同或不同模型的））

字段示例包括布尔、浮点、字符、文本、日期和选择(Boolean, Float, Char, Text, Date and Selection)

我们的表estate_property（房产属性）需要以下这些字段：

Field	Type
name	Char
description	Text
postcode	Char
date_availability	Date
expected_price	Float
selling_price	Float
bedrooms	Integer
living_area	Integer
facades	Integer
garage	Boolean
garden	Boolean
garden_area	Integer
garden_orientation	Selection

你可以使用下面的代码真正创建一个estate_property表，新建models/estate_property.py:

from odoo import models, fields, api

class EstateProperty(models.Model):
    _name = "estate_property"
    _description = "Estate Property"
    
    name = fields.Char(required=True)
    description = fields.Text()
    postcode = fields.Char()
    date_available = fields.Date()
    expected_price = fields.Float(required=True)
    selling_price = fields.Float()
    bedrooms = fields.Integer()
    living_area = fields.Integer()
    facades = fields.Integer()  # 外墙
    garage = fields.Boolean()
    garden = fields.Boolean()
    garden_area = fields.Integer()
    garden_orientation = fields.Selection([
        ("north", "North"),
        ("south", "South"),
        ("east", "East"),
        ("west", "West"),
    ])

与模型本身一样，字段也可以通过传递配置属性作为参数来进行配置：

name = fields.Char(required=True)

有些属性适用于所有字段，以下是最常见的属性：
string（str，默认：字段名）
字段在用户界面中的标签（用户可见）。

required （bool，默认值：False）
如果为 True，则字段不能为空。它必须有一个默认值，或者在创建记录时始终给定一个值。

help （str，默认值：''）
在用户界面中为用户提供帮助提示。

index（bool，默认值：False）
请求 Odoo 为列创建数据库索引。

自动字段

Odoo 会在所有模型中创建一些字段。这些字段由系统管理，不能写入，但如果有用或有必要，可以读取：

id （标识）
模型记录的唯一标识符。

create_date （日期）
记录的创建日期。

create_uid （Many2one）
创建记录的用户。

write_date (Datetime)
记录的最后修改日期。

write_uid (Many2one)
最后修改记录的用户。

总结：

到此为止，我们模块的结构应该是下面这样（忽略pycache文件夹）

 models/__init__.py:

from . import estate_property

estate/__init__.py:

from . import models

最后重启你的容器 docker restart <container_id>

用数据库管理软件，例如pgadmin4，就能看到你新创建的表啦！
ps: 如何还看不到，找到你的模块，点击Upgrade：

上一篇文章 odoo17开发教程（3）：详解__manifest__.py文件_odoo 17开发文档-CSDN博客 

下一篇文章 odoo17开发教程（5）：权限的简单介绍_odoo17 权限-CSDN博客