3.

Eclipse でプロジェクトを作成する手順|動的 Web プロジェクト / Maven / Spring Boot

編集
この記事の要点
  • Eclipse でプロジェクトを新規作成する手順
  • 一般 Java: ファイル → 新規 → Java プロジェクト
  • 動的 Web: ファイル → 新規 → 動的 Web プロジェクト
  • Maven: ファイル → 新規 → Maven プロジェクト
  • Spring Boot: ファイル → 新規 → Spring Starter プロジェクト(STS プラグイン)

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

用途選ぶプロジェクトタイプ
純粋な Java(CUI ツール、ライブラリ)Java プロジェクト
Servlet / JSP の Web アプリ動的 Web プロジェクト
Maven 管理のプロジェクト全般Maven プロジェクト
Gradle 管理Gradle プロジェクト
Spring BootSpring Starter プロジェクト(STS)
既存プロジェクトを取り込むファイル → インポート

動的 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 メソッド付きクラスを作成

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

方式用途
一般 → 既存プロジェクトをワークスペースへ別 Eclipse で作ったものを取り込む(.project あり)
Maven → 既存 Maven プロジェクトpom.xml がある Maven プロジェクト
Git → Git からプロジェクトGitHub からクローンしてインポート
一般 → アーカイブからプロジェクトzip ファイルから直接

プロジェクトの命名規約

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

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

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

項目内容
Java Build Pathクラスパス(ライブラリ / 依存)
Java Compilerコンパイラのバージョン
Project FacetsJava / Dynamic Web Module / JPA 等
Targeted RuntimesTomcat / WildFly などのランタイム
MavenMaven 関連設定
Resource文字コード(UTF-8 推奨)

作成後の動作確認

// 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 のバージョンを上げる
  • ワークスペースに既存プロジェクトと同名がある: 別ワークスペースを使う
編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. インストール(eclipseプラグイン)
  2. クイックスタート
  3. プロジェクトの作成
  4. Spring Bootプロジェクトの作成
  5. Spring Bootプロジェクトの実行
  6. Spring BootでHello World!
  7. アノテーション一覧
  8. DB接続設定からエンティティおよびリポジトリの作成、値の取得まで(JPA編)
  9. DB接続設定や値の取得(JdbcTemplate編)
  10. ビューから値をモデルに格納しコントローラーで受け取る方法
  11. コントローラーにてモデルに値を格納してビューに渡す方法
  12. テンプレートエンジン
  13. ModelとModelAndViewの違い
  14. AOPの使用方法
  15. classpath: 内部ファイルの読み込み
  16. file: 外部ファイルの読み込み
  17. CSVファイルアップロード方法(Ajax)
  18. CSVファイルダウンロード方法(Ajax)
  19. Spring Bootプロジェクトのビルドと本番環境へのデプロイ方法(内部tomcat使用)
  20. Application.propertiesの環境依存設定の分割方法
  21. JPAにおけるEntityManagerの取得方法
  22. JPAにおけるjava.sql.Connectionの取得方法
  23. エラー一覧
  24. jarの引数を受け取る方法
  25. Spring BootでGmailからメール送信
  26. 複数のDBに接続する設定(Spring Boot & JPA編)
  27. ポート番号の変更
  28. Basic認証の実装と特定のURLに限定する方法
  29. Spring SecurityのBasic認証の無効化
  30. 独自のエラーページを定義する方法
  31. プロパティファイルの値やjar実行時の引数を取得する方法