odk/examples/DevelopersGuide/Drawing/Helper.java

   1 /*************************************************************************
   2  *
   3  *  $RCSfile: Helper.java,v $
   4  *
   5  *  $Revision: 1.4 $
   6  *
   7  *  last change: $Author: rt $ $Date: 2005-01-31 16:23:08 $
   8  *
   9  *  The Contents of this file are made available subject to the terms of
  10  *  the BSD license.
  11  *
  12  *  Copyright (c) 2003 by Sun Microsystems, Inc.
  13  *  All rights reserved.
  14  *
  15  *  Redistribution and use in source and binary forms, with or without
  16  *  modification, are permitted provided that the following conditions
  17  *  are met:
  18  *  1. Redistributions of source code must retain the above copyright
  19  *     notice, this list of conditions and the following disclaimer.
  20  *  2. Redistributions in binary form must reproduce the above copyright
  21  *     notice, this list of conditions and the following disclaimer in the
  22  *     documentation and/or other materials provided with the distribution.
  23  *  3. Neither the name of Sun Microsystems, Inc. nor the names of its
  24  *     contributors may be used to endorse or promote products derived
  25  *     from this software without specific prior written permission.
  26  *
  27  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  28  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  29  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  30  *  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  31  *  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  32  *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  33  *  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  34  *  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  35  *  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
  36  *  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  37  *  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38  *
  39  *************************************************************************/
  40
  41 // __________ Imports __________
  42
  43 import com.sun.star.uno.UnoRuntime;
  44
  45 public class Helper
  46 {
  47     // __________ static helper methods __________
  48
  49     /** Connect to an office, if no office is running a new instance is started.
  50      * A new connection is established and the service manger from the running
  51      * offic eis returned.
  52      */
  53     static public com.sun.star.uno.XComponentContext connect()
  54         throws Exception
  55     {
  56         // get the remote office component context
  57         com.sun.star.uno.XComponentContext xOfficeContext =
  58             com.sun.star.comp.helper.Bootstrap.bootstrap();
  59
  60         // if connection fails an exception is thrown
  61         System.out.println("Connected to a running office ...");
  62
  63         return xOfficeContext;
  64     }
  65
  66     /** creates and instantiates new document
  67     */
  68     static public com.sun.star.lang.XComponent createDocument(
  69         com.sun.star.uno.XComponentContext xOfficeContext,
  70         String sURL, String sTargetFrame, int nSearchFlags,
  71         com.sun.star.beans.PropertyValue[] aArgs )
  72             throws Exception
  73     {
  74         com.sun.star.lang.XComponent xComponent = null;
  75         com.sun.star.frame.XComponentLoader aLoader =
  76             (com.sun.star.frame.XComponentLoader)UnoRuntime.queryInterface(
  77                 com.sun.star.frame.XComponentLoader.class,
  78                 xOfficeContext.getServiceManager().createInstanceWithContext(
  79                     "com.sun.star.frame.Desktop", xOfficeContext));
  80
  81         xComponent = (com.sun.star.lang.XComponent)UnoRuntime.queryInterface(
  82             com.sun.star.lang.XComponent.class, aLoader.loadComponentFromURL(
  83                 sURL, sTargetFrame, nSearchFlags, aArgs ) );
  84
  85         if ( xComponent == null )
  86             throw new Exception( "could not create document: " + sURL );
  87         return xComponent;
  88     }
  89 }