【Important】
This system has not been maintained yet.
It has evolved into PlayVisualizerC.js.
- ブラウザからデモページにアクセスし利用する
- https://github.com/RYOSKATE/PlayVisualizerC/releases からスタンドアロン版をダウンロードする。
- binフォルダ内のファイルを実行し、サーバーを起動する。(Javaがインストールされていない場合は下記の Javaインストール を参照)
- ブラウザから localhost:9000/visualizer にアクセスし利用する。
- Java (インストール必須)
- Play (インストール必須)
- EclipseなどのIDE(インストール推奨)
- Mac
MacOSは標準でJavaを導入しているはずです。
- Windows
コマンドプロンプトで
java -version
javac -version
を入力してください。
コマンドが認識されなかった場合はJavaのインストールが必要です。 公式Webページ から最新のJDKをダウンロード・インストールをしてください。 プロジェクトのコンパイルにエラーが発生した場合は古いバージョンを使用している可能性があります。 その場合も最新のJDKを導入してください。
システム環境変数のPathにC:\java\jdk1.8.0_25\bin;などインストールしたJDKのbinディレクトリを追加してください。
環境変数JAVA_HOMEを作成し、C:\java\jdk1.8.0_25;などインストールしたJDKディレクトリを追加してください。
Playはactivatorというツールを利用して提供されます。 まずそれぞれの環境で最新のactivatorをインストールします。
- Mac
ターミナルから以下のコマンドを入力することでインストールができます。
brew install typesafe-activator
- Windows
PlayFrameworkの 公式Webページ からtypesafe-activatorをダウンロードします。
このプロジェクト作成に利用したPlayのバージョンは__2.5.3__です。
なんらかの理由で古いバージョンを利用する場合、バージョン2.2以前はactivatorを用いず以降入力するコマンドも異なるので注意してください。
ダウンロードした typesafe-activator-X.X.X-minimal.zipを展開します。
activator-X.X.X-minimal/bin/activator.batがあることを確認してください。
システム環境変数PATHにactivator.batがあるディレクトリを追加してください。
コマンドプロンプト/ターミナルで以下のコマンドが実行できることを確認してください。
activator help
もし実行できない場合はパスの確認、PCの再起動を試してみてください。
次にこのプロジェクトをクローン、もしくはダウンロードします。 プロジェクトのディレクトリに移動し以下のコマンドを実行してください。
activator run
コンパイルが終わり以下の文が表示されたら正常に実行されています。
(Server started, use Ctrl+D to stop and go back to the console...)
ブラウザを開きlocalhost:9000にアクセスしてください。
プロジェクトのトップページが表示されていれば成功です。
Ctrl+Dを押すまでactivatorはrun状態となります。
run状態でソースコードを変更した場合、変更の影響を受けるページにアクセスすると
Playは自動的にコンパイルを行ってくれます。
activatorがrun状態の場合Ctrl+Dで一旦終了してください。
- Scalaプラグイン
メニュー → PreferencesからPluginsという項目を開いてください。
Browse repositoriesからScalaプラグインを選択しダウンロードします。
IDEAを再起動することで有効化されます。
- インポート
IDEA起動後に Import Projectを選択します。
PVCのプロジェクトディレクトリを選択しOKを押します。
Import project from external modelを選び、SBTを選択してください。
Next→Finishでプロジェクトのインポートが行われます。
File→Project Structure→SDKsで使用しているjdkのバージョンを確認します。
jdk1.7などではエラーが発生する場合があります。jdk1.8以上を選択してください。
(場合によっては「Javaインストール」の章を参考に最新のjdkを導入してください。
- デバッグ設定
Run→Edit Configurationsを選択してください。
左上の緑色の + を押し、Remote を選択してください。
Nameに任意のデバッグ名をつけてください。
Portを9999に変更しApplyしてください。
以上でDubugが可能になります。
- インポート
このプロジェクトでは既にsbteclipseというEclipseへの変換プラグインが利用できるようになっています。
プロジェクトのディレクトリで
activator eclipse
を実行することでEclipse用のプロジェクトファイルが作成されます。
Eclipseを起動し、FIle→Import→General→Existing project...からこのプロジェクトのディレクトリを指定することでインポートが可能です。
最新の変換プラグインを利用したい場合、project/plugins.sbtをテキストエディタで開き
addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "X.X.X")
の数字を sbteclipse の最新バージョンの数値に書き換えて実行してください。
- Scala用プラグインインストール
Help → Install New Software… → Add
・Scala IDE for Eclipse
・http://download.scala-ide.org/sdk/lithium/e44/scala211/stable/site
を追加、全て選択しインストール。
- デバッグ設定
Eclipseにインポートしたプロジェクトに対して Debug As -> Debug Configurations → Remote Java Application → New で新しいデバッグ構成を作成します。 Portを9999に変更しApplyしてください。 以上でDubugが可能になります。
IDEからPort 9999のデバッグ構成を設定することで、ブレークポイントなどを利用したデバッグが可能になります。
ここまで使用してきた activator run は本番用の実行コマンドです。
デバッグ時は以下のコマンドを利用してください。
activator -jvm-debug 9999 ~run
このデバッグ実行状態ではブレークポイントなどが有効になります。
また ~runはファイルを変更する毎にコンパイルが行われます。
実際にブラウザでページを表示した時だけコンパイルを行いたい場合は、
activator -jvm-debug 9999 run
としてください。
PlayFrameworkはMVCモデルを採用しています。
ただしPVCはデータベースを使用しないため、モデルは用いず 主な処理はコントローラとビューで行われます。
代表的・重要なファイルについて説明します。
- build.sbt
依存するライブラリなどを記述します。
Junicoenはここで使用するRelease/tag,コミット番号を指定することで参照します。
Junicoenの機能を利用する場合は、コンパイルエラーにならないコミット番号に更新してください。
更新後はactivator updateを行うことで設定や参照が更新されます。
- lib/
このディレクトリに使用するライブラリファイル(.jarなど)を配置するとクラスパスの設定を必要とせずに利用できます。
- conf/routes
GET/POSTアドレスとコントローラのアクションの対応関係を設定します。
- app/controllers/
コントローラのアクションを記述します。(Scala)
- app/views/
htmlとして表示されるファイルです。(HTML/JavaScript)
- public/
ビューで必要とする画像や.js,.cssなどを配置します。