1 /************************************************************************* 2 * 3 * The Contents of this file are made available subject to the terms of 4 * the BSD license. 5 * 6 * Copyright 2000, 2010 Oracle and/or its affiliates. 7 * All rights reserved. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 3. Neither the name of Sun Microsystems, Inc. nor the names of its 18 * contributors may be used to endorse or promote products derived 19 * from this software without specific prior written permission. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 24 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 25 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 27 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 28 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 29 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR 30 * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 31 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 * 33 *************************************************************************/ 34 35 import java.util.Vector; 36 37 // __________ Implementation __________ 38 39 /** 40 * We need a generic interface to forward any oneway uno interface method 41 * by using threads to the original object. Reason: 42 * It's not allowed to call synchronoues back to the office if a java object 43 * was called in a oneway declared interface method. Then it must be 44 * executed asynchronoues. To do so - a thread can be created which use this 45 * interface. It get the object, which whis to be called back and the type and 46 * parameter of the original request. 47 * 48 * @author Andreas Schlüns 49 * @created 17.07.2002 08:09 50 */ 51 public interface IOnewayLink 52 { 53 // _______________________________ 54 55 /** 56 * @param nRequest 57 * The two user of this callback can define an unique number, 58 * which identify the type of original interface method. So the called 59 * interface object can decide, which action will be neccessary. 60 * 61 * @param lParams 62 * If the original method used parameters, they will be coded here in 63 * a generic way. Only the called interface object know (it depends 64 * from the original request - see nRequest too), how this list must 65 * be interpreted. 66 * Note: Atomic types (e.g. int, long) will be transported as objects 67 * too (Integer, Long)! 68 */ 69 public abstract void execOneway( int nRequest, Vector lParams ); 70 } 71