Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

`String.replaceAll()`: substituição com expressões regulares

Substitui todas as correspondências de uma expressão regular. O exemplo mascara valores num formato específico de argumento de palavra-passe sem alterar os dados de entrada.

Versão: Java SE 21

Sintaxe

Java SE 21
String replaced = text.replaceAll(regex, replacement); // both arguments: String

replaceAll(String, String) devolve o texto após substituir todas as correspondências da expressão regular, não apenas a primeira. A cadeia original não é alterada. Um padrão inválido provoca PatternSyntaxException. No texto de substituição, $1 refere-se ao primeiro grupo de captura e \ é um carácter de escape. Usa Matcher.quoteReplacement para texto de substituição literal e Pattern.quote para texto de padrão literal. Se ambos os argumentos forem literais, usa replace(CharSequence, CharSequence).

No exemplo, \A e \z exigem que todo o argumento corresponda ao padrão, e (?i) faz com que o padrão não distinga maiúsculas de minúsculas nas letras ASCII. Só se mascara --password= seguido de um ou mais caracteres do conjunto de letras ASCII, algarismos ASCII, traços inferiores e hífenes. O par --password value e valores como abc! ficam inalterados. Isto não é um mecanismo geral para ocultar segredos: não passes palavras-passe reais na linha de comandos nem escrevas esta cópia nos registos. Mascarar não apaga o original.

Exemplos

import java.util.Arrays;

public class MaskArgs {
    public static void main(String[] args) {
        String[] original = {"--mode=demo", "--Password=demo_42", "--password=demo-7"};
        String[] copy = new String[original.length];
        String passwordPattern = "(?i)\\A--password=[A-Za-z0-9_-]+\\z";
        boolean originalUnchanged = true;

        for (int i = 0; i < original.length; i++) {
            String before = original[i];
            copy[i] = before.replaceAll(passwordPattern, "--password=***");
            originalUnchanged &= original[i].equals(before);
        }

        System.out.println("COPY: " + Arrays.toString(copy));
        System.out.println("Original unchanged: " + originalUnchanged);
    }
}

Resultado

COPY: [--mode=demo, --password=***, --password=***]
Original unchanged: true

O programa usa os valores fictícios definidos no código-fonte. No resultado esperado, `COPY` contém dois valores mascarados e `Original unchanged: true` indica que os elementos do array original não foram alterados.

Lições relacionadas

  • Java · Lição 55 · Avançado · Versão: 2

Fontes