Java – ファイル名から拡張子を削除する方法

2025-04-15更新日: 2025-04-15

Javaでファイル名から拡張子を削除するには、文字列操作を使用します。

具体的には、StringクラスのlastIndexOfメソッドで最後のドット.の位置を取得し、substringメソッドでその位置までの部分文字列を切り出します。

例えば、ファイル名がexample.txtの場合、最後のドットの位置を特定し、拡張子.txtを除いたexampleを取得します。

ドットが存在しない場合はそのまま返す処理を追加することで、エラーを防ぐことができます。

目次から探す

Javaで拡張子を削除する基本的な方法
Java標準ライブラリを活用した方法
Apache Commons IOを利用した方法
- Apache Commons IOのインストール方法
実装時の注意点
- 具体的な実装例
具体的なユースケース
- 具体的な例
まとめ

Javaで拡張子を削除する基本的な方法

Javaでファイル名から拡張子を削除する基本的な方法は、文字列操作を用いることです。

以下のサンプルコードでは、lastIndexOfメソッドを使用して、拡張子の位置を特定し、substringメソッドでファイル名を切り取ります。

import java.io.File;
public class App {
    public static void main(String[] args) {
        // ファイル名を指定
        String fileName = "example.txt";
        
        // 拡張子を削除
        String fileNameWithoutExtension = removeExtension(fileName);
        
        // 結果を表示
        System.out.println("拡張子を削除したファイル名: " + fileNameWithoutExtension);
    }
    // 拡張子を削除するメソッド
    public static String removeExtension(String fileName) {
        // 最後のドットの位置を取得
        int lastDotIndex = fileName.lastIndexOf(".");
        
        // ドットが見つからない場合はそのまま返す
        if (lastDotIndex == -1) {
            return fileName;
        }
        
        // ドットの前の部分を返す
        return fileName.substring(0, lastDotIndex);
    }
}

拡張子を削除したファイル名: example

このコードでは、removeExtensionメソッドを定義し、ファイル名から拡張子を削除しています。

lastIndexOfメソッドで最後のドットの位置を取得し、その位置を基にsubstringメソッドでファイル名を切り取ります。

ドットが存在しない場合は、元のファイル名をそのまま返します。

Java標準ライブラリを活用した方法

Javaの標準ライブラリには、ファイル操作を簡単に行うためのクラスが用意されています。

特に、java.nio.fileパッケージを使用することで、ファイル名から拡張子を削除する処理をより効率的に行うことができます。

以下のサンプルコードでは、PathクラスとFilesクラスを利用して、ファイル名から拡張子を削除します。

import java.nio.file.Path;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        // ファイル名を指定
        String fileName = "example.txt";
        
        // 拡張子を削除
        String fileNameWithoutExtension = removeExtension(fileName);
        
        // 結果を表示
        System.out.println("拡張子を削除したファイル名: " + fileNameWithoutExtension);
    }
    // 拡張子を削除するメソッド
    public static String removeExtension(String fileName) {
        // Pathオブジェクトを作成
        Path path = Paths.get(fileName);
        
        // 拡張子を削除したファイル名を取得
        String fileNameWithoutExtension = path.getFileName().toString();
        int lastDotIndex = fileNameWithoutExtension.lastIndexOf(".");
        
        // ドットが見つからない場合はそのまま返す
        if (lastDotIndex == -1) {
            return fileNameWithoutExtension;
        }
        
        // ドットの前の部分を返す
        return fileNameWithoutExtension.substring(0, lastDotIndex);
    }
}

拡張子を削除したファイル名: example

このコードでは、Paths.getメソッドを使用してPathオブジェクトを作成し、getFileNameメソッドでファイル名を取得しています。

その後、lastIndexOfメソッドとsubstringメソッドを使って拡張子を削除しています。

この方法は、ファイルパスを扱う際に特に便利です。

Apache Commons IOを利用した方法

Apache Commons IOは、Javaでのファイル操作を簡素化するための便利なライブラリです。

このライブラリを使用すると、ファイル名から拡張子を簡単に削除することができます。

以下の手順でApache Commons IOをプロジェクトに追加し、拡張子を削除する方法を示します。

Apache Commons IOのインストール方法

Mavenを使用する場合:

pom.xmlに以下の依存関係を追加します。

   <dependency>
       <groupId>commons-io</groupId>
       <artifactId>commons-io</artifactId>
       <version>2.11.0</version> <!-- 最新のバージョンを確認してください -->
   </dependency>

Gradleを使用する場合:

build.gradleに以下の依存関係を追加します。

   implementation 'commons-io:commons-io:2.11.0' // 最新のバージョンを確認してください

手動でダウンロードする場合:

Apache Commons IOの公式サイトからJARファイルをダウンロードし、プロジェクトのクラスパスに追加します。

以下のサンプルコードでは、Apache Commons IOのFilenameUtilsクラスを使用して、ファイル名から拡張子を削除します。

import org.apache.commons.io.FilenameUtils;
public class App {
    public static void main(String[] args) {
        // ファイル名を指定
        String fileName = "example.txt";
        
        // 拡張子を削除
        String fileNameWithoutExtension = removeExtension(fileName);
        
        // 結果を表示
        System.out.println("拡張子を削除したファイル名: " + fileNameWithoutExtension);
    }
    // 拡張子を削除するメソッド
    public static String removeExtension(String fileName) {
        // FilenameUtilsを使用して拡張子を削除
        return FilenameUtils.removeExtension(fileName);
    }
}

拡張子を削除したファイル名: example

このコードでは、FilenameUtils.removeExtensionメソッドを使用して、ファイル名から拡張子を簡単に削除しています。

Apache Commons IOを利用することで、コードがシンプルになり、可読性も向上します。

実装時の注意点

ファイル名から拡張子を削除する際には、いくつかの注意点があります。

これらを考慮することで、より堅牢で信頼性の高いコードを実装することができます。

以下に主な注意点を示します。

注意点	説明
ドットの位置に注意	ファイル名に複数のドットが含まれている場合、最後のドットを基準に拡張子を削除する必要があります。
拡張子がない場合の処理	拡張子が存在しないファイル名(例: `example`)に対しても適切に処理を行う必要があります。
空のファイル名の処理	空の文字列が渡された場合、エラーを避けるために適切な処理を行うことが重要です。
特殊文字やパスの扱い	ファイル名に特殊文字やパス区切り文字が含まれる場合、正しく処理できるように注意が必要です。
大文字小文字の扱い	拡張子の大文字小文字を区別するかどうかを明確にし、必要に応じて正規化することが求められます。

具体的な実装例

これらの注意点を考慮した実装例を以下に示します。

public static String removeExtension(String fileName) {
    // 空のファイル名の場合はそのまま返す
    if (fileName == null || fileName.isEmpty()) {
        return fileName;
    }
    
    // 最後のドットの位置を取得
    int lastDotIndex = fileName.lastIndexOf(".");
    
    // ドットが見つからない場合はそのまま返す
    if (lastDotIndex == -1) {
        return fileName;
    }
    
    // ドットの前の部分を返す
    return fileName.substring(0, lastDotIndex);
}

この実装では、空のファイル名や拡張子がない場合の処理を追加しています。

これにより、エラーを防ぎ、より堅牢なコードを実現しています。

ファイル名の取り扱いにおいては、常にこれらの注意点を意識することが重要です。

具体的なユースケース

ファイル名から拡張子を削除する処理は、さまざまなアプリケーションやシステムで利用されます。

以下に、具体的なユースケースをいくつか示します。

ユースケース	説明
ファイル管理システム	ユーザーがアップロードしたファイルの拡張子を表示せず、ファイル名のみを表示することで、インターフェースをシンプルに保つ。
画像処理アプリケーション	画像ファイルの拡張子を削除し、ファイル名を基に画像のメタデータを生成する際に使用。
バッチ処理プログラム	複数のファイルを処理する際に、ファイル名から拡張子を削除して、処理結果をファイル名に基づいて保存する。
ログファイルの管理	ログファイルの名前から拡張子を削除し、日付や時間を基にしたファイル名を生成することで、整理されたログを作成。
データベースへのインポート	ファイル名をデータベースに保存する際、拡張子を削除して、よりクリーンなデータを保持する。