如何进行JDK日志框架中的STAF浅析
本篇文章给大家分享的是有关如何进行JDK日志框架中的STAF浅析，小编觉得挺实用的，因此分享给大家学习，希望大家阅读完这篇文章后可以有所收获，话不多说，跟着小编一起来看看吧。
JDK日志框架之实例结合STAF，STAF 日志服务概念的提出，这方面是什么情况呢？让我们首先从什么是STAF开始。
STAF（Software Testing Automation Framework）是一个自动化软件测试框架，它可以实现分布式的自动化软件测试管理。我们可以应用 STAF 库的 Java API 来做基于 STAF 框架的应用，同时 STAF 同时也提供了日志服务。其日志服务是用来记录自动化测试流程中的信息，方便在 24x7 的自动化测试中记录自动化测试的操作，便于发现潜在的自动化测试管理脚本的问题。
既然我们可以用 STAF 的 Java API 来做基于 STAF 的应用，我们也可以将JDK 的日志框架同 STAF 的日志服务接口结合起来。 STAF 的日志服务的 java 接口定义如清单 7 所示：
清单 7 STAFLog 类定义
public class STAFLog { public STAFLog(String logType, String logName, STAFHandle handle); public STAFResult log(int level, String msg) // Log type constAnts public static STAFResult log(STAFHandle theHandle, String logType, String logName, int level, String msg) public String getName(); public String getLogType(); public int getMonitorMask(); ... //other methods }
从清单 7 我们可以看出，STAFLog 类提供了方法可以将日志信息存储到 STAF 的日志库中， 这个日志库既可以是本地的文件，也可以是另一个 STAF 服务器上的JDK日志库。这是通过本地 STAF 服务器的配置来决定的。而 STAFLog.log（） 方法只用于记录日志信息。
将 STAF 日志服务的 java API 同JDK日志框架结合起来需要做如下步骤：
创建 STAF 日志 Handler 类
该类封装了 STAF 日志服务 API 的接口。同时 STAF 的 Java API 需要一个全局的 STAFHandle 对象，用来表示本地的 STAF 服务句柄。这个可以通过建立一个静态的 STAFHandle 对象即可。其代码如下所示，我们定义了一个 STAFHandler 类如清单 8 所示。
清单 8 STAFHandler 类实现
import java.util.logging.*; import com.ibm.staf.wrapper.STAFLog; public class STAFHandler extends Handler { private String logName; private static STAFHandle stafHandle = null; public STAFHandler(String name) { configure(); logName = name; } public STAFHandler() { configure(); } @Override public void close() throws SecurityException { if (stafHandle != null){ try { stafHandle.unRegister(); } catch (STAFException e) { //ignore } } } @Override public void flush() { //nothing } @Override public void publish(LogRecord record) { if (!isLoggable(record)) { return; } String msg; try { msg = getFormatter().format(record); } catch (Exception ex) { reportError(null, ex, ErrorManager.FORMAT_FAILURE); return; } try { STAFLog.log(stafHandle, STAFLog.MACHINE, logName, record.getLevel().getName(), msg); } catch (Exception ex) { reportError(null, ex, ErrorManager.WRITE_FAILURE); } ...
在实现 STAFHandler 类时有以下几个要点：
1、由于 STAF API 的调用时需要一个 STAFHandle 的对象来代表本地的 STAF 服务，在该类中声明了一个全局变量用来存储 STAFHandle .
2、close 方法是用来清理系统资源的，上述代码的 close 方法中释放了全局变量 STAFHandle 对象。
3、publish 方法就是获得格式化后的消息后，直接调用 STAF 的日志 API 将日志发送到 STAF 服务中。
但到目前为止，我们还没有给 STAFHandler 类添加一个配置的代码，使之可以支持配置文件。下面我们定义了一个函数 configure，其代码如清单 9 所示。
清单 9 配置函数实现
private void configure() { if (stafHandle == null) { try { stafHandle = new STAFHandle("my application"); } catch (STAFException e) { reportError("registe staf handle error", e, ErrorManager.OPEN_FAILURE); } } LogManager manager = LogManager.getLogManager(); String cname = getClass().getName(); //set staf log name logName = manager.getProperty(cname + ".name"); if (logName == null) logName = "demo.staflog"; //set formatter String sformatter = manager.getProperty(cname + ".formatter"); Formatter formatter = null; if (sformatter != null) { try { formatter = (Formatter)Class.forName(sformatter).newInstance(); } catch (Exception e) { //ignore } } setFormatter(formatter == null? new STAFFormatter() : formatter); //set level String sLevel = manager.getProperty(cname + ".level"); Level level = null; if (sLevel != null) { try { level = STAFLevel.parse(sLevel); } catch (Exception e) { //ignore } } setLevel(level == null? STAFLevel.DEBUG : level); }
在实现配置文件支持的代码中，有以下几个要点：
1、STAF API 的初始化需要注册 STAFHandle 对象。而且该注册只能执行一次。我们根据全局变量 stafHandle 的值来决定是否注册该对象。
2、JDK的日志框架有一个全局的 singleton 管理类 STAFManager，该类用于管理日志类，并提供了读取日志配置文件的成员函数 getProperty 。在上述的代码中，我们通过 STAFManager.getProperty 方法，从日志配置文件中读取 STAFHandler 对象所设置的 Formatter 类名，然后通过反射生成一个新的 Formatter 对象，设置到 Handler 对象中。
3、对于日志级别也是通过 STAFManager.getProperty 方法。需要注意的是由于我们的日志级别是自定义的级别，所以 Level 对象是由我们自定义的 Level 类 STAFLevel 来生成的。
4、我们也能定义自己需要的属性。比如清单 9 中我们定义了一个 .name 属性，用来存储 STAF 日志名称，通过 getProperty 函数从配置文件中读取 .name 属性。
以上就是如何进行JDK日志框架中的STAF浅析，小编相信有部分知识点可能是我们日常工作会见到或用到的。希望你能通过这篇文章学到更多知识。更多详情敬请关注行业资讯频道。
