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