Establishing Interprocess Connections

OpenOffice.org Developer's Guide

Professional UNO

< Previous Section

Next Section >

• Introduction
• API Concepts

• Data Types

• Simple Types
• The Any Type
• Interfaces
• Services
• Structs
• Predefined Values
• Sequences
• Modules
• Exceptions
• Singletons

• Understanding the API Reference

• UNO Concepts

• UNO Interprocess Connections

• Starting OpenOffice.org in Listening Mode
• Importing a UNO Object
• Characteristics of the Interprocess Bridge
• Opening a Connection
• Creating the Bridge
• Closing a Connection
• Example: A Connection Aware Client

• Service Manager and Component Context

• Service Manager
• Component Context

• Using UNO Interfaces
• Properties
• Collections and Containers
• Event Model
• Exception Handling
• Lifetime of UNO objects

• acquire() and release()
• The XComponent Interface
• Children of the XEventListener Interface
• Weak Objects and References
• Differences Between the Lifetime of C++ and Java Objects

• Object Identity

• UNO Language Bindings

• Java Language Binding

• Getting a Service Manager
• Transparent Use of Office UNO Components
• Handling Interfaces
• Type Mappings

• Mapping of Sequence Types
• Mapping of Enum Types
• Mapping of Struct Types
• Mapping of Exception Types
• Mapping of Interface Types
• Mapping of UNOIDL
• Mapping of Services
• Mapping of Singletons
• Inexact approximation of UNO Value Semantics

• C++ Language Binding

• Establishing Interprocess Connections
• Transparent Use of Office UNO Components
• Type Mappings

• Mapping of Struct Types
• Mapping of Interface Types
• Mapping of Sequence Types
• Mapping of Services
• Mapping of Singletons

• Using Weak References
• Exception Handling in C++

• OpenOffice.org Basic

• Handling UNO Objects

• Instantiating UNO Services
• Getting Information about UNO Objects

• Mapping of UNO and Basic Types

• Mapping of Simple Types
• Mapping of Sequences and Arrays
• Mapping of Structs
• Mapping of Enums and Constant Groups

• Case Sensitivity
• Exception Handling
• Listeners

• Automation Bridge

• The Service Manager Component
• Using UNO from Automation

• Calling Functions and Accessing Properties
• Return Values
• Usage of Types

• Using Automation Objects from UNO
• Type Mappings

• Default Mappings

• Mapping of Simple Types
• Mapping of Hyper and Decimal
• Mapping of String
• Mapping of Interfaces and Structures
• Mapping of Sequence
• Mapping of Type

• Conversion Mappings
• Client-Side Conversions
• Value Objects
• Exceptions and Errorcodes

• Automation Objects with UNO Interfaces
• DCOM
• The Bridge Services
• Unsupported COM Features

• CLI Language Binding

• The Language Binding DLLs
• Type Mapping

• Type Name Decoration
• Type Mappings
• Additional Structures

• Lifetime Management and Obtaining Interfaces
• Writing Client Programs

• The Override Problem
• Important Interfaces and Implementations

< Previous Page

Next Page >

Any language binding supported by UNO establishes interprocess connections using a local service manager to create the services necessary to connect to the office. Refer to chapter UNO Interprocess Connections for additional information. The following client program connects to a running office and retrieves the com.sun.star.lang.XMultiServiceFactory in C++:

  #include <stdio.h>
  
  #include <cppuhelper/bootstrap.hxx>
  #include <com/sun/star/bridge/XUnoUrlResolver.hpp>
  #include <com/sun/star/lang/XMultiServiceFactory.hpp>
  
  using namespace com::sun::star::uno;
  using namespace com::sun::star::lang;
  using namespace com::sun::star::bridge;
  using namespace rtl;
  using namespace cppu;
  
  int main( )
  {
      // create the initial component context
      Reference< XComponentContext > rComponentContext =
          defaultBootstrap_InitialComponentContext();
   
      // retrieve the service manager from the context
      Reference< XMultiComponentFactory > rServiceManager = 
          rComponentContext->getServiceManager();
  
      // instantiate a sample service with the service manager.
      Reference< XInterface > rInstance =
          rServiceManager->createInstanceWithContext( 
          OUString::createFromAscii("com.sun.star.bridge.UnoUrlResolver" ),
          rComponentContext );
  
      // Query for the XUnoUrlResolver interface
      Reference< XUnoUrlResolver > rResolver( rInstance, UNO_QUERY );
   
      if( ! rResolver.is() )
      {
          printf( "Error: Couldn't instantiate com.sun.star.bridge.UnoUrlResolver service\n" );
          return 1;
      }
      try
      {
          // resolve the uno-URL
          rInstance = rResolver->resolve( OUString::createFromAscii( 
              "uno:socket,host=localhost,port=2002;urp;StarOffice.ServiceManager" ) );
  
          if( ! rInstance.is() )
          {
              printf( "StarOffice.ServiceManager is not exported from remote process\n" );
              return 1;
          }
  
          // query for the simpler XMultiServiceFactory interface, sufficient for scripting
          Reference< XMultiServiceFactory > rOfficeServiceManager (rInstance, UNO_QUERY);
  
          if( ! rOfficeServiceManager.is() )
          {
              printf( "XMultiServiceFactory interface is not exported\n" );
              return 1;
          }
  
          printf( "Connected sucessfully to the office\n" );
      }
      catch( Exception &e )
      {
          OString o = OUStringToOString( e.Message, RTL_TEXTENCODING_ASCII_US );
          printf( "Error: %s\n", o.pData->buffer );
          return 1;
      }
      return 0;
  }

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