下载构建方式,参见https://www.lagomframework.com/get-started-scala.html
Lagom系统通常由一组sbt构建组成,每个构建提供多个服务。开始使用一个新的Lagom系统最简单的方法是使用Lagom sbt Giter8模板创建一个新项目。这将创建一个sbt项目,包含两个服务,hello
和stream
。模板使用.sbtopts
文件来增加启动项目时JVM
所使用的内存。有关增加内存的其他方法,请参阅增加sbt运行内存。
按照以下步骤创建和运行Hello World:
- 创建
- 浏览
-
创建工程
为Lagom项目在文件系统中选择一个位置。模板将提示您输入项目名称,并使用该名称创建一个目录,其中包含构建结构和Lagom示例服务。请注意,sbt下载依赖项可能需要几秒钟到几分钟的时间。
要创建您的项目,请遵循以下步骤: 打开控制台并切换到为项目选择的目录。
- 输入如下命令:
模板提示输入以下参数。按Enter键接受默认值或指定自己的值:sbt new lagom/lagom-scala.g8
name
——成为顶级项目目录的名称。organization
——用作包名。-
浏览工程结构
创建的工程包含如下元素:
hello → Project root
└ hello-api → hello api project
└ hello-impl → hello implementation project
└ hello-stream-api → hello-stream api project
└ hello-stream-impl → hello-stream implementation project
└ project → sbt configuration files
└ build.properties → Marker for sbt project
└ plugins.sbt → sbt plugins including the declaration for Lagom itself
└ build.sbt → Your project build file
请注意,每个服务拆分成了两个项目工程:api接口和实现。
api
项目包含一个服务接口,使用者可以通过该接口与服务进行交互。impl
项目包含实际的服务实现。project
文件夹包含sbt特定的文件。build.sbt
文件包含构建、运行和部署服务所需的所有信息。运行Hello World
Lagom包括一个开发环境,您只需在sbt控制台中输入runAll
就可以启动所有服务。要运行Hello World,将目录切换到顶级目录并启动sbt,当命令提示符显示时,调用runAll
。例如:
构建项目和启动服务需要一些时间。在其他消息中,您可以看到以下内容:cd hello
sbt
... (booting up)
> runAll
通过从任何HTTP客户端(如浏览器)调用服务,来验证服务是否确实启动并运行:[info] Starting embedded Cassandra server
..........
[info] Cassandra server running at 127.0.0.1:4000
[info] Service locator is running at http://localhost:9008
[info] Service gateway is running at http://localhost:9000
[info] Service hello-impl listening for HTTP on 127.0.0.1:24266
[info] Service hello-impl listening for HTTPS on 127.0.0.1:50695
[info] Service hello-stream-impl listening for HTTP on 127.0.0.1:26230
[info] Service hello-stream-impl listening for HTTPS on 127.0.0.1:58440
(Services started, press enter to stop and go back to the console...)
该服务返回消息http://localhost:9000/api/hello/World
Hello, World!
。祝贺您,您已经构建了您的第一个Lagom项目!