JSweet:Java到JavaScript的转译器
JSweet利用TypeScript通过使用JavaScript库和框架在Java中编写丰富且响应迅速的Web应用程序。使用JSweet,Java程序被转译(源代码到源代码编译)为TypeScript和JavaScript,以便在浏览器、移动Web视图或Node.js中运行。
- JSweet安全可靠。它为Web应用程序提供类型检查,并生成完全类型检查的JavaScript程序。它基于Oracle的Java编译器(javac)和Microsoft的TypeScript(tsc)。
- JSweet允许你使用你喜欢的JS库(JSweet+Angular2, JSweet+threejs, IONIC/Cordova, ...)。
- JSweet实现了服务器端Java和客户端JavaScript之间的代码共享。JSweet为核心Java库提供了实现,用于代码共享和旧Java代码迁移目的。
- JSweet快速、轻量且与JavaScript完全兼容。生成的代码是普通的JavaScript代码,这意味着与JavaScript相比没有额外开销,并且可以直接与现有的JavaScript程序和库互操作。
它是如何工作的?JSweet依赖于JavaScript API的良好类型描述,称为"糖果",其中大多数是从TypeScript定义文件自动生成的。这些Java中的API描述可以被视为头文件(类似于C中的*.h头文件),用于连接Java和JavaScript库。现有库有多个糖果来源,你可以轻松为任何库构建糖果(参见更多详情)。
使用JSweet,你可以利用所有Java工具(IDE、Maven等)来编程真正的JavaScript应用程序,使用最新的JavaScript库。
Java -> TypeScript -> JavaScript
这里是使用JSweet的第一个示例。考虑这个简单的Java程序:
package org.jsweet;
import static jsweet.dom.Globals.*;
/**
* 这是一个非常简单的示例,只显示一个警告框。
*/
public class HelloWorld {
public static void main(String[] args) {
alert("你好!");
}
}
用JSweet转译会得到以下TypeScript程序:
namespace org.jsweet {
/**
* 这是一个非常简单的示例,只显示一个警告框。
*/
export class HelloWorld {
public static main(args : string[]) {
alert("你好!");
}
}
}
org.jsweet.HelloWorld.main(null);
然后产生以下JavaScript输出:
var org;
(function (org) {
var jsweet;
(function (jsweet) {
/**
* 这是一个非常简单的示例,只显示一个警告框。
*/
var HelloWorld = (function () {
function HelloWorld() {
}
HelloWorld.main = function (args) {
alert("你好!");
};
return HelloWorld;
}());
jsweet.HelloWorld = HelloWorld;
})(jsweet = org.jsweet || (org.jsweet = {}));
})(org || (org = {}));
org.jsweet.HelloWorld.main(null);
更多内容请查看在线沙盒。
特性
- Java和TypeScript之间的完整语法映射,包括类、接口、函数类型、联合类型、元组类型、对象类型、字符串类型等。
- 自1.1.0版本以来,广泛支持Java构造和语义(内部类、匿名类、final字段、方法重载、instanceof运算符、静态初始化器等)。
- 超过1000个JavaScript库、框架和插件,用于编写Web和移动HTML5应用程序(JQuery、Underscore、Angular、Backbone、Cordova、Node.js等更多)。
- 一个Maven仓库,包含所有可用库的Maven构件(又称糖果)。
- 支持Java基本API,如J4TS糖果(从GWT的JRE仿真分叉而来)。
- 一个Eclipse插件,便于安装和使用。
- 一个Maven插件,可以从任何其他IDE或命令行使用JSweet。
- 一个Gradle插件,用于将JSweet集成到基于Gradle的项目中。
- 调试模式,可在你喜欢的浏览器中调试Java代码。
- 一组优秀的WEB/移动HTML5示例,帮助你入门并熟悉JSweet和最常见的JavaScript API(在示例部分还有更多示例)。
- 支持捆绑包,以最简单的方式运行生成的程序。
- 支持JavaScript模块(commonjs、amd、umd)。JSweet程序可以在浏览器或Node.js中运行。
- 支持各种EcmaScript目标版本(ES3到ES6)。
- 支持async/await习语。
- ...
入门
- 第1步:安装(或检查是否已安装)Git、Node.js和Maven(命令
git
、node
、npm
和mvn
应该在你的路径中)。 - 第2步:从Github克隆jsweet-quickstart项目:
$ git clone https://github.com/cincheo/jsweet-quickstart.git
- 第3步:运行转译器生成JavaScript代码:
$ cd jsweet-quickstart
$ mvn generate-sources
- 第4步:在浏览器中查看结果:
$ firefox webapp/index.html
- 第5步:编辑项目并开始编程:
更多信息请访问http://www.jsweet.org。
示例
- 说明在Java中使用各种框架的简单示例(jQuery、Underscore、Backbone、AngularJS、Knockout):https://github.com/cincheo/jsweet-examples
- 说明在Java中使用Threejs框架的简单示例:https://github.com/cincheo/jsweet-examples-threejs)
- Node.js + Socket.IO + AngularJS:https://github.com/lgrignon/jsweet-node-example
- 一些入门React.js的简单示例:https://github.com/cincheo/jsweet-examples-react
- JSweet JAX-RS服务器示例(如何在客户端和服务器之间共享Java模型):https://github.com/lgrignon/jsweet-jaxrs-server-example
- JSweet Cordova / Polymer示例:https://github.com/lgrignon/jsweet-cordova-polymer-example
- JSweet Cordova / Ionic示例:https://github.com/lgrignon/jsweet-cordova-ionic-example
- JSweet Angular 2示例:https://github.com/cincheo/jsweet-angular2-quickstart
- JSweet Angular 2 + PrimeNG:https://github.com/cincheo/jsweet-primeng-quickstart
子项目
这个仓库组织为子项目。每个子项目都有自己的构建过程。
- JSweet转译器:Java到TypeScript/JavaScript的编译器。
- JSweet核心糖果:核心API(JavaScript语言、JavaScript DOM和JSweet语言实用工具)。
- JDK运行时:从GWT的JRE仿真分叉,在JSweet/TypeScript/JavaScript中实现主要的JDK API。
- JSweet糖果生成器:一个从TypeScript定义文件生成Java API并将其打包为JSweet糖果的工具。
- JSweet文档:JSweet文档。
此外,JSweet的一些工具在外部仓库中可用。
如何构建
请查看每个子项目的README文件。
贡献
JSweet使用Git Flow。
你可以fork这个仓库。默认分支是develop。请使用git flow feature start myAwesomeFeature
开始工作on something great :)
完成后,你可以提交常规的GitHub拉取请求。
许可证
请阅读LICENSE文件。