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 the GNAT Pro Ada Compiler

Edition

GNAT Pro Edition

Version

22.0w

Date

2021-04-06

Author

AdaCore

Copyright

C 1995-2021, 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. Debugging Ada memory allocations embedded in Java Applications
  • 3.5. 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. Renaming bound record types
  • 5.2. Dealing with Name Clashes
  • 5.3. Dealing with ambiguous operand in conversion errors
  • 5.4. Removing function/procedure from binding layer
  • 5.5. Allowing Java object creation even if the primitive cannot be bounded
  • 5.6. Allowing Java child types even if the primitive cannot be bounded
  • 5.7. Disabling function alias creation on name clash
  • 5.8. Memory Model
    • 5.8.1. Requirements for Non-null Parameter Values
    • 5.8.2. Allocating Ada Objects from Java
    • 5.8.3. Automatic Creation of Native Objects
    • 5.8.4. Native Ownership
    • 5.8.5. Object Allocators
    • 5.8.6. Restrictions on Proxy-Owned Objects Passed to Subprograms
    • 5.8.7. Parameter Mode Documentation
  • 5.9. Aliasing
  • 5.10. Thread Safety
  • 5.11. Proxies and Native Object Equality
  • 5.12. Clone and Copy Semantics
  • 5.13. Cross-Language Inheritance
    • 5.13.1. Inheriting from a Java Proxy
    • 5.13.2. Cross Language Dispatching from Ada
    • 5.13.3. The Shadow Native Object
    • 5.13.4. Controlled Types
  • 5.14. Managing Attachment to Java Proxies
  • 5.15. Exceptions propagation
  • 5.16. Allowing limited types Java derivation
  • 5.17. Disabling Java Iterator For Ada Collections
  • 5.18. Disabling Java Iterator Optimization For Ada Collections
• 6. Using JNI Directly
  • 6.1. Introduction
  • 6.2. Implementing a Native Method in Ada
    • 6.2.1. A Java class with a native method
    • 6.2.2. Generating an Ada specification
    • 6.2.3. Implementing the native method
    • 6.2.4. Compiling to a shared library or DLL
    • 6.2.5. Running the program
  • 6.3. Interfacing to an Existing Ada API
  • 6.4. Calling a Java Method from Ada
  • 6.5. Using Ada Objects from Java
  • 6.6. Using Java Objects from Ada