java アノテーション

Question

javaを触り始めたばかりなのですが、アノテーション？というものがどういうものなのがさっぱりわかりません…
注釈といった意味があるようなのですが、コメントとはどう違うんでしょうか？
@GET
@path
@Produces
などいろいろあるようですが、使い方なども教えていただけると助かります。

Answer 1

コメントは単にプログラムを人間が読みやすくするための付加的な情報でコンパイラーはそれらを無視します。一方アノテーションは@アノテーションクラス名で始まるものでコンパイラーはその構文を解釈しますが意味の解釈はアノテーションプロセッサーに任せるようになっています。アノテーションプロセッサーはJavaで記述することができ、コンパイラーからアノテーションの情報を受け取りそれを用いて様々な拡張機能を提供するようになっています。

アノテーションの使い方はアノテーションプロセッサによって決まり、これは誰にでも作れるという意味で仕様は無限にありえます。よって特定のものを使うにはしかるべきドキュメントを読む必要があります。ライブラリーを利用する場合と同じです。

@GET

特定の文脈ではこれでも意味は通じますが、これがJAX-RS RESTで使うアノテーションのことなのか他のフレームワーク用の別物なのかは「どのフレームワーク・ライブラリーについての話題なのか」(もしくはGETアノテーションクラスの完全名)を言わないと曖昧です。有名なフレームワークであれば読み手の方でそれが何かをくみ取ってくれることが多いとは思いますが。

補足：アノテーションプロセッサーのことを注釈プロセッサーともいいますがそこでの「注釈」とはコメントのことではなくアノテーションのことを指します。自分は用語として「注釈」を使わず「コメント」「アノテーション」を使うべきだと思います。

Answer 2

ざっくり言えばコメントは人間が読むためのもので、アノテーションはコンパイラに命令を出すものです。