タグ: 環境変数

  • [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ファイルを次の2つのフォルダに保存します。

    • 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サンプルプログラム

  • [Java]Apache Mavenインストールからプロジェクト作成まで

     片仮名で「メーベン」とするのが日本語っぽいでしょうか。色々なライブラリを使ったJavaのプログラムをビルドするためにあるそうです

    ダウンロード

     こちら(Apache Maven のダウンロード – Apache Maven Project)から圧縮ファイルをダウンロードできます。

    インストール

     解凍したら任意のフォルダに保存します

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

    Windows環境変数

     [Path]にMavenのフォルダの中の[bin]を追加します。例えば D:\webservice\maven\bin になります。

    確認

     確認のために、次のようにMavenのバージョンを表示してみましょう

    mvn -v

    settings.xml設定

     Mavenによって自動ダウンロードされるファイルが保存されるフォルダを作成します。次にsettings.xmlを更新します

    1. お好きな場所にフォルダを作成します
    2. Maven\conf\settings.xmlをメモ帳で開きます
    3. キーボード Ctrl + F キーで『<localRepository>』を探します
    4. 『<!–』から『–>』まではコメントなので、それよりも外にフォルダを指定します。次のような行を追加します↓
    <localRepository>D:\webservice\maven\repository</localRepository>

     これで設定は終わりです

    プロジェクト作成

    Spring Initializrでひな形をつくる

     Mavenには次のようなSpring Bootのアーキタイプがありますが、10年も更新されず放置されているようです

    3213: remote -> org.springframework.boot:spring-boot-sample-tomcat-archetype (Spring Boot Tomcat Sample)


     Spring Initializrで『Project』を『Maven』にして、ひな形をつくると良いでしょう

    Mavenでひな形をつくる

     流れは次のようになります

    1. Windowsコマンドプロンプトを開きます
    2. プロジェクトをつくるフォルダへ移動します
    3. mvnコマンドを実行します

    コマンドは次のようなものです↓

    cd /d "プロジェクトをつくるフォルダ"
    mvn -B archetype:generate "-DgroupId=グループ名" "-DartifactId=プロジェクト名"

    注意事項

    • グループ名に「-(ハイフン、マイナス記号)」を含めるとビルド時にエラーになります。1行目のハイフンのところで「;(セミコロン)」がないと言われます

    実行結果

    次のようにフォルダとファイルがつくられます↓

    プロジェクトをつくるフォルダ
      プロジェクト名フォルダ
        srcフォルダ
          mainフォルダ
            javaフォルダ
              グループ名フォルダ
                App.javaファイル
          testフォルダ
            javaフォルダ
              グループ名フォルダ
                AppTest.javaファイル
        pom.xmlファイル

    App.javaはこんな感じです↓ コメントを取り除いています

    package グループ名;
    
    public class App 
    {
        public static void main( String[] args )
        {
            System.out.println( "Hello World!" );
        }
    }

    AppTest.javaはこんな感じです↓ コメントを取り除いています

    package グループ名;
    
    import junit.framework.Test;
    import junit.framework.TestCase;
    import junit.framework.TestSuite;
    
    public class AppTest 
        extends TestCase
    {
        public AppTest( String testName )
        {
            super( testName );
        }
    
        public static Test suite()
        {
            return new TestSuite( AppTest.class );
        }
    
        public void testApp()
        {
            assertTrue( true );
        }
    }

    pom.xmlはこんな感じです↓

    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>グループ名</groupId>
      <artifactId>プロジェクト名</artifactId>
      <packaging>jar</packaging>
      <version>1.0-SNAPSHOT</version>
      <name>プロジェクト名</name>
      <url>http://maven.apache.org</url>
      <dependencies>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
      </dependencies>
    </project>

    ビルド

     できたサンプルをビルドするには、プロジェクト作成時につくられたpom.xmlファイルがあるフォルダへ移動してから次のようにコマンドを入力します

    cd /d "プロジェクトをつくるフォルダ\プロジェクト名"
    mvn compile

    削除

     プロジェクトを削除するには、プロジェクト作成時につくられたpom.xmlファイルがあるフォルダへ移動してから次のようにコマンドを入力します

    cd /d "プロジェクトをつくるフォルダ\プロジェクト名"
    mvn clear
  • [Java]SPRING BOOT CLIインストール

     EclipseやVisual Studio Codeを使うばあいは不要です
     Spring Initializrを使っても良いかもしれません

     次のページの『手動インストール』部分にある圧縮ファイル(例えば spring-boot-cli-3.3.5-bin.zip)をダウンロードします
    Spring Boot のインストール - Spring

     任意のフォルダに保存します。

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

    Windows環境変数

     [Path]にSpring Boot CLIフォルダの中の[bin]を追加します。例えば D:\webservice\spring_CLI\bin になります

  • [Python]name ‘pip’ is not defined

     Python(パイソン)でpip install ○○』と入力したとき、pipって何?というエラーがでました。
    なぜでしょうか?

    name 'pip' is not defined

     昔インストールした古いパスが残っていることがあります。
    Windowsのスタート画面で『環境変数を編集』と検索し、検索結果を開きます。
    画面上部にユーザー環境変数が、画面下部にシステム環境変数が表示されます。どちらにも『Path』があります。
     Pathに設定された値を確認します。『Python』を含むものを見つけましょう。そのパスが示すフォルダはあるでしょうか?なければ削除しましょう。これで治ったのではないかとおもいます。