Log4j支持符合JSR223的腳本語言使用在它的組件上。任何一種支持符合JSR223標準的語言引擎都可以使用。所有的語言列表可以在JSR223腳本引擎的頁面中找到。很多語言被列在這里，例如javaScript,Groovy,BeanShell，直接支持JSR223語言框架，只要引入了jar就可以支持選擇的語言了。Log4j通過<script>,<scriptFile>和<scriptRef>這三個元素標簽來支持腳本語言的使用。Script元素包含了腳本的名稱，腳本編寫的語言，以及腳本的內容。

scriptFile包含了腳本的名稱，和這個腳本所在的位置，語言，字符集，是否對腳本的變化進行監視。

scriptRef包含了在script元素定義的腳本名稱。

腳本的名稱通常用來存儲腳本，并且和他的腳本引擎在一起，因此每次腳本需要運行的時候都可以被快速定位。然而腳本的名字不是必須的，提供名字方便在運行的時候有助于調試。在script元素中必須指定腳本語言（language屬性），而且這些語言必須是在配置列表中的語言。如果腳本語言沒有在scriptFile元素上指定，那么通過腳本的擴展名來識別腳本語言。如果腳本文件監控需要執行，那么必須在configuration元素中設置monitorInterval為非0的值。間隔interval時長，系統將會檢測腳本文件的變化。

<?xml version="1.0" encoding="UTF-8"?> <Configuration status="debug" name="RoutingTest"><Scripts><Script name="selector" language="javascript"><![CDATA[var result;if (logEvent.getLoggerName().equals("JavascriptNoLocation")) {result = "NoLocation";} else if (logEvent.getMarker() != null && logEvent.getMarker().isInstanceOf("FLOW")) {result = "Flow";}result;]]></Script><ScriptFile name="groovy.filter" path="scripts/filter.groovy"/></Scripts><Appenders><Console name="STDOUT"><ScriptPatternSelector defaultPattern="%d %p %m%n"><ScriptRef ref="selector"/><PatternMatch key="NoLocation" pattern="[%-5level] %c{1.} %msg%n"/><PatternMatch key="Flow" pattern="[%-5level] %c{1.} ====== %C{1.}.%M:%L %msg ======%n"/></ScriptPatternSelector><PatternLayout pattern="%m%n"/></Console></Appenders><Loggers><Logger name="EventLogger" level="info" additivity="false"><ScriptFilter onMatch="ACCEPT" onMisMatch="DENY"><Script name="GroovyFilter" language="groovy"><![CDATA[if (logEvent.getMarker() != null && logEvent.getMarker().isInstanceOf("FLOW")) {return true;} else if (logEvent.getContextMap().containsKey("UserId")) {return true;}return false;]]></Script></ScriptFilter><AppenderRef ref="STDOUT"/></Logger><Root level="error"><ScriptFilter onMatch="ACCEPT" onMisMatch="DENY"><ScriptRef ref="groovy.filter"/></ScriptFilter><AppenderRef ref="STDOUT"/></Root></Loggers></Configuration>

如果Configuration元素設置status為DEBUG，那么啟動的時候當前安裝的腳本引擎以及腳本的信息，將會在輸出日志中逐條顯示出來。

盡管有些引擎不是線程安全的，但是Log4j會確保他們在線程安全的模式下運行。

2015-09-27 16:13:22,925 main DEBUG Installed script engines 2015-09-27 16:13:22,963 main DEBUG AppleScriptEngine Version: 1.1, Language: AppleScript, Threading: Not Thread Safe,Compile: false, Names: {AppleScriptEngine, AppleScript, OSA} 2015-09-27 16:13:22,983 main DEBUG Groovy Scripting Engine Version: 2.0, Language: Groovy, Threading: MULTITHREADED,Compile: true, Names: {groovy, Groovy} 2015-09-27 16:13:23,030 main DEBUG BeanShell Engine Version: 1.0, Language: BeanShell, Threading: MULTITHREADED,Compile: true, Names: {beanshell, bsh, java} 2015-09-27 16:13:23,039 main DEBUG Mozilla Rhino Version: 1.7 release 3 PRERELEASE, Language: ECMAScript, Threading: MULTITHREADED,Compile: true, Names: {js, rhino, JavaScript, javascript, ECMAScript, ecmascript}

當腳本被執行，他們會提供一系列的變量，這些變量保證完成 各種他們期望執行的各種任務。腳本可用變量的列表，可以查看每個組件的相關文檔。

組件期望腳本的返回值傳遞給Java代碼。對于大多數腳本語言都不是問題，但是JavaScript不允許返回，除非是在一個fuction里。

然后JavaScript將腳本中的最后一個表達式返回。

如下的代碼就是我們期望的結果（result被返回）。

var result;if (logEvent.getLoggerName().equals("JavascriptNoLocation")) {result = "NoLocation";} else if (logEvent.getMarker() != null && logEvent.getMarker().isInstanceOf("FLOW")) {result = "Flow";}result;

Beanshell 備注

JSR 223?腳本引擎規定如果引擎支持編譯他們的腳本，需要識別他們支持的編譯接口。Beanshell就有這樣的特點。

然后無論什么情況編譯方法只要被調用就會報一個錯誤（不是異常）

Log4j捕獲了這個錯誤，并且將這個錯誤打印了出來。所有的BeanShell腳本在每次執行的時候才進行解釋（解釋執行）。

2015-09-27 16:13:23,095 main DEBUG Script BeanShellSelector is compilable 2015-09-27 16:13:23,096 main WARN Error compiling script java.lang.Error: unimplementedat bsh.engine.BshScriptEngine.compile(BshScriptEngine.java:175)at bsh.engine.BshScriptEngine.compile(BshScriptEngine.java:154)at org.apache.logging.log4j.core.script.ScriptManager$MainScriptRunner.<init>(ScriptManager.java:125)at org.apache.logging.log4j.core.script.ScriptManager.addScript(ScriptManager.java:94)

?

?

轉載自?并發編程網 - ifeve.com

總結

以上是生活随笔為你收集整理的《Log4j 2 官方文档》Scripts的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。