1/*
2 * Copyright (C) 2009 Google 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 are
6 * met:
7 *
8 *     * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 *     * Redistributions in binary form must reproduce the above
11 * copyright notice, this list of conditions and the following disclaimer
12 * in the documentation and/or other materials provided with the
13 * distribution.
14 *     * Neither the name of Google Inc. nor the names of its
15 * contributors may be used to endorse or promote products derived from
16 * this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 */
30
31#ifndef ThreadableLoader_h
32#define ThreadableLoader_h
33
34#include "ResourceLoaderOptions.h"
35#include <wtf/Noncopyable.h>
36#include <wtf/PassRefPtr.h>
37#include <wtf/RefPtr.h>
38#include <wtf/Vector.h>
39
40#if ENABLE(RESOURCE_TIMING)
41#include <wtf/text/AtomicString.h>
42#endif
43
44namespace WebCore {
45
46    class ResourceError;
47    class ResourceRequest;
48    class ResourceResponse;
49    class ScriptExecutionContext;
50    class SecurityOrigin;
51    class ThreadableLoaderClient;
52
53    enum CrossOriginRequestPolicy {
54        DenyCrossOriginRequests,
55        UseAccessControl,
56        AllowCrossOriginRequests
57    };
58
59    enum PreflightPolicy {
60        ConsiderPreflight,
61        ForcePreflight,
62        PreventPreflight
63    };
64
65    struct ThreadableLoaderOptions : public ResourceLoaderOptions {
66        ThreadableLoaderOptions();
67        ~ThreadableLoaderOptions();
68
69        PreflightPolicy preflightPolicy; // If AccessControl is used, how to determine if a preflight is needed.
70        CrossOriginRequestPolicy crossOriginRequestPolicy;
71        RefPtr<SecurityOrigin> securityOrigin;
72#if ENABLE(RESOURCE_TIMING)
73        AtomicString initiator;
74#endif
75    };
76
77    // Useful for doing loader operations from any thread (not threadsafe,
78    // just able to run on threads other than the main thread).
79    class ThreadableLoader {
80        WTF_MAKE_NONCOPYABLE(ThreadableLoader);
81    public:
82        static void loadResourceSynchronously(ScriptExecutionContext*, const ResourceRequest&, ThreadableLoaderClient&, const ThreadableLoaderOptions&);
83        static PassRefPtr<ThreadableLoader> create(ScriptExecutionContext*, ThreadableLoaderClient*, const ResourceRequest&, const ThreadableLoaderOptions&);
84
85        virtual void cancel() = 0;
86        void ref() { refThreadableLoader(); }
87        void deref() { derefThreadableLoader(); }
88
89    protected:
90        ThreadableLoader() { }
91        virtual ~ThreadableLoader() { }
92        virtual void refThreadableLoader() = 0;
93        virtual void derefThreadableLoader() = 0;
94    };
95
96} // namespace WebCore
97
98#endif // ThreadableLoader_h
99