WebAPIを利用したアプリケーションの実装

Question

APIの実装について伺いたいです。
最初、APIを実行するメソッドを作るとき、curlコマンドのバッチを作り、それを実行する実装を作る考えでいましたが、Javaでヘッダーを作りURLへ投げるのが普通と言われました。下記のようなイメージです。

  JUrlTest1(){
    URL url = null;

    try{
        url = new URL("http://www.javadrive.jp/tutorial/imageicon/hasami.png");
    }catch(MalformedURLException e){
        e.printStackTrace();
    }

こちらのほうがいいのは何となく理解できるのですが、こちらのやり方が普通でしょうか？また、Javaでヘッダーを作りURLへ投げる方法のほうが決定的な良さがあるのでしょうか？（レスポンスが速いなど）
よろしくお願いします。

Comments

[KSwordOfHaste]

単にAPIではなくWebAPIですね？また「APIの実装」だとインターフェース提供側の実装をイメージします。タイトルを「WebAPIを利用したアプリケーションの実装」などにすると閲覧者がより的確に内容を把握できると思います。

Answer 1

そのアプリケーションの開発前提によって「普通」の意味合いはいくぶん振れると思います。

1. プロセス起動のオーバーヘッド

APIを利用したこのメソッドがクライアント内でしか使われないならそこまで気にすることではないかもしれません。ただそのメソッドをサーバー側の論理でも使うなら気にした方がいいかも知れません。

1. エラー処理

スクリプトのexit codeやstderrの内容に頼ることより、java内に論理を実装したほうがよりきめ細かくエラーハンドリングを実装しやすいかも知れません。

1. 可搬性

アプリケーションの前提環境がlinux固定でライフサイクルを考えても他プラットフォームの可能性がない、といった場合なら問題ではないかも知れません。多少スクリプトが増えてもアプリケーションの配置が自動化されていれば大した手間もかからないでしょうから。そうでないなら問題になる可能性が出てくると思います。curlなどの互換性を気にしなくてもjava APIで可搬性を確保したほうが楽だからです。

1. 生産性

スクリプトである程度複雑なことをする場合で他の不利な点を考慮してもなお生産性の点からスクリプトを選択する判断はあり得ると思います。逆にそう複雑なことをしないならjavaで実装すればよくわざわざスクリプトを呼び出すほどではないという場合もあると思います。

何が一般的かはわかりませんが、「WebAPIを利用するjavaメソッドを実装せよ」とだけ言われたら外部コマンドを呼び出すよりはJavaに閉じた実装(標準ライブラリーのみ、あるいは何かのフレームワーク・ライブラリーを利用したもの)をする方を最初にイメージする気がします。