org.nustaq.kontraktor.webapp.transpiler

Interface TranspilerHook

All Known Implementing Classes:

CLICommandTranspiler, CoffeeScriptTranspiler, JSXIntrinsicTranspiler, JSXWithBabelTranspiler

public interface TranspilerHook

Created by ruedi on 21.05.16. hook to transpile files dynamically. Hooks can be registered in the http4k builder class 'BldResPath'

Method Summary

Modifier and Type	Method and Description
byte[]	transpile(File f) indicates a file is being accessed.
default byte[]	transpile(File f, FileResolver resolver, Set<String> alreadyResolved)

Method Detail

transpile

byte[] transpile(File f)
          throws TranspileException

indicates a file is being accessed. in dev mode this is called always (so its up to the implementation to check for filedate/modification). In order to run an external transpiler, just run transpilation synchronous such that the given file is updated and return null. Alternatively an implementation might choose to just transpile dynamically and directly return byte[]. NOTE: transpilation is static. this means in production mode it will be called once on first resource access.

Parameters:

f - - the file being accessed (after resourcepath resolvment)

Returns:

either (transpiled) file content or null. Should throw an exception in case an error occured during transpile.

Throws:

TranspileException

transpile

default byte[] transpile(File f,
                         FileResolver resolver,
                         Set<String> alreadyResolved)