/*
 * @(#)CookiePolicyHandler.java             0.3-3 06/05/2001
 *
 *  This file is part of the HTTPClient package
 *  Copyright (C) 1996-2001 Ronald Tschal�r
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; either
 *  version 2 of the License, or (at your option) any later version.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, write to the Free
 *  Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *  MA 02111-1307, USA
 *
 *  For questions, suggestions, bug-reports, enhancement-requests etc.
 *  I may be contacted at:
 *
 *  ronald@innovation.ch
 *
 *  The HTTPClient's home page is located at:
 *
 *  http://www.innovation.ch/java/HTTPClient/ 
 *
 */

package org.exoplatform.common.http.client;

/**
 * This is the interface that a cookie policy handler must implement. A policy
 * handler allows you to control which cookies are accepted and which are sent.
 * @see org.exoplatform.common.http.client.CookieModule#setCookiePolicyHandler(HTTPClient.CookiePolicyHandler)
 * @version 0.3-3 06/05/2001
 * @author Ronald Tschal�r
 * @since V0.3
 */
public interface CookiePolicyHandler
{
   /**
    * This method is called for each cookie that a server tries to set via the
    * Set-Cookie header. This enables you to implement your own cookie acceptance
    * policy.
    * @param cookie the cookie in question
    * @param req the request sent which prompted the response
    * @param resp the response which is trying to set the cookie
    * @return true if this cookie should be accepted, false if it is to be
    *         rejected.
    */
   boolean acceptCookie(Cookie cookie, RoRequest req, RoResponse resp);

   /**
    * This method is called for each cookie that is eligible for sending with a
    * request (according to the matching rules for the path, domain, protocol,
    * etc). This enables you to control the sending of cookies.
    * @param cookie the cookie in question
    * @param req the request this cookie is to be sent with
    * @return true if this cookie should be sent, false if it is to be ignored.
    */
   boolean sendCookie(Cookie cookie, RoRequest req);
}
