VisiBroker 8.5.2 VisiBroker for .NET 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-2014. All rights reserved. VisiBroker contains derivative works of Borland Software Corporation, Copyright 1992-2010 Borland Software Corporation (a Micro Focus company). MICRO FOCUS, the Micro Focus logo and Micro Focus Licensing are trademarks or registered trademarks of Micro Focus IP Development Limited or its subsidiaries or affiliated companies in the United States, United Kingdom and other countries. BORLAND, the Borland logo and VisiBroker are trademarks or registered trademarks of Borland Software Corporation 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. 2014-06-30 ii Contents Introduction to VisiBroker for .NET ............................................. 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 VisiBroker for .NET model.............................. 5 What is VisiBroker for .NET? ............................................................................... 5 Changes in VisiBroker for .NET ................................................................... 6 VisiBroker for .NET developer tools ............................................................. 6 VisiBroker for .NET runtime........................................................................ 6 VisiBroker for .NET features ....................................................................... 7 What is .NET?................................................................................................... 7 Common language runtime ........................................................................ 7 .NET Framework class library ..................................................................... 8 .NET Remoting ......................................................................................... 8 Managed vs. Unmanaged Applications ......................................................... 8 What is J2EE?................................................................................................... 9 Enterprise JavaBeans ................................................................................ 9 Java RMI ................................................................................................. 9 What is CORBA? ............................................................................................. 10 Interface Definition Language................................................................... 10 CORBA and .NET Remoting ...................................................................... 10 Microsoft Visual Studio .NET options .................................................................. 11 Developing VisiBroker for .NET client applications .................... 13 Some simple examples .................................................................................... 13 A simple .NET Remoting example.............................................................. 13 A simple J2EE example............................................................................ 14 A simple CORBA example......................................................................... 15 .NET Remoting configuration ............................................................................ 15 Specifying the object location ................................................................... 16 URL schemes ................................................................................. 16 Specifying the Remoting channel .............................................................. 17 Client-activated objects vs. server-activated objects ............................................ 18 Programmatic activation .................................................................................. 19 Configuring properties............................................................... 21 Setting properties at the command line.............................................................. 21 Setting properties programmatically .................................................................. 22 Setting properties within a configuration file ....................................................... 22 VisiBroker for .NET property descriptions............................................................ 23 Resolving the Naming Service .................................................................. 23 ORBInitRef .................................................................................... 23 Licensing property .................................................................................. 24 janeva.license.dir ........................................................................... 24 Transactions properties............................................................................ 24 janeva.transactions......................................................................... 24 janeva.transactions.factory.url.......................................................... 25 Server-side properties ............................................................................. 25 VisiBroker for .NET Developer’s Guide iii janeva.server.defaultPort .................................................................25 janeva.server.remoting ....................................................................26 Interoperability property ..........................................................................26 janeva.interop.jvmType ...................................................................26 Security properties ..................................................................................27 janeva.security ...............................................................................27 janeva.security.username ................................................................28 janeva.security.password .................................................................28 janeva.security.realm ......................................................................28 janeva.security.certificate.................................................................28 Server-side security properties..................................................................29 janeva.security.server .....................................................................29 janeva.security.server.defaultPort......................................................30 janeva.security.server.certificate .......................................................30 Firewall property .....................................................................................31 janeva.firewall................................................................................31 Portable Interceptor property....................................................................31 janeva.orb.init ................................................................................31 VisiBroker Smart Agent properties.............................................................32 janeva.agent ..................................................................................32 janeva.agent.port ...........................................................................32 janeva.agent.addr...........................................................................32 Setting VisiBroker properties.............................................................................33 Building and deploying VisiBroker for .NET applications ............35 Generating VisiBroker for .NET stubs and skeletons..............................................35 Adding references to VisiBroker for .NET runtime libraries.....................................36 Deploying VisiBroker for .NET applications ..........................................................37 Microsoft .NET Framework Redistributable Package ......................................38 VisiBroker for .NET runtime libraries ..........................................................38 VisiBroker for .NET deployment license key.................................................38 Including the license as an embedded resource...................................39 Copying the license to the application virtual root................................39 Modifying the application configuration file .........................................39 Developing VisiBroker for .NET Remoting servers......................41 Introduction ...................................................................................................41 About .NET Remoting...............................................................................41 About VisiBroker for .NET Server ...............................................................42