摘要：就是砍這是一個代碼動態編譯工具，也就是能夠把形式的代碼實時地編譯為字節碼的工具動態編譯工具，其實自發布以來，應該出現過很多，不過的特點在于就像它的名字一樣可以選擇性地砍掉任意語言特性也就是說這是一個可以在動態編譯代碼的同時，對語言語法

這是一個java代碼動態編譯工具，也就是能夠把String形式的java代碼實時地編譯為字節碼的工具；

“動態編譯”工具，其實自jdk1.6發布以來，應該出現過很多，不過kan-java的特點在于 —— 就像它的名字一樣 —— 可以選擇性地砍掉任意語言特性；

也就是說 —— 這是一個可以在動態編譯java代碼的同時，對java語言語法做裁剪的動態編譯工具。

通過下面這個例子可以看出“裁剪”指的是什么意思：

// 禁止帶標簽的continue語句
void testLabeledContinue(){
    def kan = new KanJava(Feature.labeledContinue)
    def srcs = []
    srcs << new JavaSourceFile("TestLabeledContinue.java", "kanjava.test", readContent("testLabeledContinue/TestLabeledContinue.src"));
    def rst = kan.checkAndCompile(srcs)

    assertTrue !rst.isSuccess()
    assertTrue rst.errMsg != null
    assertTrue rst.classes == null
    println rst.errMsg
}

上述groovy代碼創建了一個KanJava編譯工具實例, 并指明想要砍掉labeledContinue特性(即帶標簽的continue語句)
其中readContent方法的返回結果如下：

package kanjava.test;

public class TestLabeledContinue {

    public static void main(String... args) {
        for(int i=0;i<10;i++){
            if(i == 5) continue;
        }
        label: while(true){
            if(true) continue label;
        }
    }
}

上述代碼包含2個continue語句：第一個不帶標簽而第二個帶標簽
最終輸出結果如下：

Error at row: 10, col: 22, reason: Continue statements with labels are not allowed.

即“帶標簽的continue語句”已被禁止了，在編譯過程中發現這種語句即會報錯, 其核心功能，概念上講就是這么簡單。

擁有一個裁剪版本的java，這有怎樣的應用場景？

目前最直接的答案是"高性能的內部DSL"

即當我需要一個語法上非常接近普通過程式編程語言的DSL，但卻又不想或覺得沒必要自己從頭實現一個(外部DSL)的時候，就可以考慮以某種現成的過程式通用編程語言為藍本，通過裁剪其語法達到目的；
而當這種“現成的過程式通用編程語言”被選擇為java時，kan-java出場的時刻就到了, 試想一下，下面這樣“砍”會砍出來什么效果？ ——

private static final KanJava kanJava = new KanJava(Feature.assertion, 
                                                   Feature.doWhileLoop,
                                                   Feature.forLoop,
                                                   Feature.labeledBreak,
                                                   Feature.labeledContinue,
                                                   Feature.nestedClass,
                                                   Feature.whileLoop);

相信所有java程序員都可以猜到：你將得到一個“沒有assert語句、沒有do-while循環、沒有for循環、沒有帶標簽的break、沒有帶標簽的continue、沒有嵌套類、沒有while循環”的 —— java.
P.S. 如果你還堅信它是java的話 :)

而這些"內部DSL"最終將被編譯成字節碼運行，因此也有了高速運行的基礎；
所以說kan-java能夠成為“利用java實現高性能的內部DSL”的強大工具。

上面示例中的這種“砍”法并不夸張，這是從現實中的使用案例中截選出來的。

kan-java提供的api能夠將“砍語法”和“編譯為字節碼”拆分為兩個步驟；
這使得你可以 —— 比如說 —— 在用戶輸入的時候禁掉"import語句"，而實際編譯的時候可以正常插入import語句后再編譯, 相信這種功能會很有用;

更普遍意義地講，kan-java實際上提供了一套"java語言語法靜態處理框架", 在此框架之上，“砍”語法其實只是冰山一角 —— 因為你還可以用它來“砍用法”，比如你并不想完全禁掉import語句，但希望禁止import一些特定的類;
再比如你不想完全禁止用戶new對象，但你能夠做到不讓用戶new特定的對象...

凡是能夠出現在代碼當中的任意結構，都可以被控制。
因此可以說，被發布出來的kan-java庫只是一個小小的核心，其更加廣闊的應用場景還有待猿們繼續擴充...

有沒有更加“高級(黑)”的話題？ 當然有；因為在kan-java提供的這套框架之上不僅限于能“砍”，它還能“加”...
不過目前這個庫的主要目的還是提供一套“基于java的內部DSL構建工具”，其它的什么“用kan-java做源碼增強”，什么“用kan-java把java編譯到GPU上”這些黑科技就暫不展開了 :)

最重要的事情總是最后才說...

目前kan-java所支持的java基礎語法是1.6的，也就是說，你使用kan-java來“砍”語法的時候，是以java 1.6為基礎來砍的
不過這并不影響kan-java庫被放到更高版本的java環境中使用(above v1.6), 起碼大多數情況下是ok的；不過，如果真的遇到問題，還是最好能從源碼編譯一份對應當前java版本環境的kan-java庫(因為kan-java在實現上使用了com.sun包下的一些類, 這些類并不完全保證在不同版本java之間的兼容)

同樣因為kan-java使用了com.sun包下的類，我也只能假定kan-java只能在oracle hotspot jvm上運行

目前開放的可被“砍”的功能，只是源于目前我個人在實際項目中的需要而已；肯定還有更多可能的“花式砍法”，如果希望有，可以提出來，有興趣的我們可以共建

使用kan-java時，需確保tools.jar也在classpath中

按道理講，除了java標準庫，kan-java是不需要依賴任何第三方庫的，不過項目中出現了對groovy-all的依賴，這僅僅是因為我想實踐一把"java和groovy混編開發模式"的任性而已，不要太在意 :)

目前的發布版本為v0.1, maven依賴為：

    com.github.pfmiles
    kan-java
    0.1

原文鏈接：https://github.com/pfmiles/kan-java