1 /************************************************************************* 2 * 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * Copyright 2000, 2010 Oracle and/or its affiliates. 6 * 7 * OpenOffice.org - a multi-platform office productivity suite 8 * 9 * This file is part of OpenOffice.org. 10 * 11 * OpenOffice.org is free software: you can redistribute it and/or modify 12 * it under the terms of the GNU Lesser General Public License version 3 13 * only, as published by the Free Software Foundation. 14 * 15 * OpenOffice.org is distributed in the hope that it will be useful, 16 * but WITHOUT ANY WARRANTY; without even the implied warranty of 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18 * GNU Lesser General Public License version 3 for more details 19 * (a copy is included in the LICENSE file that accompanied this code). 20 * 21 * You should have received a copy of the GNU Lesser General Public License 22 * version 3 along with OpenOffice.org. If not, see 23 * <http://www.openoffice.org/license.html> 24 * for a copy of the LGPLv3 License. 25 * 26 ************************************************************************/ 27 28 package com.sun.star.comp.beans; 29 30 import java.awt.Container; 31 32 import com.sun.star.lang.XComponent; 33 import com.sun.star.uno.XComponentContext; 34 35 /** 36 * This abstract class reprecents a connection to the office 37 * application. 38 39 @deprecated 40 */ 41 public interface OfficeConnection 42 extends XComponent 43 { 44 /** 45 * Sets a connection URL. 46 * 47 * @param url This is UNO URL which describes the type of a connection. 48 */ 49 void setUnoUrl(String url) 50 throws java.net.MalformedURLException; 51 52 /** 53 * Sets an AWT container catory. 54 * 55 * @param containerFactory This is a application provided AWT container 56 * factory. 57 */ 58 void setContainerFactory(ContainerFactory containerFactory); 59 60 /** 61 * Retrives the UNO component context. 62 * Establishes a connection if necessary and initialises the 63 * UNO service manager if it has not already been initialised. 64 * 65 * @return The office UNO component context. 66 */ 67 XComponentContext getComponentContext(); 68 69 /** 70 * Creates an office window. 71 * The window is either a sub-class of java.awt.Canvas (local) or 72 * java.awt.Container (RVP). 73 * 74 * This method does not add add the office window to its container. 75 * 76 * @param container This is an AWT container. 77 * @return The office window instance. 78 */ 79 OfficeWindow createOfficeWindow(Container container); 80 } 81