Javadoc ドキュメンテーションコメントの書き方 - Qiita
そもそも、そのメソッドの作成者が近くにいない場合、こういった確認すら行えません。結局、あるメソッドを使うために、そのメソッドの実装を時間をかけて分析することになるため、複数人で開発していることが、逆に開発効率を悪化させてしまいます。つまり、簡単に言うと、 「仕様の明確でないメソッドを作るのは迷惑行為です！」 ドキュメンテーションコメントによって API 仕様が明確にされていれば、こういった無駄なやりとりがなくなるため、開発効率もコード品質も上がります。下記のグラフは、開発メンバの人数と、生産性の関係を表しています。 仕様の不明確な API が溢れているプロジェクトに新しい実装メンバを投入しても、開発効率はうまく上がっていきません。すべての API の仕様が明確になっていれば、不具合が見つかった場合でも、各メソッドが何を実現すべきかが分かるので、別の人が実装を引き継いで修正していくことが可能
JAX-RSを活用して、JavaクラスをWebサービス化しよう
JAX-RSはもともとRESTアーキテクチャなWebアプリを作成するための仕様だが、これを利用すると、普通のJavaクラスにアノテーションを付けるだけでWebサービスとして公開できるようになる。この記事では単純なJavaクラスを作成し、それをJAX-RSを利用してWebサービスとして公開するまでを示す。 なお、JAX-RS自体はJava EEの仕様のため、Java SEで利用可能なフレームワークはサードパーティによって提供される。本記事ではjava.netで公開されているJerseyを利用する。インストール手順などは記事内で説明する。 JAX-RSを利用したWebサービスがどのように動作しているかは最後で解説するものとして、ここではJAX-RSを利用すると、普通のJavaクラスをWebサービス化するのがどれほど簡単かに注目いただきたい。 JAX-RSの意義 全てのソフトウェアをサービスとし
Web API を作ってみる
12月17日 Web API を作ってみる Firefox OSと直接の関係性が薄い記事ですが、Webアプリケーション開発関連として、御了承下さい。 パッケージ型の Firefox OS アプリを作ってたとしましても、サーバサイドでの独自のWeb APIが必要になることがありますよね。 そこで、簡単な例としてGETメソッド・リクエストで名前を受け取り挨拶を返してくれる「あいさつ」Web APIを作ってみます。 【お詫び】 私のPC環境は、Ubuntu 14.04 LTS 64bit ですので、サンプル内容も Linux 用になっています。 他の環境の方、ごめんなさい。 JavaでサクッとWeb API作成 Javaには、RESTful なシステム機能を提供する JAX-RS という規格(パッケージ/ライブラリ)があります。 JAX-RS が提供する機能を利用すると、単なるPOJOのクラスと
Javaで業務アプリを開発するための環境構築手順（Windows/Mac対応）
この連載は、Javaをいきなりやることになってしまった新卒の人や、Java以外の言語の使用経験しかない人など、Javaの初心者なのに業務アプリ（ビジネスで使われるアプリケーション）の開発で即戦力にならないといけない人達に向けての連載になります。標準のJavaでできることはもちろん、DB操作のためのSQLやよく使われるライブラリの使い方など、単なるJavaのみの紹介ではなく、Javaでの業務アプリの開発に必要とされる基礎知識全般について連載を通じて学んでいくことを目的としています。 はじめに 今回の記事では、Java（ジャバ）で業務アプリを開発するための開発環境の構築を行います。また、Javaのアプリケーションの開発では統合開発環境（IDE）を使って作業することがほとんどです。統合開発環境とはアプリケーションの開発をサポートする環境で、この連載では多くの現場で使われているEclipse（エク
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
