Palavras-chave Java Matrizes Java Programação orientada a objetos em Java Manuseio de arquivos Java Introdução ao Java Noções básicas da linguagem Java

palavra-chave throws em Java

A palavra-chave throws em Java é usada em declarações de métodos para especificar que o método pode lançar uma ou mais exceções. Ele fornece uma maneira de os métodos sinalizarem que podem encontrar condições excepcionais com as quais não estão equipados para lidar.

Uso

A palavra-chave throws é colocada na assinatura do método após a lista de parâmetros e antes do corpo do método. Ele é seguido por uma lista separada por vírgulas de classes de exceção que o método pode lançar.

Sintaxe

returnType methodName(parameters) throws ExceptionType1, ExceptionType2 {
    // method body
}Tecnologia

returnType: O tipo de retorno do método.
methodName: O nome do método.
parameters: Os parâmetros do método.
ExceptionType1, ExceptionType2: As exceções que o método pode lançar.

Exemplos

Exemplo 1: Exceção única

public void readFile(String fileName) throws IOException {
    FileReader file = new FileReader(fileName);
    BufferedReader fileInput = new BufferedReader(file);

    // Read file content
    for (int counter = 0; counter < 3; counter++)&nbsp;
        System.out.println(fileInput.readLine());

    fileInput.close();
}Tecnologia

Neste exemplo, o método readFile declara que você pode lançar um IOException. Isso indica que o método pode encontrar um erro de entrada/saída que não pode ser tratado internamente.

Exemplo 2: Múltiplas exceções

public void processFile(String fileName) throws IOException {
    FileReader file = new FileReader(fileName);
    BufferedReader fileInput = new BufferedReader(file);

    // Read file content
    for (int counter = 0; counter < 3; counter++)
        System.out.println(fileInput.readLine());

    fileInput.close();
}Tecnologia

Aqui, o método processFile declara que pode lançar tanto IOException quanto FileNotFoundException. Isso informa ao chamador que o método pode encontrar uma dessas exceções.

Exemplo 3: Exceção personalizada

public class CustomException extends Exception {
    public CustomException(String message) {
        super(message);
    }
}

public void validateAge(int age) throws CustomException {
    if (age < 18) {
        throw new CustomException("Age must be 18 or older.");
    }
    System.out.println("Age is valid.");
}Tecnologia

Neste exemplo, é criada uma exceção personalizada CustomException. O método validateAge declara que pode lançar essa exceção personalizada se a idade for inferior a 18 anos.

Dicas e práticas recomendadas

Declarar exceções específicas: Declare as exceções mais específicas possíveis em vez de usar uma classe Exception genérica. Isso torna o código mais legível e de fácil manutenção.
```
public void method() throws IOException, SQLException {
    // method body
}Tecnologia
```

Exceções de documentos: Sempre documente as exceções que um método pode lançar usando os comentários do Javadoc. Isso ajuda outros desenvolvedores a entender os possíveis riscos e a lidar com eles adequadamente.

/**
 * Reads a file and prints its content.
 * 
 * @param fileName the name of the file to read
 * @throws IOException if an I/O error occurs
 */
public void readFile(String fileName) throws IOException {
    // method body
}Tecnologia

Use o site throws criteriosamente: Use a palavra-chave throws somente quando o método não puder tratar a exceção internamente. Se possível, trate as exceções dentro do método para oferecer um aplicativo mais robusto e fácil de usar.

public void readFile(String fileName) {
    try {
        FileReader file = new FileReader(fileName);
        BufferedReader fileInput = new BufferedReader(file);
        // Read file content
        for (int counter = 0; counter < 3; counter++) 
            System.out.println(fileInput.readLine());
        fileInput.close();
    } catch (IOException e) {
        System.err.println("An error occurred: " + e.getMessage());
    }
}Tecnologia

Propagar exceções: Ao propagar exceções, certifique-se de que o método de chamada seja capaz de tratá-las ou de propagá-las na pilha de chamadas.

Java Documentation