版本记录

版本号	时间
V1.0	2018.03.19

前言

我们做APP发起网络请求，一般都是使用框架，这些框架的底层也都是苹果的API，接下来几篇就一起来看一下和网络有关的几个类。感兴趣的可以看上面几篇文章。
1. 详细解析几个和网络请求有关的类 （一） —— NSURLSession
2. 详细解析几个和网络请求有关的类（二） —— NSURLRequest和NSMutableURLRequest
3. 详细解析几个和网络请求有关的类（三） —— NSURLConnection
4. 详细解析几个和网络请求有关的类（四） —— NSURLSession和NSURLConnection的区别
5. 详细解析几个和网络请求有关的类（五） —— 关于NSURL加载系统（一）
6. 详细解析几个和网络请求有关的类（六） —— 使用NSURLSession（二）
7. 详细解析几个和网络请求有关的类（七） —— URL数据的编码和解码（三）
8. 详细解析几个和网络请求有关的类（八） —— 处理重定向和其他请求更改（四）
9. 详细解析几个和网络请求有关的类（九） —— 身份验证挑战和TLS链验证（五）
10. 详细解析几个和网络请求有关的类（十） —— 理解获取缓存（六）
11. 详细解析几个和网络请求有关的类（十一） —— Cookies和自定义协议（七）
12. 详细解析几个和网络请求有关的类（十二） —— URL Session的生命周期（八）
13. 详细解析几个和网络请求有关的类（十三） —— NSURLResponse（一）
14. 详细解析几个和网络请求有关的类（十四） —— NSHTTPCookie（一）
15. 详细解析几个和网络请求有关的类（十五） —— NSHTTPCookieStorage（一）
16. 详细解析几个和网络请求有关的类（十六） —— NSURLCache（一）
17. 详细解析几个和网络请求有关的类（十七） —— NSCachedURLResponse（一）
18. 详细解析几个和网络请求有关的类（十八） —— NSURLAuthenticationChallenge（一）
19. 详细解析几个和网络请求有关的类（十九） —— NSURLProtectionSpace（一）
20. 详细解析几个和网络请求有关的类（二十） —— NSURLCredential（一）
21. 详细解析几个和网络请求有关的类（二十一） —— NSURLCredentialStorage（一）
22. 详细解析几个和网络请求有关的类（二十二） —— NSStream（一）

回顾

上一篇讲述了NSStream这个类的详细信息以及一些注意要点，下面这篇我们就主要看一下NSInputStream。

---

Overview

提供只读流功能的流。

下面看一下该类的基本信息。

NSInputStream与Core Foundation的CFReadStreamRef是“toll-free bridged”。 有关toll-free bridged的更多信息，请参阅Toll-Free Bridging。

---

Subclassing Notes

NSInputStream是由NSStream的具体子类组成的类集群的抽象超类，它为流数据提供标准的只读访问权限。 虽然NSInputStream对于需要访问流数据的大多数情况来说可能已足够，但是如果您需要更专业化的行为（例如，您想要记录流中数据的统计信息），则可以创建NSInputStream的子类。

Methods to Override - 要重写的方法

要创建NSInputStream的子类，您可能必须为所支持的流数据类型实现初始化器，并适当地重新实现现有的初始化器。 您还必须提供以下方法的完整实现：

• read:maxLength:

  • 从当前读索引开始，从流中获取第二个参数中指定的字节数，并将它们放在客户端提供的缓冲区（第一个参数）中。 缓冲区必须是第二个参数指定的大小。 返回放置在缓冲区中的实际字节数; 如果流中没有任何内容，则返回0。将索引重置到流中以进行下一次读取操作。

• getBuffer:length:

  • 返回0（1）指向子类分配缓冲区（第一个参数）的指针。 在第二个参数中通过引用返回实际放入缓冲区的字节数。 缓冲区的内容仅在下一个流操作之前有效。 如果无法访问缓冲区中的数据，则返回NO; 否则，返回YES。 如果此方法不适合您的流类型，则可能会返回NO。

• hasBytesAvailable

  • 如果流中有更多数据要读取，则返回YES，否则返回NO。 如果你想在语义上与NSInputStream兼容，如果必须尝试读取确定字节是否可用，则返回YES。

---

Topics

1. Creating Streams - 创建流

• + inputStreamWithData:

  • 从给定的NSData对象读取，创建并返回一个初始化的NSInputStream对象。

• + inputStreamWithFileAtPath:

  • 从给定的路径的文件中读取，创建并返回一个初始化的NSInputStream对象。

• + inputStreamWithURL:

  • 从给定URL的文件中读取，创建并返回一个初始化的NSInputStream对象。

• - initWithData:

  • 从给定的NSData对象读取，初始化并返回一个NSInputStream对象。

• - initWithFileAtPath:

  • 从给定的路径的文件中读取数据，初始化并返回一个NSInputStream对象。

• - initWithURL:

  • 从给定URL的文件中读取数据，初始化并返回一个NSInputStream对象。

2. Using Streams - 使用流

• - read:maxLength:

  • 将给定数量的字节数读到给定缓冲区。

• - getBuffer:length:

  • 通过引用返回指向读缓冲区的指针，并通过引用返回可用字节数，并返回一个布尔值，指示缓冲区是否可用。

• hasBytesAvailable

  • 一个布尔值，指示接收者是否有可读取的字节。

---

API

1. NSInputStream本类

NSInputStream是一个表示读取流的基本功能的抽象类，子类需要实现这些方法。

// NSInputStream is an abstract class representing the base functionality of a read stream.
// Subclassers are required to implement these methods.
@interface NSInputStream : NSStream

// 将长度字节读入所提供的缓冲区，该缓冲区的大小必须至少为len。 返回读取的实际字节数。
- (NSInteger)read:(uint8_t *)buffer maxLength:(NSUInteger)len;
    // reads up to length bytes into the supplied buffer, which must be at least of size len. Returns the actual number of bytes read.

// 在O（1）中返回一个指向'buffer'中的缓冲区的指针，并且通过'len'中的引用返回可用的字节数。 
// 该缓冲区仅在下一个流操作之前有效。 如果不适合流类型，子类可能会返回NO。 如果缓冲区不可用，
// 这可能会返回NO
- (BOOL)getBuffer:(uint8_t * _Nullable * _Nonnull)buffer length:(NSUInteger *)len;
    // returns in O(1) a pointer to the buffer in 'buffer' and by reference in 'len' how many bytes are available. This buffer is only valid until the next stream operation. Subclassers may return NO for this if it is not appropriate for the stream type. This may return NO if the buffer is not available.

@property (readonly) BOOL hasBytesAvailable;
    // returns YES if the stream has bytes available or if it impossible to tell without actually doing the read.

- (instancetype)initWithData:(NSData *)data NS_DESIGNATED_INITIALIZER;
- (nullable instancetype)initWithURL:(NSURL *)url API_AVAILABLE(macos(10.6), ios(4.0), watchos(2.0), tvos(9.0)) NS_DESIGNATED_INITIALIZER;

@end

2. NSInputStream分类NSInputStreamExtensions

// The NSInputStreamExtensions category contains additional initializers and convenience routines for dealing with NSInputStreams.
// NSInputStreamExtensions类别包含用于处理NSInputStreams的附加初始化程序和便利例程

@interface NSInputStream (NSInputStreamExtensions)

- (nullable instancetype)initWithFileAtPath:(NSString *)path;

+ (nullable instancetype)inputStreamWithData:(NSData *)data;
+ (nullable instancetype)inputStreamWithFileAtPath:(NSString *)path;
+ (nullable instancetype)inputStreamWithURL:(NSURL *)url API_AVAILABLE(macos(10.6), ios(4.0), watchos(2.0), tvos(9.0));

@end

后记

本篇主要讲述了类NSInputStream的基本信息和接口使用，喜欢的给个赞或者关注，谢谢~~~