1d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen/* 2d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Copyright 2009 Mike Cumings 3d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 4d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Licensed under the Apache License, Version 2.0 (the "License"); 5d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * you may not use this file except in compliance with the License. 6d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * You may obtain a copy of the License at 7d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 8d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * http://www.apache.org/licenses/LICENSE-2.0 9d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 10d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Unless required by applicable law or agreed to in writing, software 11d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * distributed under the License is distributed on an "AS IS" BASIS, 12d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * See the License for the specific language governing permissions and 14d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * limitations under the License. 15d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen */ 16d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 17d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chenpackage com.kenai.jbosh; 18d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 19d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen/** 20d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Interface used by parties interested in monitoring outbound requests made 21d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * by the client to the connection manager (CM). No opportunity is provided 22d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * to manipulate the outbound request. 23d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * <p/> 24d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * The messages being sent are typically modified copies of the message 25d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * body provided to the {@code BOSHClient} instance, built from the 26d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * originally provided message body plus additional BOSH protocol 27d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * state and information. Messages may also be sent automatically when the 28d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * protocol requires it, such as maintaining a minimum number of open 29d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * connections to the connection manager. 30d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * <p/> 31d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Listeners are executed by the sending thread immediately prior to 32d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * message transmission and should not block for any significant amount 33d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * of time. 34d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen */ 35d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chenpublic interface BOSHClientRequestListener { 36d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 37d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen /** 38d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * Called when the listener is being notified that a client request is 39d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * about to be sent to the connection manager. 40d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * 41d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen * @param event event instance containing the message being sent 42d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen */ 43d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen void requestSent(BOSHMessageEvent event); 44d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen 45d7955ce24d294fb2014c59d11fca184471056f44Shuyi Chen} 46