概要
業務でPlay Framework を使って書かれたwebサービスを紐解く必要が出てきたため、Play Framework を理解するために環境構築の構築から新規アプリケーションを作るところまで試してみる。
環境構築
今回はMac OS ver 10.9.5 にて環境構築を行う。
JDK インストール
こちらを参考にインストールするだけ
MacにJava(JDK)をインストール
activator とPlay Framework のダウンロード
play はactivator によって提供されるようなので、まずactivator のダウンロードから行う。
※activator についてはこちらを参照
activator ダウンロード
公式ページへアクセスし、最新のパッケージをダウンロード
http://www.playframework.org/
activator のPath 追加
ダウンロードが完了したらそれぞれのフォルダを任意の場所に設置。
activator 及びのPath を通す必要があるのでbash, zsh 等環境に合わせてPath を追加。
以下は$HOME/Library 配下にフォルダを移した場合に追加するPath
${HOME}/Library/activator-1.3.9-minimal/bin
activator のPath が通ったかの検証
$ activator -help
成功例
% activator -help
Usage: activator <command> [options]
Command:
ui Start the Activator UI
new [name] [template-id] Create a new project with [name] using template [template-id]
list-templates Print all available template names
-h | -help Print this message
Options:
-v | -verbose Make this runner chattier
-d | -debug Set sbt log level to debug
-mem <integer> Set memory options (default: , which is -Xms1024m -Xmx1024m -XX:MetaspaceSize=64m -XX:MaxMetaspaceSize=256m)
-jvm-debug <port> Turn on JVM debugging, open at the given port.
# java version (default: java from PATH, currently java version "1.8.0_77")
-java-home <path> Alternate JAVA_HOME
# jvm options and output control
-Dkey=val Pass -Dkey=val directly to the java runtime
-J-X Pass option -X directly to the java runtime
(-J is stripped)
# environment variables (read from context)
JAVA_OPTS Environment variable, if unset uses ""
SBT_OPTS Environment variable, if unset uses ""
ACTIVATOR_OPTS Environment variable, if unset uses ""
In the case of duplicated or conflicting options, the order above
shows precedence: environment variables lowest, command line options highest.
play ダウンロード
同様に公式ページよりインストール
https://www.playframework.com/download
play のPath 追加
activator と同じく展開したフォルダを任意の場所に設置し、Path を通す
以下は$HOME/Library 配下にフォルダを移した場合に追加するPath
${HOME}/Library/play-2.2.6
play のPath が通ったかの検証
以下のコマンドを実行し、正常にヘルプが表示されればOK
$ play help
成功例
% play help
Getting com.typesafe.play console_2.10 2.2.6 ...
:: retrieving :: org.scala-sbt#boot-app
confs: [default]
6 artifacts copied, 0 already retrieved (2012kB/139ms)
Getting Scala 2.10.3 (for console)...
:: retrieving :: org.scala-sbt#boot-scala
confs: [default]
5 artifacts copied, 0 already retrieved (24447kB/319ms)
_
_ __ | | __ _ _ _
| '_ \| |/ _' | || |
| __/|_|\____|\__ /
|_| |__/
play 2.2.6 built with Scala 2.10.3 (running Java 1.8.0_77), http://www.playframework.com
Welcome to Play 2.2.6!
These commands are available:
-----------------------------
license Display licensing informations.
new [directory] Create a new Play application in the specified directory.
You can also browse the complete documentation at http://www.playframework.com.
新規プロジェクトの作成
以下のコマンドで新しいプロジェクトが作られる
$ play new [プロジェクト名]
実行例、今回はJava で作成。
(アプリケーション名を問われた際には何も入力せずEnterを打っています)
% play new playSampleProject
_
_ __ | | __ _ _ _
| '_ \| |/ _' | || |
| __/|_|\____|\__ /
|_| |__/
play 2.2.6 built with Scala 2.10.3 (running Java 1.8.0_77), http://www.playframework.com
The new application will be created in /Users/XXXX/work/playSampleProject
What is the application name? [playSampleProject]
>
Which template do you want to use for this new application?
1 - Create a simple Scala application
2 - Create a simple Java application
> 2
OK, application playSampleProject is created.
Have fun!
できました^^
アプリの起動
コンソールの起動
先ほど作成したプロジェクトディレクトリに移動し、playコマンドを実行。
初回の起動では必要なファイルがダウンロードされます。
% play
Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=512M; support was removed in 8.0
Getting org.scala-sbt sbt 0.13.0 ...
:: retrieving :: org.scala-sbt#boot-app
confs: [default]
43 artifacts copied, 0 already retrieved (12440kB/242ms)
[info] Loading project definition from /Users/XXXX/work/playSampleProject/project
[info] Set current project to playSampleProject (in build file:/Users/XXXX/work/playSampleProject/)
_
_ __ | | __ _ _ _
| '_ \| |/ _' | || |
| __/|_|\____|\__ /
|_| |__/
play 2.2.6 built with Scala 2.10.3 (running Java 1.8.0_77), http://www.playframework.com
> Type "help play" or "license" for more information.
> Type "exit" or use Ctrl+D to leave this console.
[playSampleProject] $
なんか表示が変わった、コンソールが起動したぽい
アプリの起動
この状態でrun を実行
[playSampleProject] $ run
[info] Updating {file:/Users/XXXX/work/playSampleProject/}playsampleproject...
[info] Resolving org.fusesource.jansi#jansi;1.4 ...
[info] Done updating.
--- (Running the application from SBT, auto-reloading is enabled) ---
[info] play - Listening for HTTP on /0:0:0:0:0:0:0:0:9000
(Server started, use Ctrl+D to stop and go back to the console...)
※デフォルトのポート番号は9000。既に利用している場合はrun [port番号]のように、使用していないポート番号を指定する。
起動したアプリにアクセス
http://localhost:9000 にアクセスし、以下のような画面が表示されることを確認。
次回
次は生成されたプロジェクトの構成を調査します。