CKTIS / Java
MalformedURLException — falha ao criar um URL
MalformedURLException é uma exceção verificada de java.net que herda de IOException. Indica um problema ao criar um URL, como um protocolo não reconhecido ou uma entrada rejeitada pelo respetivo processador; não significa que uma ligação tenha falhado.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public class MalformedURLException extends IOException
public MalformedURLException()
public MalformedURLException(String msg)MalformedURLException, do pacote java.net, indica uma especificação de URL inválida: não foi encontrado um protocolo válido ou não foi possível analisar a especificação. Herda de IOException e é verificada: o código que chama um método que a declara tem de a capturar ou declará-la com throws.
A classe disponibiliza MalformedURLException() sem mensagem detalhada e MalformedURLException(String msg) com a mensagem indicada. Não confunda esta exceção com uma falha de DNS, uma ligação recusada ou uma resposta HTTP de erro. A criação de um objeto URL, por si só, não confirma a disponibilidade do recurso nem a validade completa do endereço; parte da validação depende do processador do protocolo.
No Java SE 21, os construtores URL estão obsoletos. A abordagem recomendada é criar um URI e, em seguida, chamar URI.toURL(). Este método pode lançar MalformedURLException se o protocolo for desconhecido ou se a conversão falhar. Um URI relativo, porém, causa IllegalArgumentException. Uma sintaxe inválida passada a URI.create(...) também causa IllegalArgumentException, enquanto o construtor new URI(...) lança URISyntaxException.
O exemplo converte para URL um URI constante e absoluto que utiliza o protocolo https, captura MalformedURLException e imprime o protocolo. Não abre qualquer ligação de rede. Para esta entrada, o resultado esperado é https; o ramo catch não é executado.
Exemplos
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;
public class Main {
public static void main(String[] args) {
URI uri = URI.create("https://example.com/docs");
try {
URL url = uri.toURL();
System.out.println(url.getProtocol());
} catch (MalformedURLException e) {
System.out.println("Cannot construct URL");
}
}
}Resultado
https
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.