geekcheng / jibu Goto Github PK

                       Jibu release 1.x

什么是 Jibu？
------------

  最好不要直接把 Jibu 当作一个开源框架来使用，也就是说，在没有完全了解其实现原理
  以前，不要以它作为你项目的首选架构。否则到时很可能被老板爆粗，被同事唾弃。

  Jibu 开发的初衷是为 Gaixie.ORG 的内部运营提供支持，它的所有功能也必须满足这一
  前提。在很多人看来必不可少的功能，这里很可能并没有实现，因为我们暂时不需要。所
  以它只是一个供大家交流，学习的样例系统。不同的是，这个系统是一个真实的、运营中
  的系统，它不但开放源码，所有文档、设计**、运维体系也全部开放。换句话说，除了
  部分核心密码，其它所有的一切都是公开的。太祖都说过：“实践是检验真理的唯一标准”。

  Jibu 的设计与实现力求简洁，高效。并始终坚持 “约定优于配置”，不会有复杂的配置文
  件，也不会有大多的封装，4个字：“够用就行”（如下图）。所以不要怀疑它那小巧的体
  积，个人觉得，这类应用写大很容易，写小要难得多。

  +-------+-----------------+-------+
  |       | Extjs           |       |
  +---+---+-----------------|-------+
  | S | M | Servlet         |       |
  | L | o +-----------------|       |
  | F | d | Service         | Guice |
  | 4 | e +----------+------|       |
  | J | l | Dbutils  | DAO  |       |
  +---+---+----------+------|-------+
  |       | Dbcp            |       |
  |       |-----------------+-------+
  |       | MySQL or PostgreSQL     |
  +-------+-------------------------+

相关文档：
--------

  Jibu 的主文档只有一份，详细介绍了系统如何安装、运行、使用、维护，以及开发。此
  外还有一份 javadoc 文档和数据库 schema 说明文档。可以通过下面的地址在线阅读
  最新的版本，历史版本通过源码编译生成，详细步骤请参考主文档。

    - 主文档: http://jibu.qiniudn.com/jibu-doc/
    - javadoc: http://jibu.qiniudn.com/jibu-api/
    - 数据库 schema: http://jibu.qiniudn.com/jibu-schema/

通过源码进行编译：
---------------
  
  确保你的机器上已经安装了 JDK 1.7+ 和 Apache Maven 3.0.3+ 以上版本。从
  github.com 上下载或通过 git clone 最新的版本。
    
    git clone https://github.com/bitorb/jibu.git

  进入 jibu 目录进行编译打包，如果没有创建相应的数据库 schema ，需要跳过运行测试
  用例。

    cd jibu
    mvn clean install -Dmaven.test.skip=true

  如果创建数据库 schema，可以下载或者通过 git clone 最新的 jibu-schema 项目
    
    git clone https://github.com/bitorb/jibu-schema.git

编译好的安装包：
-------------

  可以通过下面的地址直接下载已经编译好的安装包:

    - http://repo2.maven.org/maven2/org/gaixie/jibu/assemblies/jibu/

Bug 提交：
---------

  Jibu 使用 github.com 进行 Bug 跟踪，所以如果发现任何问题，请提交到下面的地址：

    - https://github.com/bitorb/jibu/issues

交流沟通：
--------

  邮件是我们最主要的沟通方式，有一个邮件列表负责所有与 Jibu 相关问题的讨论，由于
  之前有过被垃圾邮件*扰的经验，目前我一个人也忙不过来，所以此邮件列表不再开放注
  册，改为邀请制，如果你有兴趣加入，请发送邮件给我。我的邮箱在主文档的目录页。

  邮件列表的内容可以通过 Web 方式浏览（可能需要有崂山道士的本领），地址是：

    - https://groups.google.com/d/forum/gaixie-jibu