174fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon/*
274fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * Copyright (C) 2008 The Android Open Source Project
374fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon *
474fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * Licensed under the Apache License, Version 2.0 (the "License");
574fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * you may not use this file except in compliance with the License.
674fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * You may obtain a copy of the License at
774fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon *
874fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon *      http://www.apache.org/licenses/LICENSE-2.0
974fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon *
1074fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * Unless required by applicable law or agreed to in writing, software
1174fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * distributed under the License is distributed on an "AS IS" BASIS,
1274fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1374fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * See the License for the specific language governing permissions and
1474fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * limitations under the License.
1574fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon */
1674fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon
1774fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixonpackage android.webkit;
1874fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon
1974fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixonimport android.webkit.CacheManager.CacheResult;
2074fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixonimport android.webkit.PluginData;
2174fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixonimport java.util.Map;
2274fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon
2374fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon/**
2474fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * @hide
2574fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * @deprecated This interface was inteded to be used by Gears. Since Gears was
2674fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon * deprecated, so is this class.
2774fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon */
2874fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon@Deprecated
2974fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixonpublic interface UrlInterceptHandler {
3074fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon
3174fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon    /**
3274fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * Given an URL, returns the CacheResult which contains the
3374fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * surrogate response for the request, or null if the handler is
3474fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * not interested.
3574fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     *
3674fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @param url URL string.
3774fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @param headers The headers associated with the request. May be null.
3874fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @return The CacheResult containing the surrogate response.
3974fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     *
4074fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @hide
4174fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @deprecated Do not use, this interface is deprecated.
4274fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     */
4374fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon    @Deprecated
4474fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon    public CacheResult service(String url, Map<String, String> headers);
4574fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon
4674fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon    /**
4774fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * Given an URL, returns the PluginData which contains the
4874fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * surrogate response for the request, or null if the handler is
4974fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * not interested.
5074fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     *
5174fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @param url URL string.
5274fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @param headers The headers associated with the request. May be null.
5374fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @return The PluginData containing the surrogate response.
5474fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     *
5574fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @hide
5674fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     * @deprecated Do not use, this interface is deprecated.
5774fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon     */
5874fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon    @Deprecated
5974fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon    public PluginData getPluginData(String url, Map<String, String> headers);
6074fc73f62bd1ade8e94a6bba34bcd24d54400dd2Jonathan Dixon}
61