Moqui运行和部署

原文：http://www.moqui.org/framework/docs/RunDeploy.html

1. 快速入门
2. 运行目录和配置文件
3. 可执行WAR文件
4. 示例和公共文件
5. 从源码编译和运行
6. 目录结构

---

1. 快速入门
   
   1. 安装JDK1.6
   2. 下载moqui 二进制分发版本，解压到任意目录
   3. 加载种子和演示数据 (默认将在derby中创建表结构)
      
      $ java -jar moqui-<version>.war -load
   4. 运行框架
      
      $ java -jar moqui-<version>.war
   5. 在浏览器访问
      
      http://localhost:8080/

   ---

2. 运行目录和配置文件
   Moqui框架部署有两个主要部分：
   
   1. 可执行的WAR文件
   2. 运行时配置文件的目录
   使用的可执行的WAR文件，你必须有一个runtime目录，（也可以修改XML配置文件指向其他的目录）
   runtime目录主要用来放置需要加载的components，配置文件、日志文件、Derby 数据库文件（moqui默认使用的是Derby）等。
   
   

   ---

3. 可执行WAR文件
   对于moqui WAR文件，有3个主要的操作命令
   加载数据
   $ java -jar moqui-<version>.war -load
   运行在嵌入式Web服务器
   $ java -jar moqui-<version>.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目录中
      可使用以下任意一个命令
      
      $ 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
   运行在嵌入式Web服务器
   $ gradle run
   或
   
   $ ant run
   清理JAR文件，WAR文件
   $ gradle clean
   清理所有构建文件和运行时的文件(日志, 数据库, 等等)
   $ gradle cleanAll  
   
   注意  加载和运行是依赖于构建任务的. 最简单的获得一个全新开发环境以及数据库的命令是:
   
   $ gradle load run
   这将构建WAR 文件、加载数据、运行内置嵌入式Web服务器。 停止命令为<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