NCMBはモバイル向けのBaaS(mobile Backend as a Service)ですが、サーバー側のデータとNCMB上のデータを連係させたいというニーズは良くあります。
そんなときには各言語向けのSDKがあると便利です。サーバー向けにはRuby、Python、PHP、Java、C#のSDKがあります(すべて公式サポート対象外の、コミュニティSDKという位置づけです)。
今回はGo言語向けのSDK開発をはじめたので、その使い方を紹介します。今回はログインやユーザー登録といった会員管理周りの使い方です。
ソースコード
ソースコードはGitHubにて公開しています。ライセンスはMIT Licenseになります。
インストール
SDKのインストールは下記コマンドで行います。
go get -u github.com/NCMBMania/ncmb_go
インポート
続けてSDKをインポートします。
import (
"github.com/NCMBMania/ncmb_go"
)
初期化
NCMBより取得したアプリケーションキー、クライアントキーを使って初期化します。
ncmb := NCMB.Initialize("YOUR_APPLICATION_KEY", "YOUR_CLIENT_KEY")
ユーザー登録
ユーザー登録はユーザー名とパスワードを使います。
user, err := ncmb.SignUpByAccount(userName, password)
メールアドレスの場合は、まず会員登録メールを該当メールアドレス宛に送信する必要があります。
bol, err := ncmb.RequestSignUpEmail(mailAddress)
パスワードリマインダー
パスワードをリセットする場合です。メールアドレス認証でしか使えないので注意してください。
bol, err := ncmb.RequestPasswordReset(mailAddress)
ログイン
ログインはユーザー名とパスワード、またはメールアドレスとパスワードに対応しています。
// ユーザー名とパスワードによるログイン
user, err := ncmb.Login(userName, password)
// メールアドレスとパスワードによるログイン
user, err := ncmb.LoginWithMailAddress(mailAddress, password)
返却値はユーザーオブジェクトです。ユーザーオブジェクトは、データストアのアイテムオブジェクトと似た形になっています。
type User struct {
ncmb *NCMB
Item
}
そのため、 Set や Get〜 、 Save 、 Delete などが使えます。詳細は下の各記事を参照してください。
Go言語向けNCMB SDKの使い方(データストアの保存) - Qiita
Go言語向けNCMB SDKの使い方(データストアの取り出し方) - Qiita
Go言語向けNCMB SDKの使い方(データストアの更新と削除) - Qiita
会員の検索
検索する場合には、 users を対象としてください。後はデータストアの検索と変わらず利用できます。
query := ncmb.Query("users")
ログアウト
ログアウトは Logout メソッドになります。もしセッションの有効期限が切れていた場合、API呼び出しが失敗します。そのため、エラー判定は無視した方が良いでしょう。
bol, err := ncmb.Logout()
まとめ
まだ基本的な機能しかありませんが、徐々にバージョンアップしていきます。
Go言語を使ってWebアプリケーションを開発している方は、そのデータ保存先としてNCMBを利用してみてください。