好文章收藏夹

详细解析几个和网络请求有关的类(二十三) —— NSInputS

2018-03-19  本文已影响19人  刀客传奇

版本记录

版本号 时间
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

提供只读流功能的流。

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

NSInputStreamCore FoundationCFReadStreamRef“toll-free bridged”。 有关toll-free bridged的更多信息,请参阅Toll-Free Bridging


Subclassing Notes

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

Methods to Override - 要重写的方法

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


Topics

1. Creating Streams - 创建流

2. Using Streams - 使用流


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的基本信息和接口使用,喜欢的给个赞或者关注,谢谢~~~

上一篇下一篇

猜你喜欢

热点阅读