//
|
// TWTRMultipartFormDocument.h
|
// TwitterCore
|
//
|
// Created by Chase Latta on 8/19/15.
|
// Copyright (c) 2015 Twitter Inc. All rights reserved.
|
//
|
|
#import <Foundation/Foundation.h>
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
typedef void (^TWTRMultipartFormDocumentLoadDataCallback)(NSData *data);
|
|
@interface TWTRMultipartFormElement : NSObject
|
|
/**
|
* The name of the form element.
|
*/
|
@property (nonatomic, copy, readonly) NSString *name;
|
|
/**
|
* The content type of the form element.
|
*/
|
@property (nonatomic, copy, readonly) NSString *contentType;
|
|
/**
|
* An optional filename for this element.
|
*/
|
@property (nonatomic, copy, readonly, nullable) NSString *fileName;
|
|
/**
|
* The content's data.
|
*/
|
@property (nonatomic, copy, readonly) NSData *content;
|
|
/**
|
* Returns a fully initialized form element to be used in a multipart for document.
|
*
|
* @param name the name of the element
|
* @param contentType the elements content type
|
* @param fileName an optional file name
|
* @param content the data associated with this item
|
*/
|
- (instancetype)initWithName:(NSString *)name contentType:(NSString *)contentType fileName:(nullable NSString *)fileName content:(NSData *)content NS_DESIGNATED_INITIALIZER;
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
@end
|
|
/**
|
* A class representing a multipart form document.
|
*/
|
@interface TWTRMultipartFormDocument : NSObject
|
|
/**
|
* The forms boundary
|
*/
|
@property (nonatomic, copy, readonly) NSString *boundary;
|
|
/**
|
* Returns a value appropriate for the Content-Type header field
|
*/
|
@property (nonatomic, copy, readonly) NSString *contentTypeHeaderField;
|
|
/**
|
* Instantiates the document with the given elements.
|
*
|
* @param formElements the elements to append to this document
|
*/
|
- (instancetype)initWithFormElements:(NSArray *)formElements NS_DESIGNATED_INITIALIZER;
|
|
/**
|
* Asynchrounously loads the body data.
|
*
|
* @param callbackQueue the queue to invoke the handler on
|
* @param completion the completion block to call with the loaded data.
|
*/
|
- (void)loadBodyDataWithCallbackQueue:(dispatch_queue_t)callbackQueue completion:(TWTRMultipartFormDocumentLoadDataCallback)completion;
|
|
@end
|
|
NS_ASSUME_NONNULL_END
|
