Moqui运行部署说明(中文翻译)

http://www.moqui.org/framework/docs/RunDeploy.html



运行和部署指南
本文档介绍了如何运行Moqui通过可执行的jar文件，或者在应用程序服务器中部署WAR文件。
<!--jiasudu 15000850008 -->
运行和部署指南
1。快速入门
2。运行目录和配置文件
3。执行WAR文件
4。示例和公共文件
简单的方式 - 默认设置
普通的用法 - 在命令行中指定一个配置文件
在设置里面创建一个自定义的WAR文件
5。从源代码的编译和运行
6。目录结构
<!--jiasudu 15000850008 -->

1、快速入门
    1.1 请确保你有一个Java6 JDK安装（最好是Sun / Oracle和苹果版本的jdk，OpenJDK或Harmony可能会有问题）
    1.2 下载并解压缩二进制分发版，创建一个moqui目录
    1.3 加载种子数据和演示数据，并创建derby数据以及表结构:
            $ java -jar moqui-<version>.war -load
    1.4 运行框架（内嵌的servlet，JTA / CP，DB）：
            $ java -jar moqui-<version>.war
     1.5 在浏览器（同一台计算机上），访问：
            输入http://localhost:8080/




2、运行目录和配置文件
Moqui框架部署有两个主要部分：
1 可执行的WAR文件（见下文）
2 运行时配置文件的目录

使用的可执行的WAR文件，你必须有一个runtime目录，你可以重写一个XML配置文件的默认设置。
运行目录是主要的地方，把你要加载，为Web应用程序的根文件（root screen）的画面，和配置文件的组成部分。它的框架也会把日志文件，Derby 数据库文件（如果你使用的是Derby），JCR repo文件，等你最终将要创建自己的运行时目录，并保持它在自己的源库中，您可以使用默认的项目一开始浏览网页。

指定这两个属性：
    moqui.runtime运行时目录（如果存在，默认为“/runtime”，或如果没有运行的子目录,仅仅是“.”）
    moqui.conf的Conf XML文件（URL或路径相对于moqui.runtime）

有两种方法可以指定这两个属性：
1、MoquiInit.properties文件在classpath中
2、系统属性可以在命令行上指定（java -D 参数 ）
请参阅下面的例子。



3. 执行WAR文件
生成一个可执行的war文件. 你需要做3个步骤:
加载数据: $ java -jar moqui-<version>.war -load
运行内置的Web服务器: $ java -jar moqui-<version>.war
发布成war, 部署到Tomcat: $ cp moqui-<version>.war ../tomcat/webapps
你也可以获取帮助信息:
java -jar moqui-<version>.war -help
获得一些帮助的说明文字.

4. 示例和公共方法
简单方式 - 默认设置
最简单的方式 解压moqui的二进制发行包，运行moqui.
使用默认配置:
moqui.runtime = runtime
moqui.conf = conf/MoquiDevConf.xml (相对于 runtime)
运行下面的命令:
加载数据 $ java -jar moqui-<version>.war -load
启动服务器 $ java -jar moqui-<version>.war

修改一些配置 - 在命令行指定一个配置文件
加载数据 $ java -Dmoqui.conf=conf/MoquiStagingConf.xml -jar moqui-<version>.war -load
启动服务器 $ java -Dmoqui.conf=conf/MoquiStagingConf.xml -jar moqui-<version>.war

创建一个自定义的war文件
    1 在runtime目录里面新增一个组件或者其他资源
    2 修改 ${moqui.home}/MoquiInit.properties
    3 根据需求修改Moqui配置文件(runtime/conf/Moqui*Conf.xml)
    4 基于moqui.war 文件创建派生的war文件并添加到runtime目录中以及        MoquiInit.properties文件: "$ gradle addRuntime" 或者 "$ ant add-runtime"
    5 将新建的war文件 (moqui-plus-runtime.war) 部署到目标服务器
    6 运行服务器 (或者重新部署war包)



5. 从源代码的编译和运行
Moqui 框架使用了 Gradle作为编译工具..
这也有Ant的一些构建命令,但是不适用从源码代码构建.
编译 JAR, WAR $ gradle build
加载所有数据 $ gradle load $ ant load
运行内置服务器 $ gradle run $ ant run
清理JAR文件, WAR文件 $ gradle clean
清理所有构建文件和运行时的文件(日志, 数据库, 等等) $ gradle cleanAll
注意  加载和运行任务是依赖于构建任务的. 最简单的获得一个全新开发环境以及数据库的命令是:
$ gradle load run
这将构建war 文件, 加载数据, 运行内置服务器. 停止命令为<ctrl-c>.

6. 项目的目录结构
- moqui (from https://github.com/jonesde/moqui)
  - framework
    - build     : Results of framework build go here (classes, jars, etc)
    - data      : Seed data
    - entity    : Framework entity definitions
    - lib       : Libraries (JAR files) used in Moqui
    - screen    : Framework screens
    - service   : Framework services
    - src       : Java API, standard entities, services, data, XSDs, etc
      - api     : Java source for the Moqui Framework API
      - main    : Main implement source
        - groovy    : Groovy source (bulk of the implementation)
        - java      : Java source (a few special classes)
        - resources : Classpath resources, placed in JAR as-is
        - webapp    : Base webapp, mostly just a WEB-INF/web.xml file
      - start   : Java source for MoquiStart, used for executable WAR
    - template  : Framework templates (screen/form, xml-actions FTLs)
    - xsd       : Framework XML Schema files
  - runtime
    - component : Components to deploy
      - example : An example application
      - tools   : Framework administration and maintenance tools
      - webroot : Root Screen and supporting content
    - conf      : Configuration files separated by dev, staging, prod, etc
    - db        : Database files for Derby, etc will go here
    - lib       : JAR files to add to classpath
    - log       : Log files will go here
    - mantle    : The Mantle root can go here, with components under it
    - template  : General Templates
    - tmp       : Temporary files


设置环境变量
export GRADLE_HOME=/Users/user/tools/gradle-1.2
export PATH=$GRADLE_HOME/bin:$PATH
最后在终端下执行gradle -v 查看输出

gradle run