Using the Java Gateway in a Production - InterSystems Documentation
Using the Java Gateway in a Production - InterSystems Documentation
Using the Java Gateway in a Production - InterSystems Documentation
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
1<br />
Introduction to <strong>the</strong> <strong>Java</strong> <strong>Gateway</strong><br />
This chapter <strong>in</strong>troduces <strong>the</strong> <strong>Java</strong> <strong>Gateway</strong>, which provides an easy way for Ensemble to <strong>in</strong>teroperate with <strong>Java</strong> components.<br />
It discusses <strong>the</strong> follow<strong>in</strong>g topics:<br />
• Prerequisites<br />
• <strong>Java</strong> <strong>Gateway</strong> Architecture<br />
• Start<strong>in</strong>g and Stopp<strong>in</strong>g <strong>the</strong> <strong>Gateway</strong><br />
• Connect<strong>in</strong>g and Disconnect<strong>in</strong>g<br />
• Import<strong>in</strong>g <strong>Java</strong> Classes<br />
• Proxy Call Sequence<br />
1.1 Prerequisites<br />
The <strong>Java</strong> <strong>Gateway</strong> server runs with<strong>in</strong> a JVM, which can be on <strong>the</strong> same mach<strong>in</strong>e as Ensemble or on a different mach<strong>in</strong>e.<br />
Complete <strong>the</strong> follow<strong>in</strong>g setup steps on <strong>the</strong> mach<strong>in</strong>e on which <strong>the</strong> <strong>Java</strong> <strong>Gateway</strong> will run:<br />
1. Install <strong>the</strong> <strong>Java</strong> Runtime Environment (for example, JRE 1.6.0.18).<br />
2. Make a note of <strong>the</strong> location of <strong>the</strong> <strong>in</strong>stallation directory for JRE. This is <strong>the</strong> directory that conta<strong>in</strong>s <strong>the</strong> subdirectories<br />
b<strong>in</strong> and lib.<br />
This is <strong>the</strong> value that you would use for JAVA_HOME environment variable. For example: c:\Program<br />
Files\<strong>Java</strong>\jre6<br />
You use this <strong>in</strong>formation later when you configure your production.<br />
3. Also make a note of <strong>the</strong> <strong>Java</strong> version. If you are uncerta<strong>in</strong> about <strong>the</strong> <strong>Java</strong> version, open a DOS w<strong>in</strong>dow, go to <strong>the</strong> b<strong>in</strong><br />
subdirectory of your <strong>Java</strong> <strong>in</strong>stallation, and enter <strong>the</strong> follow<strong>in</strong>g command:<br />
java.exe -version<br />
You should receive output like <strong>the</strong> follow<strong>in</strong>g, depend<strong>in</strong>g on your platform:<br />
java version "1.6.0_18"<br />
<strong>Java</strong>(TM) SE Runtime Environment (build 1.6.0_18-b07)<br />
<strong>Java</strong> HotSpot(TM) 64-Bit Server VM (build 16.0-b13, mixed mode)<br />
It is not necessary to set any environment variables. To access <strong>the</strong> JVM, Ensemble uses <strong>in</strong>formation conta<strong>in</strong>ed <strong>in</strong> <strong>the</strong> production.<br />
<strong>Us<strong>in</strong>g</strong> <strong>the</strong> <strong>Java</strong> <strong>Gateway</strong> 3