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