qadevOOo/tests/java/ifc/io/_XConnectable.java

   1 /*************************************************************************
   2  *
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * Copyright 2008 by Sun Microsystems, Inc.
   6  *
   7  * OpenOffice.org - a multi-platform office productivity suite
   8  *
   9  * $RCSfile: _XConnectable.java,v $
  10  * $Revision: 1.5 $
  11  *
  12  * This file is part of OpenOffice.org.
  13  *
  14  * OpenOffice.org is free software: you can redistribute it and/or modify
  15  * it under the terms of the GNU Lesser General Public License version 3
  16  * only, as published by the Free Software Foundation.
  17  *
  18  * OpenOffice.org is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU Lesser General Public License version 3 for more details
  22  * (a copy is included in the LICENSE file that accompanied this code).
  23  *
  24  * You should have received a copy of the GNU Lesser General Public License
  25  * version 3 along with OpenOffice.org.  If not, see
  26  * <http://www.openoffice.org/license.html>
  27  * for a copy of the LGPLv3 License.
  28  *
  29  ************************************************************************/
  30
  31 package ifc.io;
  32
  33 import lib.MultiMethodTest;
  34
  35 import com.sun.star.io.XConnectable;
  36 import com.sun.star.uno.UnoRuntime;
  37 import com.sun.star.uno.XInterface;
  38
  39 /**
  40 * Testing <code>com.sun.star.io.XConnectable</code>
  41 * interface methods:
  42 * <ul>
  43 *   <li><code>setPredecessor()</code></li>
  44 *   <li><code>getPredecessor()</code></li>
  45 *   <li><code>setSuccessor()</code></li>
  46 *   <li><code>getSuccessor()</code></li>
  47 * </ul> <p>
  48 * This test needs the following object relations :
  49 * <ul>
  50 *  <li> <code>'Connectable'</code> (supports the <code>XConnectable</code>
  51 *   interface):
  52 *   another 0bject to connect </li>
  53 * </ul>
  54 * After test completion object environment has to be recreated.
  55 * @see com.sun.star.io.XConnectable
  56 */
  57 public class _XConnectable extends MultiMethodTest {
  58
  59     public XConnectable oObj = null;
  60
  61     private XConnectable xConnect = null ;
  62
  63     /**
  64      * Get another connectable object from object relations.
  65     */
  66     public void before() {
  67         XInterface x = (XInterface)tEnv.getObjRelation("Connectable");
  68         xConnect = (XConnectable)UnoRuntime.queryInterface(
  69                                                     XConnectable.class, x) ;
  70     }
  71
  72     /**
  73     * Test calls the method using interface <code>XConnectable</code>
  74     * received in method <code>before()</code> as parameter. <p>
  75     * Has <b> OK </b> status if the method successfully returns. <p>
  76     */
  77     public void _setPredecessor() {
  78         oObj.setPredecessor(xConnect) ;
  79
  80         tRes.tested("setPredecessor()", true) ;
  81     }
  82
  83     /**
  84     * Test calls the method and compares returned value with value that was
  85     * set in the method <code>setPredecessor()</code>. <p>
  86     * Has <b> OK </b> status if values are equal. <p>
  87     * The following method tests are to be completed successfully before :
  88     * <ul>
  89     *  <li> <code> setPredecessor() </code></li>
  90     * </ul>
  91     */
  92     public void _getPredecessor() {
  93         requiredMethod("setPredecessor()") ;
  94
  95         XConnectable gConnect = oObj.getPredecessor() ;
  96
  97         tRes.tested("getPredecessor()", xConnect.equals(gConnect)) ;
  98     }
  99
 100     /**
 101     * Test calls the method using interface <code>XConnectable</code>
 102     * received in method <code>before()</code> as parameter. <p>
 103     * Has <b> OK </b> status if the method successfully returns. <p>
 104     */
 105     public void _setSuccessor() {
 106         oObj.setSuccessor(xConnect) ;
 107
 108         tRes.tested("setSuccessor()", true) ;
 109     }
 110
 111     /**
 112     * Test calls the method and compares returned value with value that was
 113     * set in the method <code>setSuccessor()</code>. <p>
 114     * Has <b> OK </b> status if values are equal. <p>
 115     * The following method tests are to be completed successfully before :
 116     * <ul>
 117     *  <li> <code> setSuccessor() </code></li>
 118     * </ul>
 119     */
 120     public void _getSuccessor() {
 121         requiredMethod("setSuccessor()") ;
 122
 123         XConnectable gConnect = oObj.getSuccessor() ;
 124
 125         tRes.tested("getSuccessor()", xConnect.equals(gConnect)) ;
 126     }
 127
 128     /**
 129     * Forces object environment recreation.
 130     */
 131     public void after() {
 132         this.disposeEnvironment() ;
 133     }
 134 }
 135