Play-Scala.js 项目教程

1. 项目的目录结构及介绍

Play-Scala.js 项目的目录结构如下：

play-scalajs/
├── build.sbt
├── project
│   └── build.properties
├── server/
│   ├── app/
│   │   └── controllers/
│   │       └── HomeController.scala
│   ├── conf/
│   │   ├── application.conf
│   │   └── routes
│   └── public/
│       └── javascripts/
│           └── client-fastopt.js
├── client/
│   ├── src/
│   │   └── main/
│   │       └── scala/
│   │           └── client/
│   │               └── Main.scala
│   └── build.sbt
└── README.md

目录结构介绍

• build.sbt: 项目的主构建文件，定义了项目的依赖和任务。
• project/: 包含项目构建的配置文件，如 build.properties。
• server/: Play 应用的服务端部分。
  • app/: 包含应用程序的源代码。
    • controllers/: 控制器文件，如 HomeController.scala。
  • conf/: 配置文件，如 application.conf 和路由文件 routes。
  • public/: 静态资源文件，如 JavaScript 文件。
• client/: Scala.js 应用的客户端部分。
  • src/: 源代码目录。
    • main/: 主代码目录。
      • scala/: Scala 代码目录。
        • client/: 客户端代码，如 Main.scala。
  • build.sbt: 客户端部分的构建文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

服务端启动文件

服务端的启动文件主要是 server/app/controllers/HomeController.scala，这是 Play 应用的入口控制器。

package controllers

import javax.inject._
import play.api._
import play.api.mvc._

@Singleton
class HomeController @Inject()(cc: ControllerComponents) extends AbstractController(cc) {
  def index() = Action { implicit request: Request[AnyContent] =>
    Ok(views.html.index())
  }
}

客户端启动文件

客户端的启动文件是 client/src/main/scala/client/Main.scala，这是 Scala.js 应用的入口点。

package client

import org.scalajs.dom

object Main {
  def main(args: Array[String]): Unit = {
    dom.document.getElementById("root").textContent = "Hello World"
  }
}

3. 项目的配置文件介绍

主构建文件 (build.sbt)

build.sbt 文件定义了项目的依赖和任务。

lazy val server = (project in file("server"))
  .enablePlugins(PlayScala)
  .settings(
    name := "play-scalajs-server",
    scalaVersion := "2.13.10",
    libraryDependencies ++= Seq(
      guice,
      "org.scalatestplus.play" %% "scalatestplus-play" % "5.0.0" % Test
    )
  )
  .dependsOn(client)

lazy val client = (project in file("client"))
  .enablePlugins(ScalaJSPlugin)
  .settings(
    name := "play-scalajs-client",
    scalaVersion := "2.13.10",
    scalaJSUseMainModuleInitializer := true,
    libraryDependencies ++= Seq(
      "org.scala-js" %%% "scalajs-dom" % "1.1.0"
    )
  )

服务端配置文件 (server/conf/application.conf)

application.conf 文件包含了 Play 应用的配置信息。

play.http.secret.key = "changeme"

play.filters.enabled += "play.filters.csrf.CSRFFilter"

客户端构建文件 (client/build.sbt)

client/build.sbt 文件