GNAT Ada-Java Interfacing Suite User’s Guide

Category:GNU Ada tools Title:GNAT Ada-Java Interfacing Suite User’s Guide Subtile:A Toolkit for GNAT, the GNU Ada Compiler Edition:GNAT GPL Edition Version:gpl-2014 Date:2014-04-06 Author:AdaCore Copyright:C 1995-2014, Free Software Foundation

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being “GNU Free Documentation License”, with the Front-Cover Texts being “GNAT Ada-Java Interfacing Suite” and “GNAT-AJIS User’s Guide”, and with no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License”.

• 1. About This Guide
  • 1.1. What This Guide Contains
  • 1.2. What You Should Know before Reading This Guide
• 2. Getting Started with GNAT-AJIS
  • 2.1. Introduction
  • 2.2. GNAT-AJIS Installation Structure
  • 2.3. GNAT-AJIS / GNAT Compatibility
  • 2.4. A Simple Example: Calling Ada from Java
    • 2.4.1. Environment Setup
    • 2.4.2. An Ada Package
    • 2.4.3. Invoking ada2java
    • 2.4.4. Compiling the Java class
    • 2.4.5. Building the Application
    • 2.4.6. Running the Program
• 3. Using ada2java to Generate Java Classes
  • 3.1. Using the Tool
  • 3.2. Compiling and Running the Generated Code
    • 3.2.1. Issues with the Ada Generated Code
    • 3.2.2. Compiling as an Ada Shared Library
    • 3.2.3. Compiling as an Ada Main Subprogram
    • 3.2.4. Compiling the Java Generated Classes
  • 3.3. Debugging an Ada / Java Application
  • 3.4. Pragma Annotate and ada2java
• 4. Mapping Ada to Java
  • 4.1. Types
    • 4.1.1. Scalar Types
    • 4.1.2. Arrays
    • 4.1.3. Strings
    • 4.1.4. Simple Record Types
    • 4.1.5. Tagged Types
  • 4.2. Global Variables and Constants
  • 4.3. Subprograms
    • 4.3.1. Method placement
    • 4.3.2. Subprogram parameters
    • 4.3.3. Overloaded operators
  • 4.4. Subprogram Access Types
  • 4.5. Exceptions
  • 4.6. Renamings
  • 4.7. Generics
  • 4.8. Predefined Environment
  • 4.9. Current Limitations
• 5. Advanced ada2java Topics
  • 5.1. Dealing with Name Clashes
  • 5.2. Dealing with ambiguous operand in conversion errors
  • 5.3. Removing function/procedure from binding layer
  • 5.4. Memory Model
    • 5.4.1. Requirements for Non-null Parameter Values
    • 5.4.2. Allocating Ada Objects from Java
    • 5.4.3. Automatic Creation of Native Objects
    • 5.4.4. Native Ownership
    • 5.4.5. Object Allocators
    • 5.4.6. Restrictions on Proxy-Owned Objects Passed to Subprograms
    • 5.4.7. Parameter Mode Documentation
  • 5.5. Aliasing
  • 5.6. Thread Safety
  • 5.7. Proxies and Native Object Equality
  • 5.8. Clone and Copy Semantics
  • 5.9. Cross-Language Inheritance
    • 5.9.1. Inheriting from a Java Proxy
    • 5.9.2. Cross Language Dispatching from Ada
    • 5.9.3. The Shadow Native Object
    • 5.9.4. Controlled Types
  • 5.10. Managing Attachment to Java Proxies
  • 5.11. Exceptions propagation
• 6. Using javastub to Generate Ada Package Specifications
• 7. Using JNI Directly
  • 7.1. Introduction
  • 7.2. Implementing a Native Method in Ada
    • 7.2.1. A Java class with a native method
    • 7.2.2. Generating an Ada specification
    • 7.2.3. Implementing the native method
    • 7.2.4. Compiling to a shared library or DLL
    • 7.2.5. Running the program
  • 7.3. Interfacing to an Existing Ada API
  • 7.4. Calling a Java Method from Ada
  • 7.5. Using Ada Objects from Java
  • 7.6. Using Java Objects from Ada