Micro Focus VisiBroker 8.5.5 VisiBroker for Java Developer’s Guide Micro Focus The Lawn 22-30 Old Bath Road Newbury, Berkshire RG14 1QN UK http://www.microfocus.com Copyright © Micro Focus 2009-2018. All rights reserved. MICRO FOCUS, the Micro Focus logo and Micro Focus Licensing are trademarks or registered trademarks of Micro Focus Development Limited or its subsidiaries or affiliated companies in the United States, United Kingdom and other countries. All other marks are the property of their respective owners. 2018-06-28 ii Contents Introduction to VisiBroker........................................................... 1 Accessing VisiBroker online help topics in the standalone Help Viewer ...................... 1 Accessing VisiBroker online help topics from within a VisiBroker GUI tool.................. 1 Documentation conventions................................................................................ 2 Platform conventions................................................................................. 2 Contacting Micro Focus ...................................................................................... 2 Further Information and Product Support ..................................................... 2 Information We Need ................................................................................ 3 Contact information .................................................................................. 3 Understanding the CORBA model................................................. 5 What is CORBA? ............................................................................................... 5 What is VisiBroker? ........................................................................................... 6 VisiBroker Features ........................................................................................... 6 VisiBroker's Smart Agent (osagent) Architecture ........................................... 6 Enhanced Object Discovery Using the Location Service .................................. 7 Implementation and Object Activation Support ............................................. 7 Robust thread and connection management ................................................. 7 IDL compilers........................................................................................... 7 Dynamic invocation with DII and DSI .......................................................... 8 Interface and implementation repositories.................................................... 8 Server-side portability ............................................................................... 8 Customizing the VisiBroker ORB with interceptors and object wrappers ............ 8 Event Queue ............................................................................................ 9 Backing stores in the Naming Service .......................................................... 9 Defining interfaces without IDL................................................................... 9 GateKeeper.............................................................................................. 9 VisiBroker CORBA compliance............................................................................. 9 VisiBroker Development Environment .................................................................. 9 Programmer's tools......................................................................... 10 CORBA services tools ...................................................................... 10 Administration Tools........................................................................ 10 Java Development Environment ........................................................................ 10 Java 2 Standard Edition ........................................................................... 10 Java Run-time Environment ..................................................................... 11 What's Required for GateKeeper ............................................................... 11 Java-enabled Web browser....................................................................... 11 Interoperability with VisiBroker ......................................................................... 11 Interoperability with other ORB products............................................................ 11 IDL to Java mapping ....................................................................................... 12 Developing an example application with VisiBroker .................. 13 Development process ...................................................................................... 13 Step 1: Defining object interfaces ..................................................................... 14 Writing the account interface in IDL .......................................................... 14 Step 2: Generating client stubs and server servants ............................................ 15 Files produced by the idl compiler ............................................................. 15 Step 3: Implementing the client........................................................................ 16 Client.java ............................................................................................. 16 Binding to the AccountManager object............................................... 17 Obtaining an Account object ............................................................ 17 Obtaining the balance ..................................................................... 17 AccountManagerHelper.java...................................................................... 17 Other methods............................................................................... 17 Step 4: Implementing the server ...................................................................... 18 VisiBroker for Java Developer’s Guide iii Server programs .....................................................................................18 Step 5: Building the example ............................................................................19 Compiling the example ............................................................................19 Step 6: Starting the server and running the example ...........................................19 Starting the Smart Agent .........................................................................19 Starting the server ..................................................................................19 Running the client ...................................................................................20 Deploying applications with VisiBroker................................................................20 VisiBroker Applications.............................................................................21 Deploying applications .....................................................................21 Environment variables .....................................................................21 Support service availability...............................................................21 Using vbj .......................................................................................22 Running the application ...................................................................22 Executing client applications .............................................................22 Executing server applications in Java .................................................23 Programmer tools for Java ........................................................25 Options..........................................................................................................25 General options ......................................................................................25 idl2ir .............................................................................................................26 ir2idl .............................................................................................................27 idl2java..........................................................................................................27 java2idl..........................................................................................................29 java2iiop ........................................................................................................30 vbj ................................................................................................................33 vbjc...............................................................................................................34 Specifying the classpath ...................................................................................35 Specifying the JVM ..........................................................................................35 idl2wsj...........................................................................................................35 IDL to Java mapping..................................................................37 Names ...........................................................................................................37 Reserved names..............................................................................................37 Reserved words ..............................................................................................38 Modules .........................................................................................................38 Basic types.....................................................................................................38