//
//  NSObject+XWAdd.h
//  BuguLive
//
//  Created by 岳克奎 on 16/9/1.
//  Copyright © 2016年 xfg. All rights reserved.
//

/*!
 1.作用：对KVO && Notification 一句话调用扩展
 2.使用 KVO：(销毁的时候其绑定的KVO会自己移除/主动把p=nil 也会使得KVO（name失效）)
 2.1  对象p                            p = [person new];
 2.2 对象属性 p.name  监听name的变化    [p xw_addObserverBlockForKeyPath:@"name"
 block:^(id obj, id oldVal, id newVal){
 NSLog(ASLocalizedString(@"kvo，修改name为%@"), newVal);}];
 2.3 修改anme的值
 
 3.使用通知：Noti （可对post宏定义）（FanweNotificationHeader）
 3.1 发通知                            [[NSNotificationCenter defaultCenter] postNotificationName:ASLocalizedString(@"通知名")object:nil
 userInfo:@{@"test" : @"1"}];
 3.2 收通知
 [self xw_addNotificationForName:ASLocalizedString(@"通知名")block:^(NSNotification *notification) {
 NSLog(ASLocalizedString(@"收到通知1：%@"), notification.userInfo); }];
 3.3不需要dealloc
 */

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface NSObject (XWAdd)

#pragma mark - KVO

/**
 *  通过Block方式注册一个KVO，通过该方式注册的KVO无需手动移除，其会在被监听对象销毁的时候自动移除,所以下面的两个移除方法一般无需使用
 *
 *  @param keyPath 监听路径
 *  @param block   KVO回调block，obj为监听对象，oldVal为旧值，newVal为新值
 */
- (void)xw_addObserverBlockForKeyPath:(NSString*)keyPath block:(void (^)(id obj, id oldVal, id newVal))block;

/**
 *  提前移除指定KeyPath下的BlockKVO(一般无需使用，如果需要提前注销KVO才需要)
 *
 *  @param keyPath 移除路径
 */
- (void)xw_removeObserverBlockForKeyPath:(NSString *)keyPath;

/**
 *  提前移除所有的KVOBlock(一般无需使用)
 */
- (void)xw_removeAllObserverBlocks;

#pragma mark - Notification

/**
 *  通过block方式注册通知，通过该方式注册的通知无需手动移除，同样会自动移除
 *
 *  @param name  通知名
 *  @param block 通知的回调Block，notification为回调的通知对象
 */
- (void)xw_addNotificationForName:(NSString *)name block:(void (^)(NSNotification *notification))block;

/**
 *  提前移除某一个name的通知
 *
 *  @param name 需要移除的通知名
 */
- (void)xw_removeNotificationForName:(NSString *)name;

/**
 *  提前移除所有通知
 */
- (void)xw_removeAllNotification;

/**
 *  发送一个通知
 *
 *  @param name     通知名
 *  @param userInfo 数据字典
 */
- (void)xw_postNotificationWithName:(NSString *)name userInfo:(nullable NSDictionary *)userInfo;

@end

NS_ASSUME_NONNULL_END