MacのVSCodeでSpringプロジェクトを動かす

Spring BootのプロジェクトはSpring Boot Extension Packをインストールしたら簡単に動かせたのだが、Springのプロジェクトは動かすのに苦労したので、記録を残しておく。
前提としてSpring BootはTomcatを内包しているが、Springはそうではないので、Tomcatを準備して動かす必要がある。

ざっくりとした手順は以下の通り。

  1. VSCodeTomcat for Javaをインストールする
  2. MacTomcatをインストールする
  3. Tomcat for JavaTomcatのインストール先ディレクトリを選択する
  4. Springプロジェクトをビルドする
  5. Tomcatを起動する
  6. ブラウザアクセスする

ビルドツールはmavenを想定している。

1. VSCodeTomcat for Javaをインストールする

特筆事項なし

2. MacTomcatをインストールする

以下の通りインストールする

MacBook-Air-3:report anhirayuuta$ brew install tomcat
Updating Homebrew...
==> Auto-updated Homebrew!
Updated 1 tap (homebrew/core).
==> New Formulae
gcc@8
==> Updated Formulae
abyss           fastme          kahip           octave          r
armadillo       fftw            lapack          open-mpi        reprepro
arpack          gcc             libxc           openblas        root
bazel           gjs             lysp            packmol         scalapack
binwalk         grib-api        mmseqs2         petsc           scipy
cp2k            hdf5            mpich           petsc-complex   spades
dungeon         hdf5@1.8        mvnvm           pgplot
dynare          imake           netcdf          plplot
eccodes         json-fortran    nwchem          qrupdate
==> Deleted Formulae
minisat

==> Downloading https://www.apache.org/dyn/closer.cgi?path=/tomcat/tomcat-9/v9.0
==> Downloading from http://ftp.jaist.ac.jp/pub/apache/tomcat/tomcat-9/v9.0.19/b
######################################################################## 100.0%
==> Caveats
To have launchd start tomcat now and restart at login:
  brew services start tomcat
Or, if you don't want/need a background service you can just run:
  catalina run
==> Summary
🍺  /usr/local/Cellar/tomcat/9.0.19: 638 files, 14.6MB, built in 7 seconds
MacBook-Air-3:report anhirayuuta$ which tomcat
MacBook-Air-3:report anhirayuuta$ cd /usr/
bin/        libexec/    sbin/       standalone/ 
lib/        local/      share/

インストール先ディレクトリは「/usr/local/Cellar/tomcat/9.0.19」となった。

3. Tomcat for JavaTomcatのインストール先ディレクトリを選択する

  • 「⬆️ + command + p」でAdd Tomcat Serverと打つ。
  • Tomcatのインストール先ディレクトリの選択画面になるが、「/usr/local」みたいなパスが指定できない。
  • 「⬆️ + command + g」で「フォルダの場所を入力:」という覧が表示されるので、先ほどの「/usr/local/Cellar/tomcat/9.0.19」を入力する。
  • ここをTomcatのインストール先ディレクトリとして指定すると「Please make sure you select a valid Tomcat Directory.」というエラーが出るので、「/usr/local/Cellar/tomcat/9.0.19/libexec」を指定する。するとエラーは出ない。(問題なく設定できた旨のメッセージは表示されないっぽい。)

4. Springプロジェクトをビルドする

mvn package

BUILD SUCCESSのメッセージを確認する。

5. Tomcatを起動する

  • 「⬆️ + command + p」でRun on Tomcat Serverと打つ。
  • target配下のwarを指定する。
  • OUTPUTビューにTomcatのメッセージが出力される。

6. ブラウザアクセスする

  • localhost:8080にアクセスすると「Tomcat for Visual Studio Code」というページが表示されるので、「War Packages Deployed on this Tomcat Server:」からアプリを選択する。

かなりざっくりですが、こんな感じでできました。
こちらのQiitaを大いに参考にさせていただきました。