PageRenderTime 27ms CodeModel.GetById 20ms RepoModel.GetById 0ms app.codeStats 0ms

/docs/zh_CN/uliweb/introduction.md

https://github.com/limodou/uliweb-doc
Markdown | 130 lines | 83 code | 47 blank | 0 comment | 0 complexity | db6094710ee04778193a1dd8713a0faf MD5 | raw file
    

  1. # Uliweb 简介
    2. 

  2. 

  3. 

  4. ## 它是什么
    5. 

  5. 

  6. Uliweb是一个全栈式的Python Web Framework，它有三个主要设计目标：可重用性，可配
    7. 

  7. 置性和可替换性。所有的功能都是围绕着这些目标。
    8. 

  8. 

  9. 这个项目是由Limodou <mailto:limodou@gmail.com>发起并创建的。
    10. 

  10. 

  11. 

  12. ## License
    13. 

  13. 

  14. Uliweb按照BSD协议进行发布。
    15. 

  15. 

  16. 

  17. ## 基础组件
    18. 

  18. 

  19. 它并不完全是从头写的一个东西，我目前使用了一些库，如：
    20. 

  20. 

  21. 

  22. * [Werkzeug](http://werkzeug.pocoo.org/) 用它来进行框架的核心处理，比如：
    23. 

  23.     URL Mapping，Debug，Request, Response 等。
    24. 

  24. * [SqlAlchemy](http://www.sqlalchemy.org) 基于它封装了Uliorm，可以使用ORM对
    25. 

  25.     数据库进行处理。
    26. 

  26. 

  27. 还有一些比较小的引用，如：
    28. 

  28. 

  29. * template 是从 [tornado](http://mdp.cti.depaul.edu/) 改造来的（从0.4开始，在此之前是基于 [web2py](http://mdp.cti.depaul.edu/) ）
    30. 

  30. * 部分处理代码从 [Django](http://www.djangoproject.com/) 中借鉴
    31. 

  31. 

  32. 另外还有一些是自已新造的，如：
    33. 

  33. 

  34. * Form处理，可以用来生成HTML代码和对上传的数据进行校验
    35. 

  35. * i18n处理，包括对模板的处理
    36. 

  36. * Cache 和 Session 模块
    37. 

  37. * Uliorm，是在SqlAlchemy基础之上进行的封装，同时参考了GAE中的datastore的代码
    38. 

  38. * 框架的处理代码，这块不可能不自已造了
    39. 

  39. * 插件机制，从Ulipad中移植并进行了改造
    40. 

  40. 

  41. 

  42. ## 功能特点
    43. 

  43. 

  44. 

  45. * 项目组织管理
    46. 

  46. 

  47.     * 采用MVT模型开发。
    48. 

  48.     * 分散开发统一管理。采用App方式的项目组织。每个App有自已的配置文件，templates目录，
    49. 

  49.         static目录。使得Uliweb的App重用非常方便。同时在使用上却可以将所有App看成一个整体，
    50. 

  50.         可以相互引用静态文件和模板。缺省是所有App都是生效的，也可以指定哪些App是生效的。
    51. 

  51.         所有生效App的配置文件在启动时会统一进行处理，最终合成一个完整的配置视图。
    52. 

  52. 

  53. * URL处理
    54. 

  54. 

  55.     * 灵活强大的URL映射。采用Werkzeug的Routing模块，可以非常方便地定义URL，并与View函数
    56. 

  56.         进行绑定。同时可以根据view函数反向生成URL。支持URL参数定义，支持缺省URL定义，如:
    57. 

  57. 

  58.         ```
    59. 

  59.         appname/view_module/function_name
    60. 

  60.         ```
    61. 

  61. 

  62. 

  63. * View与Template
    64. 

  64. 

  65.     * View模板的自动套用。当view返回dict对象时，自动根据view函数的名字查找对应的模板。
    66. 

  66.     * 目前View方法支持一般函数和类的方式。
    67. 

  67.     * 环境方式运行。每个view函数在运行时会处于一个环境下，因此你不必写许多的import，许多
    68. 

  68.         对象可以直接使用，比如request, response等。可以大大减少代码量。
    69. 

  69.     * 模板中可以直接嵌入Python代码，不需要考虑缩近，只要在块结束时使用pass。支持模板的
    70. 

  70.         include和继承。
    71. 

  71. 

  72. * ORM
    73. 

  73. 

  74.     * 类Django和GAE的datastore，可以支持自动建表，同时提供命令行工具进行数据的备分，装入，建表等处理。
    75. 

  75.     * Model可配置化，因此可以实现Model的替换
    76. 

  76.     * 提供多数据库连接的支持
    77. 

  77.     * 支持alembic的数据库迁移处理
    78. 

  78. 

  79. * i18n
    80. 

  80. 

  81.     * 支持代码和模板中的i18n处理
    82. 

  82.     * 支持浏览器语言和cookie的自动选择，动态切换语言
    83. 

  83.     * 提供命令行工具可以自动提取po文件，可以以App为单位或整个项目为单位。并在处理时自动将
    84. 

  84.         所有语言文件进行合并处理。当发生修改时，再次提取可以自动进行合并。
    85. 

  85. 

  86. * 扩展
    87. 

  87. 

  88.     * plugin扩展。这是一种插件处理机制。Uliweb已经预设了一些调用点，这些调用点会在特殊的地方
    89. 

  89.         被执行。你可以针对这些调用点编写相应的处理，并且将其放在settings.py中，当Uliweb在启动
    90. 

  90.         时会自动对其进行采集，当程序运行到调用点位置时，自动调用对应的插件函数。
    91. 

  91.     * middleware扩展。它与Django的机制完全类似。你可以在配置文件中配置middleware类。每个
    92. 

  92.         middleware可以处理请求和响应对象。
    93. 

  93.     * views模块的初始化处理。在views模块中，如果你写了一个名为__begin__的函数，它将在执行
    94. 

  94.         要处理的view函数之前被处理，它相当于一个入口。因此你可以在这里面做一些模块级别的处理，
    95. 

  95.         比如检查用户的权限。因此建议你根据功能将view函数分到不同的模块中。
    96. 

  96. 

  97. * 命令行工具
    98. 

  98. 

  99.     * 可以自动创始初始工作环境，自动包含必要的目录结构，文件和代码
    100. 

  100.     * 静态文件导出，可以将所有生效的App下的static导出到一个统一的目录
    101. 

  101.     * 除了有项目组命令工具外，还提供APP专属命令工具，如ORM
    102. 

  102. 

  103. * 部署
    104. 

  104. 

  105.     * 支持GAE部署
    106. 

  106.     * 支持Apache下的mod_wsgi部署
    107. 

  107.     * 支持uwsgi部署
    108. 

  108.     * 支持dotcloud部署
    109. 

  109.     * 支持sae部署
    110. 

  110. 

  111. * 开发
    112. 

  112. 

  113.     * 提供开发服务器，并当代码修改时自动装载修改的模块
    114. 

  114.     * 提供debug功能，可以查看出错的代码，包括模板中的错误
    115. 

  115. 

  116. ## 社区
    117. 

  117. 

  118. 

  119. * 邮件列表 http://groups.google.com/group/uliweb
    120. 

  120. * QQ讨论组 162487035
    121. 

  121. 

  122. 

  123. ## 链接
    124. 

  124. 

  125. 

  126. * Uliweb 项目主页 https://github.com/limodou/uliweb
    127. 

  127. * Uliweb-doc 文档项目 [http://github.com/limodou/uliweb-doc](http://github.com/limodou/uliweb-doc)
    128. 

  128. * Uliweb-doc 在线文档查看链接 [http://limodou.github.com/uliweb-doc/](http://limodou.github.com/uliweb-doc/)
    129. 

  129. * plugs Uliweb apps收集项目 https://github.com/limodou/plugs
    130. 

  130. 

  131.