创建一个基本模块
在 Odoo，我们通过创建模块来完成任务。
使用 Odoo 的搭建脚本工具可以创建一个基本模块。
$ ./odoo-bin scaffold Academy my-modules
安装演示模块
在创建了 academy 模块后，即使它什么也没做，我们也可以安装这个模块。启动 Odoo 服务，
$ ./odoo-bin --addons-path addons,my-modules
然后在应用中去掉过滤器，搜索 academy 就可以安装。
和浏览器交互
Controllers 处理浏览器的请求，返回结果。
from odoo import http
class Academy(http.Controller):
@http.route('/academy/academy/', auth='public')
def index(self, **kw):
return "Hello, world"
在浏览器中打开 http://localhost:8069/academy/academy/ , 你会看到如下的页面
http的路由路径可以随意定义，不一定要以模块名，这里是 academy 开始。我们建议以模块名开始避免冲突。
我们看到 @http.route , 这是 Python 的 decorator 的语法。http://www.cnblogs.com/Jerry-Chou/archive/2012/05/23/python-decorator-explain.html
使用模板
手动拼装 html 不是一件让人愉快的事情。
在 Odoo 中，我们使用 QWeb（https://www.odoo.com/documentation/11.0/reference/qweb.html#reference-qweb） 作为模板语言（你也可以使用其他基于 Python 的模板语言）。
class Academy(http.Controller):
@http.route('/academy/academy/', auth='public')
def index(self, **kw):
return http.request.render('academy.index', {
'teachers': ["Diana Padilla", "Jody Caroll", "Lester Vaughn"],
})
这里将使用在 manifest.py 中注册的 academy.index 模板。
academy/templates.xml
....
Academy
你需要重新更新模块，在启动的时候可以使用更新选项:
$ odoo-bin --addons-path addons,my-modules -d academy -u academy
在浏览器中打开会看到如下的页面
数据存储
首先定义好模型的类，
academy/models.py
from odoo import models, fields, api
class Teachers(models.Model):
_name = 'academy.teachers'
name = fields.Char()
设置相关的访问权限
academy/manifest.py
# always loaded
'data': [
'security/ir.model.access.csv',
'templates.xml',
],
# only loaded in demonstration mode
academy/security/ir.model.access.csv
id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_academy_teachers,access_academy_teachers,model_academy_teachers,,1,0,0,0
演示数据
可以用 XML 描述用于演示的静态数据
academy/demo.xml
Diana Padilla
Jody Carroll
Lester Vaughn
这些数据会在演示模式下加载，在启动的时候会看到如下输出：
2018-06-26 12:07:29,908 20692 INFO phone580 odoo.modules.registry: module academy: creating or updating database tables
2018-06-26 12:07:29,997 20692 INFO phone580 odoo.modules.loading: loading academy/security/ir.model.access.csv
2018-06-26 12:07:30,030 20692 INFO phone580 odoo.modules.loading: loading academy/views/views.xml
2018-06-26 12:07:30,033 20692 INFO phone580 odoo.modules.loading: loading academy/views/templates.xml
2018-06-26 12:07:30,057 20692 INFO phone580 odoo.modules.loading: loading academy/demo/demo.xml
通过 PostgreSQL 客户端在 Tables 下可以观察到关联的数据
当我们修改静态数据之后，需要更新模块才能生效，使用 -u 参数在启动的时候更新模块，要同时使用 -d 参数才能生效。
访问数据
academy/controllers.py
class Academy(http.Controller):
@http.route('/academy/academy/', auth='public')
def index(self, **kw):
Teachers = http.request.env['academy.teachers']
return http.request.render('academy.index', {
'teachers': Teachers.search([])
})
# @http.route('/academy/academy/objects/', auth='public')
academy/templates.xml
Academy
我们看到很关键的地方在 Teachers = http.request.env['academy.teachers'] 这里将Teacher这个类引进了代码的上下文之中。
至此，我们看到了一个基本的渲染框架，以及一个简单的ORM框架，这些是构建一个网站的两个基本组成。
网站支持
odoo提供了一系列的模块帮助我们建立网站。目前为止，我们使用controllers的方式很直接，odoo通过website模块增加了更深度的整合以及包括样式、主体的服务。
增加
website作为依赖；然后在 controller 设置
website=True标志，这样我们可以通过the request object获取更多变量，也可以在模板里使用website的layout；使用website的layout。
URLs和路由
用来做路由的字符串可以使用converter patterns，不仅可以用来做路由匹配，还可以将数据作为本地变量使用。
academy/controllers.py
'teachers': Teachers.search([])
})
@http.route('/academy//', auth='public', website=True)
def teacher(self, name):
return '{}
'.format(name)
converter patterns 不仅仅是数据提取，还可以用于转换和验证。
academy/controllers.py
'teachers': Teachers.search([])
})
@http.route('/academy//', auth='public', website=True)
def teacher(self, id):
return '{} ({})
'.format(id, type(id).__name__)
你可以使用model来根据id获取记录。
academy/controllers.py
'teachers': Teachers.search([])
})
@http.route('/academy//', auth='public', website=True)
def teacher(self, teacher):
return http.request.render('academy.biography', {
'person': teacher
})
academy/templates.xml
