SwiXML开源框架(二) 主要类和包结构

一。SwiXML包结构如下:

Packages
org.swixml
org.swixml.converters

 

org.swixml包中 是程序核心包

org.swixml.converters 包含的是继承接口org.swixml.converter接的转换器。转换器的作用是将Tag中的属性的值转换为对应的类型

比如font="red" 经过转换器转换后生成 new Font(red)对象

 

二。org.swixml包

1.接口

<1>Converter接口

General purpose data type converter that can be registered and used within the SwingEngine package to manage the conversion of objects from one type to another.

通用的数据转换器，能够在ConverterLibrary类总注册，可以管理从一个对象转换为另外一个对象.

 

Object	convert(Class type, Attribute attr, Localizer localizer)           Convert the value of the given Attribute object into an output object of the specified type.
Class	convertsTo()           A Converters conversTo method informs about the Class type the converter is returning when its convert method is called

 

 

convert(Class type,Attribute attr,Localizer localizer)将Attribute中指定的属性值转换为type类型的对象

 

convertTo() 返回转换后的对象Class。

 

Target	Factory
java.awt.Rectangle	org.swixml.converters.RectangleConverter
float	org.swixml.converters.PrimitiveConverter
int	org.swixml.converters.PrimitiveConverter
boolean	org.swixml.converters.PrimitiveConverter
javax.swing.Action	org.swixml.converters.ActionConverter
javax.swing.KeyStroke	org.swixml.converters.KeyStrokeConverter
java.lang.String	org.swixml.converters.StringConverter
java.util.Locale	org.swixml.converters.LocaleConverter
java.awt.Component	org.swixml.converters.ComponentConverter
javax.swing.ImageIcon	org.swixml.converters.ImageIconConverter
java.awt.LayoutManager	org.swixml.converters.LayoutConverter
java.awt.Font	org.swixml.converters.FontConverter
long	org.swixml.converters.PrimitiveConverter
double	org.swixml.converters.PrimitiveConverter
javax.swing.border.Border	org.swixml.converters.BorderConverter
java.awt.Image	org.swixml.converters.ImageConverter
java.awt.Point	org.swixml.converters.PointConverter
java.awt.Color	org.swixml.converters.ColorConverter
java.awt.Dimension	org.swixml.converters.DimensionConverter
javax.swing.Icon	org.swixml.converters.ImageIconConverter
java.awt.Insets	org.swixml.converters.InsetsConverter

 

<2>Facotry:根据Tag的名字生成对应的Swing组件，

Field Summary
static String	ADDER_ID
static String	SETTER_ID           Specifies the prefix string for all setter methods

 

Method Summary
Method	getSetter(Class template)           Returns a setter method, which accepts a parameter of the given type 根据给定的template(即Swing组件类，比如JButton,JFrame),返回其set方法
Method	getSetter(String name)           Returns a setter method by name 根据给定的名字返回set方法
Collection	getSetters()
Class	getTemplate()
Method	guessSetter(String name)           Returns a setter method by a Attribute name. 根据XML文件中的属性的名字 返回Set方法
Object	newInstance()           Create a new component instance 新建一个Swing组件实例
Object	newInstance(Object parameter)           Creates a new Object which class is getTemplate() 新建一个Swing组件实例，构造函数参数是parameter
Object	newInstance(Object[] parameter)           Creates a new Object which class is getTemplate() and the constructor parameter are parameter. 新建一个Swing组件实例,构造函数传入的参数是parameter数组

 

 

<3>SwingEngine

The SwingEngine class is the rendering engine able to convert an XML descriptor into a java.swing UI.