Eclipseで最初のJavaプロジェクトを作る（パッケージ/クラス設計の基本）

初回プロジェクトの作成から、正しいパッケージ設計・クラス分割・動作確認までをステップ形式で解説。記事のとおりに進めれば、Eclipseで「動くJavaアプリ」を作りながら、現場でも通用する設計の土台が身につきます。

本記事のゴールと前提

Eclipseで新規Javaプロジェクトを正しく作れる
適切なパッケージ構成とクラス分割で小さなアプリを組み立てられる
Run As > Java Application で実行して結果を確認できる

JDKやEclipseの導入がまだの方は、先に導入記事（JDK設定まで）をご覧ください。

新規プロジェクト作成（Eclipse）

File > New > Java Project を選択。
Project name：first-java-project（空白や日本語は避ける）
JRE：Use an execution environment JRE: JavaSE-21（またはインストール済みJDK）
Project layout：既定のままでOK（ソースは src）
Module（module-info.java）について：最初は作らないほうが簡単。もし自動作成された場合は一旦削除して構いません。
Finish（初回だけ「Open Associated Perspective?」は Yes でOK）。

続けて、src を右クリック → New > Package でパッケージを作ります（次章）。

パッケージ設計の基礎（命名規則と層）

パッケージは全部小文字で、逆ドメイン形式が一般的です。個人開発や学習では com.example から始めると無難。

com.example.todo
├─ domain      （アプリの中心的なデータ構造：Taskなど）
├─ repository  （データの保存・取得：DBやメモリ）
├─ service     （業務ロジック：検証・集約・操作）
└─ app         （UI層／エントリポイント：mainメソッド）

domain：ビジネスで扱う名詞（Task, User, Order など）
repository：データのCRUDを隠蔽。後でDBに差し替えても他層に影響が少ない
service：ユースケース（「タスク追加」「完了にする」等）の手順を1か所に集約
app：入出力部分。今回はコンソール。将来Web/UIに変わっても他層は再利用できる

この4層に分けるだけで、コードの見通しと拡張性が大幅に上がります。

サンプルで学ぶ：コンソールToDoアプリ

最小限のToDo管理を作ります。タスクの追加/一覧/完了を、レイヤごとに役割分担して実装します。

1) domain：エンティティ（Task）

package com.example.todo.domain;

import java.time.LocalDateTime;
import java.util.Objects;

public class Task {
  private final long id;
  private String title;
  private boolean done;
  private final LocalDateTime createdAt;

  public Task(long id, String title) {
    this.id = id;
    this.title = title;
    this.done = false;
    this.createdAt = LocalDateTime.now();
  }

  public long getId() { return id; }
  public String getTitle() { return title; }
  public boolean isDone() { return done; }
  public LocalDateTime getCreatedAt() { return createdAt; }

  public void rename(String newTitle) {
    if (newTitle == null || newTitle.isBlank()) {
      throw new IllegalArgumentException("タイトルは1文字以上で入力してください。");
    }
    this.title = newTitle;
  }

  public void markDone() { this.done = true; }

  @Override
  public String toString() {
    return (done ? "[x] " : "[ ] ") + id + ": " + title + " (" + createdAt + ")";
  }

  @Override
  public boolean equals(Object o) {
    if (this == o) return true;
    if (!(o instanceof Task)) return false;
    Task task = (Task) o;
    return id == task.id;
  }

  @Override
  public int hashCode() {
    return Objects.hash(id);
  }
}

2) repository：データ取得

package com.example.todo.repository;

import com.example.todo.domain.Task;
import java.util.List;
import java.util.Optional;

public interface TaskRepository {
  Task save(Task task);
  Optional<Task> findById(long id);
  List<Task> findAll();
}

package com.example.todo.repository;

import com.example.todo.domain.Task;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;

public class InMemoryTaskRepository implements TaskRepository {
  private final Map<Long, Task> store = new ConcurrentHashMap<>();

  @Override
  public Task save(Task task) {
    store.put(task.getId(), task);
    return task;
  }

  @Override
  public Optional<Task> findById(long id) {
    return Optional.ofNullable(store.get(id));
  }

  @Override
  public List<Task> findAll() {
    List<Task> list = new ArrayList<>(store.values());
    list.sort(Comparator.comparing(Task::getCreatedAt));
    return list;
  }
}

3) service：業務ロジック

package com.example.todo.service;

import com.example.todo.domain.Task;
import com.example.todo.repository.TaskRepository;

import java.util.List;
import java.util.concurrent.atomic.AtomicLong;

public class TaskService {
  private final TaskRepository repository;
  private final AtomicLong sequence = new AtomicLong(1L);

  public TaskService(TaskRepository repository) {
    this.repository = repository;
  }

  public Task add(String title) {
    if (title == null || title.isBlank()) {
      throw new IllegalArgumentException("タイトルを入力してください。");
    }
    long id = sequence.getAndIncrement();
    Task task = new Task(id, title.trim());
    return repository.save(task);
  }

  public List<Task> list() {
    return repository.findAll();
  }

  public Task complete(long id) {
    Task task = repository.findById(id)
        .orElseThrow(() -> new IllegalArgumentException("指定IDのタスクが見つかりません: " + id));
    task.markDone();
    repository.save(task);
    return task;
  }

  public Task rename(long id, String newTitle) {
    Task task = repository.findById(id)
        .orElseThrow(() -> new IllegalArgumentException("指定IDのタスクが見つかりません: " + id));
    task.rename(newTitle);
    repository.save(task);
    return task;
  }
}

4) app：エントリポイント（Main）

package com.example.todo.app;

import com.example.todo.repository.InMemoryTaskRepository;
import com.example.todo.repository.TaskRepository;
import com.example.todo.service.TaskService;

import java.util.Scanner;

public class Main {
  private static void printHelp() {
    System.out.println("=== ToDo Commands ===");
    System.out.println(" add <title>     : タスク追加");
    System.out.println(" list             : 一覧表示");
    System.out.println(" done <id>        : 完了にする");
    System.out.println(" rename <id> <t>  : タイトル変更");
    System.out.println(" help             : コマンド一覧");
    System.out.println(" exit             : 終了");
    System.out.println("=====================");
  }

  public static void main(String[] args) {
    TaskRepository repo = new InMemoryTaskRepository();
    TaskService service = new TaskService(repo);

    try (Scanner sc = new Scanner(System.in)) {
      printHelp();
      while (true) {
        System.out.print("> ");
        String cmd = sc.next();
        switch (cmd) {
          case "add":
            String title = sc.nextLine().trim();
            System.out.println("追加: " + service.add(title));
            break;
          case "list":
            service.list().forEach(System.out::println);
            break;
          case "done":
            long id = sc.nextLong();
            System.out.println("完了: " + service.complete(id));
            break;
          case "rename":
            long rid = sc.nextLong();
            String nt = sc.nextLine().trim();
            System.out.println("変更: " + service.rename(rid, nt));
            break;
          case "help":
            printHelp();
            break;
          case "exit":
            System.out.println("Bye.");
            return;
          default:
            System.out.println("不明なコマンド。help を参照してください。");
        }
      }
    }
  }
}

5) 実行と確認

Package Explorerで Main を右クリック → Run As > Java Application
コンソールに > が出たら成功。以下の例を試す：

add 牛乳を買う
add 本を10ページ読む
list
done 1
rename 2 本を15ページ読む
list
exit

メモリ内リポジトリなので、Eclipseを終了するとデータは消えます。後日、ファイル保存やDBに差し替えてみましょう（repository層だけ差し替えればOK）。

設計の基本原則（最初に押さえる3点）

関心の分離（SoC）：入出力（app）と業務ロジック（service）とデータアクセス（repository）を分ける。
不変条件の保持：domainのコンストラクタ/メソッドで不正な状態を拒否（例：タイトルの空文字禁止）。
依存方向は内側へ：app → service → repository → domain の一方向。下位層は上位層を参照しない。

この3つを守るだけで、クラスが巨大化しにくく、機能追加や差し替えが楽になります。

よくあるエラーと対処

Could not find or load main class：Main のパッケージ宣言（package com.example.todo.app;）とフォルダ構成が一致しているか確認。
違うJREで実行される：Project > Properties > Java Build Path → JRE System Library をJDK21に。Project Facetsや Compiler のバージョンも見直し。
module-info.javaが邪魔：最初は削除してOK。モジュールは慣れてから。
文字化け：Preferences > General > Workspace > Text file encoding を UTF-8 に。コンソールも UTF-8 （必要なら VM引数に -Dfile.encoding=UTF-8）。
ビルドされない：Project > Build Automatically を有効化。ダメなら Project > Clean…。

Eclipse便利設定（最初に済ませると幸せ）

Save Actions：保存時に自動整形・不要import削除（Preferences > Java > Editor > Save Actions）。
Formatter：Preferences > Java > Code Style > Formatter でプロファイル作成（チーム運用の第一歩）。
Organize Imports：ショートカット割当（例：Windows: Ctrl+Shift+O, Mac: ⌘⇧O）。
Quick Fix：Ctrl+1 / ⌘1 で警告から即修正。

この次に知りたい情報

Eclipse × Git（EGit）入門：初回コミットとリモート連携 — 変更履歴の管理とチーム開発の基礎。
Maven/Gradle超入門：依存管理とビルドの基礎 — ライブラリ導入とビルドの標準化。

導入〜完成チェックリスト

Java Project を first-java-project で作成した
com.example.todo 配下に domain/repository/service/app を作成した
各クラスを入力し、エラーがない（電球マークはQuick Fixで解消）
Main を Run As で実行してコマンドが動作した
Save Actions / Formatter を設定してコードが自動整形される

FAQ

パッケージ名は日本語でもいい？

推奨しません。英小文字＋ドット区切り（例：com.example.todo）に統一しましょう。

クラスは1ファイル1クラス？

基本は1ファイル1公開クラス（public）です。小規模の補助クラスはパッケージプライベートで同パッケージに置いてOK。

テストはどう書く？

次段のMaven/Gradle導入後に JUnit を使うのが定番です。まずは service のメソッド単位から始めましょう。

Eclipseで最初のJavaプロジェクトを作る（パッケージ/クラス設計の基本）

本記事のゴールと前提

新規プロジェクト作成（Eclipse）

パッケージ設計の基礎（命名規則と層）

サンプルで学ぶ：コンソールToDoアプリ

1) domain：エンティティ（Task）

2) repository：データ取得

3) service：業務ロジック

4) app：エントリポイント（Main）

5) 実行と確認

設計の基本原則（最初に押さえる3点）

よくあるエラーと対処

Eclipse便利設定（最初に済ませると幸せ）

この次に知りたい情報

導入〜完成チェックリスト

FAQ

コメントを残すコメントをキャンセル

最近の投稿

最近のコメント

アーカイブ

カテゴリー

本記事のゴールと前提

新規プロジェクト作成（Eclipse）

パッケージ設計の基礎（命名規則と層）

サンプルで学ぶ：コンソールToDoアプリ

1) domain：エンティティ（Task）

2) repository：データ取得

3) service：業務ロジック

4) app：エントリポイント（Main）

5) 実行と確認

設計の基本原則（最初に押さえる3点）

よくあるエラーと対処

Eclipse便利設定（最初に済ませると幸せ）

この次に知りたい情報

導入〜完成チェックリスト

FAQ

コメントを残す コメントをキャンセル

最近の投稿

最近のコメント

アーカイブ

カテゴリー

コメントを残すコメントをキャンセル