GCKRequest 類別

GCKRequest 類別參考資料

總覽

用於追蹤非同步要求的物件。

如要瞭解委派通訊協定,請參閱 GCKRequestDelegate

辛策
3.0

沿用 NSObject。

執行個體方法摘要

(void) - cancel
 取消要求。更多...
 
(void) - complete
 完成要求並通知委派對象。更多...
 
(void) - failWithError:
 將要求失敗並通知委派對象。更多...
 
(void) - abortWithReason:
 使用要求取消要求,並通知委派對象。更多...
 

類別方法摘要

(GCKRequest *) + applicationRequest
 建構 GCKRequest 物件,供呼叫應用程式使用。更多...
 

屬性摘要

id< GCKRequestDelegatedelegate
 用於接收要求狀態通知的委派對象。更多...
 
GCKRequestID requestID
 指派給這個請求的專屬 ID。更多...
 
GCKErrorerror
 導致要求失敗的錯誤 (如果有的話),否則傳回 nil更多...
 
BOOL inProgress
 指出要求是否正在處理中的標記。更多...
 
BOOL external
 這個標記指出這是外部要求,也就是由應用程式 (而非架構本身) 所建立的要求。更多...
 

方法說明

- (void) cancel

取消要求。

取消要求並不保證要求會在接收器上完成,只會讓傳送者停止追蹤要求。

+ (GCKRequest *) applicationRequest

建構 GCKRequest 物件,供呼叫應用程式使用。

應用程式可使用這個工廠方法建立的要求物件,使用 completefailWithError:abortWithReason: 方法來管理。

辛策
3.4
- (void) complete

完成要求並通知委派對象。

只有在應用程式使用 applicationRequest 工廠方法建構的 GCKRequest 物件上,才能呼叫這個方法。針對由架構本身建立的 GCKRequest 物件呼叫這個方法會引發例外狀況。

辛策
3.4
- (void) failWithError: (GCKError *)  error

將要求失敗並通知委派對象。

只有在應用程式使用 GCKRequest::requestWithID: 工廠方法建構的 GCKRequest 物件上,才能呼叫這個方法。針對由架構本身建立的 GCKRequest 物件呼叫這個方法會引發例外狀況。

Parameters
errorThe error describing the failure.
辛策
3.4
- (void) abortWithReason: (GCKRequestAbortReason)  reason

使用要求取消要求,並通知委派對象。

只有在應用程式使用 GCKRequest::requestWithID: 工廠方法建構的 GCKRequest 物件上,才能呼叫這個方法。針對由架構本身建立的 GCKRequest 物件呼叫這個方法會引發例外狀況。

Parameters
reasonThe reason for the abort.
辛策
3.4

資源詳細資料

- (id<GCKRequestDelegate>) delegate
readwritenonatomicweak

用於接收要求狀態通知的委派對象。

- (GCKRequestID) requestID
readnonatomicassign

指派給這個請求的專屬 ID。

- (GCKError*) error
readnonatomiccopy

導致要求失敗的錯誤 (如果有的話),否則傳回 nil

- (BOOL) inProgress
readnonatomicassign

指出要求是否正在處理中的標記。

- (BOOL) external
readnonatomicassign

這個標記指出這是外部要求,也就是由應用程式 (而非架構本身) 所建立的要求。

辛策
3.4