Scalatra 教程（第一部分）

在这个系列教程里，我们将更近距离的看看Scalatra。Scalatra是基于微web框架的轻量级scala，它可以用来创建高性能站点和API.  在第一个教程里，我们将开始着手安装scalatra，然后把我们的测试项目倒入到Eclipse里。

SBT和giter8

在你开始着手之前，你需要安装两个工具（我假设你已经安装了JDK1.6+）。我将给你提供简缩的安装指令，详细版的安装指令可通过 下面的scalatra页面找到（ http://www.scalatra.org/getting-started/first-steps.html）。这种方法应该可以在大多数环境下运行，不过，对我自己来说，它不能运行......它下载了老版本的 giter8和老版本的sbt。为了获得sbt，我使用macport下载了最新版本： 

port install sbt

然后我也手工下载了giter8. 

curl https://raw.github.com/n8han/conscript/master/setup.sh | sh
cs n8han/giter8

最后一个命令是安装g8到你的/bin目录下。我已经对这个版本的g8进行了下面测试：

~/bin/g8
 
giter8 0.5.0
Usage: g8 [TEMPLATE] [OPTION]...
Apply specified template.
 
OPTIONS
    -b, --branch
        Resolves a template within a given branch
    --paramname=paramvalue
        Set given parameter value and bypass interaction.
 
 
Apply template and interactively fulfill parameters.
    g8 n8han/giter8
 
Or
    g8 git://github.com/n8han/giter8.git
 
Apply template from a remote branch
    g8 n8han/giter8 -b some-branch
 
Apply template from a local repo
    g8 file://path/to/the/repo
 
Apply given name parameter and use defaults for all others.
    g8 n8han/giter8 --name=template-test

创建并初始化项目 

在你的主目录里运行下面的命令创建你的项目：

[email protected]:~/dev/scalatra/firststeps$ g8 scalatra/scalatra-sbt
organization [com.example]: org.smartjava
package [com.example.app]: org.smartjava.scalatra     
name [scalatra-sbt-prototype]: hello-scalatra
servlet_name [MyScalatraServlet]: HelloScalatraServlet
scala_version [2.9.1]: 
version [0.1.0-SNAPSHOT]:

这步会在当前目录下创建hello-scalatra项目目录。

./build.sbt
./project
./project/build.properties
./project/plugins.sbt
./README.md
./src
./src/main
./src/main/resources
./src/main/resources/logback.xml
./src/main/scala
./src/main/scala/org
./src/main/scala/org/smartjava
./src/main/scala/org/smartjava/scalatra
./src/main/scala/org/smartjava/scalatra/HelloScalatraServlet.scala
./src/main/scala/Scalatra.scala
./src/main/webapp
./src/main/webapp/WEB-INF
./src/main/webapp/WEB-INF/layouts
./src/main/webapp/WEB-INF/layouts/default.scaml
./src/main/webapp/WEB-INF/views
./src/main/webapp/WEB-INF/views/hello-scalate.scaml
./src/main/webapp/WEB-INF/web.xml
./src/test
./src/test/scala
./src/test/scala/org
./src/test/scala/org/smartjava
./src/test/scala/org/smartjava/scalatra
./src/test/scala/org/smartjava/scalatra/HelloScalatraServletSpec.scala

为了测试所有的一切是能工作的，到你的项目目录，通过‘container:start’这个命令，使用sbt启动你的项目。这会下载很多东西，完成之后会启动应用：

[email protected]:~/dev/scalatra/firststeps/hello-scalatra$ sbt
[info] Loading project definition from /Users/jos/Dev/scalatra/firststeps/hello-scalatra/project
[info] Set current project to hello-scalatra (in build file:/Users/jos/Dev/scalatra/firststeps/hello-scalatra/)
> container:start
[info] jetty-8.1.5.v20120716
[info] NO JSP Support for /, did not find org.apache.jasper.servlet.JspServlet
[info] started o.e.j.w.WebAppContext{/,[file:/Users/jos/Dev/scalatra/firststeps/hello-scalatra/src/main/webapp/]}
[info] started o.e.j.w.WebAppContext{/,[file:/Users/jos/Dev/scalatra/firststeps/hello-scalatra/src/main/webapp/]}
15:12:44.604 [pool-6-thread-4] INFO  o.scalatra.servlet.ScalatraListener - Initializing life cycle class: Scalatra
[info] started o.e.j.w.WebAppContext{/,[file:/Users/jos/Dev/scalatra/firststeps/hello-scalatra/src/main/webapp/]}
15:12:44.727 [pool-6-thread-4] INFO  o.f.s.servlet.ServletTemplateEngine - Scalate template engine using working directory: /var/folders/mc/vvzshptn22lg5zpp7fdccdzr0000gn/T/scalate-5609005579304140836-workdir
[info] Started [email protected]:8080
[success] Total time: 1 s, completed Sep 7, 2012 3:12:44 PM
>
[success] Total time: 1 s, completed Sep 7, 2012 3:10:05 PM

为了测试是否所有的正确，打开你的浏览器访问 localhost:8080，你会看到下面的界面说明一切正确：

导入到Eclipse里

我通常使用Eclipse开发，因此在这种情况下，让我们确保我们可以在Eclipse里编辑源代码。为了这个目的，我们可以使用eclipse的sbt插件。添加这个插件是非常容易的。进入‘项目’文件夹，然后把下面的内容（在它之前由一个空行）增加到plugins.sbt文件里。

addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "2.1.0"

当你下一步运行sbt的时候，你将看到正在下载的很多东西。从sbt里运行'eclipse',这时创建了eclipse的配置文件(.classpath和.project) 。现在启动Eclipse集成开发环境，然后你可以导入你刚才创建的项目（确保你也安装了eclipse的scala-ide)。

现在我们启动容器，让sbt侦听我们资源的变化。

$ sbt
> container:start
> ~ ;copy-resources;aux-compile

在Eclipse里我们存储文件的任何时刻，sbt都将复制和重新编译资源。因此我们能直接在浏览器里看到已经更改的文件。打开文件HelloScalatraServlet，然后修改欢迎文本。如果你保存了这个文件，那么sbt将重新装载应用，而且你将直接看到已经更改了的文件。