現在ではREST APIはとても一般的な話題です。ほとんどすべてのWebアプリケーションの一部分となっています。シンプルで一貫性があり実際的なインターフェースは必須です。これは皆さんのAPIを他の人が使うことをとても容易にします。皆さんにとってはRESTの実践が日常的に感じられるかもしれませんが、RESTをあまり尊重しない人々もよく見かけます。これがRESTについて投稿するきっかけでした。 この記事にはRESTfulなAPIを設計する時に考慮すべきベストプラクティスがあります。 注意 : ここでのベストプラクティスは、私が過去の経験に基づいて良いと考える事例です。もし違う考えをお持ちであれば、お気軽にメールをくだされば意見交換できると思います。 APIのバージョンを示す APIのバージョンは必須であるべきです。これがあると時間が経ってAPIが変わっても影響を受けません。その方法の1つはUR

この記事は Java Advent Calendar 2014、8 日目です。昨日は @d7kuro さんの「Apache Camelに関する機能のまとめ」です。 Java で日付と時刻を扱う場合は Date and Time API を使います。過去の Java （Java 7 および Java 6）には同 API が含まれていないため、同等品の ThreeTen backport を別途用意します。ThreeTen backport さえ使えない Java は、古すぎるのでもう使わないでください。 Date and Time API には多数のクラスが含まれていますが、とりあえず LocalDate、LocalTime、LocalDateTime、DateTimeFormatter を覚えておけば良いです。「LocalDateTime には時差の情報がないから通常は ZonedDate

既存のライブラリが java.util.logging API 使ってて、俺は今 logback が使いたいんだ！設定ファイルは logback.xml に統一したいんだ！という人向けの情報 http://mvnrepository.com/ で「jul-to-slf4」java logging api から slf4j へのブリッジになるライブラリを落としてきます。 以下のようなコードを書きます。Java java.util.logging.Logger rootLogger = LogManager.getLogManager().getLogger(""); Handler[] handlers = rootLogger.getHandlers(); for (int i = 0; i < handlers.length; i++) { rootLogger.removeHandle

Java nio の API を見ていくシリーズ（目次）。　前回から結構時間が空いてしまいましたが、java.nio.file パッケージのクラスを見ていきま〜す。　今回はファイル、ディレクトリの操作です。　ファイルをコピーとか移動とかします。　以降の記事では「ファイル」と書いてファイルとディレクトリの両方を指している場合があります。　文脈で分かるかと思いますが。 ファイルの存在と削除 LinkOption 定数 ファイルのコピーと移動 CopyOption シンボリック・リンクを読み込む ファイルの存在と削除まずはファイルの存在を確認するメソッドと、ファイルを削除するメソッド。 メソッド 返り値 説明 exists(Path, LinkOption...) notExists(Path, LinkOption...) boolean ファイル、ディレクトリが存在するかどうかを確認する d

新しい Java SE API リファレンスの入手先について 2012年3月25日 at 10:30 午後 3件のコメント 2012 年 03 月 25 日、sun.com のドメインが利用不可になりました。これに併せ、java.sun.com で提供されていた Java SE API 日本語ドキュメントもオンライン経由で参照する事ができなくなりました。今後、日本語の Java SE API レファレンスはオンライン経由では参照できなくなりますので、アーカイブを御入手の上、ローカル環境でご参照ください。お手数をお掛けし申し訳ございませんが、どうぞ宜しくお願いします。 Java API の日本語ドキュメントはコチラから入手が可能です。 ドキュメントの再配布ポリシーはコチラをご参照ください。 新しい日本語 API ドキュメントのオンライン参照先URL (2012/4/11 訂正、追記) htt

昨日かいたとおり、JavaSEのあたりをつけるためのエントリを描いていく。 細かい解説はしないので、詳しくはJavadocを見ながらいろいろといじってもらいたい。あくまでも索引のようなエントリということで。 特別なぞるわけではないが、このへんを参考に。 「Javaが使えます」という人の基準 画像を扱う 画像を扱う基本となるクラスは名前ですぐ気がつくと思うが、Imageクラスだ。java.awtパッケージにある。画像のサイズを保持していたり、画像に対して実際に描画するグラフィックスコンテキスト（後述）を作成したりする。 ただし、このクラスは抽象クラスである。 実態は別にある。 特に一般的にユーザーが扱うImageを継承したクラスは2つ。 BufferedImageとVolatileImageである。これらはパッケージは変わってjava.awt.imageである。 BufferedImage

社内に突っ込んだRedmineが大盛況になりました。「便利なツールが使われる」は達成できたので、「そのツールを活かして業務を改善する」まで今年持って行きたい。多分、結構な人数で使っているので、Redmineの勉強会がまたあったら事例共有しようと思うのですが、人数が増えるとやっぱりリクエストが増えます。「わがままいうな！やりたきゃてめーでやれ！」という心の声は置いておいて、今回は、RedmineにRESTでチケット登録したいという要望があったので、ちょっと調べたこと、困ったこと、できたことを共有させていただきます。 とても参考になったのがRedmine REST api を触ってみた。 by ka-ka_xyzの日記さんのページです。ありがとうございます。 準備はいいか？ Redmine REST APIは、2010/03/06ではまだ正式にリリースされていないみたいです。これを利用する場合

以前から javax.tools パッケージって気になってたんですが、それを使ったサンプルを見つけたのでちょっと試してみることに。 javax.tools パッケージのクラスを使うと、Java クラスをダイナミックに生成することができるそうです。　ここでいう“ダイナミックに”とは「内容が Java コードの java.lang.String オブジェクトから Java クラスファイルを生成できる」という意味です*1。 ただ、API を使っていると、どことなく「$JAVA_HOME/bin/javac.exe」をラップした API って感じが漂ってくるので（実際にそういう実装なのかは知りませんが）、何か何処かぎこちない気もしないでもない（こともない*2）　まぁ、ともかくサンプルを動かしてみましょう。　ちなみに JDK 6 必須です。 参考 URL JavaDoc 「Package javax

Javaの最適化の議論で「インライン展開」「エスケープアナリシス」などの用語が出てきていて、気になって調べたところ、java実行時のオプションで最適化の方法を指定したり実行過程を表示したり出来るらしい。 主なオプションについて Java HotSpot VM Optionsにパフォーマンスに影響しそうなHotSpot VMのオプションが説明されている。 例: オプション 効果 -XX:+PrintCompilation メソッドがコンパイルされた際にメッセージを表示 -XX:+UseBiasedLocking Biased Lockingを使用する -XX:+OptimizeStringConcat 可能なら文字列の連結操作の最適化を行う -XX:+AggressiveOpts 将来のリリースでデフォルトになりそうな最適化フラグを有効にする ... ... たとえばjava起動時に-XX:

LuvPadを手に入れたのを機に今まで開発者登録をしたまま放置をしていたAndroidアプリにも手を出そうと思ってます。 そこで始めに本屋で吟味して購入した本の紹介をします。 初めてプログラミングをする人には少々難しいかもしれませんが、iPhone開発経験者はこれがあればすぐに開発できると思います。 基礎から学ぶ Android SDK 基礎からと書いてある割にはSDKのインストールから書かれているだけで、初心者向きの本ではないと思います。 Javaの言語についても書かれているわけではありません。 豊富は処理サンプルコードがあるので、ある程度プログラミングがわかる人には重宝します。 AndroidSDK開発のレシピ―104個のレシピで学ぶAndroidアプリ開発の極意 この本はiOS版もあり、とても重宝しています。 Tipsごとに逆引き風に書かれているので、ちょっとした技を調べることが出来

アノテーションプロセッサを実装するための"Pluggable Annotation Processing API"はJava6から実装された機能であり、残念ながらAndroidプラットホームでは使えない。がしかしEclipse自体はJava6で動作しており、プラグイン、コンパイラ等は全てJava6上で動作しているため、以下の条件を満たせばAndroidプロジェクトに対してアノテーションプロセッサを適用することが可能である。 Androidのクラス群にアクセスしない(Dalvikランタイムにアクセスしない) これだけだ。Annotation Processorの起動は適切な設定を行うことでEclipseがやってくれる。(プラグインorg.eclipse.jdt.apt.pluggable.coreが担当する) アノテーションプロセッサを実装するための"Pluggable Annotation

最近、Java API(JavaDoc)を開こうとすると遅い・・・というかタイムアウトで失敗する・・・。 ググってみたら、 java.sun.comが開けない DNSがおかしい気がする http://twitter.com/joniburn/status/4822838108233728 DNSがおかしい？ とりえあず、nslookup っと・・・ Name : java.sun.com Address : 192.9.162.55 ローカルIPですね(笑)(23:00削除) 予約されているIPアドレスでした。(23:30削除) 192.0.0.0/24 - This block is reserved for IETF protocol assignments. RFC 5735 - Special Use IPv4 Addresses Whoisで確認したら、ちゃんと割り当てられてるみ