NCMBUser Class Reference
Inherits from | NCMBObject : NSObject |
---|---|
Declared in | NCMBUser.h |
Overview
NCMBUserクラスは、ニフクラ mobile backend上に保存されたユーザデータを管理するクラスです。 ユーザの新規登録やログイン/ログアウト、会員情報の更新・取得・削除を行います。 また、パスワードリセットやメールアドレス認証のリクエスト送信も行います。
User
+ user
NCMBUserのインスタンスを新規生成
+ (NCMBUser *)user
Return Value
新規生成したNCMBUserのインスタンス
Declared In
NCMBUser.h
+ query
NCMBQueryのインスタンスを新規作成する
+ (NCMBQuery *)query
Return Value
userクラスがセットされたNCMBQueryインスタンスを返却する
Declared In
NCMBUser.h
+ currentUser
現在ログインしているユーザ情報を取得する もしログインしているユーザーがいない場合にはnilが返ってくる
+ (NCMBUser *)currentUser
Return Value
現在ログインしているユーザオブジェクト
Declared In
NCMBUser.h
+ automaticCurrentUserWithBlock:
enableAutomaticUserを設定した場合に、anonymous認証による自動会員登録を実行する。
+ (void)automaticCurrentUserWithBlock:(NCMBUserResultBlock)block
Parameters
block |
anonymous認証による会員登録がリクエストされたあとに実行されるブロック |
---|
Discussion
enableAutomaticUserが設定されていない場合や、すでにログイン済みの会員が存在している場合はcurrentUserと同じ処理を行う。
Declared In
NCMBUser.h
+ automaticCurrentUserWithTarget:selector:
enableAutomaticUserを設定した場合に、anonymous認証による自動会員登録を実行する。
+ (void)automaticCurrentUserWithTarget:(id)target selector:(SEL)selector
Parameters
target |
anonymous認証による会員登録がリクエストされたあとに実行されるセレクタのターゲット |
---|---|
selector |
anonymous認証による会員登録がリクエストされたあとに実行されるセレクタ |
Discussion
enableAutomaticUserが設定されていない場合や、すでにログイン済みの会員が存在している場合はcurrentUserと同じ処理を行う。
Declared In
NCMBUser.h
– isAuthenticated
ユーザが認証済みかを判定
- (BOOL)isAuthenticated
Return Value
BOOL型YES=認証済、NO=未認証
Declared In
NCMBUser.h
Signup
– signUp:
ユーザの新規登録。必要があればエラーをセットし、取得することもできる。
- (void)signUp:(NSError **)error
Parameters
error |
処理中に起きたエラーのポインタ |
---|
Declared In
NCMBUser.h
– signUpInBackgroundWithBlock:
ユーザを非同期で新規登録。新規登録し終わったら与えられたblockを呼び出す。
- (void)signUpInBackgroundWithBlock:(NCMBErrorResultBlock)block
Parameters
block |
通信後実行されるblock。blockは次の引数のシグネチャを持つ必要がある(NSError *error) errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
---|
Declared In
NCMBUser.h
– signUpInBackgroundWithTarget:selector:
ユーザを非同期で新規登録。新規登録し終わったら指定されたコールバックを呼び出す。
- (void)signUpInBackgroundWithTarget:(id)target selector:(SEL)selector
Parameters
target |
呼び出すセレクタのターゲット |
---|---|
selector |
呼び出すセレクタ。次のシグネチャを持つ必要がある。 (void)callbackWithResult:(NSError **)error errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– signUpWithGoogleToken:withBlock:
googleのauthDataをもとにニフクラ mobile backendへの会員登録(ログイン)を行う
- (void)signUpWithGoogleToken:(NSDictionary *)googleInfo withBlock:(NCMBErrorResultBlock)block
Parameters
googleInfo |
google認証に必要なauthData |
---|---|
block |
サインアップ後に実行されるblock |
Declared In
NCMBUser.h
– signUpWithTwitterToken:withBlock:
twitterのauthDataをもとにニフクラ mobile backendへの会員登録(ログイン)を行う
- (void)signUpWithTwitterToken:(NSDictionary *)twitterInfo withBlock:(NCMBErrorResultBlock)block
Parameters
twitterInfo |
twitter認証に必要なauthData |
---|---|
block |
サインアップ後に実行されるblock |
Declared In
NCMBUser.h
– signUpWithFacebookToken:withBlock:
facebookのauthDataをもとにニフクラ mobile backendへの会員登録(ログイン)を行う
- (void)signUpWithFacebookToken:(NSDictionary *)facebookInfo withBlock:(NCMBErrorResultBlock)block
Parameters
facebookInfo |
facebook認証に必要なauthData |
---|---|
block |
サインアップ後に実行されるblock |
Declared In
NCMBUser.h
– signUpWithAppleToken:withBlock:
appleのauthDataをもとにニフクラ mobile backendへの会員登録(ログイン)を行う
- (void)signUpWithAppleToken:(NSDictionary *)appleInfo withBlock:(NCMBErrorResultBlock)block
Parameters
appleInfo |
apple認証に必要なauthData |
---|---|
block |
サインアップ後に実行されるblock |
Declared In
NCMBUser.h
requestAuthenticationMail
+ requestAuthenticationMail:error:
指定したメールアドレスに対して、会員登録を行うためのメールを送信するよう要求する。必要があればエラーをセットし、取得することもできる。
+ (void)requestAuthenticationMail:(NSString *)email error:(NSError **)error
Parameters
email |
指定するメールアドレス |
---|---|
error |
処理中に起きたエラーのポインタ |
Declared In
NCMBUser.h
+ requestAuthenticationMailInBackground:target:selector:
指定したメールアドレスに対して、会員登録を行うためのメールを送信するよう要求する。終わったら指定されたコールバックを呼び出す。
+ (void)requestAuthenticationMailInBackground:(NSString *)email target:(id)target selector:(SEL)selector
Parameters
email |
指定するメールアドレス |
---|---|
target |
呼び出すセレクタのターゲット |
selector |
呼び出すセレクタ。次のシグネチャを持つ必要がある。 (void)callbackWithResult:(NSError **)error errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
+ requestAuthenticationMailInBackground:block:
指定したメールアドレスに対して、会員登録を行うためのメールを送信するよう要求する。終わったら与えられたblockを呼び出す。
+ (void)requestAuthenticationMailInBackground:(NSString *)email block:(NCMBErrorResultBlock)block
Parameters
email |
指定するメールアドレス |
---|---|
block |
通信後実行されるblock。blockは次の引数のシグネチャを持つ必要がある (NSError *error) errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
LogIn
+ logInWithUsername:password:error:
ユーザ名とパスワードを指定してログイン。必要があればエラーをセットし、取得することもできる。
+ (NCMBUser *)logInWithUsername:(NSString *)username password:(NSString *)password error:(NSError **)error
Parameters
username |
ログイン時に指定するユーザ名 |
---|---|
password |
ログイン時に指定するパスワード |
error |
処理中に起きたエラーのポインタ |
Return Value
ログインしたユーザの情報
Declared In
NCMBUser.h
+ logInWithUsernameInBackground:password:target:selector:
ユーザ名とパスワードを指定して非同期でログイン。ログインし終わったら指定されたコールバックを呼び出す。
+ (void)logInWithUsernameInBackground:(NSString *)username password:(NSString *)password target:(id)target selector:(SEL)selector
Parameters
username |
ログイン時に指定するユーザ名 |
---|---|
password |
ログイン時に指定するパスワード |
target |
呼び出すセレクタのターゲット |
selector |
呼び出すセレクタ。次のシグネチャを持つ必要がある。(void)callbackWithResult:(NCMBUser *)user error:(NSError **)error userにはログインしたユーザの情報が渡される。errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
+ logInWithUsernameInBackground:password:block:
ユーザ名とパスワードを指定して非同期でログイン。ログインし終わったら与えられたblockを呼び出す。
+ (void)logInWithUsernameInBackground:(NSString *)username password:(NSString *)password block:(NCMBUserResultBlock)block
Parameters
username |
ログイン時に指定するユーザ名 |
---|---|
password |
ログイン時に指定するパスワード |
block |
通信後実行されるblock。blockは次の引数のシグネチャを持つ必要がある(NCMBUser user, NSError error) userにはログインしたユーザの情報が渡される。errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
+ logInWithMailAddress:password:error:
メールアドレスとパスワードを指定してログイン。必要があればエラーをセットし、取得することもできる。
+ (NCMBUser *)logInWithMailAddress:(NSString *)email password:(NSString *)password error:(NSError **)error
Parameters
email |
ログイン時に指定するメールアドレス |
---|---|
password |
ログイン時に指定するパスワード |
error |
処理中に起きたエラーのポインタ |
Return Value
ログインしたユーザの情報
Declared In
NCMBUser.h
+ logInWithMailAddressInBackground:password:target:selector:
メールアドレスとパスワードを指定して非同期でログイン。ログインし終わったら与えられたコールバックを呼び出す。
+ (void)logInWithMailAddressInBackground:(NSString *)email password:(NSString *)password target:(id)target selector:(SEL)selector
Parameters
email |
ログイン時に指定するメールアドレス |
---|---|
password |
ログイン時に指定するパスワード |
target |
呼び出すセレクタのターゲット |
selector |
呼び出すセレクタ。次のシグネチャを持つ必要がある。(void)callbackWithResult:(NCMBUser *)user error:(NSError **)error userにはログインしたユーザの情報が渡される。errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
+ logInWithMailAddressInBackground:password:block:
メールアドレスとパスワードを指定して非同期でログイン。ログインし終わったら与えられたblockを呼び出す。
+ (void)logInWithMailAddressInBackground:(NSString *)email password:(NSString *)password block:(NCMBUserResultBlock)block
Parameters
email |
ログイン時に指定するメールアドレス |
---|---|
password |
ログイン時に指定するパスワード |
block |
通信後実行されるblock。blockは次の引数のシグネチャを持つ必要がある(NCMBUser user, NSError error) userにはログインしたユーザの情報が渡される。errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
Logout
+ logOutInBackgroundWithBlock:
非同期でログアウトを行う
+ (void)logOutInBackgroundWithBlock:(NCMBErrorResultBlock)block
Parameters
block |
ログアウトのリクエストをした後に実行されるblock |
---|
Declared In
NCMBUser.h
requestPasswordReset
+ requestPasswordResetForEmail:error:
指定したメールアドレスを持つユーザのパスワードリセットを要求。ユーザが存在した場合、パスワードをリセットし、再設定のメールを送信する。必要があればエラーをセットし、取得することもできる。
+ (void)requestPasswordResetForEmail:(NSString *)email error:(NSError **)error
Parameters
email |
指定するメールアドレス |
---|---|
error |
処理中に起きたエラーのポインタ |
Declared In
NCMBUser.h
+ requestPasswordResetForEmailInBackground:target:selector:
指定したメールアドレスを持つユーザのパスワードリセットを非同期で要求。ユーザが存在した場合、パスワードをリセットし、再設定のメールを送信する。リセットし終わったら指定されたコールバックを呼び出す。
+ (void)requestPasswordResetForEmailInBackground:(NSString *)email target:(id)target selector:(SEL)selector
Parameters
email |
指定するメールアドレス |
---|---|
target |
呼び出すセレクタのターゲット |
selector |
呼び出すセレクタ。次のシグネチャを持つ必要がある。 (void)callbackWithResult:(NSNumber *)result error:(NSError **)error resultにはリセットの有無をNSNumber型で渡される。errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
+ requestPasswordResetForEmailInBackground:block:
指定したメールアドレスを持つユーザのパスワードリセットを非同期で要求。ユーザが存在した場合、パスワードをリセットし、再設定のメールを送信する。リセットし終わったら与えられたblockを呼び出す。
+ (void)requestPasswordResetForEmailInBackground:(NSString *)email block:(NCMBErrorResultBlock)block
Parameters
email |
指定するメールアドレス |
---|---|
block |
通信後実行されるblock。blockは次の引数のシグネチャを持つ必要がある (NSError *error)errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– signUpFromAnonymous:password:error:
匿名会員を正規会員として同期で登録する。2回のAPIリクエストが発生する。objectiId,createDate,updateDate,authdata以外の情報を引き継ぐ。必要があればエラーをセットし、取得することもできる。
- (void)signUpFromAnonymous:(NSString *)userName password:(NSString *)password error:(NSError **)error
Parameters
userName |
正規会員のユーザー名 |
---|---|
password |
正規会員のパスワード |
error |
処理中に起きたエラーのポインタ |
Declared In
NCMBUser.h
– signUpFromAnonymousInBackgroundWithBlock:password:block:
匿名会員を正規会員として非同期で登録する。2回のAPIリクエストが発生する。objectiId,createDate,updateDate,authdata以外の情報を引き継ぐ。必要があればエラーをセットし、取得することもできる。
- (void)signUpFromAnonymousInBackgroundWithBlock:(NSString *)userName password:(NSString *)password block:(NCMBErrorResultBlock)block
Parameters
userName |
正規会員のユーザー名 |
---|---|
password |
正規会員のパスワード |
block |
通信後実行されるblock。blockは次の引数のシグネチャを持つ必要がある(NSError *error) errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– signUpFromAnonymousInBackgroundWithTarget:password:target:selector:
匿名会員を正規会員として非同期で登録する。2回のAPIリクエストが発生する。objectiId,createDate,updateDate,authdata以外の情報を引き継ぐ。必要があればエラーをセットし、取得することもできる。
- (void)signUpFromAnonymousInBackgroundWithTarget:(NSString *)userName password:(NSString *)password target:(id)target selector:(SEL)selector
Parameters
userName |
正規会員のユーザー名 |
---|---|
password |
正規会員のパスワード |
target |
呼び出すセレクタのターゲット |
selector |
呼び出すセレクタ。次のシグネチャを持つ必要がある。 (void)callbackWithResult:(NSError **)error errorにはエラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
link
– linkWithGoogleToken:withBlock:
ログイン中のユーザー情報に、googleの認証情報を紐付ける
- (void)linkWithGoogleToken:(NSDictionary *)googleInfo withBlock:(NCMBErrorResultBlock)block
Parameters
googleInfo |
googleの認証情報(idとaccess_token) |
---|---|
block |
既存のauthDataのgoogle情報のみ更新後実行されるblock。エラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– linkWithTwitterToken:withBlock:
ログイン中のユーザー情報に、twitterの認証情報を紐付ける
- (void)linkWithTwitterToken:(NSDictionary *)twitterInfo withBlock:(NCMBErrorResultBlock)block
Parameters
twitterInfo |
twitterの認証情報 |
---|---|
block |
既存のauthDataのtwitter情報のみ更新後実行されるblock。エラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– linkWithFacebookToken:withBlock:
ログイン中のユーザー情報に、facebookの認証情報を紐付ける
- (void)linkWithFacebookToken:(NSDictionary *)facebookInfo withBlock:(NCMBErrorResultBlock)block
Parameters
facebookInfo |
facebookの認証情報 |
---|---|
block |
既存のauthDataのfacebook情報のみ更新後実行されるblock。エラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– linkWithAppleToken:withBlock:
ログイン中のユーザー情報に、appleの認証情報を紐付ける
- (void)linkWithAppleToken:(NSDictionary *)appleInfo withBlock:(NCMBErrorResultBlock)block
Parameters
appleInfo |
appleの認証情報 |
---|---|
block |
既存のauthDataのapple情報のみ更新後実行されるblock。エラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
– isLinkedWith:
会員情報に、引数で指定したtypeの認証情報が含まれているか確認する
- (BOOL)isLinkedWith:(NSString *)type
Parameters
type |
認証情報のtype(googleもしくはtwitter、facebook、apple、anonymous) |
---|
Return Value
引数で指定したtypeの会員情報が含まれている場合はYESを返す
Declared In
NCMBUser.h
– unlink:withBlock:
会員情報から、引数で指定したtypeの認証情報を削除する
- (void)unlink:(NSString *)type withBlock:(NCMBErrorResultBlock)block
Parameters
type |
認証情報のtype(googleもしくはtwitter、facebook、apple、anonymous) |
---|---|
block |
エラー情報を返却するblock エラーがあればエラーのポインタが、なければnilが渡される。 |
Declared In
NCMBUser.h
mailAddressConfirm
– isMailAddressConfirm
メールアドレスが確認済みのものかを把握する
- (BOOL)isMailAddressConfirm
Return Value
メールアドレスが確認済みの場合はYESを返す
Declared In
NCMBUser.h