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 | shcs n8han/giter8

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

~/bin/g8 giter8 0.5.0Usage: 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

创建并初始化项目 

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

[e-mail]:~/dev/scalatra/firststeps$ g8 scalatra/scalatra-sbtorganization [com.example]: org.smartjavapackage [com.example.app]: org.smartjava.scalatra     name [scalatra-sbt-prototype]: hello-scalatraservlet_name [MyScalatraServlet]: HelloScalatraServletscala_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启动你的项目。这会下载很多东西，完成之后会启动应用：

[e-mail]:~/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 SelectChannelConnector@0.0.0.0: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将重新装载应用，而且你将直接看到已经更改了的文件。