fhc 、Node.js、および NPM 以外に、他の開発ツールが必要です。

sudo npm install -g grunt-cli

プロジェクト開発を含める新しいディレクトリーを作成します。

mkdir helloworld
cd helloworld

fhc projects clone <project-guid> を使用してプロジェクト内の全アプリのソースコードをクローンします。以下に例を示します。

fhc projects clone XME5iUr2VoBV3DbXrVF7qApG  # <== Replace this projectId with your projectId

以下のような出力メッセージが表示されます。

Cloning into 'helloWorld-Hello-World-Cloud-App'...

Cloning into 'helloWorld-Hello-World-Client'...

完了したら、作成された新しいディレクトリーを確認します。

ls

helloWorld-Hello-World-Client   helloWorld-Hello-World-Cloud-App

https://github.com/evanshortiss/rhmap-express-template などのリモートのリポジトリーからコードを使用するには、以下の手順を実行します。

これでアプリを開発してその結果を RHMAP にプッシュすることができます。

クラウドアプリにアクセスするには以下の 2 つの方法があります。

fhc app hosts --app=<app-guid> --env=<some-env>

{
  "url": "https://testing-3utxgzhawprfqot3tya04v5i-example.feedhenry.com"
}

cd <PROJECT-DIR>/helloWorld-Hello-World-Cloud-App

npm install

grunt serve

Running "env:local" (env) task

Running "concurrent:serve" (concurrent) task
Running "watch" task
Waiting...
Running "nodemon:dev" (nodemon) task
[nodemon] v1.0.20
[nodemon] to restart at any time, enter `rs`
[nodemon] watching: *.*
[nodemon] starting `node application.js`
App started at: Tue Sep 30 2014 15:39:07 GMT+0100 (IST) on port: 8001

curl -X POST http://localhost:8001/hello?hello=world

{"msg":"Hello world"}

grunt serve     #  'live reload' でサーバーをローカル実行
grunt test      # ローカルでテストを実行
grunt coverage  # コードカバレッジでテストを実行

クライアントアプリをローカルで実行します。

cd <PROJECT-DIR>/helloWorld-Hello-World-Client

クライアントアプリ向けのすべての依存関係 (主に grunt 関連) をインストールします。

npm install

Web ブラウザーセッションを開始します。

grunt serve:local

grunt serve:local により、デフォルトでポート 8001 でのローカル Node.js クラウドアプリへの接続が試行されます。以下のようなメッセージが表示されます。

Running "serve:local" (serve) task

Running "clean:server" (clean) task

Running "connect:livereload" (connect) task
Started connect web server on http://localhost:9002

Running "watch" task
Waiting...

詳細については、'Hello World Client' テンプレートアプリ向けの README.md を参照してください。

MBaaS サービスは Node.js アプリケーションです。MBaaS サービスは、Oracle 統合サービスのようなバックエンドシステムと統合するためにプロジェクトで使用できます。MBaaS サービスは 1 つ以上のプロジェクトと関連付けてアプリで利用できるようにする必要があります。そのようにしないと、プロジェクト内のアプリは MBaaS サービスにアクセスできません。MBaaS サービスの詳細については、relevant product documentation を参照してください。

サービスは、クラウドアプリから $fh.service クラウド API コールで呼び出されます。以下に例を示します。

$fh.service({
  guid: "PFi1ftKRBvlp-qSmgdcOeGe3",
  path: "/hello",
  method: "GET",
  params: {
    "hello": "world"
  }
}, function(err, data) {
  if (err) {
    return console.log(err);
  }
  return console.log(data);
});

ローカル開発環境から MBaaS サービスと対話するには、以下の間でマッピングが必要です。

Gruntfile.js での新しい環境変数の定義が必要です。

env : {
  options : {},
  // environment variables - see https://github.com/jsoverson/grunt-env for more information
  local: {
    FH_USE_LOCAL_DB: true,
    FH_SERVICE_MAP: function() {
      /*
       * ローカル開発用のサービスのマッピングをここで定義します。
       * アクセスしたい各サービスでマッピングを提供する必要があります。
       * これは、ローカルで実行中のサービスのインスタンスとする (ローカル開発用)
       * もしくはリモートインスタンスとすることができます。
       */
      var serviceMap = {
        'PFi1ftKRBvlp-qSmgdcOeGe3': 'http://127.0.0.1:8010'
      };
      return JSON.stringify(serviceMap);
    }
  }
},

上記の例では、FH_SERVICE_MAP がローカル環境変数の定義に追加されます。新しい変数は関数に対してマップされ、ポート 8010 でローカルで実行中のサービスを参照する GUID PFi1ftKRBvlp-qSmgdcOeGe3 を格納します。サービスのホスト済みインスタンスをターゲットにするには、Studio の Details ページにあるサービスの Current Host URL を使用してください。すべての追加サービスは serviceMap 変数に追加されます。

ユーザーは、文字列化された JSON オブジェクトではなく標準的な JSON オブジェクトとしてサービスマッピングを定義できます。以下の例では、FH_SERVICE_MAP 環境変数は標準的な JSON オブジェクトを使用して設定されます。

FH_SERVICE_MAP: '{"PFi1ftKRBvlp-qSmgdcOeGe3":"http://127.0.0.1:8010"}'

利用可能なサンプルは、ここで確認できます。

クラウドアプリのディレクトリーに移動し、./lib/hello.js を開きます。

応答で現在の時間を設定するパラメーターを追加するには、新しいパラメーターを GET と POST の両方の要求に入力します。

res.json({msg: 'Hello ' + world});

上記の内容を以下の内容に置き換えます。

res.json({msg: 'Hello ' + world, 'timestamp': new Date().getTime() });

これで応答にミリ秒単位の現在の時間がタイムスタンプに追加されます。これが 2 つあるのは、GET および POST リクエストの両方用にルートハンドラーがあるためです。

このファイルが保存されると、クラウドアプリは自動的に再起動します。ファイルの保存後に、以前実行した curl コマンドを再実行します。

curl -X POST http://localhost:8001/hello?hello=world

応答にタイムスタンプが含まれるようになります。

{"msg":"Hello World","timestamp":1412111429480}

クライアントアプリのディレクトリーに移動し、./www/index.html を開きます。これは、"name" 用の入力フィールドとクラウドを呼び出すボタンがある基本的な Web ページです。また、クラウドコールから応答に値を入力するために使用する cloudResponse div もあります。

コード "cloudResponse" の直下:

<div id="cloudResponse"></div>

timestamp div の追加:

<div id="timestamp"></div>

./www/hello.js で、クリックハンドラーは "Say Hello" ボタンに割り当てられます。トリガーされると、$fh.cloud API を使用してクラウドアプリの /hello エンドポイントが呼び出されます。

タイムスタンプを提供するには、./www/hello.js を開き、

document.getElementById('cloudResponse').innerHTML = "<p>" + res.msg + "</p>";

上記のコードの直下に以下のコードを追加します。

document.getElementById('timestamp').innerHTML = "<p>" + new Date(res.timestamp) + "</p>";

クライアントディレクトリーとクラウドディレクトリーで以下のコマンドを実行します。

git commit -am"Add timestamp parameter"
git push origin master

これで、ローカルで行われた変更が App Studio に表示されるようになります。

fh.db() や fh.cache() といった MBaaS API を使用した高度な開発には、別のソフトウェアが必要です。