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