iOS XMPP：电子名片细讲（五）

  // 电子名片相关模块头文件引入 #import "XMPPvCardTempModule.h" #import "XMPPvCardTemp.h" #import "XMPPvCardCoreDataStorage.h"   

  @interfaceXMPPvCardTemp: XMPPvCardTempBase   // 出生日期 @property (nonatomic, strong) NSDate *bday; // 照片 @property (nonatomic, strong) NSData *photo; // 昵称 @property (nonatomic, strong) NSString *nickname; // full name @property (nonatomic, strong) NSString *formattedName; @property (nonatomic, strong) NSString *familyName; @property (nonatomic, strong) NSString *givenName; @property (nonatomic, strong) NSString *middleName; @property (nonatomic, strong) NSString *prefix; @property (nonatomic, strong) NSString *suffix; // 地址数组 @property (nonatomic, strong) NSArray *addresses; // Represents the actual text that should be put on the mailing label when delivering a physical package to the person/object associated with the vCard (related to the ADR property). @property (nonatomic, strong) NSArray *labels;   @property (nonatomic, strong) NSArray *telecomsAddresses; @property (nonatomic, strong) NSArray *emailAddresses;   @property (nonatomic, strong) XMPPJID *jid; // 邮件 @property (nonatomic, strong) NSString *mailer; // 时区 @property (nonatomic, strong) NSTimeZone *timeZone; // 地埋位置 @property (nonatomic, strong) CLLocation *location; // 职位 @property (nonatomic, strong) NSString *title; // 角色。标准说明：The role, occupation, or business // category of the vCard object within an organization. @property (nonatomic, strong) NSString *role; // logo @property (nonatomic, strong) NSData *logo; // 标准定义：Information about another person who will act // on behalf of the vCard object. Typically this would // be an area administrator, assistant, or secretary // for the individual. Can be either a URL or an embedded vCard. @property (nonatomic, strong) XMPPvCardTemp *agent; // 组织 @property (nonatomic, strong) NSString *orgName;   /* * ORGUNITs can only be set if there is already an ORGNAME. Otherwise, changes are ignored. */ // 部门信息 @property (nonatomic, strong) NSArray *orgUnits; // A list of "tags" that can be used to describe the object represented by this vCard. // 也就是分类标签 @property (nonatomic, strong) NSArray *categories; // 电话 @property (nonatomic, strong) NSString *note; @property (nonatomic, strong) NSString *prodid; @property (nonatomic, strong) NSDate *revision; @property (nonatomic, strong) NSString *sortString; @property (nonatomic, strong) NSString *phoneticSound; @property (nonatomic, strong) NSData *sound; @property (nonatomic, strong) NSString *uid; // 个人网站URL @property (nonatomic, strong) NSString *url; // 电子名片版本 @property (nonatomic, strong) NSString *version; @property (nonatomic, strong) NSString *desc;   @property (nonatomic, assign) XMPPvCardTempClass privacyClass; @property (nonatomic, strong) NSData *key; @property (nonatomic, strong) NSString *keyType;   + (XMPPvCardTemp *)vCardTempFromElement:(NSXMLElement *)element; + (XMPPvCardTemp *)vCardTemp; + (XMPPvCardTemp *)vCardTempSubElementFromIQ:(XMPPIQ *)iq; + (XMPPvCardTemp *)vCardTempCopyFromIQ:(XMPPIQ *)iq; + (XMPPIQ *)iqvCardRequestForJID:(XMPPJID *)jid;     - (void)addAddress:(XMPPvCardTempAdr *)adr; - (void)removeAddress:(XMPPvCardTempAdr *)adr; - (void)clearAddresses;     - (void)addLabel:(XMPPvCardTempLabel *)label; - (void)removeLabel:(XMPPvCardTempLabel *)label; - (void)clearLabels;     - (void)addTelecomsAddress:(XMPPvCardTempTel *)tel; - (void)removeTelecomsAddress:(XMPPvCardTempTel *)tel; - (void)clearTelecomsAddresses;     - (void)addEmailAddress:(XMPPvCardTempEmail *)email; - (void)removeEmailAddress:(XMPPvCardTempEmail *)email; - (void)clearEmailAddresses;     @end   

  <?xmlversion="1.0" encoding="UTF-8"?> <vcardsxmlns="urn:ietf:params:xml:ns:vcard-4.0">   <vcard>     <tel>       <parameters>         <type>           <text>work</text>         </type>       </parameters>       <uri>tel:+1-111-555-1212</uri>     </tel>     <adr>       <parameters>         <type><text>work</text></type>         <label><text>100 Waters Edge                     Baytown, LA 30314                     United States ofAmerica</text></label>       </parameters>     </adr>     <email><text>forrestgump@example.com</text></email>   </vcard> </vcards>   

  @interfaceXMPPvCardCoreDataStorage: XMPPCoreDataStorage < XMPPvCardAvatarStorage, XMPPvCardTempModuleStorage>    + (instancetype)sharedInstance;   @end   

  @interfaceXMPPvCardTempModule: XMPPModule {     id <XMPPvCardTempModuleStorage> __strong_xmppvCardTempModuleStorage;     XMPPIDTracker *_myvCardTracker; }     @property(nonatomic, strong, readonly) id <XMPPvCardTempModuleStorage> xmppvCardTempModuleStorage; @property(nonatomic, strong, readonly) XMPPvCardTemp *myvCardTemp;   - (id)initWithvCardStorage:(id <XMPPvCardTempModuleStorage>)storage; - (id)initWithvCardStorage:(id <XMPPvCardTempModuleStorage>)storagedispatchQueue:(dispatch_queue_t)queue;   // 若本地没有该电子名片，则从服务器提求 - (void)fetchvCardTempForJID:(XMPPJID *)jid;   // 获取某个jid的电子名片，是否忽略本地所存储的电子名片 - (void)fetchvCardTempForJID:(XMPPJID *)jidignoreStorage:(BOOL)ignoreStorage;   // 获取某个jid的电子名片，是否自动从服务器提求 - (XMPPvCardTemp *)vCardTempForJID:(XMPPJID *)jidshouldFetch:(BOOL)shouldFetch;   // 这个API用于将电子名片存储到本地数据库，然后发送到服务器 - (void)updateMyvCardTemp:(XMPPvCardTemp *)vCardTemp;   @end     @protocol XMPPvCardTempModuleDelegate @optional   - (void)xmppvCardTempModule:(XMPPvCardTempModule *)vCardTempModule          didReceivevCardTemp:(XMPPvCardTemp *)vCardTemp                       forJID:(XMPPJID *)jid;   - (void)xmppvCardTempModuleDidUpdateMyvCard:(XMPPvCardTempModule *)vCardTempModule;   - (void)xmppvCardTempModule:(XMPPvCardTempModule *)vCardTempModulefailedToUpdateMyvCard:(NSXMLElement *)error;   @end     @protocol XMPPvCardTempModuleStorage <NSObject>   - (BOOL)configureWithParent:(XMPPvCardTempModule *)aParentqueue:(dispatch_queue_t)queue;   - (XMPPvCardTemp *)vCardTempForJID:(XMPPJID *)jidxmppStream:(XMPPStream *)stream;   - (void)setvCardTemp:(XMPPvCardTemp *)vCardTempforJID:(XMPPJID *)jidxmppStream:(XMPPStream *)stream;   - (XMPPvCardTemp *)myvCardTempForXMPPStream:(XMPPStream *)stream;   - (BOOL)shouldFetchvCardTempForJID:(XMPPJID *)jidxmppStream:(XMPPStream *)stream;   @end   

  // 电子名片数据存储 XMPPvCardCoreDataStorage *vCardStorage = [XMPPvCardCoreDataStorage sharedInstance];   // 添加电子名片模块 _vCardModule = [[XMPPvCardTempModule alloc]initWithvCardStorage: vCardStorage]; // 激活 [_vCardModuleactivate:_xmppStream];