過去バージョン

classpath: とは

classpath: は Spring Framework が提供するリソース指定の識別子です。プロジェクトの src/main/resources/ 以下にあるファイルを示します。ビルド後は jar / war 内部に含まれるため、配布した後でもアプリ内から読み込めます。

プロジェクト構造

your-project/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/App.java
│   │   └── resources/      ← ★ classpath: が指す場所
│   │       ├── application.properties
│   │       ├── jdbc.properties
│   │       ├── mybatis-config.xml
│   │       └── data/
│   │           └── master.csv
│   └── test/
│       └── resources/      ← テスト時の classpath: もここを含む
├── pom.xml
└── target/
    └── classes/            ← ビルド後はここに resources がコピーされる

file: との違い

使用例 1: プロパティファイル読み込み

@Configuration
@PropertySource("classpath:/jdbc.properties")
public class DbConfig {
    @Value("${db.url}")
    private String dbUrl;

    @Value("${db.user}")
    private String dbUser;
}

Spring Boot の application.properties は明示的に classpath: を書かなくても自動で読み込まれます。追加のプロパティを読みたいときに使います。

使用例 2: ResourceLoader で読み込み

@Service
public class MasterDataService {

    @Autowired
    private ResourceLoader resourceLoader;

    public List<String> readMasterCsv() throws IOException {
        Resource resource = resourceLoader.getResource("classpath:data/master.csv");
        try (BufferedReader br = new BufferedReader(
                new InputStreamReader(resource.getInputStream(), StandardCharsets.UTF_8))) {
            return br.lines().collect(Collectors.toList());
        }
    }
}

使用例 3: テンプレート/XML 読み込み

<!-- mybatis-spring 設定 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="configLocation" value="classpath:mybatis-config.xml"/>
    <property name="mapperLocations" value="classpath:mappers/*.xml"/>
</bean>

<!-- Velocity / Thymeleaf テンプレートの場所 -->
<property name="templateLoaderPath" value="classpath:/templates/"/>

classpath* の使い方（複数 jar 横断）

プラグイン的に複数 jar から同名のリソースを集めたい場合に classpath*: を使います:

// 全 jar の META-INF/spring.factories を集める例
Resource[] resources = applicationContext.getResources("classpath*:META-INF/spring.factories");

// XML 設定を複数モジュールから集める
@ImportResource("classpath*:META-INF/spring/*-context.xml")

jar 化後の注意点

classpath: リソースは jar 内部にあるため、通常の File オブジェクトとして開けません:

// ❌ NG: jar 内部のリソースは File として扱えない
Resource resource = resourceLoader.getResource("classpath:data/master.csv");
File file = resource.getFile();  // FileNotFoundException

// ✅ OK: InputStream で読む
InputStream is = resource.getInputStream();

// ✅ OK: 一時ファイルにコピーする
File tmp = Files.createTempFile("master", ".csv").toFile();
Files.copy(is, tmp.toPath(), StandardCopyOption.REPLACE_EXISTING);

環境別の設定切り替え

本番では file: で外部設定を読みたいケース。両方をフォールバック構成にできます:

@PropertySource(value = "classpath:application-default.properties")
@PropertySource(value = "file:${CONFIG_DIR}/application.properties", ignoreResourceNotFound = true)
public class AppConfig {}

環境変数 CONFIG_DIR に本番設定ディレクトリを指定。ファイルが無ければ classpath 内部設定だけが使われる、というフォールバック。

よくあるハマりどころ

• "classpath:foo.txt" vs "classpath:/foo.txt": 先頭の / は推奨だが省略可能。意味は同じ
• jar 内部で File として開こうとして失敗: 必ず InputStream で読む
• テスト時のリソースが本番に混入: src/test/resources のファイルは jar に含まれない（テスト時のみ classpath）
• パッケージング後にリソースが見つからない: pom.xml の <resources> 設定を確認 / Maven 標準なら設定不要
• Windows でパス区切り: classpath では / 統一（\ は使わない）