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.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 * @deprecated 39 */ 40 public interface OfficeConnection 41 extends XComponent 42 { 43 /** 44 * Sets a connection URL. 45 * 46 * @param url This is UNO URL which describes the type of a connection. 47 */ 48 void setUnoUrl(String url) 49 throws java.net.MalformedURLException; 50 51 /** 52 * Sets an AWT container catory. 53 * 54 * @param containerFactory This is a application provided AWT container 55 * factory. 56 */ 57 void setContainerFactory(ContainerFactory containerFactory); 58 59 /** 60 * Retrives the UNO component context. 61 * Establishes a connection if necessary and initialises the 62 * UNO service manager if it has not already been initialised. 63 * 64 * @return The office UNO component context. 65 */ 66 XComponentContext getComponentContext(); 67 68 /** 69 * Creates an office window. 70 * The window is either a sub-class of java.awt.Canvas (local) or 71 * java.awt.Container (RVP). 72 * 73 * This method does not add add the office window to its container. 74 * 75 * @param container This is an AWT container. 76 * @return The office window instance. 77 */ 78 OfficeWindow createOfficeWindow(Container container); 79 } 80