odoo-addon-fs-file 17.0.1.0.0.4

使用方法

新字段 FSFile 已开发，允许您在外部文件系统存储中存储文件。其设计基于以下原则：

• 只有在需要时才从文件系统中读取文件内容。

• 默认情况下必须能够将文件内容作为流进行操作。

• 与Odoo的二进制字段不同，内容是原始文件内容（没有base64编码）。

• 为了允许与其他系统交换文件内容，可以将内容写入base64。读取操作将返回一个包含文件名、MIME类型、大小和下载文件URL的JSON结构。

这种设计允许在处理大型文件以及通过默认jsonrpc接口与其他系统交换时，最大限度地减少服务器的内存消耗。

具体来说，这种设计允许您编写如下代码：

from IO import BytesIO
from odoo import models, fields
from odoo.addons.fs_file.fields import FSFile

class MyModel(models.Model):
    _name = 'my.model'

    name = fields.Char()
    file = FSFile()

# Create a new record with a raw content
my_model = MyModel.create({
    'name': 'My File',
    'file': BytesIO(b"content"),
})

assert(my_model.file.read() == b"content")

# Create a new record with a base64 encoded content
my_model = MyModel.create({
    'name': 'My File',
    'file': b"content".encode('base64'),
})
assert(my_model.file.read() == b"content")

# Create a new record with a file content
my_model = MyModel.create({
    'name': 'My File',
    'file': open('my_file.txt', 'rb'),
})
assert(my_model.file.read() == b"content")
assert(my_model.file.name == "my_file.txt")

# create a record with a file content as base64 encoded and a filename
# This method is useful to create a record from a file uploaded
# through the web interface.
my_model = MyModel.create({
    'name': 'My File',
    'file': {
        'filename': 'my_file.txt',
        'content': base64.b64encode(b"content"),
    },
})
assert(my_model.file.read() == b"content")
assert(my_model.file.name == "my_file.txt")

# write the content of the file as base64 encoded and a filename
# This method is useful to update a record from a file uploaded
# through the web interface.
my_model.write({
    'file': {
        'name': 'my_file.txt',
        'file': base64.b64encode(b"content"),
    },
})

# the call to read() will return a json structure with the filename,
# the mimetype, the size and a url to download the file.
info = my_model.file.read()
assert(info["file"] == {
    "filename": "my_file.txt",
    "mimetype": "text/plain",
    "size": 7,
    "url": "/web/content/1234/my_file.txt",
})

# use the field as a file stream
# In such a case, the content is read from the filesystem without being
# stored in memory.
with my_model.file.open("rb) as f:
  assert(f.read() == b"content")

# use the field as a file stream to write the content
# In such a case, the content is written to the filesystem without being
# stored in memory. This kind of approach is useful to manipulate large
# files and to avoid to use too much memory.
# Transactional behaviour is ensured by the implementation!
with my_model.file.open("wb") as f:
    f.write(b"content")

变更日志

错误跟踪器

在GitHub Issues上跟踪错误。如果遇到问题，请检查是否已报告您的问题。如果您是第一个发现问题的，请通过提供详细和受欢迎的反馈来帮助我们解决问题。

请不要直接联系贡献者寻求支持或帮助解决技术问题。

鸣谢

维护者

此模块由OCA维护。

OCA，即Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并促进其广泛使用。

当前维护者

此模块是GitHub上OCA/storage项目的一部分。

欢迎您贡献。要了解如何贡献，请访问https://odoo-community.org/page/Contribute。