Home | History | Annotate | Download | only in agent
      1 /**
      2  * $Revision$
      3  * $Date$
      4  *
      5  * Copyright 2003-2007 Jive Software.
      6  *
      7  * All rights reserved. Licensed under the Apache License, Version 2.0 (the "License");
      8  * you may not use this file except in compliance with the License.
      9  * You may obtain a copy of the License at
     10  *
     11  *     http://www.apache.org/licenses/LICENSE-2.0
     12  *
     13  * Unless required by applicable law or agreed to in writing, software
     14  * distributed under the License is distributed on an "AS IS" BASIS,
     15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     16  * See the License for the specific language governing permissions and
     17  * limitations under the License.
     18  */
     19 
     20 package org.jivesoftware.smackx.workgroup.agent;
     21 
     22 /**
     23  * An interface which all classes interested in hearing about chat offers associated to a particular
     24  *  AgentSession instance should implement.<br>
     25  *
     26  * @author Matt Tucker
     27  * @author loki der quaeler
     28  * @see org.jivesoftware.smackx.workgroup.agent.AgentSession
     29  */
     30 public interface OfferListener {
     31 
     32     /**
     33      * The implementing class instance will be notified via this when the AgentSession has received
     34      *  an offer for a chat. The instance will then have the ability to accept, reject, or ignore
     35      *  the request (resulting in a revocation-by-timeout).
     36      *
     37      * @param request the Offer instance embodying the details of the offer
     38      */
     39     public void offerReceived (Offer request);
     40 
     41     /**
     42      * The implementing class instance will be notified via this when the AgentSessino has received
     43      *  a revocation of a previously extended offer.
     44      *
     45      * @param revokedOffer the RevokedOffer instance embodying the details of the revoked offer
     46      */
     47     public void offerRevoked (RevokedOffer revokedOffer);
     48 
     49 }
     50