~ubuntu-branches/ubuntu/raring/libjboss-remoting-java/raring

« back to all changes in this revision

Viewing changes to src/main/org/jboss/remoting/callback/AsynchInvokerCallbackHandler.java

  • Committer: Package Import Robot
  • Author(s): Torsten Werner
  • Date: 2011-09-09 14:01:03 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: package-import@ubuntu.com-20110909140103-hqokx61534tas9rg
Tags: 2.5.3.SP1-1
* Newer but not newest upstream release. Do not build samples.
* Change debian/watch to upstream's svn repo.
* Add patch to fix compile error caused by tomcat update.
  (Closes: #628303)
* Switch to source format 3.0.
* Switch to debhelper level 7.
* Remove useless Depends.
* Update Standards-Version: 3.9.2.
* Update README.source.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/*
 
2
 * JBoss, Home of Professional Open Source
 
3
 * Copyright 2005, JBoss Inc., and individual contributors as indicated
 
4
 * by the @authors tag. See the copyright.txt in the distribution for a
 
5
 * full listing of individual contributors.
 
6
 *
 
7
 * This is free software; you can redistribute it and/or modify it
 
8
 * under the terms of the GNU Lesser General Public License as
 
9
 * published by the Free Software Foundation; either version 2.1 of
 
10
 * the License, or (at your option) any later version.
 
11
 *
 
12
 * This software is distributed in the hope that it will be useful,
 
13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 
14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 
15
 * Lesser General Public License for more details.
 
16
 *
 
17
 * You should have received a copy of the GNU Lesser General Public
 
18
 * License along with this software; if not, write to the Free
 
19
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 
20
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 
21
 */
 
22
package org.jboss.remoting.callback;
 
23
 
 
24
 
 
25
/** 
 
26
 * AsynchInvokerCallbackHandler extends InvokerCallbackHandler with
 
27
 * asynchronous callback handling.
 
28
 * 
 
29
 * @author <a href="ron.sigal@jboss.com">Ron Sigal</a>
 
30
 * @version $Revision: 1633 $
 
31
 * <p>
 
32
 * Copyright Nov 28, 2006
 
33
 * </p>
 
34
 */
 
35
public interface AsynchInvokerCallbackHandler extends InvokerCallbackHandler
 
36
{
 
37
   /**
 
38
    * For push callbacks, will send the callback to the server invoker on the
 
39
    * client side, hand off processing to a separate thread, and return.<p>
 
40
    * 
 
41
    * For pull callbacks, behaves the same as handleCallback(Callback callback).<p>
 
42
    * 
 
43
    * @param callback
 
44
    * @throws HandleCallbackException
 
45
    */
 
46
   public void handleCallbackOneway(Callback callback)
 
47
   throws HandleCallbackException;
 
48
   
 
49
   
 
50
   /**
 
51
    * For push callbacks:<p>
 
52
    *   if serverSide == false, will send the callback to the server invoker on
 
53
    *   the client side, hand off processing to a separate thread, and return.<p>
 
54
    *   
 
55
    *   if serverside == true, will hand off to a separate thread the sending
 
56
    *   of the callback and will then return.<p>
 
57
    * 
 
58
    * For pull callbacks, behaves the same as handleCallback(Callback callback).<p>
 
59
    * 
 
60
    * @param callback
 
61
    * @param serverSide
 
62
    * @throws HandleCallbackException
 
63
    */
 
64
   public void handleCallbackOneway(Callback callback, boolean serverSide)
 
65
   throws HandleCallbackException;
 
66
   
 
67
   
 
68
   /**
 
69
    * For push callbacks:<p>
 
70
    *   if asynch == false, behaves the same as handleCallback(Callback callback).<p>
 
71
    *   
 
72
    *   if asynch == true:<p>
 
73
    *     if serverSide == false, will send the callback to the server invoker on
 
74
    *     the client side, hand off processing to a separate thread, and return.<p>
 
75
    *   
 
76
    *     if serverside == true, will hand off to a separate thread the sending
 
77
    *     of the callback and will then return.<p>
 
78
    * 
 
79
    * For pull callbacks, behaves the same as handleCallback(Callback callback).<p>
 
80
    * 
 
81
    * @param callback
 
82
    * @param asynch
 
83
    * @param serverSide
 
84
    * @throws HandleCallbackException
 
85
    */
 
86
   public void handleCallback(Callback callback, boolean asynch, boolean serverSide)
 
87
   throws HandleCallbackException;
 
88
}