https://github.com/j4ts/j4ts-quickstart
A quickstart project to get started with Java library support for TypeScript/JavaScript
https://github.com/j4ts/j4ts-quickstart
Last synced: 4 months ago
JSON representation
A quickstart project to get started with Java library support for TypeScript/JavaScript
- Host: GitHub
- URL: https://github.com/j4ts/j4ts-quickstart
- Owner: j4ts
- Created: 2020-05-27T06:34:20.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-27T07:00:28.000Z (about 5 years ago)
- Last Synced: 2025-01-14T03:39:09.208Z (6 months ago)
- Size: 1000 Bytes
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# j4ts-quickstart
A quickstart project to get started with Java library support for TypeScript/JavaScript
DISCLAIMER: this project is under construction and is open for contributions.
## Expected content
- A basic support for a simple Java API (for instance the BigDecimal class) so that users can clone the project and get started from there
- A HOWTO (in this README), that explains all the steps for creating a new Java API support.
# HOWTO
(Still under construction)
In this section, we explain how to create a new support for an existing Java API and the required steps to create/compile/publish the project.
- Step 1: Create the J4TS project
Just clone this repo to start from an existing minimalistic project.
- Step 2a: Import the source code of the Java API
If you have the source code of the Java API you need to support, one way to start is to import the Java source code as is and try to compile it with JSweet (``mvn generate-sources``). It is likely that it will not compile as is because it will miss dependencies to other Java API. In that case, go to step 3.
- Step 2b: Write a minimalistic version of the Java API in Java
This is the preferred choice if you don't have/own the source code, or if the source code is too Java-platform-dependent to be transpiled easily.
- Step 3: Solve external dependencies
If you imported existing source code, it is most likely that it depends on a Java library. If this Java library is already supported, you can just add it as a Maven dependency. Otherwise, you also need to provide support for this library. This is where it can become complicated...
It is likely that an existing JavaScript library will make the implementation much simpler (for instance, for implementing Java ``BigDecimal``, using the JavaScript library ``big.js`` will save you a lot of time - eventhough the behavor might not be fully similar to Java).
- Step 4: Compile and share
TBD