下载构建方式,参见https://www.lagomframework.com/get-started-scala.html

Lagom系统通常由一组sbt构建组成,每个构建提供多个服务。开始使用一个新的Lagom系统最简单的方法是使用Lagom sbt Giter8模板创建一个新项目。这将创建一个sbt项目,包含两个服务,hellostream。模板使用.sbtopts文件来增加启动项目时JVM所使用的内存。有关增加内存的其他方法,请参阅增加sbt运行内存。
按照以下步骤创建和运行Hello World:

  1. 创建
  2. 浏览
  3. 运行

    创建工程

    为Lagom项目在文件系统中选择一个位置。模板将提示您输入项目名称,并使用该名称创建一个目录,其中包含构建结构和Lagom示例服务。请注意,sbt下载依赖项可能需要几秒钟到几分钟的时间。
    要创建您的项目,请遵循以下步骤:

  4. 打开控制台并切换到为项目选择的目录。

  5. 输入如下命令:
    1. sbt new lagom/lagom-scala.g8
    模板提示输入以下参数。按Enter键接受默认值或指定自己的值:
  • name——成为顶级项目目录的名称。
  • organization——用作包名。
  • version-系统的版本号。

    浏览工程结构

    创建的工程包含如下元素:

    1. hello Project root
    2. hello-api hello api project
    3. hello-impl hello implementation project
    4. hello-stream-api hello-stream api project
    5. hello-stream-impl hello-stream implementation project
    6. project sbt configuration files
    7. build.properties Marker for sbt project
    8. plugins.sbt sbt plugins including the declaration for Lagom itself
    9. build.sbt Your project build file
  • 请注意,每个服务拆分成了两个项目工程:api接口和实现。api项目包含一个服务接口,使用者可以通过该接口与服务进行交互。impl项目包含实际的服务实现。

  • project文件夹包含sbt特定的文件。
  • build.sbt文件包含构建、运行和部署服务所需的所有信息。

    运行Hello World

    Lagom包括一个开发环境,您只需在sbt控制台中输入runAll就可以启动所有服务。要运行Hello World,将目录切换到顶级目录并启动sbt,当命令提示符显示时,调用runAll。例如:
    1. cd hello
    2. sbt
    3. ... (booting up)
    4. > runAll
    构建项目和启动服务需要一些时间。在其他消息中,您可以看到以下内容:
    1. [info] Starting embedded Cassandra server
    2. ..........
    3. [info] Cassandra server running at 127.0.0.1:4000
    4. [info] Service locator is running at http://localhost:9008
    5. [info] Service gateway is running at http://localhost:9000
    6. [info] Service hello-impl listening for HTTP on 127.0.0.1:24266
    7. [info] Service hello-impl listening for HTTPS on 127.0.0.1:50695
    8. [info] Service hello-stream-impl listening for HTTP on 127.0.0.1:26230
    9. [info] Service hello-stream-impl listening for HTTPS on 127.0.0.1:58440
    10. (Services started, press enter to stop and go back to the console...)
    通过从任何HTTP客户端(如浏览器)调用服务,来验证服务是否确实启动并运行:
    1. http://localhost:9000/api/hello/World
    该服务返回消息Hello, World!。祝贺您,您已经构建了您的第一个Lagom项目!