18e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* 28e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * Copyright (C) 2003, 2004, 2005 Apple Computer, Inc. All rights reserved. 38e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 48e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * Redistribution and use in source and binary forms, with or without 58e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * modification, are permitted provided that the following conditions 68e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * are met: 78e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 88e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 1. Redistributions of source code must retain the above copyright 98e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer. 108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 2. Redistributions in binary form must reproduce the above copyright 118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer in the 128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * documentation and/or other materials provided with the distribution. 138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of 148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * its contributors may be used to endorse or promote products derived 158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * from this software without specific prior written permission. 168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY 188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY 218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#import <Cocoa/Cocoa.h> 308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#import <WebKit/WebDocument.h> 328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class NSMutableURLRequest; 348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class NSURLConnection; 358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class NSURLRequest; 368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class NSURLResponse; 378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class WebArchive; 388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class WebDataSourcePrivate; 398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class WebFrame; 408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@class WebResource; 418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @class WebDataSource 448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion A WebDataSource represents the data associated with a web page. 458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project A datasource has a WebDocumentRepresentation which holds an appropriate 468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project representation of the data. WebDataSources manage a hierarchy of WebFrames. 478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project WebDataSources are typically related to a view by their containing WebFrame. 488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@interface WebDataSource : NSObject 508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project{ 518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@private 528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project WebDataSourcePrivate *_private; 538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project} 548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method initWithRequest: 578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract The designated initializer for WebDataSource. 588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param request The request to use in creating a datasource. 598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns an initialized WebDataSource. 608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (id)initWithRequest:(NSURLRequest *)request; 628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method data 658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion The data will be incomplete until the datasource has completely loaded. 668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns the raw data associated with the datasource. Returns nil 678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project if the datasource hasn't loaded any data. 688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSData *)data; 708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method representation 738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion A representation holds a type specific representation 748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of the datasource's data. The representation class is determined by mapping 758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project a MIME type to a class. The representation is created once the MIME type 768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project of the datasource content has been determined. 778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns the representation associated with this datasource. 788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project Returns nil if the datasource hasn't created it's representation. 798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (id <WebDocumentRepresentation>)representation; 818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method webFrame 848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Return the frame that represents this data source. 858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (WebFrame *)webFrame; 878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method initialRequest 908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns a reference to the original request that created the 918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project datasource. This request will be unmodified by WebKit. 928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSURLRequest *)initialRequest; 948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method request 978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns the request that was used to create this datasource. 988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSMutableURLRequest *)request; 1008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method response 1038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result returns the WebResourceResponse for the data source. 1048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSURLResponse *)response; 1068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method textEncodingName 1098e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns either the override encoding, as set on the WebView for this 1108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project dataSource or the encoding from the response. 1118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSString *)textEncodingName; 1138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method isLoading 1168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion Returns YES if there are any pending loads. 1178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (BOOL)isLoading; 1198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method pageTitle 1228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns nil or the page title. 1238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSString *)pageTitle; 1258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method unreachableURL 1288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion This will be non-nil only for dataSources created by calls to the 1298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project WebFrame method loadAlternateHTMLString:baseURL:forUnreachableURL:. 1308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result returns the unreachableURL for which this dataSource is showing alternate content, or nil 1318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSURL *)unreachableURL; 1338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method webArchive 1368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result A WebArchive representing the data source, its subresources and child frames. 1378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @description This method constructs a WebArchive using the original downloaded data. 1388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project In the case of HTML, if the current state of the document is preferred, webArchive should be 1398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project called on the DOM document instead. 1408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (WebArchive *)webArchive; 1428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method mainResource 1458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result A WebResource representing the data source. 1468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @description This method constructs a WebResource using the original downloaded data. 1478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project This method can be used to construct a WebArchive in case the archive returned by 1488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project WebDataSource's webArchive isn't sufficient. 1498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (WebResource *)mainResource; 1518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method subresources 1548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract Returns all the subresources associated with the data source. 1558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @description The returned array only contains subresources that have fully downloaded. 1568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSArray *)subresources; 1588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project method subresourceForURL: 1618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract Returns a subresource for a given URL. 1628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param URL The URL of the subresource. 1638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @description Returns non-nil if the data source has fully downloaded a subresource with the given URL. 1648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (WebResource *)subresourceForURL:(NSURL *)URL; 1668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 1688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method addSubresource: 1698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract Adds a subresource to the data source. 1708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param subresource The subresource to be added. 1718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @description addSubresource: adds a subresource to the data source's list of subresources. 1728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project Later, if something causes the data source to load the URL of the subresource, the data source 1738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project will load the data from the subresource instead of from the network. For example, if one wants to add 1748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project an image that is already downloaded to a web page, addSubresource: can be called so that the data source 1758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uses the downloaded image rather than accessing the network. NOTE: If the data source already has a 1768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project subresource with the same URL, addSubresource: will replace it. 1778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 1788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (void)addSubresource:(WebResource *)subresource; 1798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@end 181