Matcher.replaceAll() / replaceFirst()

// すべての一致箇所を指定した文字列で置換します。
String result = matcher.replaceAll(String replacement);

// 最初の一致箇所だけを置換します。
String result = matcher.replaceFirst(String replacement);

// 一致箇所を個別に処理しながら置換を構築します。
matcher.appendReplacement(StringBuffer sb, String replacement);

// 残りの文字列をStringBufferに追記します。
matcher.appendTail(StringBuffer sb);

sample_MatcherReplaceall.java

import java.util.regex.*;

class MatcherReplaceall {
    public static void main(String[] args) {
        // replaceAll() ですべての数字を「*」に置換します。
        Pattern p = Pattern.compile("\\d+");
        Matcher m = p.matcher("電話番号: 090-1234-5678");
        System.out.println(m.replaceAll("*")); // 『電話番号: *-*-*』と出力されます。

        // replaceFirst() で最初の一致箇所のみ置換します。
        Matcher m2 = p.matcher("値は3で、個数は5です。");
        System.out.println(m2.replaceFirst("N")); // 『値はNで、個数は5です。』と出力されます。

        // appendReplacement() と appendTail() で動的な置換を行います。
        Pattern wordPattern = Pattern.compile("\\b(Java|Python)\\b");
        Matcher wordMatcher = wordPattern.matcher("JavaとPythonは人気の言語です。");
        StringBuffer sb = new StringBuffer();
        while (wordMatcher.find()) {
            wordMatcher.appendReplacement(sb, "[" + wordMatcher.group() + "]");
        }
        wordMatcher.appendTail(sb);
        System.out.println(sb.toString()); // 『[Java]と[Python]は人気の言語です。』と出力されます。

        // Java 9以降: replaceAll() にラムダ式で動的置換を行います。
        Matcher m3 = Pattern.compile("\\d+").matcher("値は3で、個数は12です。");
        String result = m3.replaceAll(mr -> String.valueOf(Integer.parseInt(mr.group()) * 2));
        System.out.println(result); // 『値は6で、個数は24です。』と出力されます。
    }
}

javac MatcherReplaceall.java
java MatcherReplaceall
電話番号: *-*-*
値はNで、個数は5です。
[Java]と[Python]は人気の言語です。
値は6で、個数は24です。

『replaceAll()』と『replaceFirst()』は Matcher オブジェクトのメソッドで、正規表現に一致した箇所を指定した文字列で置換します。置換文字列には $1、$2 のようにキャプチャグループを参照することもできます。

『appendReplacement()』と『appendTail()』を組み合わせると、マッチごとに異なるロジックで置換内容を生成できます。置換文字列に $ や \ を含む場合は Matcher.quoteReplacement() でエスケープする必要があります。

パターンのコンパイルと基本的なマッチングには『Pattern.compile() / Matcher.matches() / find()』を参照してください。