From Apache OpenOffice Wiki
< Documentation‎ | DevGuide
Revision as of 13:17, 27 September 2007 by Cc208500 (Talk)

Jump to: navigation, search


Enable Java in uses a Java Virtual Machine to instantiate components written in Java. From 2.0 on, Java is found automatically during startup, or latest when Java functionality is required. If you prefer to preselect a JRE or JDK, or if no Java is found, you can configure Java using the Tools – Options dialog in and select the section – Java section. In older versions of you can also easily tell the office which JVM to use: launch the jvmsetup executable from the programs folder under the, select an installed JRE or JDK and click OK. Close the including the Quickstarter in the taskbar and restart Furthermore, open the Tools - Options dialog in, select the section - Security and make sure that the Java enable option is checked.

Using the Java UNO runtime and API in your IDE

Next, the API and Java UNO runtime class files must be made known to the Java IDE. For NetBeans the necessary jar files are made available by simply installing the API Plugin for NetBeans. After the configuration the plugin installs a new library in NetBeans that can be used in projects directly. The library will be automatically added to new projects created with the project wizards coming with the plugin. The following steps show how to install the plugin in NetBeans 5.5 or higher and how to create a new UNO client application project.

  1. Install and start NetBeans
  2. from the Tools menu, select Update center. check mark at least the NetBeans Update Center and press Next. Under Features search for the entry API Plugin, select the entry, Add it, press Next, accept the license and follow the next steps to install it completely.
  3. A plugin specific configuration dialog comes up and required the input of a PATH to a valid office and SDK installation . After completeion of this dialog the plugin is installed and configured correctly.
  4. From the File menu, select New Project. Select category and select the Client Application. Follow the next step and finish the project wizard.
  5. A new project with your specified name is created. The main function of a generated JAVA skeleton contains already the UNO bootstrap function that gives you access to an office context object as main entry point to get started with the API. The context object is from a remote office instance that is connected over a named pipe connection and the default office is started automatically if no instance is running.

Add the API Reference to your IDE

We recommend to add the API and the Java UNO reference to your Java IDE to get online help for the API and the Java UNO runtime. The generated reference documentation provides Javadoc conform index files that can be integrated in most Java IDEs. In NetBeans the IDL reference is automatically integrated with the installation of the API Plugin.

Using the reference in NetBeans is quite simple, type an IDL type in the editor and press F1. A further useful feature is the code completion feature that you get also automatically when you install the plugin.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools