SimplePing

最新推荐文章于 2020-12-22 12:25:07 发布
最新推荐文章于 2020-12-22 12:25:07 发布
阅读量4.1k 收藏 3
点赞数

前言

手机网络连接状态的检测对于 iOS App 开发来说是一个非常基础的需求，在前一篇文章 苹果示例源码阅读：Reachability 我们介绍了如何通过 SCNetworkReachability 提供的一系列 C 函数 API 进行网络连接状态变化的监听。但事实上，此方案能获取的只是设备的本地连接状态，有时它很难为我们检测真正的网络连接状态，如以下场景：

  • 现在很多的公共场所的 WiFi，需要网页登录授权，授权之前无法上网，但本地连接已经建立；

  • 存在了本地网络连接，但信号很差，实际无法连接到服务器； 

  • iOS 连接的路由设备本身没有连接外网等。 

Ping

ping 是 Windows、Unix 、Linux 和 macOS 等系统下一个常用的命令，利用 ping 命令可以用来测试数据包 (ICMP) 能否通过 IP 协议到达特定主机，并收到主机的应答，以检查网络是否连通和网络连接速度，帮助我们分析和判定网络故障。

幸运的是，苹果为我们提供了示例源码：SimplePing，示范了在 iOS 或者 Mac 上如何用 Objective-C / Swift 实现 ping 操作，因此我们也可以通过 ping 来检查手机网络的真实连接状态。事实上，Github 上著名的第三方开源库 RealReachability 也是这么做的。

SimplePingHelper:是一个检测iPhone设备同服务器联通的助手类,是基于SimplePing再做的一层封装。

SimplePing源码阅读

对于 SimplePing 源码的阅读，我们将分为两部分来介绍。第一部分将结合 SimplePing.h 头文件里声明的方法，介绍如何使用 SimplePing 类封装的方法进行 ping 操作，第二部分（下一篇）将详细介绍 SimplePing.m 里各方法的具体实现细节。

类结构

通过 SimplePing.h 头文件中的声明，我们整理 SimplePing 的类结构如下图所示：

SimplePing1-1.png

?

下面我们一一介绍 SimplePing 类的各个属性、方法以及 delegate 回调方法的含义及作用。

初始化方法
  
- (instancetype)init NS_UNAVAILABLE;- (instancetype)initWithHostName:(NSString *)hostName NS_DESIGNATED_INITIALIZER;

SimplePing 中，禁用了 init 方法，只提供 initWithHostName: 一个方法，它可以初始化一个用于 ping 指定的主机实例对象。其中 hostName 参数可以是主机的 DNS 域名，或者是 IPv4、IPv6 地址的字符串形式。

属性
  
@property (nonatomic, copy, readonly) NSString * hostName;

  • hostName：只读，保存由初始化方法 initWithHostName: 传入的 ping 操作要连接的主机域名或 IP 地址。

  
@property (nonatomic, assign, readwrite) SimplePingAddressStyle addressStyle;

  • addressStyle：主机的 IP 地址类型，如 IPv4 或 IPv6 等，其中 SimplePingAddressStyle 枚举类型的定义如下：

  
typedef NS_ENUM(NSInteger, SimplePingAddressStyle) {SimplePingAddressStyleAny,    
// IPv4 或 IPv6SimplePingAddressStyleICMPv4, // IPv4SimplePingAddressStyleICMPv6  // IPv6};
  
@property (nonatomic, copy, readonly, nullable) NSData * hostAddress;

  • hostAddress：只读，在 start 方法调用之后，根据 hostName 得到的要 ping 的主机的 IP 地址，它是 struct sockaddr 形式的 NSData 数据。当 SimplePing 实例处于 stopped 状态，或者实例调用了 start 方法，但在 simplePing:didStartWithAddress:方法被调用之前，hostAddress 的值都是 nil。

  
@property (nonatomic, assign, readonly) sa_family_t hostAddressFamily;

  • hostAddressFamily：只读，hostAddress 的地址族，如果 hostAddress 为 nil，则其值为：AF_UNSPEC。

  
@property (nonatomic, assign, readonly) uint16_t identifier;

  • identifier：只读，当创建一个 SimplePing 实例对象时，会自动生成一个的随机的标识符，用来唯一标识当前 ping 对象。

  
@property (nonatomic, assign, readonly) uint16_t nextSequenceNumber;

  • nextSequenceNumber：只读，ping 每发送一次数据包都会有一个对应的序列号(sequence number)，此值为下一次 ping 操作要发送数据时的序列号，从 0 开始递增，当 ping 成功发送一次数据到主机并收到应答时，该值 +1。而对于本次 ping 的 sequence number在成功发送数据(request)和成功接收到响应(response)的 delegate 回调方法里都会以方法参数返回，以便进行 ping 操作耗时的计算等等。

  
@property (nonatomic, weak, readwrite, nullable) id delegate;

  • delegate：当前对象的回调，delegate 中的回调方法将在对象调用 start 方法所在的线程对应的 run loop 中以默认的 run loop model 执行。

实例方法
  
- (void)start;

  • start 方法：开始一个 ping 操作，在调用此方法前，必须给 SimplePing 实例对象的 delegete 以及其他参数赋值。当 start 方法成功执行时，会回调 delegate 中的 simplePing:didStartWithAddress: 方法，在该回调方法里，就可以通过 sendPingWithData: 开始发送 ICMP 数据包，并等待接受主机应答的数据包。另外需要注意的是，当一个实例已经 started，又一次调用此 start 方法会出错。

  
- (void)sendPingWithData:(nullable NSData *)data;

  • sendPingWithData: 方法：向主机发送特定格式的 ICMP 数据包，调用此方法前必须保证实例已经 started 并且要等待 simplePing:didStartWithAddress: 回调执行才能开始发送数据。参数 data 为要向主机发送的 ICMP 数据包，可以为 nil，默认会发一个标准的 64 byte 数据包。

  
- (void)stop;

  • stop 方法：当结束要 ping 操作时，调用此方法。与 start方法不同的是，当一个实例已经 stopped，再次调用此方法也没事。

delegate 回调方法

  • start 方法执行结果的回调:

  
// start 方法成功执行，可在此开始发送数据，其中 address 为主机的 IP 地址；
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address;
// start 方法执行失败，返回错误信息；
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error;

  • sendPingWithData: 方法执行结果的回调，每发送一次数据，都会同步地回调以下两个方法其中一个（除非你在发送途中调用了 stop 方法）：

  
// 成功发送 ICMP 数据包到指定主机，在此传回已发送的数据包以及本次 ping 对应的序列号；
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;
// 发送数据失败，并返回错误信息，绝大部分原因由于 hostName 解析失败。另，当此方法调用时，ping 实例状态会自动转为 `stopped`，不用再显示调用 `stop` 方法；
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error;

  • 接收到主机返回应答数据的回调：

  
// 成功接收到主机回传的与之前发送相匹配的 ICMP 数据包；
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;
// 收到的未知的数据包。
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet;

注：以上回调方法中的 packet 数据包只包含了 ICMP header 和 sendPingWithData: 中传入的数据，但不包含任何 IP 层的 header。

使用流程

根据苹果提供的 Demo，我们梳理了一下使用 SimplePing 类进行 ping 操作的流程如下图所示：

SimplePing2.png

?

根据上图，我们写了一个简单的使用示例，详见下面代码以及注释，不再赘述。

  
#import "ViewController.h"
#import "SimplePing.h"
@interface ViewController () 
@property (nonatomic, strong) SimplePing *pinger;
@end
@implementation ViewController
- (void)viewDidLoad {[super viewDidLoad];// 
  //(1)初始化一个 SimplePing 实例，注意，这个 pinger 实例不能为临时变量，不然当前函数执行完毕后，pinger 实例就会被释放，那么它的 delegate 将不会执行。
  self.pinger = [[SimplePing alloc] initWithHostName:@"www.apple.com"];
   // (2) 指定 pinger 的 delegate
   self.pinger.delegate = self;
   // 指定要 ping 的 IP 地址的类型
   self.pinger.addressStyle = SimplePingAddressStyleICMPv4;
  // (3)// 调用 start 方法开始 
   ping[self.pinger start];
}
#pragma mark - SimplePingDelegate
// (4) start 方法成功执行，可开始发送数据
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address {
  NSLog(@"address: %@", address);
  // (5) 调用 sendPingWithData: 方法发送数据
  [pinger sendPingWithData:nil]; 
  // data 可传入 nil，此时 ping 发送的数据会有一个默认值。

}
// (4) start 方法执行失败，返回错误信息
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error {
  NSLog(@"%@", error.localizedDescription);
}
#pragma mark -
// (6) 成功发送数据
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {
  NSLog(@"didSendPacket: %@", packet);
  NSLog(@"identifier: %d", pinger.identifier);
  NSLog(@"sequenceNumber: %d", sequenceNumber);
  NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);
}

// (6) 发送数据失败
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error {
  NSLog(@"didFailToSendPacket: %@", error.localizedDescription);
}

#pragma mark -
// (7) 成功接收到之前 pinger 发送的数据
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {
  NSLog(@"didReceivePingResponsePacket: %@", packet);NSLog(@"identifier: %d", pinger.identifier);
  NSLog(@"sequenceNumber: %d", sequenceNumber);
  NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);
}
// (7) 接收到到未知的数据
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet {
  NSLog(@"didReceiveUnexpectedPacket: %@", packet);
}

总结

本篇文章介绍了如何使用苹果提供的示例源码 SimplePing 类初始化一个实例在 iOS 设备上进行 ping 操作，以进行判断网络真实连接状态。

源码阅读

对于 SimplePing 源码的阅读，我们将分为两部分来介绍。第一部分将结合 SimplePing.h 头文件里声明的方法，介绍如何使用 SimplePing 类封装的方法进行 ping 操作，第二部分（下一篇）将详细介绍 SimplePing.m 里各方法的具体实现细节。

类结构

通过 SimplePing.h 头文件中的声明，我们整理 SimplePing 的类结构如下图所示：

SimplePing1-1.png

?

下面我们一一介绍 SimplePing 类的各个属性、方法以及 delegate 回调方法的含义及作用。

初始化方法
  
- (instancetype)init NS_UNAVAILABLE;- (instancetype)initWithHostName:(NSString *)hostName NS_DESIGNATED_INITIALIZER;

SimplePing 中，禁用了 init 方法，只提供 initWithHostName: 一个方法，它可以初始化一个用于 ping 指定的主机实例对象。其中 hostName 参数可以是主机的 DNS 域名，或者是 IPv4、IPv6 地址的字符串形式。

属性
  
@property (nonatomic, copy, readonly) NSString * hostName;

  • hostName：只读，保存由初始化方法 initWithHostName: 传入的 ping 操作要连接的主机域名或 IP 地址。

  
@property (nonatomic, assign, readwrite) SimplePingAddressStyle addressStyle;

  • addressStyle：主机的 IP 地址类型，如 IPv4 或 IPv6 等，其中 SimplePingAddressStyle 枚举类型的定义如下：

  
typedef NS_ENUM(NSInteger, SimplePingAddressStyle) {SimplePingAddressStyleAny,    
// IPv4 或 IPv6SimplePingAddressStyleICMPv4, // IPv4SimplePingAddressStyleICMPv6  // IPv6};
  
@property (nonatomic, copy, readonly, nullable) NSData * hostAddress;

  • hostAddress：只读，在 start 方法调用之后，根据 hostName 得到的要 ping 的主机的 IP 地址，它是 struct sockaddr 形式的 NSData 数据。当 SimplePing 实例处于 stopped 状态，或者实例调用了 start 方法，但在 simplePing:didStartWithAddress:方法被调用之前，hostAddress 的值都是 nil。

  
@property (nonatomic, assign, readonly) sa_family_t hostAddressFamily;

  • hostAddressFamily：只读，hostAddress 的地址族，如果 hostAddress 为 nil，则其值为：AF_UNSPEC。

  
@property (nonatomic, assign, readonly) uint16_t identifier;

  • identifier：只读，当创建一个 SimplePing 实例对象时，会自动生成一个的随机的标识符，用来唯一标识当前 ping 对象。

  
@property (nonatomic, assign, readonly) uint16_t nextSequenceNumber;

  • nextSequenceNumber：只读，ping 每发送一次数据包都会有一个对应的序列号(sequence number)，此值为下一次 ping 操作要发送数据时的序列号，从 0 开始递增，当 ping 成功发送一次数据到主机并收到应答时，该值 +1。而对于本次 ping 的 sequence number在成功发送数据(request)和成功接收到响应(response)的 delegate 回调方法里都会以方法参数返回，以便进行 ping 操作耗时的计算等等。

  
@property (nonatomic, weak, readwrite, nullable) id delegate;

  • delegate：当前对象的回调，delegate 中的回调方法将在对象调用 start 方法所在的线程对应的 run loop 中以默认的 run loop model 执行。

实例方法
  
- (void)start;

  • start 方法：开始一个 ping 操作，在调用此方法前，必须给 SimplePing 实例对象的 delegete 以及其他参数赋值。当 start 方法成功执行时，会回调 delegate 中的 simplePing:didStartWithAddress: 方法，在该回调方法里，就可以通过 sendPingWithData: 开始发送 ICMP 数据包，并等待接受主机应答的数据包。另外需要注意的是，当一个实例已经 started，又一次调用此 start 方法会出错。

  
- (void)sendPingWithData:(nullable NSData *)data;

  • sendPingWithData: 方法：向主机发送特定格式的 ICMP 数据包，调用此方法前必须保证实例已经 started 并且要等待 simplePing:didStartWithAddress: 回调执行才能开始发送数据。参数 data 为要向主机发送的 ICMP 数据包，可以为 nil，默认会发一个标准的 64 byte 数据包。

  
- (void)stop;

  • stop 方法：当结束要 ping 操作时，调用此方法。与 start方法不同的是，当一个实例已经 stopped，再次调用此方法也没事。

delegate 回调方法

  • start 方法执行结果的回调:

  
// start 方法成功执行，可在此开始发送数据，其中 address 为主机的 IP 地址；
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address;
// start 方法执行失败，返回错误信息；
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error;

  • sendPingWithData: 方法执行结果的回调，每发送一次数据，都会同步地回调以下两个方法其中一个（除非你在发送途中调用了 stop 方法）：

  
// 成功发送 ICMP 数据包到指定主机，在此传回已发送的数据包以及本次 ping 对应的序列号；
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;
// 发送数据失败，并返回错误信息，绝大部分原因由于 hostName 解析失败。另，当此方法调用时，ping 实例状态会自动转为 `stopped`，不用再显示调用 `stop` 方法；
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error;

  • 接收到主机返回应答数据的回调：

  
// 成功接收到主机回传的与之前发送相匹配的 ICMP 数据包；
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;
// 收到的未知的数据包。
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet;

注：以上回调方法中的 packet 数据包只包含了 ICMP header 和 sendPingWithData: 中传入的数据，但不包含任何 IP 层的 header。

使用流程

根据苹果提供的 Demo，我们梳理了一下使用 SimplePing 类进行 ping 操作的流程如下图所示：

SimplePing2.png

?

根据上图，我们写了一个简单的使用示例，详见下面代码以及注释，不再赘述。

  
#import "ViewController.h"
#import "SimplePing.h"
@interface ViewController () 
@property (nonatomic, strong) SimplePing *pinger;
@end
@implementation ViewController
- (void)viewDidLoad {[super viewDidLoad];// 
  //(1)初始化一个 SimplePing 实例，注意，这个 pinger 实例不能为临时变量，不然当前函数执行完毕后，pinger 实例就会被释放，那么它的 delegate 将不会执行。
  self.pinger = [[SimplePing alloc] initWithHostName:@"www.apple.com"];
   // (2) 指定 pinger 的 delegate
   self.pinger.delegate = self;
   // 指定要 ping 的 IP 地址的类型
   self.pinger.addressStyle = SimplePingAddressStyleICMPv4;
  // (3)// 调用 start 方法开始 
   ping[self.pinger start];
}
#pragma mark - SimplePingDelegate
// (4) start 方法成功执行，可开始发送数据
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address {
  NSLog(@"address: %@", address);
  // (5) 调用 sendPingWithData: 方法发送数据
  [pinger sendPingWithData:nil]; 
  // data 可传入 nil，此时 ping 发送的数据会有一个默认值。

}
// (4) start 方法执行失败，返回错误信息
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error {
  NSLog(@"%@", error.localizedDescription);
}
#pragma mark -
// (6) 成功发送数据
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {
  NSLog(@"didSendPacket: %@", packet);
  NSLog(@"identifier: %d", pinger.identifier);
  NSLog(@"sequenceNumber: %d", sequenceNumber);
  NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);
}

// (6) 发送数据失败
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error {
  NSLog(@"didFailToSendPacket: %@", error.localizedDescription);
}

#pragma mark -
// (7) 成功接收到之前 pinger 发送的数据
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {
  NSLog(@"didReceivePingResponsePacket: %@", packet);NSLog(@"identifier: %d", pinger.identifier);
  NSLog(@"sequenceNumber: %d", sequenceNumber);
  NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);
}
// (7) 接收到到未知的数据
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet {
  NSLog(@"didReceiveUnexpectedPacket: %@", packet);
}

总结

本篇文章介绍了如何使用苹果提供的示例源码 SimplePing 类初始化一个实例在 iOS 设备上进行 ping 操作，以进行判断网络真实连接状态。



SimplePing 源码阅读

对于 SimplePing 源码的阅读，我们将分为两部分来介绍。第一部分将结合 SimplePing.h 头文件里声明的方法，介绍如何使用 SimplePing 类封装的方法进行 ping 操作，第二部分（下一篇）将详细介绍 SimplePing.m 里各方法的具体实现细节。

类结构

通过 SimplePing.h 头文件中的声明，我们整理 SimplePing 的类结构如下图所示：

SimplePing1-1.png

?

下面我们一一介绍 SimplePing 类的各个属性、方法以及 delegate 回调方法的含义及作用。

初始化方法
  
- (instancetype)init NS_UNAVAILABLE;- (instancetype)initWithHostName:(NSString *)hostName NS_DESIGNATED_INITIALIZER;

SimplePing 中，禁用了 init 方法，只提供 initWithHostName: 一个方法，它可以初始化一个用于 ping 指定的主机实例对象。其中 hostName 参数可以是主机的 DNS 域名，或者是 IPv4、IPv6 地址的字符串形式。

属性
  
@property (nonatomic, copy, readonly) NSString * hostName;

  • hostName：只读，保存由初始化方法 initWithHostName: 传入的 ping 操作要连接的主机域名或 IP 地址。

  
@property (nonatomic, assign, readwrite) SimplePingAddressStyle addressStyle;

  • addressStyle：主机的 IP 地址类型，如 IPv4 或 IPv6 等，其中 SimplePingAddressStyle 枚举类型的定义如下：

  
typedef NS_ENUM(NSInteger, SimplePingAddressStyle) {SimplePingAddressStyleAny,    
// IPv4 或 IPv6SimplePingAddressStyleICMPv4, // IPv4SimplePingAddressStyleICMPv6  // IPv6};
  
@property (nonatomic, copy, readonly, nullable) NSData * hostAddress;

  • hostAddress：只读，在 start 方法调用之后，根据 hostName 得到的要 ping 的主机的 IP 地址，它是 struct sockaddr 形式的 NSData 数据。当 SimplePing 实例处于 stopped 状态，或者实例调用了 start 方法，但在 simplePing:didStartWithAddress:方法被调用之前，hostAddress 的值都是 nil。

  
@property (nonatomic, assign, readonly) sa_family_t hostAddressFamily;

  • hostAddressFamily：只读，hostAddress 的地址族，如果 hostAddress 为 nil，则其值为：AF_UNSPEC。

  
@property (nonatomic, assign, readonly) uint16_t identifier;

  • identifier：只读，当创建一个 SimplePing 实例对象时，会自动生成一个的随机的标识符，用来唯一标识当前 ping 对象。

  
@property (nonatomic, assign, readonly) uint16_t nextSequenceNumber;

  • nextSequenceNumber：只读，ping 每发送一次数据包都会有一个对应的序列号(sequence number)，此值为下一次 ping 操作要发送数据时的序列号，从 0 开始递增，当 ping 成功发送一次数据到主机并收到应答时，该值 +1。而对于本次 ping 的 sequence number在成功发送数据(request)和成功接收到响应(response)的 delegate 回调方法里都会以方法参数返回，以便进行 ping 操作耗时的计算等等。

  
@property (nonatomic, weak, readwrite, nullable) id delegate;

  • delegate：当前对象的回调，delegate 中的回调方法将在对象调用 start 方法所在的线程对应的 run loop 中以默认的 run loop model 执行。

实例方法
  
- (void)start;

  • start 方法：开始一个 ping 操作，在调用此方法前，必须给 SimplePing 实例对象的 delegete 以及其他参数赋值。当 start 方法成功执行时，会回调 delegate 中的 simplePing:didStartWithAddress: 方法，在该回调方法里，就可以通过 sendPingWithData: 开始发送 ICMP 数据包，并等待接受主机应答的数据包。另外需要注意的是，当一个实例已经 started，又一次调用此 start 方法会出错。

  
- (void)sendPingWithData:(nullable NSData *)data;

  • sendPingWithData: 方法：向主机发送特定格式的 ICMP 数据包，调用此方法前必须保证实例已经 started 并且要等待 simplePing:didStartWithAddress: 回调执行才能开始发送数据。参数 data 为要向主机发送的 ICMP 数据包，可以为 nil，默认会发一个标准的 64 byte 数据包。

  
- (void)stop;

  • stop 方法：当结束要 ping 操作时，调用此方法。与 start方法不同的是，当一个实例已经 stopped，再次调用此方法也没事。

delegate 回调方法

  • start 方法执行结果的回调:

  
// start 方法成功执行，可在此开始发送数据，其中 address 为主机的 IP 地址；
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address;
// start 方法执行失败，返回错误信息；
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error;

  • sendPingWithData: 方法执行结果的回调，每发送一次数据，都会同步地回调以下两个方法其中一个（除非你在发送途中调用了 stop 方法）：

  
// 成功发送 ICMP 数据包到指定主机，在此传回已发送的数据包以及本次 ping 对应的序列号；
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;
// 发送数据失败，并返回错误信息，绝大部分原因由于 hostName 解析失败。另，当此方法调用时，ping 实例状态会自动转为 `stopped`，不用再显示调用 `stop` 方法；
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error;

  • 接收到主机返回应答数据的回调：

  
// 成功接收到主机回传的与之前发送相匹配的 ICMP 数据包；
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;
// 收到的未知的数据包。
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet;

注：以上回调方法中的 packet 数据包只包含了 ICMP header 和 sendPingWithData: 中传入的数据，但不包含任何 IP 层的 header。

使用流程

根据苹果提供的 Demo，我们梳理了一下使用 SimplePing 类进行 ping 操作的流程如下图所示：

SimplePing2.png

?

根据上图，我们写了一个简单的使用示例，详见下面代码以及注释，不再赘述。

  
#import "ViewController.h"
#import "SimplePing.h"
@interface ViewController () 
@property (nonatomic, strong) SimplePing *pinger;
@end
@implementation ViewController
- (void)viewDidLoad {[super viewDidLoad];// 
  //(1)初始化一个 SimplePing 实例，注意，这个 pinger 实例不能为临时变量，不然当前函数执行完毕后，pinger 实例就会被释放，那么它的 delegate 将不会执行。
  self.pinger = [[SimplePing alloc] initWithHostName:@"www.apple.com"];
   // (2) 指定 pinger 的 delegate
   self.pinger.delegate = self;
   // 指定要 ping 的 IP 地址的类型
   self.pinger.addressStyle = SimplePingAddressStyleICMPv4;
  // (3)// 调用 start 方法开始 
   ping[self.pinger start];
}
#pragma mark - SimplePingDelegate
// (4) start 方法成功执行，可开始发送数据
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address {
  NSLog(@"address: %@", address);
  // (5) 调用 sendPingWithData: 方法发送数据
  [pinger sendPingWithData:nil]; 
  // data 可传入 nil，此时 ping 发送的数据会有一个默认值。

}
// (4) start 方法执行失败，返回错误信息
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error {
  NSLog(@"%@", error.localizedDescription);
}
#pragma mark -
// (6) 成功发送数据
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {
  NSLog(@"didSendPacket: %@", packet);
  NSLog(@"identifier: %d", pinger.identifier);
  NSLog(@"sequenceNumber: %d", sequenceNumber);
  NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);
}

// (6) 发送数据失败
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error {
  NSLog(@"didFailToSendPacket: %@", error.localizedDescription);
}

#pragma mark -
// (7) 成功接收到之前 pinger 发送的数据
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber {
  NSLog(@"didReceivePingResponsePacket: %@", packet);NSLog(@"identifier: %d", pinger.identifier);
  NSLog(@"sequenceNumber: %d", sequenceNumber);
  NSLog(@"nextSequenceNumber: %d", pinger.nextSequenceNumber);
}
// (7) 接收到到未知的数据
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet {
  NSLog(@"didReceiveUnexpectedPacket: %@", packet);
}

总结

本篇文章介绍了如何使用苹果提供的示例源码 SimplePing 类初始化一个实例在 iOS 设备上进行 ping 操作，以进行判断网络真实连接状态。

Mr_ZNN
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
SimplePing的使用
Learner_Sky的博客
03-22 4525
SimplePing是苹果封装好的关于Ping的类，研究wifi的时候顺带研究下这个类，关于什么是ping以及一些基本用法可以翻看我的博客。下面切入主题： SimplePing是一个封装低层级的BSD Sockets ping函数的类。 使用这个类创建实例，设置委托然后调用 -start 方法开始在当前的run loop(运行循环)中。 如果顺利的话你很快就会得到 -simplePi
SimplePing:用于Linux OS的Ping工具的简单实现
05-09
Simple Implementation of Ping tool for Linux OS Linux ping命令用于检测主机。 执行ping指令会使用ICMP传输协议，发出要求回应的信息，若远端主机的网络功能没有问题，就会回应该信息，因而得知该主机运作正常。 语法 ping [-dfnqrRv][-c<完成次数>][-i<间隔秒数>][-I<网络界面>][-l<前置载入>][-p<范本样式>][-s<数据包大小>][-t<存活数值>][主机名称或IP地址] 参数说明： -c<完成次数> 设置完成要求回应的次数。 -f 极限检测。 -i<间隔秒数> 指定收发信息的间隔时间。 -n 只输出数值。 -p<范本样式> 设置填满数据包的范本样式。 -q 不显示指令执行过程，开头和结尾的相关信息除外。 -r 忽略普通的Routing Table，直接将数据包送到远端主机上。 -R 记录路由过程
IOS 一个ping的例子 simplePing
比尔丁子
02-20 8461
https://github.com/chrishulbert/SimplePingHelper
swift-iOS端的一个ping网络工具采用了苹果官方提供的SimplePingdemo
08-15
iOS端的一个ping网络工具，采用了苹果官方提供的SimplePingdemo
ios学习笔记---simpleping
03-27
"SimplePing"是一个用于实现ping功能的简单示例，它是苹果官方提供的Cocoa框架，主要用于检测网络连通性。这个"ios学习笔记---simpleping"旨在帮助初学者理解如何在iOS应用中实现简单的网络探测功能。 SimplePing是...
swift-SimpleBS.swift-简单网络Ping和Traceroute工具
08-15
Swift语言在IT行业中被广泛用于开发高性能、跨平台的应用程序，尤其在iOS和macOS的开发中占据主导地位。在给定的标题"swift-SimpleBS.swift-简单网络Ping和Traceroute工具"中，我们可以了解到这是一个使用Swift编程...
STPingTest.zip
06-27
场景： 获取当前网络状态下特定地址的网络延迟，也...SimplePing的使用,参考了如下 https://blog.csdn.net/learner_sky/article/details/64615516 其实个人感觉此Demo最有价值的是我对代码的注释，便于理解本质使用。
SimplePingHelper--检测服务器连接
zhuzhiyongai的专栏
05-18 760
SimplePingHelper--检测服务器连接并获取设备的ip地址，检测当前设备网络是否可用
Swift和C混合Socket编程实现简单的ping命令&主机发现
weixin_30755393的博客
01-14 464
Swift和C混合Socket编程实现简单的ping命令 这个是用Mac下的Network Utility工具实现ping命令,用Wireshark抓取的ICMP数据包: 发送ICMP数据包内容 接受ICMP数据包内容 一.icmp结构 要真正了解ping命令实现原理，就要了解ping命令所使用到的TCP/IP协议。ICMP(Internet Control M...
C# PING小工具(除了科来ping就是这个了)
05-12
在网络不稳定时，经常会通过PING来看网速！自作了C#PING工具。 主要功能： ping 指定网址或IP。自动记录ping的信息，下次启动自动开启。 显示当前ping值和平均ping值。还有连接失败的错误率。 可选中列表，使用CTRL + C 键复制ping的结果。 界面如下： 工具下载：http://files.cnblogs.com/zjfree/NetPing.rar 源码下载：http://files.cnblogs.com/zjfree/NetPing_src.rar 开发环境：WIN2003 + VS2005 + .NET2.0 + C#
SwiftyPing:Swift 5的ICMP Ping客户端
05-01
SwiftyPing Swift 5的ICMP Ping客户端 SwiftyPing是易于使用的一个文件ICMP ping客户端 该项目基于SwiftPing： : 。 用法 // Ping indefinitely let pinger = try ? SwiftyPing ( host : " 1.1.1.1 " , configuration : PingConfiguration ( interval : 0.5 , with : 5 ), queue : DispatchQueue. global ()) pinger ? . observer = { (response) in let duration = response. duration print (duration) } try ? pinger ? . startPinging () // P
swift-iOSping(ICMP)网络测试demo
08-15
iOS ping(ICMP)网络测试demo，用于在iOS中比较多个地址的丢包率、延迟
iOS下实现ping功能
06-10
iOS下实现ping功能的一个小小demo，希望对大家有帮助
android simple github 官网地址
langwang2的专栏
12-08 577
1  https://github.com/googlesamples
ios ping服务器
gcs的博客
12-22 1653
大多数App都严重依赖于网络,一款用户体验良好的的app是必须要考虑网络状态变化的.iOSSinger下一般使用Reachability这个类来检测网络的变化. Reachability 这个是苹果开发文档里面的一个类,官方写的,用来判断网络的变化,包括无网络,wifi,和蜂窝三种情况.Reachability类实际上是苹果公司对SCNetworkReachability API的封装,使用方法比较简单,这里不再介绍.说说它的优缺点: 优点 使用简单,只有一个类,官方还有Demo,容易上手 ...
iOS计算网络测试中的丢包率，延迟，下载速度等参数、iOS实现ping
热门推荐
yingms的专栏
05-29 1万+
这段时间公司iOS的网络测试的项目。 首先，对我最不好做的模块Ping，这网上找了很久的资料都指向SimplePing这个源代码，SimplePing是由Apple提供的官方代码，官方下载地址：SimplePing，这里有一个对SimplePing进行封装的Demo，但是这个demo只能告诉用户ping的结果，即ping成功还是Ping失败了，不能像在Mac的终端和win的CMD命令行中显示pi
Swift 4.0 网络状态检测
jacob_ios的博客
04-13 6109
使用Alamofire中`NetworkReachabilityManager`实现class func currentNetReachability() { let manager = NetworkReachabilityManager() manager?.listener = { status in var statusStr: St...
JAVA实践期末复习题.docx
最新发布
07-10
JAVA实践期末复习题.docx

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值