カミュプリィの雑多なメモ

タグ: サーブレット

  • [Java]初めてApache Tomcatをセットアップ

    [Java]初めてApache Tomcatをセットアップ

    　Javaでウェブサイトを作りたくて Windows クライアントに Apache Tomcat をセットアップしました。色々なサイトを参考にしましたので、わたしもまとめ情報を公開します。

    　でもね、開発するだけなら Tomcat も HTTP Server も不要でした。詳しくはこちら↓で紹介しています
    Spring Initializrで始めるウェブ開発

    セットアップするソフトウエア

    　ダウンロードしたファイルは次のものになります。今回はすべてZIPファイルをダウンロードしました。ダウンロード先のリンクを貼っておきます。

    JDK (Java Development Kit)

    　まずはJDKからセットアップします。
    　ダウンロードしたZIPファイル内の[jdk-23]フォルダを任意のローカルディスクに保存します。わたしはフォルダ名を[jdk]に変更しました。

    　次にWindowsのシステム環境変数を設定します。Tomcatでも設定しますので、あとでまとめて設定しても良いです。
    　[スタート]から[環境変数]を検索して、[システム環境変数の編集]を開きます。[システムのプロパティ]-[詳細設定]タブが開きますので、右下の[環境変数]ボタンを押します。

    　[JAVA_HOME]を追加して値をJDKのフォルダ名にします。例えば D:\webservice\jdk になります。
    　また[Path]にJDKのフォルダの中の[bin]を追加します。例えば D:\webservice\jdk\bin になります。

    Apache Tomcat

    　JDKに続いて Apache Tomcat をセットアップします。
    　ダウンロードしたZIPファイル内の [apache-tomcat-10.1.30] フォルダを任意のローカルディスクに保存します。わたしはフォルダ名を[tomcat]に変更しました。

    　次に設定ファイルを更新します。
    　Tomcatのフォルダにある conf\server.xml をメモ帳で開きます。
    　<Connector port=”8080″ から /> までをコメントアウトして無効にします。
    　<Connector protocol=”AJP/1.3″ から /> までをコメントアウトから外して有効にします。
    　<Connector protocol=”AJP/1.3″ から /> の間に secretRequired=”false” を追記します。
    　<Host から </Host> の間に <Valve className=”org.apache.catalina.valves.RemoteAddrValve” allow=”127.0.0.1″ /> を追記します。
    　ファイルを保存して閉じます。

    （Windowsのみ）
    　Tomcatのフォルダにある conf\logging.properties をメモ帳で開きます。
    　java.util.logging.ConsoleHandler.encoding = UTF-8 行を java.util.logging.ConsoleHandler.encoding = SJIS に変更します。

    　次にWindowsのシステム環境変数を設定します。
    　[CATALINA_HOME]を追加して値をTomcatのフォルダ名にします。例えば D:\webservice\tomcat になります。
    　また[Path]にTomcatのフォルダの中の[bin]を追加します。例えば D:\webservice\tomcat\bin になります。

    　サービスとして起動するには、コマンドプロンプトを開いてトムキャットの bin ディレクトリへ移動して次のコマンドを実行します。

    service.bat install

    　もし「[error] [ 3540] 指定されたサービスは既に開始されています。」と表示されたら、既にサービスに登録されていることを疑ってみます。サービス名はAから始まる「Apache Tomcat ・・・」です。

    　次にWindowsサービスの一覧を開いて「Apache Tomcat ・・・」を見つけます。
    　「スタートアップの種類」が手動になっていますので、自動へ変更します。

    Apache HTTP Server

    　最後に Apache Http Server をセットアップします。
    　ZIPファイル内の [Apache24] フォルダを任意のローカルディスクに保存します。わたしはフォルダ名を[apache]に変更しました。

    　次に設定ファイルを更新します。
    　Apache HTTP Serverのフォルダにある conf\httpd.conf をメモ帳で開きます。
    　Define SRVROOT “パス” のパスを実際のパスに書き換えます。例えば D:/webservice/apache になります。
    　次の2行の先頭にある#を取り除いて有効にします。
    #LoadModule proxy_module modules/mod_proxy.so
    #LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
    　次の2行を追記します。
    ProxyPass / ajp://localhost:8009/
    ProxyPassReverse / ajp://localhost:8009/
    　ファイルを保存して閉じます。

    　サービスとして起動するには、コマンドプロンプトを開いてアパッチの bin ディレクトリへ移動して次のコマンドを実行します。

    httpd.exe -k install

    MariaDB

    　MySQLを使おうかMariaDBにしようか、色々と悩みました。色々と調べてみるとMySQLとMariaDBには際立った違いはなく、こだわらない人には「どちらでもよい」と感じられる程度の差異があるとの認識に達しました。今回はMariaDBを使うことにします。

    　MSIファイルをダブルクリックしてセットアップを始めます。
    　パスワードやインストール先パスを入力し、「Use UTF8 as default server’s character set」のチェックを入れます。

    　これでMariaDBのセットアップが終わり、サービスとしてMariaDBが動作しています。

    　次にWindowsのシステム環境変数を設定します。[Path]にMariaDBのフォルダの中の[bin]を追加します。例えば D:\webservice\MariaDB\bin になります。

    MariaDB Connector/J

    　ダウンロードしたjarファイルを次の２つのフォルダに保存します。

    • jdk/lib
    • tomcat/lib

    　Tomcatが開始されているときはファイル保存後に再起動します。

    開始（サービス登録していないとき）

    　最初に Tomcat を開始します。
    　Tomcat のフォルダにある bin\startup.bat をダブルクリックで Tomcat を開始します。
    　[JAVA_HOME]に関するエラーが表示されたばあいは、環境設定のパスを再確認します。パスをコピペしてみると良いでしょう。

    　次に Apache Http Server を開始します。
    　Apache HTTP Serverのフォルダにある bin\httpd.exe をダブルクリックで Apache Http Server を開始します。

    　最初に開始するときは Windows によって PC が保護されます。

    　これを回避するために bin\httpd.exe ファイルのプロパティを開いて、[全般]タブの下側にある[許可する]にチェックを入れて[適用]します。これで bin\httpd.exe ファイルをダブルクリックで実行できるようになりました。

    　ブラウザーを開いて http://localhost を開きます。Apache Tomcat の画面が表示されれば成功です。

    終了（サービス登録していないとき）

    　開いている httpd.exe の画面の右上にある X をクリックして閉じます。
    　次に Tomcat のフォルダにある bin\shutdown.bat をダブルクリックで Tomcat を終わらせます。

    https

    　これでローカルPCにサーブレットとJSPの実行環境が整いました。
    　本番環境では https が使われますので、http から変更する設定が必要になります。でもドメインが必要になりますので、ローカル環境では難しいとおもいます。別の機会に紹介できればいいなとおもいます。

    アプリを動かす設定

    　Tomcat/webapps のフォルダに アプリ名（コンテキストルート）/WEB-INF のサブフォルダを作ります。例えば tomcat\webapps\hello\WEB-INF という風です。

    サーブレットファイルを配置

    　サンプルのサーブレットファイル（なんとか.class）は WEB-INF フォルダに classes サブフォルダを作って保存します。

    web.xml を配置

    　Tomcat/conf/web.xml を WEB-INF フォルダにコピペして、メモ帳で開きます。次のブロックを探しましょう。

    <servlet>
<servlet-name>default</servlet-name>
<servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
　・・・
<load-on-startup>1</load-on-startup>
</servlet>

    　↑これを、↓このように書き換えて保存します。

    <servlet>
<servlet-name>default</servlet-name>
<servlet-class>アプリ名（コンテキストルート）</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>

    設定反映

    　Tomcatを再起動することで設定が読み込まれます。

    実行

    　ブラウザーを開いてURL「http://localhost/アプリ名（コンテキストルート）」を開きます。
    　無事に開きましたでしょうか？

    稼働確認プログラム

    　稼働確認のためにつくったプログラムはこちらからダウンロードできます
    [Java]Tomcat-MariaDBサンプルプログラム