REST API を活用することで、任意のクライアント(フロントエンドアプリケーション)と Wagby を接続することができます。

Wagbyアプリケーションは標準で REST API に対応しています。

開発者はWagbyアプリケーションが稼働しているサーバ(ホスト)に HTTP リクエストを送信すると、JSON 形式で結果を取得することができます。

この仕組みを用いて専用のフロントエンドアプリケーションから、HTTP リクエストを用いて Wagby に格納されているデータの取得や登録、更新、削除といったデータベース操作が可能になります。PC だけでなく iOS や Android OS からもアクセスできます。

代表的なAPIを示します。詳細は各ページに記載しています。

URL HTTPメソッド 説明
/rest/session POST ログオン
/rest/session DELETE ログオフ
/rest/session GET ログオンユーザの情報を取得
/rest/[モデル名]/list GET 一覧表示データを取得
/rest/[モデル名]/list POST 検索条件を指定してデータを取得
/rest/[モデル名]/entry/[主キー] GET 主キーで指定したデータを取得
/rest/[モデル名]/new GET データの新規登録を開始
/rest/[モデル名]/new POST データの新規登録を実行
/rest/[モデル名]/edit/[主キー] GET 主キーで指定したデータの更新を開始
/rest/[モデル名]/edit PUT 主キーで指定したデータの更新を実行
/rest/[モデル名]/edit/[主キー] DELETE 主キーで指定したデータを削除

本ガイドでは、RequestMapping という表記を使います。

@RequestMapping(value="/rest/session", method=PUT)

という表記は

http://localhost:8921/wagby/rest/session

method=PUT

でアクセスすることを示します。

また

produces="application/json"
という表記は、HTTPヘッダーに

Accept:application/json

を設定することを示します。

REST API 利用時も、通常の Web アプリケーションと同じく、通信路を暗号化しない限り、ログオン情報やデータは盗聴される危険があります。

このため実際の運用では、HTTP暗号化通信 (HTTPS) を使うようにしてください。具体的には「サーバ証明書」を購入します。WagbyアプリケーションはTomcatをベースにしているため、Tomcatへのサーバ証明書登録と同じ手順で設定できます。(詳細は「サーバ証明書」の発行元、もしくはWagby販売パートナーへお問い合わせください。)

画面内の処理と併用して呼び出すことはできません

REST APIをWagbyの画面内の処理と併用して呼び出すといったカスタマイズには利用できません。

例えば JavaScript を使って、一覧更新画面内にて REST API を呼び出す、といったカスタマイズを行うことはできません。

日付時刻型のデータについて

REST API で取得できるentityに含まれる日付時刻型のデータはJavaScriptで扱いやすいようにlong値で表現されています。
フォーマットされた日付時刻データを扱いたい場合はentitypやlistpに含まれる値を利用してください。