001    /*
002     * Licensed to the Apache Software Foundation (ASF) under one
003     * or more contributor license agreements.  See the NOTICE file
004     * distributed with this work for additional information
005     * regarding copyright ownership.  The ASF licenses this file
006     * to you under the Apache License, Version 2.0 (the
007     * "License"); you may not use this file except in compliance
008     * with the License.  You may obtain a copy of the License at
009     *
010     *  http://www.apache.org/licenses/LICENSE-2.0
011     *
012     * Unless required by applicable law or agreed to in writing,
013     * software distributed under the License is distributed on an
014     * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
015     * KIND, either express or implied.  See the License for the
016     * specific language governing permissions and limitations
017     * under the License.
018     */
019    
020    //
021    // This source code implements specifications defined by the Java
022    // Community Process. In order to remain compliant with the specification
023    // DO NOT add / change / or delete method signatures!
024    //
025    
026    package javax.servlet;
027    
028    import java.util.EventListener;
029    
030    /**
031     * Implementations of this interface receive notifications of
032     * changes to the attribute list on the servlet request of a
033     * web application.
034     * To receive notification events, the implementation class
035     * must be configured in the deployment descriptor for the web application.
036     *
037     * @see ServletRequestAttributeEvent
038     *
039     * @since Servlet 2.4
040     *
041     * @version $Rev: 467553 $ $Date: 2006-10-24 21:01:51 -0700 (Tue, 24 Oct 2006) $
042     */
043    public interface ServletRequestAttributeListener extends EventListener {
044        /**
045         * Notification that a new attribute was added to the servlet request.
046         * Called after the attribute is added.
047         */
048        public void attributeAdded(ServletRequestAttributeEvent srae);
049    
050        /**
051         * Notification that an existing attribute has been removed from the
052         * servlet request. Called after the attribute is removed.
053         */
054        public void attributeRemoved(ServletRequestAttributeEvent srae);
055    
056        /**
057         * Notification that an attribute on the servlet request has been
058         * replaced. Called after the attribute is replaced.
059         */
060        public void attributeReplaced(ServletRequestAttributeEvent srae);
061    }
062