incubator-ooo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ksch...@apache.org
Subject svn commit: r1206901 [2/20] - in /incubator/ooo/ooo-site/trunk/content/udk/java: ./ documentation/ documentation/com/ documentation/com/sun/ documentation/com/sun/star/ documentation/com/sun/star/comp/ documentation/com/sun/star/comp/bridgefactory/ doc...
Date Sun, 27 Nov 2011 23:05:38 GMT
Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/java_component_howto.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/java_component_howto.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/java_component_howto.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/java_component_howto.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,479 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<HEAD>
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<TITLE>How to write a UNO component in Java</TITLE>
+	<META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Win32)">
+	<META NAME="CLASSIFICATION" CONTENT="Writing a simple UNO component">
+	<META NAME="KEYWORDS" CONTENT="UNO,component">
+</HEAD>
+<BODY LINK="#444488" VLINK="#444488" BGCOLOR="#eeeeff">
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	<COL WIDTH=75>
+	<TR>
+		<TD BGCOLOR="#666699">
+			
+      <H1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none"><A HREF="http://www.openoffice.org/"><IMG SRC="../../images/open_office_org_logo.gif" NAME="Grafik1" ALT="OpenOffice" ALIGN=RIGHT WIDTH=109 HEIGHT=54 BORDER=0></A><FONT COLOR="#ffffff"><FONT SIZE=6>How 
+        to write a UNO component in Java</FONT></FONT></H1>
+		</TD>
+	</TR>
+</TABLE>
+<HR SIZE=3 noshade>
+<TABLE WIDTH=68% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+  <COL WIDTH=194*> <COL WIDTH=31*> <COL WIDTH=31*> 
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><FONT SIZE=4>Contents</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% height="123"> 
+      <p><a href="#Introduction">Introduction</a><br>
+        <a href="#Component">Writing a component</a><br>
+        <a href="#IDL">The UNO Base Interface and IDL</a><br>
+        <a href="#Register"></a><a href="#Register"></a><a href="#Factory">Getting 
+        a factory for the component</a><br>
+        <a href="#Register">Register the component</a><br>
+        <a href="#SeveralServices">Support several services</a><br>
+        <a href="#Build">How to build a component</a><br>
+	<a href="#Deployment">Deployment hints</a></p>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><font color="#ffffff"><font size=4><a name="Introduction"></a><font color="#ffffff"></font></font></font><FONT SIZE=4>Introduction</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% height="58"> 
+      <P STYLE="margin-bottom: 0cm">In this tutorial the implementation of an 
+        <a href="http://udk.openoffice.org/">UNO</a> component in the programming 
+        language Java is treated. To the better comprehensibility this tutorial 
+        is based on a component for the examination of an object of the <a href="http://api.openoffice.org/">OpenOffice 
+        API</a> (<a href="http://whiteboard.openoffice.org/Inspector/index.html">Instance 
+        Inspector</a>). Components like the Instance Inspector should be accessible 
+        as beans which you can incorporate into your programs. Actually components 
+        implement OpenOffice API services which are an abstract concept providing 
+        certain interfaces and properties. You can receive further information 
+        for the creation of UNO components in the programming language C++ under 
+        the following HTTP address: <a href="http://udk.openoffice.org/cpp/man/component_tutorial.html">http://udk.openoffice.org/cpp/man/component_tutorial.html</a></P>
+    </TD>
+  </TR>
+  <tr> 
+    <td colspan=3 width=100% bgcolor="#666699"> 
+      <h3 align=LEFT style="margin-top: 0cm; text-decoration: none"><font color="#ffffff"><font size=4><a name="Component"></a><font color="#ffffff"></font>Writing 
+        a component</font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width=100% height="580"> 
+      <p style="margin-bottom: 0cm">In general a component can be devided into 
+        two main parts and therefore into two classes:</p>
+      <ul>
+        <li>The component as a concrete implementation of the service description: 
+          in order to provide the functional specification all required interfaces 
+          have to be implemented.</li>
+        <li>The factory and the service info: The factory instantiates the component 
+          on demand. It must be an implemetation of the interface <i>com.sun.star.lang.XSingleServiceFactory</i>.</li>
+      </ul>
+      <p>The necessary classes could be nested as follows: </p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+public class InstanceInspector {<br>  static private final boolean DEBUG = false;
+
+  static public class _InstanceInspector implements XInstanceInspector, 
+                                                    XInitialization, 
+                                                    XTypeProvider {
+    static private final String __serviceName = &quot;org.OpenOffice.InstanceInspector&quot;;
+    private XMultiServiceFactory _xMultiServiceFactory;
+    ...
+ 
+    public _InstanceInspector(XMultiServiceFactory xMultiServiceFactory) {
+         _xMultiServiceFactory = xMultiServiceFactory;
+    }
+    
+    public void inspect(java.lang.Object a) throws com.sun.star.uno.RuntimeException {
+      ...
+    }
+    ...
+  }
+  ...
+}</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>The class <i>InstanceInspector</i> should provide two methods which are 
+        called by the Java Loader. One method (<i><a href="#Factory">__getServiceFactory()</a></i>) 
+        returns a <i><a href="http://api.openoffice.org/common/ref/com/sun/star/lang/XSingleServiceFactory.html">XSingleServiceFactory</a></i> 
+        for creating the component. The other method (<i><a href="#Register">__writeRegistryServiceInfo()</a></i>) 
+        writes the service information into the given registry key.</p>
+      <p>The local class <i>_InstanceInspector</i> implements three interfaces 
+        and is responsible for the concrete implementation of the service description 
+        (method <i>inspect()</i>).</p>
+    </td>
+  </tr>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699"> 
+      <H3><A NAME="IDL"></A><font color="#ffffff">The UNO Base Interface and IDL</font></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% height="427"> 
+      <P STYLE="margin-bottom: 0cm">An interface is a collection of methods that 
+        provide a certain functionality. In order to provide a language-independent 
+        programming environment, all interfaces must be described in an interface 
+        definition language (IDL). As a rule, UNO interfaces are specified in 
+        the <a href="http://www.openoffice.org/project/udk/common/man/idl_syntax.html">UNO 
+        IDL</a> and must be derived from a mandatory base interface (<a href="http://api.openoffice.org/common/ref/com/sun/star/uno/XInterface.html">com.sun.star.uno.XInterface</a>). 
+        This base interface provides three methods: queryInterface(), acquire(), 
+        and release(). Because UNO supports multiple interfaces, the queryInterface() 
+        method is necessary for navigating between the different interfaces (comparable 
+        to COM). The acquire() and release() methods handle the life cycle of 
+        UNO objects (global reference counting). Cyclic references are handled 
+        by the <a href="http://api.openoffice.org/common/ref/com/sun/star/lang/XComponent.html">com.sun.star.lang.XComponent 
+        interface</a>. Error handling is based on exceptions. </P>
+      <P STYLE="margin-bottom: 0cm">IDL's similarity with the common programming 
+        language C++ is remarkable, however IDL contains exclusively syntax for 
+        data description and no statements. </P>
+      <P STYLE="margin-bottom: 0cm">The UNO IDL file for the Instance Inspector 
+        could look as follows:</P>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="222"> 
+            <pre>
+
+<font color="#000000">#include &lt;com/sun/star/uno/XInterface.idl&gt; <br>module org { 
+  module OpenOffice { 
+    interface XInstanceInspector: com::sun::star::uno::XInterface { <br>      void inspect( [in] any aInstance );<br>    };
+  };
+};
+</font></pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <P STYLE="margin-bottom: 0cm">The IDL compiler <a href="http://udk.openoffice.org/common/man/tools.html#idlc">idlc</a> 
+        transforms interface definitions written in IDL into urd files (Uno Reflection 
+        Data). The urd files are then going to be merged into the type library 
+        (rdb).</P>
+      <P STYLE="margin-bottom: 0cm">For more details on building a component you 
+        should take a look at the section <a href="#Build">How to build a component</a> 
+        or the document <a href="http://udk.openoffice.org/java/man/map_idl_to_java.html#Mapping%20of%20interface">Mapping 
+        of UNO IDL to Java</a>.</P>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699"> 
+      <H3><A NAME="Factory"></A><FONT COLOR="#ffffff"><FONT FACE="Times New Roman, serif"><FONT SIZE=4><b>Getting 
+        a factory for the component</b></FONT></FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% height="387"> 
+      <P STYLE="margin-bottom: 0cm">The Service Manager is the central location 
+        where components are instantiated. It comes with a list of all available 
+        services registered. If a component is requested the Service Manager searches 
+        its list for a given service, in order to get the assigned factory. The 
+        Java Loader extracts the factory of a component with the aid of a static 
+        method called <i>__getServiceFactory</i>. This method should be implemented 
+        to return a customized factory for the component. Otherwise the Java Loader 
+        will return a default factory.</P>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+// Gives a factory for creating the service. 
+// This method is called by the JavaLoader 
+public static XSingleServiceFactory __getServiceFactory(String implName,
+                                                        XMultiServiceFactory multiFactory,
+                                                        XRegistryKey regKey) { 
+  XSingleServiceFactory xSingleServiceFactory = null;         
+  if (implName.equals(_InstanceInspector.class.getName()) ) 
+    xSingleServiceFactory = FactoryHelper.getServiceFactory(_InstanceInspector.class,
+                                                            _InstanceInspector.__serviceName,
+                                                            multiFactory,
+                                                            regKey); 
+  return xSingleServiceFactory; 
+} </pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>A special class <i>FactoryHelper</i> provides methods for implementing 
+        components. This class has default implementations for getting the service 
+        factory (method <i>__getServiceFactory</i>) and for writing the service 
+        info into the registry (method <i>writeRegistryServiceInfo</i>). Please note,
+	if you implement the service as inner class, then it must be a static inner
+	class. If not, then the constructors of the inner class expect an instance of
+	the outer class as first parameter. However, the FactoryHelper class cannot
+	provide one.</p>
+      <p>The field <i>__serviceName</i> in your class should specifiy the name 
+        of your service.</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="32"> 
+            <pre>
+
+static private final String __serviceName = &quot;org.OpenOffice.InstanceInspector&quot;;</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>If the property is not specified the default factory sets the components 
+        name (class name) as the service name.</p>
+    </TD>
+  </TR>
+  <tr> 
+    <td colspan=3 width=100% bgcolor="#666699"> 
+      <h3><a name="Register"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>Register 
+        the component</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width=100% height="129"> 
+      <p style="margin-bottom: 0cm">Every component should be registered with 
+        its implementation name for the service. Therefore the method <i>__writeRegistryServiceInfo</i> 
+        is responsible for writing the service information into the registry. Registration tools,such
+	as regcomp.exe, need to know what java class contains that method. This information has to be
+	placed into the manifest file. The entry has this format: <br>
+	RegistrationClassName: TheNameOfTheClass <br>
+	</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+// Writes the service information into the given registry key.
+// This method is called by the JavaLoader
+public static boolean __writeRegistryServiceInfo(XRegistryKey regKey)          {
+  return FactoryHelper.writeRegistryServiceInfo(_InstanceInspector.class.getName(),
+                                                _InstanceInspector.__serviceName,
+                                                regKey);
+}</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width=100% bgcolor="#666699"> 
+      <h3><a name="SeveralServices"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>Supporting 
+        several services</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width=100% height="109"> 
+      <p style="margin-bottom: 0cm">If the component should support more than 
+        one service all these services should be specified in the field <i>__serviceName</i>.</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+static private final String[] __serviceName = { &quot;com.sun.star.X&quot;, &quot;com.sun.star.Y&quot; };</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>Furthermore the component should be able to access the service manager. 
+        In order to set the service manager at the component the default factory 
+        uses the optional method <i>__setServiceManager</i>.</p>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width=100% bgcolor="#666699"> 
+      <h3><a name="Build"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>How 
+        to build a component</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width=100% height="468"> 
+      <p style="margin-bottom: 0cm">The following steps describe the build process 
+        by the example of the <a href="http://whiteboard.openoffice.org/Inspector/index.html">Instance 
+        Inspector</a> with the operating system Windows. First you should set 
+        the necessary variables. Perhaps you should adapt also the following commands 
+        to other operating systems requirements.</p>
+      <p style="margin-bottom: 0cm">The idl compiler <a href="http://udk.openoffice.org/common/man/tools.html#idlc">idlc</a> 
+        transforms the interface definitions written in idl into an urd file:</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+idlc -I%ODKPATH%\idl .\XInstanceInspector.idl
+</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p></p>
+      <p>The urd file is then going to be merged into the type library (rdb):</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+regmerge .\Types.rdb /UCR .\XInstanceInspector.urd</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p><a href="http://udk.openoffice.org/common/man/tools.html#regmerge">Regmerge</a> 
+        is a small tool to merge different registry files under a specified key 
+        into another registry file:</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+regmerge %OFFICEPROGRAMPATH%\applicat.rdb / .\Types.rdb</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>The <a href="http://udk.openoffice.org/common/man/tools.html#javamaker">javamaker</a> 
+        generates the appropriate java file for each idl type:</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+javamaker -Torg.OpenOffice.XInstanceInspector -BUCR .\Types.rdb 
+                                                  %ODKPATH%\windows\bin\applicat.rdb</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>Compile the java files:</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+javac -g -deprecation -classpath %OFFICEPROGRAMPATH%\classes\ridl.jar;
+                                 %OFFICEPROGRAMPATH%\classes\jurt.jar;
+                                 %OFFICEPROGRAMPATH%\classes\unoil.jar 
+                                 .\org\OpenOffice\XInstanceInspector.java 
+                                 .\InstanceInspector.java</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>Use the existing manifest file 'Manifest' and archive all the java files 
+        into 'InstanceInspector.jar':<br>
+      </p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+jar -cvfm .\InstanceInspector.jar .\Manifest 
+          .\org\OpenOffice\XInstanceInspector.class
+          .\InstanceInspector.class 
+          .\InstanceInspector$_InstanceInspector.class 
+          .\InstanceInspector$1.class 
+          .\InstanceInspector$2.class 
+          .\InstanceInspector$3.class 
+          .\InstanceInspector$4.class</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p>Registering the service, id est the jar-file:<br>
+      </p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="18"> 
+            <pre>
+
+java -classpath %OFFICEPROGRAMPATH%\classes\unoil.jar;
+                %OFFICEPROGRAMPATH%\classes\sandbox.jar;
+                %OFFICEPROGRAMPATH%\classes\jut.jar;
+                %OFFICEPROGRAMPATH%\classes\java_uno.jar;
+                %OFFICEPROGRAMPATH%\classes\ridl.jar;
+                %OFFICEPROGRAMPATH%\classes\jurt.jar;
+                %OFFICEPROGRAMPATH%\classes\juh.jar 
+                com.sun.star.tools.uno.RegComp %OFFICEPROGRAMPATH%\applicat.rdb register 
+                &quot;file:///e:/Trash/InstanceInspector.jar&quot; com.sun.star.loader.Java2</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+    </td>
+  </tr>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100% height="16"> 
+      <P>&nbsp; </P>
+    </TD>
+  </TR>
+  </TR>
+    <tr> 
+    <td colspan=3 width=100% bgcolor="#666699"> 
+      <h3><a name="Deployment"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b> 
+        Deployment hints</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 width= 100%>
+    All interfaces, which are used by the component, have to be known to the Java Virtual Machine. 
+    The standard interfaces are contained in the ridl.jar file. That jar is always in the classpath
+    and hence the VM can locate the interface classes. <br />
+    If you define your own interfaces, then you usually do not want to put them into the ridljar
+    (builds ridl.jar) project from the beginning. Instead you probably like to keep them in the jar
+    file of your component, or in a separate class or jar file during development. If the latter is
+    the case, then you must make sure that the interfaces are in the classpath during registration
+    and when running your component. This can be achieved by editing the SytemClasspath entry (office_dir\user\config\java.ini, or javarc) or
+    the user classpath in the options dialog (tools menu, StarOffice/Security). <br />
+    Also, do not forget to merge the interface with the applicat.rdb.
+</td>
+</tr>
+    <TR> 
+    <TD COLSPAN=3 WIDTH=100%> 
+      <HR SIZE=1 noshade>
+    </TD>
+  <TR> 
+    <TD WIDTH=50% BGCOLOR="#666699"> 
+      <P ALIGN=LEFT><FONT COLOR="#ffffff"> Author: <A HREF="mailto:Bertram.Nolte@germany.sun.com"><FONT COLOR="#ffffff">Bertram 
+        Nolte</FONT></A> ( 
+        <!-- #BeginDate format:IS1m -->2002-01-11  10:29<!-- #EndDate -->
+        )<BR>
+        <I>Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, 
+        CA 94303 USA.</I></FONT> </P>
+    </TD>
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100%> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+</TABLE>
+<HR SIZE=3 noshade>
+</BODY>
+</HTML>

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/java_component_howto.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/java_uno_bridge.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/java_uno_bridge.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/java_uno_bridge.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/java_uno_bridge.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,26 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+  <head>
+	<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<title>The Sandbox</title>
+	<meta NAME="KEYWORDS" CONTENT="sandbox">
+  </head>
+  <body LINK="#444488" VLINK="#444488" bgcolor="#eeeeff"><A NAME="__Top__"></A>
+
+    <table WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	  <col WIDTH=75>
+	  <tr>
+		<td bgcolor="#666699">
+          <h1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none">
+	        <font COLOR="#ffffff" SIZE=6>The Java-Uno/Binary-Uno Bridge</font>
+		  </h1>
+		</td>
+	  </tr>
+    </table>
+
+	The native java-Uno/Binary-Uno bridge works, by connecting to remote
+	bridges together. This is encapsulated as an uno bridge and is placed
+	in a library called libjava_uno.so.
+
+  </body>
+</html>

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/java_uno_bridge.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/javaloader.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/javaloader.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/javaloader.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/javaloader.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,121 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<HEAD>
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<TITLE>Java Component Loader</TITLE>
+	<META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Win32)">
+	<META NAME="CLASSIFICATION" CONTENT="Writing a simple UNO component">
+	<META NAME="KEYWORDS" CONTENT="UNO,component">
+</HEAD>
+<BODY LINK="#444488" VLINK="#444488" BGCOLOR="#eeeeff">
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	<COL WIDTH=75>
+	<TR>
+		
+    <TD BGCOLOR="#666699"> 
+      <H1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none"><A HREF="http://www.openoffice.org/"><IMG SRC="../../images/open_office_org_logo.gif" NAME="Grafik1" ALT="OpenOffice" ALIGN=RIGHT WIDTH=109 HEIGHT=54 BORDER=0></A><font color="#ffffff" size="6">Java 
+        Component Loader</font></H1>
+		</TD>
+	</TR>
+</TABLE>
+<HR SIZE=3 noshade>
+<TABLE BORDER=0 CELLPADDING=4 CELLSPACING=0 WIDTH=100%>
+  <COL WIDTH=194*> <COL WIDTH=31*> <COL WIDTH=31*> 
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><FONT SIZE=4>Contents</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 height="26"> 
+      <p><a href="#Introduction">Introduction</a><br>
+        <a href="#ExampleBasic">Example in OpenOffice Basic</a></p>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><font color="#ffffff"><font size=4><a name="Introduction"></a><font color="#ffffff"></font></font></font><FONT SIZE=4>Introduction</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 height="38"> 
+      <P STYLE="margin-bottom: 0cm">Before you can take advantage of your component 
+        written in the programming language Java you have to load the Java component. 
+        The process of the loading of the component is enabled by the Java Component 
+        Loader.</P>
+      <P STYLE="margin-bottom: 0cm">In the following one describes, how you can 
+        load a component written in Java. The example is based on the programming 
+        language OpenOffice Basic. </P>
+    </TD>
+  </TR>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3><a name="ExampleBasic"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>Example 
+        in OpenOffice Basic</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 height="175"> 
+      <p style="margin-bottom: 0cm">If you want access the services implemented 
+        in a Java class file, you must create the UNO service &quot;com.sun.star.loader.Java2&quot; 
+        to get the Java loader.</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="2"> 
+            <pre>createUnoService(&quot;com.sun.star.loader.Java2&quot;)</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p style="margin-bottom: 0cm">In order to register your component you should 
+        create the implementation registration and register the desired service.</p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="2"> 
+            <pre>regImpl = createUnoService(&quot;com.sun.star.registry.ImplementationRegistration&quot;)<br>regImpl.registerImplementation(&quot;com.sun.star.loader.Java2&quot;, &quot;file:///E:/Trash/Inspector/InstanceInspector.jar&quot;, null)</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+      <p style="margin-bottom: 0cm">After suitable preparation you can create 
+        your service:<br>
+      </p>
+      <table width="100%" bgcolor=#ffffcc>
+        <tbody> 
+        <tr> 
+          <td height="2"> 
+            <pre>objectInstanceInspector = createUnoService(&quot;com.sun.star.beans.InstanceInspector&quot;)</pre>
+          </td>
+        </tr>
+        </tbody> 
+      </table>
+    </td>
+  </tr>
+  <TR> 
+    <TD COLSPAN=3> 
+      <P>&nbsp; </P>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+  <TR> 
+    <TD BGCOLOR="#666699"> 
+      <P ALIGN=LEFT><FONT COLOR="#ffffff"> Author: <A HREF="mailto:Bertram.Nolte@sun.com"><FONT COLOR="#ffffff">Bertram 
+        Nolte</FONT></A> (Mon 18 Jun 2001 14:44:43)<BR>
+        <I>Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.</I></FONT> 
+      </P>
+    </TD>
+  <TR> 
+    <TD COLSPAN=3> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+</TABLE>
+<HR SIZE=3 noshade>
+</BODY>
+</HTML>

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/javaloader.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/javavm.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/javavm.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/javavm.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/javavm.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,32 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+  <head>
+	<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<title>The Sandbox</title>
+	<meta NAME="KEYWORDS" CONTENT="sandbox">
+  </head>
+  <body LINK="#444488" VLINK="#444488" bgcolor="#eeeeff"><A NAME="__Top__"></A>
+
+    <table WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	  <col WIDTH=75>
+	  <tr>
+		<td bgcolor="#666699">
+          <h1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none">
+	        <font COLOR="#ffffff" SIZE=6>The Java Virtual Machine Service</font>
+		  </h1>
+		</td>
+	  </tr>
+    </table>
+
+
+	The service <a href="http://api.openoffice.org/common/ref/com/sun/star/java/JavaVirtualMachine.html">com.sun.star.java.JavaVirtualMachine</a> 
+gives access to a java virtual machine. This service is only usable in process, 
+the given java virtual machine can then be accessed via Java Native Interface. 
+<p> Hints can be given to the service to find the java installation. Just set 
+  the environment variable OO_JAVA_PROPERTIES to your java runtime library.
+<p>Under the operating system Windows an assignment of this environment variable 
+  could look as follows:
+<p>set OO_JAVA_PROPERTIES=RuntimeLib=d:\jdk1.3\jre\bin\hotspot\jvm.dll
+</body>
+</html>
+ 
\ No newline at end of file

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/javavm.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/jurt.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/jurt.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/jurt.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/jurt.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,383 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<HEAD>
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<TITLE>JURT (Java Uno RunTime)</TITLE>
+	<META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Win32)">
+	<META NAME="CLASSIFICATION" CONTENT="Writing a simple UNO component">
+	<META NAME="KEYWORDS" CONTENT="UNO,component">
+</HEAD>
+<BODY LINK="#444488" VLINK="#444488" BGCOLOR="#eeeeff">
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	<COL WIDTH=75>
+	<TR>
+		
+    <TD BGCOLOR="#666699"> 
+      <H1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none"><A HREF="http://www.openoffice.org/"><IMG SRC="../../images/open_office_org_logo.gif" NAME="Grafik1" ALT="OpenOffice" ALIGN=RIGHT WIDTH=109 HEIGHT=54 BORDER=0></A><font color="#ffffff" size=6>JURT 
+        (Java Uno RunTime)</font><FONT COLOR="#ffffff"></FONT></H1>
+		</TD>
+	</TR>
+</TABLE>
+<HR SIZE=3 noshade>
+<TABLE BORDER=0 CELLPADDING=4 CELLSPACING=0 WIDTH=100%>
+  <COL WIDTH=194*> <COL WIDTH=31*> <COL WIDTH=31*> 
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><FONT SIZE=4>Contents</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3> 
+      <p><a href="#Introduction">Introduction</a><br>
+        <a href="#Introduction">Documentation</a><br>
+        <a href="#BaseFunctionality"></a><a href="#BaseServices">Base services</a><br>
+        <a href="#BaseFunctionality">Base functionality</a><br>
+        <a href="#Register"></a><a href="#Register"></a><a href="#Integration">Java 
+        integration </a><br>
+        <a href="#RemoteAPI">Remote API</a><br>
+        <a href="#WritingProtocols">How to write a protocol with the remote API</a><br>
+        <a href="#WritingBridges">How to write a bridge with the remote API</a></p>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><font color="#ffffff"><font size=4><a name="Introduction"></a><font color="#ffffff"></font></font></font><FONT SIZE=4>Introduction</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 height="47"> 
+      <P STYLE="margin-bottom: 0cm">JURT is the core of Java-UNO and the Java 
+        UNO language binding. It includes base functionality for accessing bridges/mappings 
+        and environments. Also some basic components are placed here (like components 
+        placed in stoc for binary uno).<br>
+        Since JURT is still in a development process, so far in the documentation 
+        (<a href="../ref/overview-tree.html">hierarchy</a> for all packages) 
+        only already final classes were considered. Therefore, you should visit 
+        this Internet page after a certain time interval again. </P>
+      </TD>
+  </TR>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3 align=LEFT style="margin-top: 0cm; text-decoration: none"><font color="#ffffff"><font size=4><a name="BaseServices"></a>Base 
+        services</font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 height="180"> 
+      <p>JURT provides the following services: 
+      <table border="1">
+        <tr> 
+          <td><b>Service</b></td>
+          <td><b>Description</b></td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href=../ref/com/sun/star/comp/bridgefactory/package-tree.html>BridgeFactory</a></td>
+          <td>Allows to create new or access existing interprocess bridges.</td>
+        </tr>
+        <tr> 
+          <td><a href=../ref/com/sun/star/comp/servicemanager/package-tree.html>ServiceManager</a></td>
+          <td>Provides a collection of implementations for services.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href=../ref/com/sun/star/comp/loader/package-tree.html>JavaLoader</a></td>
+          <td>Makes it possible to access the services implemented in a Java class 
+            file.</td>
+        </tr>
+        <tr> 
+          <td><a href="../ref/com/sun/star/comp/helper/package-tree.html">Helper</a></td>
+          <td>Allows to bootstrap a servicemanager with the jurt base components 
+            registered. </td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href="../ref/com/sun/star/comp/security/package-tree.html">Security</a> 
+            / <a href="../ref/com/sun/star/comp/security/auth/login/package-tree.html">Login</a></td>
+          <td>Access control, login context</td>
+        </tr>
+        <tr> 
+          <td><a href=../ref/com/sun/star/comp/urlresolver/package-tree.html>UnoUrlResolver</a></td>
+          <td>Provides the ability to access outer processes, resolving them by 
+            their name.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href="../ref/com/sun/star/comp/connections/package-tree.html">Acceptor/Connector</a></td>
+          <td>The base connector and acceptor services are defined to delegate 
+            to custom services.</td>
+        </tr>
+      </table>
+    </td>
+  </tr>
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3><A NAME="BaseFunctionality"></A><font color="#ffffff">Base functionality</font></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 height="529">Base functionality of JURT is provided by the following 
+      classes. 
+      <table border="1" width="637">
+        <tr> 
+          <td><b>Class</b></td>
+          <td><b>Description</b></td>
+        </tr>
+        <tr> 
+          <td><a href="../ref/com/sun/star/uno/Ascii.html">Ascii</a></td>
+          <td>The Ascii class represents the IDL build in type ascii.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href="../ref/com/sun/star/uno/AsciiString.html">AsciiString</a></td>
+          <td>The AsciiString class represents the IDL build in type asciistring. 
+          </td>
+        </tr>
+        <tr> 
+          <td>BridgeTurner</td>
+          <td>This class inverts the direction of a given bridge. It is needed, 
+            if a bridge of only one direction is available.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href="../ref/com/sun/star/uno/IBridge.html">IBridge</a></td>
+          <td>This is abstract interface for Bridges. Bridges are able to map 
+            one object from one environment to another and vice versa.</td>
+        </tr>
+        <tr> 
+          <td><a href="../ref/com/sun/star/uno/IEnvironment.html">IEnvironment</a></td>
+          <td>This is the interface which environments have to implement. With 
+            this interface objects can be registered and revoked from an environment. 
+            This is class is derived from the binary UNO runtime environment.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href="../ref/com/sun/star/uno/IMapping.html">IMapping</a></td>
+          <td>With a mapping objets can be mapped from one environment to another. 
+            This interface exits for api compatibility reasons with binary UNO.</td>
+        </tr>
+        <tr> 
+          <td><a href="../ref/com/sun/star/uno/IQueryInterface.html">IQueryInterface</a></td>
+          <td>This is the delegator interface for objects implementing interfaces 
+            for an underlying object. Call are delegated through the UnoRuntime 
+            to this interface.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td height="20"> 
+            <p><a href="../ref/com/sun/star/uno/MappingException.html">MappingException</a></p>
+          </td>
+          <td height="20">The mapping Exception.</td>
+        </tr>
+        <tr> 
+          <td>MappingWrapper</td>
+          <td>This class wraps an IBridge to be a Mapping.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td><a href="../ref/com/sun/star/uno/UnoRuntime.html">UnoRuntime</a></td>
+          <td>The UnoRuntime class is the central class needed for implementing 
+            or using UNO components in Java. 
+            <p>The Methods queryInterface and isSame delegate calls to the implementing 
+              objects and are used instead of casts and identity comparisons.<br>
+            </p>
+            <p>The other methods are used for managing bridges, which enable a 
+              user to map objects out to or into java.</p>
+          </td>
+        </tr>
+      </table>
+      
+      
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3><A NAME="Integration"></A><FONT COLOR="#ffffff"><FONT FACE="Times New Roman, serif"><FONT SIZE=4><b>Java 
+        integration</b></FONT></FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3> 
+      <p>How to write integration stuff with the pure runtime? 
+      <p>In the following important classes of the Java Runtime are described. 
+        Would you kindly note that these classes are still in a further development 
+        process. Therefore the following Java classes can be subject to important 
+        modifications (com.sun.star.lib.uno.*). 
+      <p> Java integration classes: 
+      <table width="606" border="1">
+        <tr bgcolor="#FFFFCC"> 
+          <td height="2"><b>Class</b></td>
+          <td height="2"><b>Description</b></td>
+        </tr>
+        <tr> 
+          <td height="2">IRequester</td>
+          <td height="2">Through this interface proxies delegate their method 
+            calls.</td>
+        </tr>
+        <tr bgcolor="#FFFFCC"> 
+          <td height="49">Proxy</td>
+          <td height="49"> The purpose of this class is to provide a ProxyFactory. 
+            Proxies are needed to integrate objects of other environments seamsless 
+            into Java. A proxy delegates all method calls to provided object.</td>
+        </tr>
+      </table>
+      
+    </TD>
+  </TR>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3><a name="RemoteAPI"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>Remote 
+        API</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 height="718"> 
+      <p>Similarly as the classes described above also the remote API is in the 
+        development. Therefore the following Java classes can be subject to important 
+        modifications (com.sun.star.lib.uno.*). </p>
+      <table width="606" border="1">
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC"><b>Class</b></td>
+          <td height="2" bgcolor="#FFFFCC"><b>Description</b></td>
+        </tr>
+        <tr> 
+          <td height="2">IProtocol</td>
+          <td height="2">This interface provides an abstraction for protocols 
+            for remote bridges.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">Protocol</td>
+          <td height="2" bgcolor="#FFFFCC">This class implements the complete 
+            IIOP protocol from corba. The functionality is reachable through the 
+            IProtocol interface.</td>
+        </tr>
+        <tr> 
+          <td height="2">IMarshal</td>
+          <td height="2">This interface provides an abstraction for protocols 
+            for remote bridges.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">IUnmarshal</td>
+          <td height="2" bgcolor="#FFFFCC">This interface provides an abstraction 
+            for protocols for remote bridges.</td>
+        </tr>
+        <tr> 
+          <td height="2">IReceiver</td>
+          <td height="2">This interface is an abstraction for giving back a reply 
+            for a request.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">Job</td>
+          <td height="2" bgcolor="#FFFFCC">The Job is an abstraction for tasks 
+            which have to be done remotely because of a method invocation.</td>
+        </tr>
+        <tr> 
+          <td height="2">IMessage</td>
+          <td height="2">The purpose of this class is to be an abstraction for 
+            messages for remote communication.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">IThreadPool</td>
+          <td height="2" bgcolor="#FFFFCC">This interface is an abstraction of 
+            the various threadpool implementations.</td>
+        </tr>
+        <tr> 
+          <td height="2">ThreadID</td>
+          <td height="2">This is the global thread id.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">ThreadPool</td>
+          <td height="2" bgcolor="#FFFFCC">This class delegates to a specific 
+            thread pool, which has to implement IThreadPool threadpool implementations.</td>
+        </tr>
+        <tr> 
+          <td height="2">IThreadPoolFactory</td>
+          <td height="2">This class delegates to a specific thread pool, which 
+            has to implement IThreadPool threadpool implementations.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">JavaThreadPool</td>
+          <td height="2" bgcolor="#FFFFCC">This class implements a java thread 
+            pool.</td>
+        </tr>
+        <tr> 
+          <td height="2">JavaThreadPoolFactory</td>
+          <td height="2">&nbsp;</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">JobQueue</td>
+          <td height="2" bgcolor="#FFFFCC">The JobQueue implements a queue for 
+            jobs. For every jobs thread id exists a job queue which is registered 
+            at the ThreadPool. A JobQueue is splitted in a sync job queue and 
+            an async job queue. The sync job queue is the registerd queue, it 
+            delegates async jobs (put by putjob) into the async queue, which is 
+            only known by the sync queue.</td>
+        </tr>
+        <tr> 
+          <td height="2">NativeThreadPool</td>
+          <td height="2">This class wrapps the native uno thread pool.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">NativeThreadPoolWrapper</td>
+          <td height="2" bgcolor="#FFFFCC">This class wrapps the native uno thread 
+            pool.</td>
+        </tr>
+        <tr> 
+          <td height="2">ThreadPoolFactory</td>
+          <td height="2">This class delegates to a specific thread pool, which 
+            has to implement IThreadPool threadpool implementations.</td>
+        </tr>
+        <tr> 
+          <td height="2" bgcolor="#FFFFCC">remote_environment</td>
+          <td height="2" bgcolor="#FFFFCC">&nbsp;</td>
+        </tr>
+      </table>
+      
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3><a name="WritingProtocols"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>How 
+        to write a protocol with the remote API?</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 height="47"> 
+      <p> The <a href="http://udk.openoffice.org/common/man/spec/urp.html">UNO 
+        Remote Protocol </a>is used to transmit UNO calls via process-boundaries 
+        (comparable to iiop in CORBA). This protocol was primarily designed to 
+        minimize the amount of transferred data for a series of oneway calls. 
+        The protocol does not make any assumptions about how the data is transferred. 
+      </td>
+  </tr>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3><a name="WritingBridges"></a><font color="#ffffff"><font face="Times New Roman, serif"><font size=4><b>How 
+        to write a bridge with the remote API?</b></font></font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3> 
+      <p style="margin-bottom: 0cm">The class <i>java_remote_bridge</i> implements 
+        a remote bridge. Therefore various interfaces are implemented. The protocol 
+        to use is passed by name, the bridge then looks for it under <i>com.sun.star.lib.uno.protocols</i>. 
+      </p>
+      </td>
+  </tr>
+  <TR> 
+    <TD COLSPAN=3> 
+      <P>&nbsp; </P>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+  <TR> 
+    <TD BGCOLOR="#666699"> 
+      <P ALIGN=LEFT><FONT COLOR="#ffffff"> Author: <A HREF="mailto:Bertram.Nolte@germany.sun.com"><FONT COLOR="#ffffff">Bertram 
+        Nolte</FONT></A> (Tue 12 Jun 2001 12:12:51)<BR>
+        <I>Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.</I></FONT> 
+      </P>
+    </TD>
+  <TR> 
+    <TD COLSPAN=3> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+</TABLE>
+<HR SIZE=3 noshade>
+</BODY>
+</HTML>

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/jurt.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/lifecycle.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/lifecycle.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/lifecycle.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/lifecycle.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,111 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<HEAD>
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<TITLE>Life cycle of Java components</TITLE>
+	<META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Win32)">
+	<META NAME="CLASSIFICATION" CONTENT="Writing a simple UNO component">
+	<META NAME="KEYWORDS" CONTENT="UNO,component">
+</HEAD>
+<BODY LINK="#444488" VLINK="#444488" BGCOLOR="#eeeeff">
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	<COL WIDTH=75>
+	<TR>
+		
+    <TD BGCOLOR="#666699"> 
+      <H1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none"><A HREF="http://www.openoffice.org/"><IMG SRC="../../images/open_office_org_logo.gif" NAME="Grafik1" ALT="OpenOffice" ALIGN=RIGHT WIDTH=109 HEIGHT=54 BORDER=0></A><font color="#ffffff" size=6>The 
+        life cycle of Java components</font><FONT COLOR="#ffffff"></FONT></H1>
+		</TD>
+	</TR>
+</TABLE>
+<HR SIZE=3 noshade>
+<TABLE BORDER=0 CELLPADDING=4 CELLSPACING=0 WIDTH=100%>
+  <COL WIDTH=194*> <COL WIDTH=31*> <COL WIDTH=31*> 
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><FONT SIZE=4>Contents</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 height="43"> 
+      <p><a href="#Introduction">Introduction</a><br>
+        <a href="#CPlusPlusToJava">C++ object mapped to Java</a><br>
+        <a href="#JavaToCPlusPlus">Java object mapped to C++</a></p>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><font color="#ffffff"><font size=4><a name="Introduction"></a><font color="#ffffff"></font></font></font><FONT SIZE=4>Introduction</FONT></FONT></H3>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3 height="69"> 
+      <p>In Java, objects live as long as they are reachable by a thread. In UNO, 
+        objects have a reference count and live as long as the reference count 
+        is greater than zero. When using pure Java UNO, the normal Java life cycle 
+        mechanism applies. When using Java UNO in cooperation with e.g. binary 
+        UNO, objects live as long as their reference count is not zero.</p>
+      <p>In the following the life cycle of Java and C++ objects are described.</p>
+      </TD>
+  </TR>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3 align=LEFT style="margin-top: 0cm; text-decoration: none"><font color="#ffffff"><font size=4><a name="CPlusPlusToJava"></a>C++ 
+        object mapped to Java</font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 height="572"> 
+      <p>If a C++ object is mapped to Java, it lives as long as it is reachable 
+        from a Java thread. That is to say that the life cycle of a C++ object 
+        mapped to Java corresponds to the Java life cycle mechanism as normal.
+      <p>An Object is created to cope with a certain work. In Java, once an object 
+        has completed its work, it is garbage-collected and its resources are 
+        recycled for use by other objects. Now, such an object is unreachable 
+        from a Java thread.
+      <p><img src="images/LifeCycleOfObjects.jpg" width="727" height="415" alt="Life cycle of objects">
+      </td>
+  </tr>
+  <tr> 
+    <td colspan=3 bgcolor="#666699"> 
+      <h3 align=LEFT style="margin-top: 0cm; text-decoration: none"><font color="#ffffff"><font size=4><a name="JavaToCPlusPlus"></a>Java 
+        object mapped to C++</font></font></h3>
+    </td>
+  </tr>
+  <tr> 
+    <td colspan=3 height="31"> 
+      <p>If a Java object is mapped to C++, the Java object lives as long as there 
+        is a C++ reference. That is to say that the life cycle of a Java object 
+        mapped to C++ corresponds to the C++ life cycle mechanism as normal.
+      <p>You can find further information to the life cycle of objects on the 
+        following page:<br>
+        <a href="http://udk.openoffice.org/project/udk/common/man/comparison_uno_corba.html#life_time_mechanism">http://udk.openoffice.org/project/udk/common/man/comparison_uno_corba.html#life_time_mechanism</a>
+      </td>
+  </tr>
+  <TR> 
+    <TD COLSPAN=3> 
+      <P>&nbsp; </P>
+    </TD>
+  </TR>
+  <TR> 
+    <TD COLSPAN=3> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+  <TR> 
+    <TD BGCOLOR="#666699"> 
+      <P ALIGN=LEFT><FONT COLOR="#ffffff"> Author: <A HREF="mailto:Bertram.Nolte@germany.sun.com"><FONT COLOR="#ffffff">Bertram 
+        Nolte</FONT></A>, <a href="mailto:Kay.Ramme@germany.sun.com">Kay Ramme</a> 
+        (Mon 18 Jun 2001 11:54:14)<BR>
+        <I>Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.</I></FONT> 
+      </P>
+    </TD>
+  <TR> 
+    <TD COLSPAN=3> 
+      <HR SIZE=1 noshade>
+    </TD>
+  </TR>
+</TABLE>
+<HR SIZE=3 noshade>
+</BODY>
+</HTML>

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/lifecycle.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/map_idl_to_java.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/map_idl_to_java.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/map_idl_to_java.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/map_idl_to_java.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,613 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<HEAD>
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<TITLE>Mapping of Uno IDL to Java</TITLE>
+	<META NAME="GENERATOR" CONTENT="StarOffice/5.2 (Win32)">
+	<META NAME="CLASSIFICATION" CONTENT="Mapping of Uno IDL to Java">
+	<META NAME="KEYWORDS" CONTENT="UNO,Mapping,IDL,Java">
+	<STYLE>
+	<!--
+		P.copyright { font-style: italic; text-align: center }
+		A:visited { color: #444488 }
+		A:link { color: #444488 }
+	-->
+	</STYLE>
+</HEAD>
+<BODY LINK="#444488" VLINK="#444488" BGCOLOR="#eeeeff"><A NAME="__Top__"></A>
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	<COL WIDTH=75>
+	<TR>
+		<TD BGCOLOR="#666699">
+			<H1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none"><A HREF="http://www.openoffice.org/"><IMG SRC="../../images/open_office_org_logo.gif" NAME="Grafik1" ALT="OpenOffice" ALIGN=RIGHT WIDTH=109 HEIGHT=54 BORDER=0></A><FONT COLOR="#ffffff"><FONT SIZE=6>Mapping
+			of Uno IDL to Java</FONT></FONT></H1>
+		</TD>
+	</TR>
+</TABLE>
+<HR SIZE=3 noshade>
+<TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+<!--	<COL WIDTH=15%>
+	<COL WIDTH=75%>
+	<COL WIDTH=10%>
+-->
+	<COL WIDTH=85*>
+	<COL WIDTH=85*>
+	<COL WIDTH=85*>
+	<TR>
+		
+    <TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699"> 
+      <H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><FONT COLOR="#ffffff"><FONT SIZE=4>Contents</FONT></FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<DL>
+				<DD><A HREF="#Abstract">Abstract</A><BR>
+				<A HREF="#Mapping of basic types">Mapping of basic types</A><BR>
+				<A HREF="#Mapping of complex types">Mapping of complex types</A><BR>
+				<A HREF="#Mapping of sequence">Mapping of &#132;sequence&#147;</A><BR>
+				<A HREF="#Mapping of module">Mapping of &#132;module&#147;</A><BR>
+				<A HREF="#Mapping of interface">Mapping of &#132;interface&#147;</A><BR>
+				<A HREF="#Mapping of interface">Mapping of &#132;struct&#147;</A><BR>
+				<A HREF="#Mapping of exception">Mapping of &#132;exception&#147;</A><BR>
+				<A HREF="#Mapping of enum">Mapping of &#132;enum&#147;</A><BR>
+				<A HREF="#Mapping of constant">Mapping of &#132;constant&#147;</A><BR>
+				<A HREF="#Mapping of contstants">Mapping of &#132;contstants&#147;</A></DD></DL>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3 ALIGN=LEFT STYLE="margin-top: 0cm; text-decoration: none"><A NAME="Abstract"></A>
+			<FONT COLOR="#ffffff"><FONT SIZE=4>Abstract</FONT></FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P>This document describes the complete mapping of Uno IDL into
+			the Java language.</P>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of basic types"></A><FONT COLOR="#ffffff">Mapping
+			of basic types</FONT></H3>
+		</TD>
+	</TR>
+	
+  <TR> 
+    <TD COLSPAN=3 WIDTH=100%> 
+      <P>The following table shows the mapping of IDL basic types to the
+			corresponding Java types.
+			</P>
+			
+      <P>Users should be careful when using unsigned types in Java. <a href="../../common/man/#contents">Because</a> 
+        there is no support in the Java language for unsigned types, a user is 
+        responsible for ensuring that large unsigned IDL type values are handled 
+        correctly as negative integers in Java.</P>
+      <table width="25%" border="1">
+        <tr> 
+          <td> 
+            <div align="center"><b>IDL</b></div>
+          </td>
+          <td> 
+            <div align="center"><b>Java</b></div>
+          </td>
+        </tr>
+        <tr> 
+          <td>boolean</td>
+          <td>boolean</td>
+        </tr>
+        <tr> 
+          <td>short</td>
+          <td>short</td>
+        </tr>
+        <tr> 
+          <td>unsigned short</td>
+          <td>short</td>
+        </tr>
+        <tr> 
+          <td>long</td>
+          <td>int</td>
+        </tr>
+        <tr> 
+          <td>usigned long</td>
+          <td>int</td>
+        </tr>
+        <tr> 
+          <td>hyper</td>
+          <td>long</td>
+        </tr>
+        <tr> 
+          <td>unsigned hyper</td>
+          <td>long</td>
+        </tr>
+        <tr> 
+          <td>float</td>
+          <td>float</td>
+        </tr>
+        <tr> 
+          <td>double</td>
+          <td>double</td>
+        </tr>
+        <tr> 
+          <td>char</td>
+          <td>char</td>
+        </tr>
+        <tr> 
+          <td>byte</td>
+          <td>byte</td>
+        </tr>
+        <tr> 
+          <td>string</td>
+          <td>java.lang.String</td>
+        </tr>
+        <tr> 
+          <td>any</td>
+          <td>com.sun.star.uno.Any</td>
+        </tr>
+        <tr> 
+          <td>type</td>
+          <td>com.sun.star.uno.Type</td>
+        </tr>
+        <tr> 
+          <td>void</td>
+          <td>void</td>
+        </tr>
+      </table>
+    </TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of complex types"></A><FONT COLOR="#ffffff">Mapping
+			of complex types</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			
+      <P><FONT COLOR="#000000">In C++ Uno all needed type information will be 
+        described with the type Type, in java Type is mapped to the Java type 
+        Class, but some informations described in IDL will be lost. So the mapping 
+        for the complex types (interface, struct, exception) will created an additional 
+        public static final member of type com.sun.star.lib.uno.typelib.TypeInfo 
+        array UNOTYPEINFO to describe this information. This array can be filled 
+        with objects of type:</FONT></P>
+			<UL>
+				<LI><P><FONT COLOR="#000000"><I>MethodTypeInfo</I><BR>to describe
+				the attributes of a method, is oneway, is const and if the return
+				type is unsigned.</FONT></P>
+				<LI><P><FONT COLOR="#000000"><I>ParameterTypeInfo</I><BR>to
+				describe if the parameter type is unsigned and if the direction
+				is inout or out.</FONT></P>
+				<LI><P><FONT COLOR="#000000"><I>AttributeTypeInfo</I><BR>to
+				describe if the type is unsigned and if the attibute is readonly.
+				</FONT>
+				</P>
+				<LI><P><FONT COLOR="#000000"><I>MemberTypeInfo</I><BR>to describe
+				if the type is unsigned</FONT></P>
+			</UL>
+			<P><FONT COLOR="#000000">Note that only definitions where
+			information are lost will be described.</FONT></P>
+			<P><FONT COLOR="#000000">This additional type information and the
+			information from Class will be used by the runtime to handle the
+			type when transport it on a remote connection or convert it to
+			another object model.</FONT></P>
+			<P><FONT COLOR="#000000">All generated types (interface, struct,
+			enum, exception) have another public static member of type Object
+			UNORUNTIMEDATA. This member is reserved for internal use by the
+			Uno runtime.</FONT></P>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of sequence"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;sequence&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P><FONT COLOR="#000000">Sequence types are mapped to a Java array
+			of the sequence base type. </FONT>
+			</P>
+			<P><FONT COLOR="#000000">An IDL <I>sequence&lt;long&gt; </I>is
+			mapped to <I>int[]</I></FONT></P>
+			<P><FONT COLOR="#000000">An IDL <I>sequence&lt; sequence &lt;long&gt;
+			&gt; </I>is mapped to <I>int[][]</I></FONT></P>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of module"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;module&#147; </FONT>
+			</H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P><FONT COLOR="#000000">An IDL module is mapped to a Java package
+			with the same name. All IDL type declarations within the module
+			are mapped to corresponding Java class or interface declarations
+			within the generated package. IDL declarations not enclosed in any
+			modules are mapped into the Java global scope.</FONT></P>
+			<P><FONT COLOR="#000000"><B>Example:</B></FONT></P>
+			<P><FONT COLOR="#000000">An IDL</FONT></P>
+			<PRE><FONT COLOR="#000000"><FONT SIZE=1><I>module stardiv {   ...}</I></FONT></FONT></PRE><P>
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			<PRE><FONT COLOR="#000000"><FONT SIZE=1><I>package stardiv;   ...</I></FONT></FONT></PRE>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of interface"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;interface&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">An IDL
+			interface is mapped to a Java interface with the same name as the
+			IDL interface type. If an IDL interface inherits another
+			interface, the Java interface will extends this appropriate Java
+			interface. Each interface has an additional static member to store
+			the uik of the IDL interface.</FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">Attributes are
+			mapped to a pair of Java 'get' and 'set' methods. These methods
+			have the name get/set followed by the name of the attribute. A
+			readonly attribute is mapped only to a 'get' method.</FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">Parameter
+			mapping: </FONT>
+			</P>
+			
+      <P STYLE="font-style: normal"><FONT COLOR="#000000">IDL in parameters, which 
+        implement call-by-value semantics, are mapped to normal Java actual parameters. 
+        The result of IDL operations are returned as the result of the corresponding 
+        Java method. IDL out and inout parameters, which implement call-by-result 
+        and call-by-result/value semantics, are mapped to an array (with length 
+        1) of the appropriate type to avoid generating of holder classes for each 
+        IDL type. The 0th element of the array has to be created by the caller 
+        of an inout parameter, and will be exchanged by the callee of an inout/out 
+        parameter. Specified exceptions (raises declarations) are mapped to normal 
+        Java throws statements and every method throws the com.sun.star.uno.RuntimeException 
+        if declared or not.</FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000"><B>Example:</B></FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">An IDL</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>module com {  module sun {  module star {  module registry {  
+
+[ uik(00000000-33D6-11D1-AABE00A0-249D5590), ident( "XImplementationRegistration", 1.0 ) ]
+interface XImplementationRegistration: com::sun::star::uno::XInterface
+{
+	void registerImplementation( [in] string aImplementationLoader, 
+			 [in] string aLocation, 
+			 [in] com::sun::star::registry::XSimpleRegistry xReg ) 
+			raises( com::sun::star::registry::CannotRegisterImplementationException ); 
+
+	boolean revokeImplementation( [in] string aLocation, 
+			 [in] com::sun::star::registry::XSimpleRegistry xReg ); 
+
+	sequence<string> getImplementations( [in] string aImplementationLoader, 
+			 [in] string aLocation ); 
+
+	sequence<string> checkInstantiation( [in] string implementationName ); 
+};</FONT></FONT></PRE>
+      <P STYLE="font-style: normal">
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>package com.sun.star.registry;
+
+public interface XImplementationRegistration extends com.sun.star.uno.XInterface
+{
+    // Methods
+    public void registerImplementation( /*IN*/String aImplementationLoader, /*IN*/String aLocation, /*IN*/XSimpleRegistry xReg ) throws CannotRegisterImplementationException, com.sun.star.uno.RuntimeException;
+    public boolean revokeImplementation( /*IN*/String aLocation, /*IN*/XSimpleRegistry xReg ) throws com.sun.star.uno.RuntimeException;
+    public String[] getImplementations( /*IN*/String aImplementationLoader, /*IN*/String aLocation ) throws com.sun.star.uno.RuntimeException;
+    public String[] checkInstantiation( /*IN*/String implementationName ) throws com.sun.star.uno.RuntimeException;
+
+    // static Member
+    public static com.sun.star.uno.Uik UIK = new com.sun.star.uno.Uik( 0x00000000, (short)0x33d6, (short)0x11d1, 0xaabe00a0, 0x249d5590 );
+
+    public static final com.sun.star.lib.uno.typeinfo.TypeInfo UNOTYPEINFO[] = { 
+        new com.sun.star.lib.uno.typeinfo.MethodTypeInfo( "registerImplementation", 0, 0 ),
+        new com.sun.star.lib.uno.typeinfo.ParameterTypeInfo( "xReg", "registerImplementation", 2, com.sun.star.lib.uno.typeinfo.TypeInfo.INTERFACE ),
+        new com.sun.star.lib.uno.typeinfo.MethodTypeInfo( "revokeImplementation", 1, 0 ),
+        new com.sun.star.lib.uno.typeinfo.ParameterTypeInfo( "xReg", "revokeImplementation", 1, com.sun.star.lib.uno.typeinfo.TypeInfo.INTERFACE ),
+        new com.sun.star.lib.uno.typeinfo.MethodTypeInfo( "getImplementations", 2, 0 ),
+        new com.sun.star.lib.uno.typeinfo.MethodTypeInfo( "checkInstantiation", 3, 0 )
+     };
+
+    public static Object UNORUNTIMEDATA = null;
+}</FONT></FONT></PRE>
+    </TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of struct"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;struct&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">An IDL struct
+			is mapped to a Java class with the same name as the struct type.
+			Each member of the IDL struct is mapped to a public instance
+			variable with the same type and name. The class also provides a
+			default constructor which initialize all members with default
+			values and a constructor for all values. If a struct inherit from
+			another struct, the generated class extends the class of the
+			inherited struct. The default constructor only initialize the
+			members which have a complex type. The member constructor has all
+			fields of the extended class and his own fields as parameter.</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>module com { module sun { module star { module uno {
+    struct Uik
+    {
+        unsigned long  m_Data1;
+        unsigned short m_Data2;
+        unsigned short m_Data3;
+        unsigned long  m_Data4;
+        unsigned long  m_Data5;
+    };
+}; }; }; };</FONT></FONT></PRE>
+      <P STYLE="font-style: normal">
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>package com.sun.star.uno;
+
+public class Uik
+{
+    // instance variables
+    public int m_Data1;
+    public short m_Data2;
+    public short m_Data3;
+    public int m_Data4;
+    public int m_Data5;
+
+    // constructors
+    public Uik()
+    {
+    }
+
+    public Uik(int _m_Data1,
+               short _m_Data2,
+               short _m_Data3,
+               int _m_Data4,
+               int _m_Data5)
+    {
+        m_Data1 = _m_Data1;
+        m_Data2 = _m_Data2;
+        m_Data3 = _m_Data3;
+        m_Data4 = _m_Data4;
+        m_Data5 = _m_Data5;
+    }
+
+    public static final com.sun.star.lib.uno.typelib.TypeInfo UNOTYPEINFO[] = 
+		{ ne</FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>v.typelib.MemberTypeInfo( &quot;m_Data1&quot;</FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>v.typelib.TypeInfo.UNSIGNED ),
+        new </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.MemberTypeInfo( &quot;m_Data2&quot;, </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.TypeInfo.UNSIGNED ),
+        new </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.MemberTypeInfo( &quot;m_Data3&quot;, </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.TypeInfo.UNSIGNED ),
+        new </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.MemberTypeInfo( &quot;m_Data4&quot;, </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.TypeInfo.UNSIGNED ),
+        new </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>typelib.MemberTypeInfo( &quot;m_Data5&quot;, </FONT><font color="#000000"><font size=1>com.sun.star.lib.uno.</font></font><FONT SIZE=1>.typelib.TypeInfo.UNSIGNED ) };
+
+    public static Object UNORUNTIMEDATA = null;
+}</FONT></FONT></PRE>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of exception"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;exception&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			
+      <P STYLE="font-style: normal"><FONT COLOR="#000000">An IDL exception is 
+        mapped to a Java class with the same name as the exception type. Each 
+        member of the IDL exception is mapped to a public instance variable with 
+        the same type and name. The class also provides a default constructor 
+        which initialize all members with default values and a constructor for 
+        all values. If an exception inherit from another exception, the generated 
+        class extends the class of the inherited exception. If the exception does 
+        not inherit the com.sun.star.uno.Exception, the generated Java class extends 
+        the java.lang.Exception. The member constructor has all fields of the 
+        extended class and his own fields as parameter. </FONT> </P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>module com { module sun { module star { module uno {
+    exception RuntimeException : Exception
+    {
+    };
+}; }; }; }; </FONT></FONT></PRE>
+      <P STYLE="font-style: normal">
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>package com.sun.star.uno;
+
+public class RuntimeException extends com.sun.star.uno.Exception
+{
+    // instance variables
+
+    // constructors
+    public RuntimeException()
+    {
+    }
+
+    public RuntimeException(String _Message,
+                            com.sun.star.uno.XInterface _Context)
+    {
+        super(_Message,
+              _Context);
+    }
+
+    public static Object UNORUNTIMEDATA = null;
+}</FONT></FONT></PRE>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of enum"></A><FONT COLOR="#ffffff">Mapping of
+			&#132;enum&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			
+      <P STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000">An 
+        IDL enum is mapped to a Java final class with the same name as the enum 
+        type. This class inherits the class com.sun.star.uno.Enum. This base class 
+        declares a protected member to store the actual value, a protected constructor 
+        to initialize the value, a public getValue method to get the actual value. 
+        The generated final class has an protected constructor, a public method 
+        getDefault, which returns an enum with the value of the first enum label 
+        as default. For each IDL enum label the class declares a public static 
+        member of the same type as the enum and initialized with the defined value 
+        in IDL. The Java class for the enum has an additional public method fromInt, 
+        which returns the enum with the specified value.</FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000"><B>Example:</B></FONT></P>
+			<P STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000">An
+			IDL</FONT></P>
+			
+      <PRE STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000"><FONT SIZE=1>module com { module sun { star { module uno {
+    enum TypeClass 
+    { 
+        INTERFACE,
+        SERVICE,
+        IMPLEMENTATION,
+        STRUCT,
+        TYPEDEF,
+        ...
+    };
+}; }; }; };</FONT></FONT></PRE>
+      <P STYLE="font-style: normal; font-weight: medium">
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			
+      <PRE STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000"><FONT SIZE=1>package com.sun.star.uno;
+
+final public class TypeClass extends com.sun.star.uno.Enum
+{
+   private TypeClass(int value)
+   {
+      super(value);
+   }
+
+   public static TypeClass getDefault()
+   {
+      return INTERFACE;
+   }
+
+   public static final TypeClass INTERFACE = new TypeClass(0);
+   public static final TypeClass SERVICE = new TypeClass(1);
+   public static final TypeClass IMPLEMENTATION = new TypeClass(2);
+   public static final TypeClass STRUCT = new TypeClass(3);
+   public static final TypeClass TYPEDEF = new TypeClass(4);
+   ...
+
+   public static TypeClass fromInt(int value)
+   {
+      switch(value)
+      {
+         case 0:
+            return INTERFACE;
+         case 1:
+            return SERVICE;
+         case 2:
+            return IMPLEMENTATION;
+         case 3:
+            return STRUCT;
+         case 4:
+            return TYPEDEF;
+         ...
+      }
+   }
+
+   public static Object UNORUNTIMEDATA = null;
+}</FONT></FONT></PRE>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of constant"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;constant&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000">IDL
+			constants are mapped to a public interface with the same as the
+			constant and containing a public static final field, named value,
+			that holds the constant value. (Note that the Java compiler will
+			normally inline the value when the class is used in other Java
+			code.)</FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000"><B>Example:</B></FONT></P>
+			<P STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000">An
+			IDL</FONT></P>
+			
+      <PRE STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000"><FONT SIZE=1>module example {
+    const long USERFLAG = 1;
+};</FONT></FONT></PRE>
+      <P STYLE="font-style: normal; font-weight: medium">
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			
+      <PRE STYLE="font-style: normal; font-weight: medium"><FONT COLOR="#000000"><FONT SIZE=1>package example;
+
+public interface USERFLAG
+{
+   public static final int value = (int)1L;
+}</FONT></FONT></PRE>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100% BGCOLOR="#666699">
+			<H3><A NAME="Mapping of contstants"></A><FONT COLOR="#ffffff">Mapping
+			of &#132;contstants&#147;</FONT></H3>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">IDL constant
+			groups are mapped to a public interface with the same as the
+			constant group. All defined constants in this constant group are
+			mapped to public static member of the interface with type and name
+			of the constant, that holds the value.</FONT></P>
+			<P STYLE="font-style: normal"><FONT COLOR="#000000">An IDL</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>module example {
+    constants USER
+    {
+        const long FLAG1 = 1;
+        const long FLAG2 = 2;
+        const long FLAG3 = 3;
+    };
+};</FONT></FONT></PRE>
+      <P STYLE="font-style: normal">
+			<FONT COLOR="#000000">is mapped to</FONT></P>
+			
+      <PRE STYLE="font-style: normal"><FONT COLOR="#000000"><FONT SIZE=1>package example;
+
+public interface USER
+{
+   public static final int FLAG1 = (int)1L;
+   public static final int FLAG2 = (int)2L;
+   public static final int FLAG3 = (int)3L;
+}</FONT></FONT></PRE>
+		</TD>
+	</TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<HR SIZE=1 noshade>
+		</TD>
+	</TR>
+	<TR>
+		<TD WIDTH=50% BGCOLOR="#666699">
+			<P ALIGN=LEFT><FONT COLOR="#ffffff">
+			Auhor: J&uuml;rgen Schmidt ($Date: 2002/10/22 11:11:27 $)<BR>
+			<I>Copyright 2001 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.</I></FONT>
+			</P>
+		</TD>
+	<TR>
+	<TR>
+		<TD COLSPAN=3 WIDTH=100%>
+			<HR SIZE=1 noshade>
+		</TD>
+	</TR>
+</TABLE>
+</BODY>
+</HTML>
\ No newline at end of file

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/map_idl_to_java.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/regcomp.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/regcomp.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/regcomp.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/regcomp.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,27 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+  <head>
+	<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<title>Java RegComp</title>
+	<meta NAME="KEYWORDS" CONTENT="sandbox">
+  </head>
+  <body LINK="#444488" VLINK="#444488" bgcolor="#eeeeff"><A NAME="__Top__"></A>
+
+    <table WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	  <col WIDTH=75>
+	  <tr>
+		<td bgcolor="#666699">
+          <h1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none">
+	        <font COLOR="#ffffff" SIZE=6>Java RegComp</font>
+		  </h1>
+		</td>
+	  </tr>
+    </table>
+
+	<P> 
+
+
+
+</body>
+</html>
+

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/regcomp.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/ooo/ooo-site/trunk/content/udk/java/man/register_java_components.html
URL: http://svn.apache.org/viewvc/incubator/ooo/ooo-site/trunk/content/udk/java/man/register_java_components.html?rev=1206901&view=auto
==============================================================================
--- incubator/ooo/ooo-site/trunk/content/udk/java/man/register_java_components.html (added)
+++ incubator/ooo/ooo-site/trunk/content/udk/java/man/register_java_components.html Sun Nov 27 23:04:57 2011
@@ -0,0 +1,80 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+  <head>
+	<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<title>Registering java components</title>
+	<meta NAME="KEYWORDS" CONTENT="java components">
+  </head>
+  <body LINK="#444488" VLINK="#444488" bgcolor="#eeeeff"><A NAME="__Top__"></A>
+
+    <table WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=0>
+	  <col WIDTH=75>
+	  <tr>
+		<td bgcolor="#666699">
+          <h1 ALIGN=CENTER STYLE="margin-top: 0cm; text-decoration: none">
+	        <font COLOR="#ffffff" SIZE=6>Registering java components</font>
+		  </h1>
+		</td>
+	  </tr>
+    </table>
+
+
+	
+<p>As there are many ways to Rom, there many ways to register a component. But 
+  what all ways have in common, is that an ImplementationRegistration instance 
+  is needed. </p>
+<p>So, a service can be registered via star basic creating the service <a href="http://api.openoffice.org/common/ref/com/sun/star/registry/ImplementationRegistration.html">ImplementationRegistration</a> 
+  and calling the method <a href="http://api.openoffice.org/common/ref/com/sun/star/registry/XImplementationRegistration.html#registerImplementation">registerImplementation</a>. 
+</p>
+Basic example: 
+<table width="100%" bgcolor=#ffffcc>
+  <tbody> 
+  <tr> 
+    <td height="71"> 
+      <pre>
+
+regImpl = createUnoService("com.sun.star.registry.ImplementationRegistration")
+regImpl.registerImplementation("com.sun.star.loader.Java2", "file:///home/testComponent.jar", null)</pre>
+    </td>
+  </tr>
+  </tbody> 
+</table>
+<p>Another way is to use the binary UNO bound tool <a href="http://udk.openoffice.org/common/man/tools.html#regcomp">regcomp</a>. 
+  This tool needs to create a java virtual machine, which it does by the service 
+  <a href="http://api.openoffice.org/common/ref/com/sun/star/java/JavaVirtualMachine.html">JavaVirtualMachine</a>. 
+</p>
+Binary exmaple (UNIX):<br>
+<table width="100%" bgcolor=#ffffcc>
+  <tbody> 
+  <tr> 
+    <td height="71"> 
+      <pre>
+
+setenv OO_JAVA_PROPERTIES RuntimeLib=/usr/java1.2/jre/lib/sparc/native_threads/libjvm.so<br>setenv CLASSPATH $UDK/ridljar:$UDK/jurt.jar:$UDK/java_uno.jar <br>regcomp -register -br applicat.rdb -c file:///home/testComponent.jar -l com.sun.star.loader.Java2 
+</pre>
+    </td>
+  </tr>
+  </tbody> 
+</table>
+<p>Unfortunatley this service <a href="http://api.openoffice.org/common/ref/com/sun/star/java/JavaVirtualMachine.html">JavaVirtualMachine</a> 
+  often needs some hints, to find the java installation to use. To avoid this, 
+  there is another java based tool. </p>
+<p> Java example: <br>
+
+<table width="100%" bgcolor=#ffffcc>
+  <tbody> 
+  <tr> 
+    <td height="71"> 
+      <pre>
+
+java com.sun.star.tools.uno.RegComp applicat.rdb register file:///home/testComponent.jar 
+  com.sun.star.loader.Java2 
+</pre>
+    </td>
+  </tr>
+  </tbody> 
+</table>
+<p>&nbsp;
+<p>&nbsp;
+</body>
+</html>

Propchange: incubator/ooo/ooo-site/trunk/content/udk/java/man/register_java_components.html
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message