[GStreamer][Soup] Let GStreamer provide the buffer data is downloaded to, to avoid...
[WebKit-https.git] / Source / WebCore / platform / network / ResourceHandleClient.h
1 /*
2  * Copyright (C) 2006 Apple Computer, Inc.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 #ifndef ResourceHandleClient_h
27 #define ResourceHandleClient_h
28
29 #include <wtf/CurrentTime.h>
30 #include <wtf/RefCounted.h>
31 #include <wtf/RefPtr.h>
32
33 #if USE(CFNETWORK)
34 #include <CFNetwork/CFURLCachePriv.h>
35 #include <CFNetwork/CFURLResponsePriv.h>
36 #endif
37
38 #if PLATFORM(WIN) && USE(CFNETWORK)
39 #include <ConditionalMacros.h>
40 #endif
41
42 #if PLATFORM(MAC)
43 OBJC_CLASS NSCachedURLResponse;
44 #endif
45
46 namespace WebCore {
47     class AsyncFileStream;
48     class AuthenticationChallenge;
49     class Credential;
50     class FileStreamClient;
51     class KURL;
52     class ProtectionSpace;
53     class ResourceHandle;
54     class ResourceError;
55     class ResourceRequest;
56     class ResourceResponse;
57
58     enum CacheStoragePolicy {
59         StorageAllowed,
60         StorageAllowedInMemoryOnly,
61         StorageNotAllowed
62     };
63     
64     class ResourceHandleClient {
65     public:
66         virtual ~ResourceHandleClient() { }
67
68         // request may be modified
69         virtual void willSendRequest(ResourceHandle*, ResourceRequest&, const ResourceResponse& /*redirectResponse*/) { }
70         virtual void didSendData(ResourceHandle*, unsigned long long /*bytesSent*/, unsigned long long /*totalBytesToBeSent*/) { }
71
72         virtual void didReceiveResponse(ResourceHandle*, const ResourceResponse&) { }
73         virtual void didReceiveData(ResourceHandle*, const char*, int, int /*encodedDataLength*/) { }
74         virtual void didReceiveCachedMetadata(ResourceHandle*, const char*, int) { }
75         virtual void didFinishLoading(ResourceHandle*, double /*finishTime*/) { }
76         virtual void didFail(ResourceHandle*, const ResourceError&) { }
77         virtual void wasBlocked(ResourceHandle*) { }
78         virtual void cannotShowURL(ResourceHandle*) { }
79
80 #if USE(NETWORK_CFDATA_ARRAY_CALLBACK)
81         virtual bool supportsDataArray() { return false; }
82         virtual void didReceiveDataArray(ResourceHandle*, CFArrayRef) { }
83 #endif
84
85         virtual bool shouldUseCredentialStorage(ResourceHandle*) { return false; }
86         virtual void didReceiveAuthenticationChallenge(ResourceHandle*, const AuthenticationChallenge&) { }
87         virtual void didCancelAuthenticationChallenge(ResourceHandle*, const AuthenticationChallenge&) { }
88 #if USE(PROTECTION_SPACE_AUTH_CALLBACK)
89         virtual bool canAuthenticateAgainstProtectionSpace(ResourceHandle*, const ProtectionSpace&) { return false; }
90 #endif
91         virtual void receivedCancellation(ResourceHandle*, const AuthenticationChallenge&) { }
92
93 #if PLATFORM(MAC)
94 #if USE(CFNETWORK)
95         virtual CFCachedURLResponseRef willCacheResponse(ResourceHandle*, CFCachedURLResponseRef response) { return response; }
96 #else
97         virtual NSCachedURLResponse* willCacheResponse(ResourceHandle*, NSCachedURLResponse* response) { return response; }
98 #endif
99         virtual void willStopBufferingData(ResourceHandle*, const char*, int) { }
100 #endif // PLATFORM(MAC)
101 #if PLATFORM(WIN) && USE(CFNETWORK)
102         virtual bool shouldCacheResponse(ResourceHandle*, CFCachedURLResponseRef) { return true; }
103 #endif
104 #if PLATFORM(CHROMIUM)
105         virtual void didDownloadData(ResourceHandle*, int /*dataLength*/) { }
106 #endif
107 #if ENABLE(BLOB)
108         virtual AsyncFileStream* createAsyncFileStream(FileStreamClient*) { return 0; }
109 #endif
110     };
111
112 }
113
114 #endif