1 /* 2 * $HeadURL: http://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/client/CookieStore.java $ 3 * $Revision: 604434 $ 4 * $Date: 2007-12-15 06:45:48 -0800 (Sat, 15 Dec 2007) $ 5 * 6 * ==================================================================== 7 * 8 * Licensed to the Apache Software Foundation (ASF) under one or more 9 * contributor license agreements. See the NOTICE file distributed with 10 * this work for additional information regarding copyright ownership. 11 * The ASF licenses this file to You under the Apache License, Version 2.0 12 * (the "License"); you may not use this file except in compliance with 13 * the License. You may obtain a copy of the License at 14 * 15 * http://www.apache.org/licenses/LICENSE-2.0 16 * 17 * Unless required by applicable law or agreed to in writing, software 18 * distributed under the License is distributed on an "AS IS" BASIS, 19 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 20 * See the License for the specific language governing permissions and 21 * limitations under the License. 22 * ==================================================================== 23 * 24 * This software consists of voluntary contributions made by many 25 * individuals on behalf of the Apache Software Foundation. For more 26 * information on the Apache Software Foundation, please see 27 * <http://www.apache.org/>. 28 * 29 */ 30 31 package org.apache.http.client; 32 33 import java.util.Date; 34 import java.util.List; 35 36 import org.apache.http.cookie.Cookie; 37 38 /** 39 * Abstract cookie store. 40 * 41 * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a> 42 * 43 * @since 4.0 44 * 45 * @deprecated Please use {@link java.net.URL#openConnection} instead. 46 * Please visit <a href="http://android-developers.blogspot.com/2011/09/androids-http-clients.html">this webpage</a> 47 * for further details. 48 */ 49 @Deprecated 50 public interface CookieStore { 51 52 /** 53 * Adds an {@link Cookie HTTP cookie}, replacing any existing equivalent cookies. 54 * If the given cookie has already expired it will not be added, but existing 55 * values will still be removed. 56 * 57 * @param cookie the {@link Cookie cookie} to be added 58 */ addCookie(Cookie cookie)59 void addCookie(Cookie cookie); 60 61 /** 62 * Returns all cookies contained in this store. 63 * 64 * @return all cookies 65 */ getCookies()66 List<Cookie> getCookies(); 67 68 /** 69 * Removes all of {@link Cookie cookies} in this store that have expired by 70 * the specified {@link java.util.Date date}. 71 * 72 * @return true if any cookies were purged. 73 */ clearExpired(Date date)74 boolean clearExpired(Date date); 75 76 /** 77 * Clears all cookies. 78 */ clear()79 void clear(); 80 81 } 82