プロジェクトタイプの選び方

動的 Web プロジェクトの作成手順

1. ファイル → 新規 → 動的 Web プロジェクト (Dynamic Web Project)
2. Project name: プロジェクト名（英数記号、スペース不可）
3. Project location: 保存場所（デフォルトでも OK）
4. Target runtime: 既存の Tomcat を選択 or 「New Runtime」で追加
   • 未登録なら → Apache → Apache Tomcat v9.0 / 10.1 / 11.0
   • Tomcat installation directory を指定
5. Dynamic web module version: Tomcat バージョンと整合
   • Tomcat 9 → 4.0
   • Tomcat 10 → 5.0 / 6.0
   • Tomcat 11 → 6.1
6. Configuration: 通常はデフォルト
7. 「Next」→ Java settings: Source folder / Default output folder
8. 「Next」→ Web Module:
   • Context root: URL のサブパス（例 myapp → http://localhost:8080/myapp/）
   • Content directory: WebContent または src/main/webapp
   • 「Generate web.xml deployment descriptor」にチェック（推奨）
9. 完了 (Finish)

Maven プロジェクトの作成手順

1. ファイル → 新規 → Maven プロジェクト
2. 「Create a simple project」のチェック有無を選択
   • チェックあり: アーキタイプを使わずに最小構成
   • チェックなし: maven-archetype-webapp 等のテンプレートから生成（推奨）
3. 「Next」→ アーキタイプ選択
   • maven-archetype-quickstart: シンプルな Java アプリ
   • maven-archetype-webapp: Web アプリ
   • spring-boot-archetype: Spring Boot
4. 「Next」→ Group Id / Artifact Id / Version / Package を入力
   • Group Id: 組織名（逆ドメイン形式）com.example
   • Artifact Id: プロジェクト名 myapp
   • Version: 通常は 1.0-SNAPSHOT
   • Package: Java パッケージ名 com.example.myapp
5. 「完了」→ pom.xml と src 構造が自動生成

生成される構造

myapp/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/myapp/
│   │   │       └── App.java
│   │   ├── resources/
│   │   └── webapp/             ← Web アーキタイプの場合
│   │       └── WEB-INF/
│   │           └── web.xml
│   └── test/
│       ├── java/
│       │   └── com/example/myapp/
│       │       └── AppTest.java
│       └── resources/
└── target/                     ← ビルド成果物

Spring Starter (Spring Boot)

Spring Tool Suite (STS) プラグイン経由が簡単:

1. ヘルプ → Eclipse マーケットプレイス で「Spring Tools 4」をインストール
2. ファイル → 新規 → Spring Starter プロジェクト
3. Service URL: https://start.spring.io（デフォルト）
4. Project type: Maven or Gradle
5. Language: Java / Kotlin / Groovy
6. Spring Boot Version: LTS バージョンを推奨
7. Group / Artifact / Description / Package
8. 「Next」→ Dependencies: 使いたい機能を選択
   • Spring Web: Web アプリ
   • Spring Data JPA: DB アクセス
   • Thymeleaf: テンプレート
   • Spring Security: 認証
   • Lombok: ボイラープレート削減
9. 「完了」→ 雛形生成 + 依存ダウンロード

Java プロジェクトの基本作成

1. ファイル → 新規 → Java プロジェクト
2. Project name: 任意
3. JRE: 使用する JDK バージョン
4. Project layout: 「Create separate folders for sources and class files」推奨
5. 「完了」
6. 右クリック → 新規 → クラスで main メソッド付きクラスを作成

既存プロジェクトのインポート

プロジェクトの命名規約

• 英数小文字 + ハイフン: my-awesome-app
• スペース・日本語は避ける: ビルドツール / git で問題
• パッケージ名は逆ドメイン: com.example.myapp
• プロジェクト名 = アーティファクト名に揃えると CI/CD が楽

プロジェクト設定の主要箇所

プロジェクト右クリック → プロパティで以下を確認:

作成後の動作確認

// Java プロジェクトの場合
public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello, Eclipse!");
    }
}
// → 右クリック → 実行 → Java アプリケーション

// Web プロジェクトの場合
@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.setContentType("text/html;charset=UTF-8");
        resp.getWriter().println("
Hello from Tomcat!
");
    }
}
// → サーバビュー → サーバ起動 → http://localhost:8080/myapp/hello

よくあるトラブル

• Target runtime に Tomcat が出ない: ウィンドウ → 設定 → サーバー → ランタイム環境で先に登録
• 作成後にコンパイルエラー: JDK バージョン不整合 / Java Build Path 確認
• Maven 依存が解決されない: プロジェクト右クリック → Maven → プロジェクトの更新
• "Dynamic Web Module 5.0 requires Java 8 or newer": Java Facets のバージョンを上げる
• ワークスペースに既存プロジェクトと同名がある: 別ワークスペースを使う