64 lines
2.7 KiB
Objective-C
64 lines
2.7 KiB
Objective-C
//
|
|
// The MIT License (MIT)
|
|
// Copyright (c) 2019 Oleg Geier
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
// this software and associated documentation files (the "Software"), to deal in
|
|
// the Software without restriction, including without limitation the rights to
|
|
// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
// of the Software, and to permit persons to whom the Software is furnished to do
|
|
// so, subject to the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be included in all
|
|
// copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
// SOFTWARE.
|
|
|
|
@import Cocoa;
|
|
@class RSParsedFeed, RSHTMLMetadataFeedLink, Feed, FaviconDownload;
|
|
@protocol FeedDownloadDelegate;
|
|
|
|
/**
|
|
All properties will be parsed and stored in local variables.
|
|
This will avoid unnecessary core data operations if user decides to cancel the edit.
|
|
*/
|
|
@interface FeedDownload : NSObject
|
|
@property (readonly, nonnull) NSURLRequest *request;
|
|
@property (readonly, nullable) NSHTTPURLResponse* response;
|
|
@property (readonly, nullable) RSParsedFeed *xmlfeed;
|
|
@property (readonly, nullable) NSError *error;
|
|
@property (readonly, nullable) NSString *faviconURL;
|
|
|
|
typedef void (^FeedDownloadBlock)(FeedDownload *sender);
|
|
|
|
// Instantiation methods
|
|
+ (instancetype)withURL:(NSString*)url;
|
|
+ (instancetype)withFeed:(Feed*)feed forced:(BOOL)flag;
|
|
// Actions
|
|
- (instancetype)startWithDelegate:(id<FeedDownloadDelegate>)delegate;
|
|
- (instancetype)startWithBlock:(nonnull FeedDownloadBlock)block;
|
|
- (void)cancel;
|
|
- (BOOL)copyValuesTo:(nonnull Feed*)feed ignoreError:(BOOL)flag;
|
|
// Getter
|
|
- (FaviconDownload*)faviconDownload;
|
|
@end
|
|
|
|
|
|
|
|
/// Protocol for handling an in memory download
|
|
@protocol FeedDownloadDelegate <NSObject>
|
|
@optional
|
|
/// Delegate must return chosen URL. If not implemented, the first URL will be used.
|
|
- (NSString*)feedDownload:(FeedDownload*)sender selectFeedFromList:(NSArray<RSHTMLMetadataFeedLink*>*)list;
|
|
/// Only called if an URL redirect occured.
|
|
- (void)feedDownload:(FeedDownload*)sender urlRedirected:(NSString*)newURL;
|
|
/// Called after xml data is loaded and parsed. Called on error, but not if download is cancled.
|
|
- (void)feedDownloadDidFinish:(FeedDownload*)sender;
|
|
@end
|