Pourquoi ByteArrayOutputStream.close() throws IOException?

Question

Pourquoi ByteArrayOutputStream. close est déclaré avec throws IOException? D'abord, de facto, il ne peut rien lancer, car son corps est vide. Deuxièmement, de jure, il ne peut rien lancer, car sa documentation dit "fermer un ByteArrayOutputStream n'a aucun effet".

N'est-ce pas une erreur (non importante, mais quand même)?

Oui, je comprends que sa superclasse implémente OutputStreamClosable, la méthode close qui est autorisé à jeter IOException. Mais personne n'interdit de l'ignorer (dans ByteArrayOutputStream) avec la méthode close sans spécification de projection. (Même si la suppression d'un méthode plus-lancer avec une méthode moins jeter était interdit dans certaines versions anciennes de Java, en changeant ByteArrayOutputStream. close définition maintenant ne sera pas le changement incompatible.)

Answer 1

L'explication la plus plausible (en plus surveillance) est la compatibilité. Retour en Java 1.1, ByteArrayOutputStreamdid not override close(), donc il a hérité de la méthode de OutputStream qui déclare IOException. À l'époque, cela aurait pu être un oubli. Peut-être, les développeurs ont pensé que c'est inutile, car personne ne va appeler close() sur un ByteArrayOutputStream de toute façon. Mais la documentation manque d'une déclaration explicite sur l'appel close() étant inutile. Depuis Java 1.2 aka Java 2, ByteArrayOutputStreamdoes override close(). Cependant, si vous supprimez la clause throws, le code appelant close() sur un ByteArrayOutputStream est intercepté et le code IOException est coché pour générer une erreur de compilation lorsque l'exception n'est pas renvoyée à un autre emplacement dans le bloc try. Comme cela n'affecte pas la compatibilité binaire, cela peut sembler étrange compte tenu de la quantité de changements avec plus d'impact sur le niveau du code source depuis lors.

Mais cette décision a été prise depuis longtemps. On ne sait pas non plus pourquoi le remplacement a été ajouté du tout, car la no-op héritée était suffisante et le remplacement ne change pas la signature et ne contient pas non plus d'amélioration de documentation utile dans cette version, aucune clarification sur close() . L'explication la plus plausible est qu'elle a été ajoutée avec l'intention de supprimer la clause throws, mais il a été détecté que l'incompatibilité était un problème avec certains codes existants.

En fin de compte, il n'est pas vraiment important de l'enlever. Si votre type de compilation est ByteArrayOutputStream, vous savez que vous n'avez pas besoin d'appeler close(). Dans tous les autres cas, à savoir si le type de compilation est plus générale OutputStream, vous devez close() et gérer la déclaration IOException ...