| /********************************************************************** |
| * Copyright (c) 2004, 2005 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - Initial API and implementation |
| **********************************************************************/ |
| package org.eclipse.wst.internet.monitor.core.internal.provisional; |
| /** |
| * Listener for new or modified requests created from a single monitor. |
| * Each request represents message traffic between a monitored client |
| * and server. |
| * <p> |
| * Requests are not persisted - they only exist in this API until the |
| * connection is done. An initial requestAdded() event is fired when the |
| * request is created (by the client creating a connection), and then |
| * requestChanged() events occur as data is passed through the request |
| * or changes are made to the request's properties. |
| * </p> |
| * |
| * @see IMonitor#addRequestListener(IRequestListener) |
| * @plannedfor 1.0 |
| */ |
| public interface IRequestListener { |
| /** |
| * Notification that the given request was created. |
| * <p> |
| * Requests may be created with little to no data in them. |
| * As additional information is available, the |
| * <code>requestChanged</code> method is called. |
| * </p> |
| * |
| * @param monitor the monitor from which the request was initiated |
| * @param request the request that has been added |
| */ |
| public void requestAdded(IMonitor monitor, Request request); |
| |
| /** |
| * Notification that the given request has been changed. |
| * This method is called when more data is available in the |
| * request. |
| * <p> |
| * Individual values within the request are rarely modified. |
| * This method may be called when they are initially set or |
| * when more data is received from the client or server. |
| * </p> |
| * |
| * @param monitor the monitor from which the request was initiated |
| * @param request the request that has been changed |
| */ |
| public void requestChanged(IMonitor monitor, Request request); |
| } |