MediaWikiDownload saves a remote file to local storage. More...

#import <MediaWikiDownload.h>

Public Member Functions
(void)	- abortRead
	Aborts the data transfer in progress.
(void)	- addProgressListener:
	Adds a progress listener object to this object's listeners.
(NSString *)	- buildQueryURL
	Builds the query URL, intended to be easily re-implemented in sublcasses.
(void)	- connection:didFailWithError:
	NSURLConnection delegate method.
(void)	- connection:didReceiveData:
	NSURLConnection delegate method.
(void)	- connection:didReceiveResponse:
	NSURLConnection delegate method.
(void)	- connectionDidFinishLoading:
	NSURLConnection delegate method.
(id)	- init `[implementation]`
	Initializes the object.
(id)	- initWithDelegate:
	Initialize a new MediaWikiDownload object with the specified delegate.
(id)	- initWithDelegate:mediaWikiURL:
	Initialize a new MediaWikiDownload object with the specified delegate and MediaWiki URL (as a string)
(void)	- removeProgressListener:
	Removes a progress listener object from this object's listeners.
(BOOL)	- startQuery
	Launches the query process.
Protected Attributes
NSURLConnection *	mediaWikiConnection
NSMutableURLRequest *	mediaWikiRequest
NSFileHandle *	outHandle
NSString *	outputPath
NSMutableSet *	progressListeners
id< MediaWikiDownloadDelegate >	queryDelegate
NSMutableData *	receivedData
BOOL	working
Properties
NSInteger	currentBytes
	Manual accessor for currentBytes.
NSInteger	expectedSize
	Manual accessor for expectedSize.
NSString *	mediaWikiFilename
	The filename of the file to download.
NSString *	mediaWikiURLString
	The base URL for this MediaWiki query.

Detailed Description

MediaWikiDownload saves a remote file to local storage.

MediaWikiDownload is designed to fetch an attachment file from a MediaWiki site, specifically IMSLP. It sets any cookies required and manually saves the data to the temp directory, moving it to the Documents storage once complete.

A succesful download is reported to the delegate.

Definition at line 15 of file MediaWikiDownload.h.

Member Function Documentation

- (void) abortRead

Aborts the data transfer in progress.

The temporary file (if it exists) is not destroyed.

Definition at line 297 of file MediaWikiDownload.m.

References mediaWikiConnection, outHandle, outputPath, and working.

Here is the caller graph for this function:

- (void) addProgressListener: (id <MediaWikiProgressListener>) listener

Adds a progress listener object to this object's listeners.

Progress Listeners receive periodic updates on the progress of the data transfer taking place. Multiple listeners are supported.

Parameters:

listener A MediaWikiProgressListener that should receive updates.

Definition at line 274 of file MediaWikiDownload.m.

References progressListeners.

Here is the caller graph for this function:

- (NSString *) buildQueryURL

Builds the query URL, intended to be easily re-implemented in sublcasses.

Builds the query URL.

The URL is based on the mediaWikiURLString property. The filename property is appended to the base URL to receive the final, complete URL to download.

Returns:: The URL to be used when attempting the connection

Definition at line 95 of file MediaWikiDownload.m.

Here is the caller graph for this function:

- (void) connection:	(NSURLConnection *)	connection
didFailWithError:	(NSError *)	error

NSURLConnection delegate method.

NSURLConnectionDelegate implementation, reports the error with NSLog and cleans file handles.

The temporary file that might have been created is not destroyed.

Definition at line 214 of file MediaWikiDownload.m.

References mediaWikiConnection, outHandle, outputPath, CatNiPErrorManager::reportError:, CatNiPErrorManager::sharedManager, and working.

Here is the call graph for this function:

- (void) connection:	(NSURLConnection *)	connection
didReceiveData:	(NSData *)	data

NSURLConnection delegate method.

NSURLConnectionDelegate implementation, passes the data to a filehandle and updates any MediaWikiProgressListeners.

Definition at line 200 of file MediaWikiDownload.m.

References currentBytes, outHandle, and progressListeners.

- (void) connection:	(NSURLConnection *)	connection
didReceiveResponse:	(NSURLResponse *)	response

NSURLConnection delegate method.

NSURLConnectionDelegate implementation, resets the output file handle (only the data from the last response is stuff we're interested in).

Definition at line 159 of file MediaWikiDownload.m.

References expectedSize, outHandle, and outputPath.

- (void) connectionDidFinishLoading: (NSURLConnection *) connection

NSURLConnection delegate method.

NSURLConnectionDelegate implementation, informs the MediaWikiDownloadDelegate about a succesful download.

Definition at line 237 of file MediaWikiDownload.m.

References mediaWikiConnection, outHandle, outputPath, queryDelegate, CatNiPErrorManager::reportError:, CatNiPErrorManager::sharedManager, and working.

Here is the call graph for this function:

- (id) init [implementation]

Initializes the object.

Definition at line 43 of file MediaWikiDownload.m.

References currentBytes, expectedSize, and progressListeners.

Here is the caller graph for this function:

- (id) initWithDelegate: (id <MediaWikiDownloadDelegate>) mediaWikiDownloadDelegate

Initialize a new MediaWikiDownload object with the specified delegate.

Initializes the object with the specified delegate.

Parameters:

MediaWikiDownloadDelegate The delegate object that will receive the data read from the URL

Returns:: id pointer to the initialized object.

Definition at line 58 of file MediaWikiDownload.m.

References init, queryDelegate, and working.

Here is the call graph for this function:

Here is the caller graph for this function:

- (id) initWithDelegate:	(id <MediaWikiDownloadDelegate>)	mediaWikiDownloadDelegate
mediaWikiURL:	(NSString*)	mwURLString

Initialize a new MediaWikiDownload object with the specified delegate and MediaWiki URL (as a string)

Initializes the object with the specified delegate and MediaWiki URL.

Parameters:

MediaWikiDownloadDelegate	The delegate object that will receive the data read from the URL
mwURLString	The URL to read from.

Returns:: id pointer to the initialized object.

Definition at line 78 of file MediaWikiDownload.m.

References initWithDelegate:.

Here is the call graph for this function:

- (void) removeProgressListener: (id <MediaWikiProgressListener>) listener

Removes a progress listener object from this object's listeners.

Parameters:

listener The listener to remove from this object's listener set.

Definition at line 287 of file MediaWikiDownload.m.

References progressListeners.

Here is the caller graph for this function:

- (BOOL) startQuery

Launches the query process.

Starts the MediaWiki query.

Starts the HTTP query represented by the URL received using [self buildQueryURL] using an internal NSURLConnection object. This object functions as the delegate for the NSURLConnection, and passes the read data to it's delegate once the connection finishes loading.

Returns:: YES if the connection started succesfully, NO if the URL was malformed or this object was already in the middle of reading data

Definition at line 107 of file MediaWikiDownload.m.

References buildQueryURL, mediaWikiConnection, mediaWikiFilename, mediaWikiRequest, CatNiPErrorManager::reportError:, CatNiPErrorManager::sharedManager, and working.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

- (NSURLConnection*) mediaWikiConnection [protected]

Definition at line 20 of file MediaWikiDownload.h.

- (NSMutableURLRequest*) mediaWikiRequest [protected]

Definition at line 19 of file MediaWikiDownload.h.

- (NSFileHandle*) outHandle [protected]

Definition at line 22 of file MediaWikiDownload.h.

- (NSString*) outputPath [protected]

Definition at line 23 of file MediaWikiDownload.h.

- (NSMutableSet*) progressListeners [protected]

Definition at line 26 of file MediaWikiDownload.h.

- (id<MediaWikiDownloadDelegate>) queryDelegate [protected]

Definition at line 16 of file MediaWikiDownload.h.

- (NSMutableData*) receivedData [protected]

Definition at line 21 of file MediaWikiDownload.h.

- (BOOL) working [protected]

Definition at line 27 of file MediaWikiDownload.h.

Property Documentation

- (NSInteger) currentBytes [read, assign]

Manual accessor for currentBytes.

Returns:: The number of bytes of data received from the target host.

Definition at line 25 of file MediaWikiDownload.h.

- (NSInteger) expectedSize [read, assign]

Manual accessor for expectedSize.

Only available once a NSURLResponse has been received from the target host. Returns NSIntegerMin if a response has not yet been received, and -1 when a response has been received but it did not contain information on the size of the response.

Returns:: The expected size (in 8-bit bytes) of the file, NSIntegerMin or -1.

Definition at line 24 of file MediaWikiDownload.h.

- (NSString *) mediaWikiFilename [read, write, copy]

The filename of the file to download.

Definition at line 18 of file MediaWikiDownload.h.

- (NSString *) mediaWikiURLString [read, write, copy]

The base URL for this MediaWiki query.

Definition at line 17 of file MediaWikiDownload.h.

The documentation for this class was generated from the following files:

/Users/awniemel/Notepad-SVN/svn/trunk/CatNiP/CatNiP/MediaWikiDownload.h
/Users/awniemel/Notepad-SVN/svn/trunk/CatNiP/CatNiP/MediaWikiDownload.m

Public Member Functions

Protected Attributes

Properties

Detailed Description

Member Function Documentation

Member Data Documentation

Property Documentation