bridges/test/java_uno/nativethreadpool/readme

   1 #*************************************************************************
   2 #
   3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4 #
   5 # Copyright 2008 by Sun Microsystems, Inc.
   6 #
   7 # OpenOffice.org - a multi-platform office productivity suite
   8 #
   9 # $RCSfile: readme,v $
  10 #
  11 # $Revision: 1.4 $
  12 #
  13 # This file is part of OpenOffice.org.
  14 #
  15 # OpenOffice.org is free software: you can redistribute it and/or modify
  16 # it under the terms of the GNU Lesser General Public License version 3
  17 # only, as published by the Free Software Foundation.
  18 #
  19 # OpenOffice.org is distributed in the hope that it will be useful,
  20 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22 # GNU Lesser General Public License version 3 for more details
  23 # (a copy is included in the LICENSE file that accompanied this code).
  24 #
  25 # You should have received a copy of the GNU Lesser General Public License
  26 # version 3 along with OpenOffice.org.  If not, see
  27 # <http://www.openoffice.org/license.html>
  28 # for a copy of the LGPLv3 License.
  29 #
  30 #*************************************************************************
  31
  32 Test that a Java URP bridge started in a native process uses the same thread
  33 pool as a C++ URP bridge.  This test currently only works on Linux Intel.
  34
  35 There are two processes involved.  The client starts as a native process.  It
  36 first loads a Java component (Relay) via the in-process JNI bridge, which in
  37 turn starts to accept incomming URP connections.  The native part of the client
  38 then connects to the server, retrieves a thread-local token from it, and checks
  39 the token for correctness.  The server simply waits for a connection from the
  40 native part of the client, creates a connection to the Java part of the client,
  41 and routes all requests from the native part of the client to the Java part of
  42 the client.  The Java part of the client in turn uses the in-process JNI bridge
  43 to obtain the thread-local token.