JavaHelp是Sun编写的一个库,用于在Swing应用程序中显示HTML帮助页。JavaHelp允许在HTML页面中嵌入Swing组件:
<html>
<object classid="java:javax.swing.JButton">
<param name="text" value="Wow, a Swing component in HTML HTML!">
</object>
</html>
此处将对此进行进一步讨论:http://docs.oracle.com/cd/E19253-01/819-0913/dev/lwcomp.html
我正在ApacheFelix中运行一个大型OSGi应用程序。如上所示,classid
属性指的是我想要嵌入的Swing组件类的FQN。我希望这是指我在自己的bundle中定义的Swing组件类。因为JavaHelp是在它自己的捆绑包中运行的,所以它不能引用我的捆绑包里的类。我只是在HTML页面中看到??
,表示找不到该类。如何让JavaHelp捆绑包引用我的捆绑包中的类?
这只是部分可能的。原因如下。
为了解决这个问题,我们必须创建自己的HTMLEditorKit
来拦截object
标签,然后自己从object
标签的classid
创建Component
。这是它的样子。
public class OurHTMLEditorKit extends HTMLEditorKit {
public ViewFactory getViewFactory() {
return new HTMLEditorKit.HTMLFactory() {
public View create(Element elem) {
if (elem.getName().equalsIgnoreCase("object"))
return new InternalObjectView(elem);
else
return super.create(elem);
}
};
}
}
private static Object attemptToGetClass(final String className) {
try {
Class c = Class.forName(className);
Object o = c.newInstance();
return o;
} catch (Exception e) {
logger.error(e.getMessage());
}
return null;
}
private static class InternalObjectView extends ObjectView {
public InternalObjectView(Element elem) {
super(elem);
logger.info(elem.toString());
}
protected Component createComponent() {
AttributeSet attrs = getElement().getAttributes();
String classname = ((String) attrs.getAttribute(HTML.Attribute.CLASSID)).trim();
try {
Component comp = (Component) attemptToGetClass(classname);
setParameters(comp, attrs);
return comp;
} catch (Exception e) {
logger.warn(e.getMessage());
}
return getUnloadableRepresentation();
}
// Copied from javax.swing.text.html.ObjectView with modifications to how exceptions are reported
Component getUnloadableRepresentation() {
Component comp = new JLabel("??");
comp.setForeground(Color.red);
return comp;
}
private void setParameters(Component comp, AttributeSet attr) {
Class k = comp.getClass();
BeanInfo bi;
try {
bi = Introspector.getBeanInfo(k);
} catch (IntrospectionException ex) {
logger.warn("introspector failed, ex: "+ex);
return; // quit for now
}
PropertyDescriptor props[] = bi.getPropertyDescriptors();
for (int i=0; i < props.length; i++) {
// System.err.println("checking on props[i]: "+props[i].getName());
Object v = attr.getAttribute(props[i].getName());
if (v instanceof String) {
// found a property parameter
String value = (String) v;
Method writer = props[i].getWriteMethod();
if (writer == null) {
// read-only property. ignore
return; // for now
}
Class[] params = writer.getParameterTypes();
if (params.length != 1) {
// zero or more than one argument, ignore
return; // for now
}
Object [] args = { value };
try {
writer.invoke(comp, args);
} catch (Exception ex) {
logger.warn("Invocation failed: " + ex.getMessage());
// invocation code
}
}
}
}
}
但是使用JavaHelp,无法使用<viewregistry>
标签[2]注册我们的HTMLEditorKit
。由于OSGi环境的原因,JavaHelp无法访问我们的HTMLEditorKit
**。
相反,唯一可能的方法是使用HTMLEditorKit
创建一个JEditorPane
,使用TOCView.parse()
创建我们自己的TOC JTree
,并告诉JEditorPane
在JTree
的选择更改时加载帮助页面。
*这看起来很长,但大部分代码都是从javax.swing.text.html.ObjectView
[1]复制的。我不得不从那里复制代码,因为getUnloadableRepresentation
和setParameters
是私有的,不受保护。
**这可能是由于Dynamic-ImportPackage
清单条目[3]造成的。但这需要经历很多困难。首先,必须更改JavaHelp清单。其次,在Felix启动后,必须告知它允许使用dynamic-import
命令进行动态导入。
- http://grepcode.com/file/repository.grepcode.com/java/root/jdk/openjdk/6-b14/javax/swing/text/html/ObjectView.java#ObjectView
- http://docs.oracle.com/cd/E19253-01/819-0913/author/helpset.html#toolbar
- http://wiki.osgi.org/wiki/DynamicImport-Package