~ubuntu-branches/ubuntu/trusty/monodevelop/trusty-proposed

<td width="100%" align="center" bgcolor="#294563"><a href="http://www.ikvm.net/"><img border="0" class="logoImage" alt="IKVM.NET" src="../images/project.gif" title="Java on .NET"></a></td>

<td valign="top" rowspan="2" bgcolor="#294563"></td>

<td bgcolor="#294563"><img height="10" width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

</tr>

<tr>

<tr>

</tr>

</table>

</div>

</td><td bgcolor="#294563"><img alt="" width="1" height="1" src="../skin/images/spacer.gif" class="spacer"></td>

</tr>

<tr>

</tr>

</table>

<tr>

<tr>

<tr>

</tr>

<tr>

</tr>

<tr>

</tr>

</table>

</td>

<td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap" valign="top" bgcolor="#4C6C8F">

<ul>

<li>

<font color="#CFDCED">About</font>

<ul>

<li>

</li>

<li>

<a href="../download.html" title="">Download</a>

</li>

<li>

</li>

<li>

</li>

<li>

</li>

<li>

<a href="http://weblog.ikvm.net/story.aspx/license" title="">License</a>

</li>

100

<li>

101

<a href="../stories.html" title="">Case Studies</a>

102

</li>

103

104

</ul>

105

</li>

106

<li>

107

<font color="#CFDCED">User's Guide</font>

108

<ul>

109

110

<li>

111

<span class="sel"><font color="#ffcc00">Introduction</font></span>

112

</li>

113

114

<li>

115

<a href="../userguide/install.html" title="">Installation</a>

116

</li>

117

118

<li>

119

<a href="../userguide/tutorial.html" title="">Tutorial</a>

120

</li>

121

122

<li>

123

<a href="../userguide/tools.html" title="">Tools Reference</a>

124

</li>

125

126

127

128

129

</ul>

130

</li>

131

<li>

132

<font color="#CFDCED">Developer's Guide</font>

133

<ul>

134

135

<li>

136

<a href="../devguide/intro.html" title="">Introduction</a>

137

</li>

138

139

<li>

140

<a href="../devguide/concepts.html" title="">Concepts</a>

141

</li>

142

143

<li>

144

<a href="../devguide/net2java.html" title="">Using Java Libraries</a>

145

</li>

146

147

<li>

148

<a href="../devguide/java2net.html" title="">Developing in Java</a>

149

</li>

150

151

</ul>

152

</li>

153

<li>

154

<font color="#CFDCED">Contributing</font>

155

<ul>

156

157

<li>

158

<a href="http://sourceforge.net/mail/?group_id=69637">Mailing Lists</a>

159

</li>

160

161

<li>

162

<a href="http://sourceforge.net/tracker/?group_id=69637">Report Bugs</a>

163

</li>

164

165

<li>

166

<a href="http://sourceforge.net/cvs/?group_id=69637">CVS Repository</a>

167

</li>

168

169

</ul>

170

</li>

171

</ul>

172

</div>

173

174

</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td bgcolor="#294563"><img width="1" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

175

</tr>

176

<tr>

177

178

</tr>

179

<tr>

180

181

</tr>

182

</table>

183

</td><td valign="top" width="100%">

184

185

186

<tr>

187

188

</tr>

189

<tr>

190

191

192

193

</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica, Sans-serif">

194

195

196

</font><img width="10" height="8" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

197

</tr>

198

<tr>

199

200

</tr>

201

202

203

<tr>

204

205

206

207

<tr>

208

209

<h1>IKVM.NET User's Guide</h1>

210

</td>

211

</tr>

212

</table>

213

214

<li>

215

<a href="#Introduction">Introduction</a>

216

</li>

217

<li>

218

<a href="#Overview">Overview</a>

219

</li>

220

<li>

221

<a href="#System+Requirements">System Requirements</a>

222

</li>

223

</ul>

224

225

226

<h3>Introduction</h3>

227

228

<p>IKVM.NET is a Java Virtual Machine (JVM) for the .NET and Mono runtimes. At a time when most people in the computer industry consider Java and

229

.NET as mutually exclusive technologies, IKVM.NET stands in the unique position of bringing them together.

230

Initially born out of frustration with the limitations of tools like JUMP and J#, IKVM.NET was created when Jeroen Frijters set out to

231

create a way to migrate an existing Java<sup>TM</sup> database application

232

to .NET<sup>TM</sup>.

233

</p>

234

<p>IKVM.NET has gone through a variety of designs and name changes to emerge as a sophisticated collection of tools offering a variety of integration patterns

235

between the Java and .NET languages and platforms. It is still under development but people have reported success in running sophisticated applications and tools

236

including Eclipse, JmDNS, JGroups, Jetty (with a few changes), etc.

237

</p>

238

<p>This manual is written for IKVM.NET version 0.36. </p>

239

</div>

240

241

242

243

<h3>Overview</h3>

244

245

<p>There are two main ways of using IKVM.NET:</p>

246

<ul>

247

248

<li>

249

250

<p>Dynamically: In this mode, Java classes and jars are used directly to execute Java applications on the .NET<sup>TM</sup> runtime.

251

Java bytecode is translated on the fly into CIL and no further steps are necessary. The full Java class loader model is supported in this mode.</p>

252

253

</li>

254

255

<li>

256

257

<p>Statically: In order to allow Java code to be used by .NET applications, it must be compiled down to a DLL and used directly.

258

The bytecode is translated to CIL and stored in this form. The assemblies can be referenced directly by the .NET applications and

259

the "Java" objects can be used as if they were .NET objects. While the static mode does not support the full Java class loader mechanism,

260

it is possible for statically-compiled code to create a class loader and load classes dynamically.

261

</p>

262

263

</li>

264

265

</ul>

266

<p>

267

IKVM.NET provides the VM-related technologies for byte-code translation and verification, classloading, etc.

268

It is dependent upon the <a target="_blank" href="http://openjdk.java.net/">OpenJDK</a> project

269

for implementations of the JDK libraries.</p>

270

<p>IKVM.NET is comprised by the following components:</p>

271

272

<caption>IKVM.NET Components</caption>

273

274

<tr>

275

276

<th colspan="1" rowspan="1">Component</th>

277

<th colspan="1" rowspan="1">Description</th>

278

279

</tr>

280

281

<tr>

282

283

<td colspan="1" rowspan="1">IKVM.Runtime.dll</td>

284

<td colspan="1" rowspan="1">The VM runtime and all supporting code. It contains (among other things):

285

<ul>

286

287

<li>

288

<p>

289

Byte Code JIT compiler/verifier: Just-in-time compiles Java Byte Code to CIL.</p>

290

291

</li>

292

293

<li>

294

<p>

295

Object model remapping infrastructure: Makes System.Object, System.String and System.Exception appear to Java code as java.lang.Object, java.lang.String and java.lang.Throwable.</p>

296

297

</li>

298

299

<li>

300

<p>

301

Managed .NET re-implementations of the native methods in Classpath.</p>

302

303

</li>

304

305

</ul>

306

307

</td>

308

309

</tr>

310

311

<tr>

312

313

<td colspan="1" rowspan="1">IKVM.OpenJDK.ClassLibrary.dll</td>

314

<td colspan="1" rowspan="1">This is a compiled version of the Java class libraries, plus some additional IKVM.NET specific code.</td>

315

316

</tr>

317

318

<tr>

319

320

<td colspan="1" rowspan="1">IKVM.AWT.WinForms.dll</td>

321

<td colspan="1" rowspan="1">Very limited and broken implementation of a few AWT peers. This is a low priority issue until the platform stabilizes and works sufficiently well.</td>

322

323

</tr>

324

325

<tr>

326

327

328

<td colspan="1" rowspan="1">Starter executable, comparable to java.exe ("dynamic mode").</td>

329

330

</tr>

331

332

<tr>

333

334

<td colspan="1" rowspan="1">ikvmc.exe</td>

335

<td colspan="1" rowspan="1">Static compiler. Used to compile Java classes and jars into a .NET assembly ("static mode")</td>

336

337

</tr>

338

339

<tr>

340

341

<td colspan="1" rowspan="1">ikvmstub.exe</td>

342

<td colspan="1" rowspan="1">A tool that generates stub class files from a .NET assembly, so that Java code can be compiled against .NET code. IKVM.NET understands the stubs and replaces the references to the stubs by references to the actual .NET types.</td>

343

344

</tr>

345

346

347

</table>

348

</div>

349

350

351

352

<h3>System Requirements</h3>

353

354

<p>You must have one of the following .NET frameworks

355

installed:</p>

356

<ul>

357

358

<li>Microsoft .NET Framework 1.1 (or later) SDK (Windows platform)</li>

359

360

<li>Mono 1.2 (or later) (Windows or Linux)</li>

361

362

</ul>

363

</div>

364

365

366

367

<div class="attribution">by Stephen Schaub, Brian J. Sletten</div>

368

</div>

369

</td><td width="10"><img width="10" height="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>

370

</tr>

371

372

</table>

373

</td>

374

</tr>

375

</table>

376

377

378

379

<tr>

380

381

</tr>

382

<tr>

383

384

385

Send feedback about this page to <a href="mailto:webmaster@ikvm.net?subject=IKVM Website Feedback - Page userguide/intro.html">webmaster@ikvm.net</a>

386

<br>

387

388

389

390

document.write(" - "+"Last Published: " + document.lastModified);

391

// --></script></font></td>

392

</tr>

393

<tr>

394

395

</tr>

396

</table>

397

398

</body>

399

</html>

Older »