Dans la javadoc, quelle est la différence entre les balises @throws et @exception?

Prendre la suite de la mise en œuvre d'un tableau de base de la pile de caractères, par exemple:

public char peek() throws Underflow {
    if (!isEmpty()) {
        return stack[pos];
    } else {
        throw new Underflow("Peeking at an empty stack.");
    }
}

Dos quand je suis juste en utilisant un éditeur de texte, j'utilise toujours le @exception de la balise, mais maintenant mon IDE (Netbeans) utilisé @throws lors de la génération de la javadoc.

Donc ma question est, quelle est la différence entre les deux et quand l'une devrait être préféré à un autre (à l'aide du code ci-dessus par exemple)?

InformationsquelleAutor jon2512chua | 2011-04-01
  1. 48

    Il n'en est aucun, ils sont synonymes. À partir de la documentation:

    Documentation des Exceptions avec @throws Tag

    NOTE - Les balises @throws et @exception sont synonymes.

    • Hmmm, dans ce cas, pourquoi avez-Soleil offrent deux façons de document exceptions?
    • href="http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#@exception" >@exception est venu en premier, mais alors (et c'est complet de la spéculation) je pense que quelqu'un a été estimé que plus long et également n'a pas la cravate de bien avec Java throws mot-clé, alors ils ont ajouté @throws. Il serait très au début, cependant, je pense qu'ils étaient tous les deux, quand j'ai commencé à l'aide de Java en 1995. Je l'ai presque jamais vu @exception utilisé à l'état sauvage, il semble y avoir une nette préférence pour @throws dans la communauté.
    • Cool. Grâce T. J. 🙂
    • Je me demande pourquoi ne @throws fin avec un "s" mais @return ne l'est pas.
    • Parce que les êtres humains sont chaotiques. 🙂 return s'intègre mieux avec param (par exemple, il décrit la valeur de retour, il décrit le paramètre), et en effet avec l'original @exception. Mais alors, en parallèle de la construction qui est sorti par la fenêtre avec @throws. 🙂
    • ce que la danse des chevaux?
    • Ils ont quitté. Se passer des choses intéressantes dans le 1er avril.

    InformationsquelleAutor T.J. Crowder
  2. 11

    @throws a été ajouté parce que c'est un mot-clé ("lance" clause dans une déclaration de méthode),

    et, en tant que verbe, il est juste plus naturel à lire. Cela se lit comme une phrase:

    @throws NullPointerException

    bien que cela semble plus redondante:

    @exception NullPointerException

    Sinon, les deux sont synonymes

    InformationsquelleAutor Hardik Mishra
  3. 5

    @exception n'est pas correct à 100% si vous code lance un Throwable. @throws est plus exact. (Je me rends compte il n'y a pas un bon cas d'utilisation pour toujours à l'aide de throw new Throwable(), mais théoriquement, il est permis.)

    • Errors sont aussi Throwables qui ne sont pas Exceptions. Vous n'avez pas l'habitude de les jeter à la main, mais je l'ai déjà écrit quelques throw new AssertionError().
    InformationsquelleAutor combinatorics