TypeScript for Vert.x 3.1 (or higher)

This library adds TypeScript 1.6 support to Vert.x 3.1 or higher.

Usage

The library registers a new factory for verticles written in TypeScript. Just add the library to your class path and you're done. Files with a name ending in .ts will automatically be compiled to JavaScript when they are executed.

Type definitions for the Vert.x JavaScript API are also provided (vertx-lang-typescript-1.0.0-typings.zip). Use them in your favourite TypeScript editor to get auto-completion, API documentation and meaningful error messages.

Add to local Vert.x installation

Download the library's main jar (vertx-lang-typescript-1.0.0.jar) and put it into the lib folder of your local Vert.x installation. It will be automatically added to the classpath by the Vert.x start script.

Add to your application

If your application's build is based on Maven add the following lines to your pom.xml:

<dependency>
    <groupId>de.undercouch</groupId>
    <artifactId>vertx-lang-typescript</artifactId>
    <version>1.0.0</version>
</dependency>

If you use Gradle add the following to your build.gradle:

dependencies {
    compile 'de.undercouch:vertx-lang-typescript:1.0.0'
}

Example

The following script creates an HTTP server:

/// <reference path="./typings/vertx-js/vertx.d.ts" />

vertx.createHttpServer().requestHandler(req => {
  req.response().putHeader("Content-Type", "text/html").end("Hello");
}).listen(8080);

Improve performance

The TypeScript compiler runs rather slow in the JVM using the Nashorn JavaScript engine. It takes a couple of cycles before the compiler reaches its full speed. For this reason, the library offers a number of parameters to tweak the performance.

Make use of Node.js

The TypeScript compiler runs a lot faster in Node.js. If the node executable is in the path the library automatically makes use of it.

Cache compiled scripts in memory

If you are compiling a script multiple times in the same Vert.x container you should set the vertx.typescriptCache system property to memory. This allows vertx-lang-typescript to reuse already compiled scripts.

On the command line you can set this property as follows:

export VERTX_OPTS=-Dvertx.typescriptCache=memory

In your Java program you can use

System.setProperty("vertx.typescriptCache", "memory");

Cache compiled scripts on disk

Caching scripts in memory only makes a difference if you, for example, deploy the same verticle multiple times. The ramp-up time, however, may still be rather long.

To mitigate this you can cache compiled scripts on disk. Set the vertx.typescriptCache system property to disk.

export VERTX_OPTS=-Dvertx.typescriptCache=disk

or

System.setProperty("vertx.typescriptCache", "disk");

Cached scripts will be stored in a directory called typescript_code_cache in the current working directory by default. You can change this location by setting the vertx.typescriptCacheDir system property:

export VERTX_OPTS=-Dvertx.typescriptCache=disk -Dvertx.typescriptCacheDir=/tmp/typescript-cache

or

System.setProperty("vertx.typescriptCache", "disk");
System.setProperty("vertx.typescriptCacheDir", "/tmp/typescript-cache");

Building

Perform a full build with

./gradlew build

Just as Vert.x 3.x the library requires Java 8.

License

The library is licensed under the Apache License, Version 2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.