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: StringreplaceAll(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