?

https://code.google.com/p/cliche/ ? ? ?jar 包 見附件

?

?

jline ? jar ?，好像是 ?hive ?的命令行 也使用了， http://jline.sourceforge.net

?

以下是引用別人的信息：

Overview

????? JLine 是一個用來處理控制臺輸入的Java類庫，目前最新的版本是0.9.94。其官方網(wǎng)址是http://jline.sourceforge.net。在介紹JLine之前，首先還是介紹一下Java 6中的Console類，以便進行對比。

?

2 Java Console

?? ?? 通過調(diào)用System.console()方法可以得到與當(dāng)前虛擬機對應(yīng)的Console對象。但是該方法并不保證其返回值一定非null，這取決于底層平臺和虛擬機啟動的方式：如果是通過交互式的命令行啟動，并且標(biāo)準(zhǔn)輸入和輸出流沒有被重定向，那么該方法的返回值通常是非null；如果是被自動啟動（例如cron）或者通過Eclipse啟動，那么返回值通常為null。

????? Console類支持的功能有限，其中一個比較有用的功能是以非回顯（echo）的方式從控制臺讀取密碼。

?

3 JLine

????? JLine不依賴任何core Java以外的類庫，但是其不是純Java的實現(xiàn)。

• 在Windows平臺下，JLine通過自帶的.dll文件初始化終端。jline.jar中包含了jline32.dll和jline64.dll，在Windows平臺上使用的時候， JLine會自動將其解壓縮到臨時目錄并進行加載。
• 在Unix或者Max OS X平臺下，JLine通過stty命令初始化終端。例如通過調(diào)用stty -icanon min 1將控制臺設(shè)置為character-buffered模式。以及通過調(diào)用stty -echo禁止控制臺回顯。在修改終端的屬性之前，JLine會對終端的屬性進行備份，然后注冊一個ShutdownHook，以便在程序退出時進行恢復(fù)。由于JVM在非正常退出時（例如收到SIGKILL信號）不保證ShutdownHook一定會被調(diào)用，因此終端的屬性可能無法恢復(fù)。

????? JLine使用起來非常簡單，jline.jar中一共只有20幾個類，源碼也不難懂。以下是個簡單的例子，其中readLine函數(shù)的參數(shù)指定了命令行提示符：

?

3.1 Features

3.1.1 Command History

????? 通過按下鍵盤的上下箭頭鍵，可以瀏覽輸入的歷史數(shù)據(jù)。此外JLine也支持終端快捷鍵，例如Ctrl+A, Ctrl+W,Ctrl+K, Ctrl+L等等，使用的時候非常便捷。

????? 可以通過ConsoleReader的setUseHistory(boolean useHistory)方法啟用/禁用Command History功能。ConsoleReader的history成員變量負(fù)責(zé)保存歷史數(shù)據(jù)，默認(rèn)情況下歷史數(shù)據(jù)只保存在內(nèi)存中。如果希望將歷史數(shù)據(jù)保存到文件中，那么只需要以File對象作為參數(shù)構(gòu)造History對象，并將該History對象設(shè)置到ConsoleReader即可。

3.1.2 Character Masking

????? ConsoleReader提供了一個readLine(final Character mask) 方法，用來指定character mask。如果參數(shù)為null，那么輸入的字符正常回顯；如果為0，那么不回顯；否則回顯mask指定的字符。

3.1.3 Tab Completion

????? JLine中跟自動補全相關(guān)的接口是Completor，它有以下幾個實現(xiàn)：

• SimpleCompletor: 對一系列指定的字符串進行自動補全。
• FileNameCompletor: 類似于bash中的文件名自動補全。
• ClassNameCompletor: 對classpath中出現(xiàn)的全路徑類名進自動補全。
• NullCompletor: 不進行自動補全。
• ArgumentCompletor: 為每個屬性使用指定的Completor。

????? 以下是個簡單的例子：

????? 以上例子中首先在命令行上鍵入a，然后按下TAB后會自動補全第一個屬性abc；然后鍵入空格，再按下TAB會進行文件名的自動補全；再鍵入空格和按下TAB后會進行類名的自動補全； 再鍵入空格和按下TAB后不再有自動補全。需要注意的是，ArgumentCompletor會對命令行上所有索引超過completors長度的屬性使用completors中最后一個元素指定的Completor。如果要禁用這個行為，那么將completors的最后一個元素設(shè)置為NullCompletor對象。

?

3.1.4 Custom Keybindings

????? 通過創(chuàng)建 HOME/.jlinebindings.properties文件（或者制定 jline.keybindings 系統(tǒng)變量），可以定制keybindings。

?

4 Known Issues

????? JLine最知名的問題莫過于在Windows平臺下的Eclipse中啟動的程序中調(diào)用reader.readLine()方法時總是返回null（正確的行為是等待用戶輸入）。通過debug， 筆者發(fā)現(xiàn)通過設(shè)置jline.WindowsTerminal.directConsole屬性為false，可以解決返回null的問題，但是感覺還是有些其它的問題。總之，筆者沒有發(fā)現(xiàn)好的對策，只能work around，即對JLine再進行一層封裝，在某些場景下仍然使用原始的基于System.in的流處理。

?

5 Usage

????? 想必很多項目都會為其應(yīng)用做一層Application之類的抽象。對應(yīng)用進行監(jiān)控的常見方式是使用JMX，JMX從邏輯上可以認(rèn)為是應(yīng)用程序的一個Shell。筆者為項目中的Application提供了一套完整的Shell抽象，包括Shell、Console、 Process 和 Command等等。其中JLine是一種Console的具體實現(xiàn)。如果是后臺應(yīng)用，那么可以通過基于Socket的Console連接到應(yīng)用，從而進行監(jiān)控，例如停止應(yīng)用程序等。如果前臺的交互式應(yīng)用，那么可以直接使用基于終端的Console實現(xiàn)， 例如筆者項目中為Spring Batch實現(xiàn)的CommandLine Scheduler等。

?