Apache Pivot DataBind(二) -- BindMapping接口

gaofeng0210

　　BindMapping介绍
　　BindMapping 是代表一系列的 BindMapping接口，这组接口用于pivot的 DataBind过程。
　　BindMapping包含一系列以BindMapping结尾命名的接口。下面列出了大部分pivot所支持的BindMapping接口
TextBindMapping--用于 Label、TextInput和TextArea等控件内容为String的控件。
StateBindMapping--用于 Toggle 按钮(Checkbox和Radio)按钮的三态的绑定。例如某个类型为boolean并且允许空值的数据库字段。
SelectedBindMapping--用于Togglea按钮的选中与非选中状态
ListDataBindMapping--由于 Pivot框架重新实现了一套集合框架。如果业务逻辑使用的List是java.util.List对象时，需要转换为Pivot框架对应的集合对象。
ItemBindMapping--用于ListView等列表组件的选中项的绑定。
SpinnerDataBindMapping 与 ListDataBindMapping 类似
TableDataBindMapping TableView数据内容的绑定，与ListDataBindMapping类似
SelectedRowBindMapping
SelectedDateBindMapping
SelectedColorBindMapping
　　何时使用BindMapping：符合下面的情况时，不需要使用BindMapping
1. 控件的显示内容(Label,TextInput显示文本，ToggleButton显示 true或者false状态..)与Bean 属性的数据类型相同时
2. Bean属性的数据类型有内置方法可以转换为控件的显示内容的数据类型
 例如 Lable，TextInput的内容为String，因此只要Bean属性的对象支持 toString方法即可。
　　
符合以上2点时，用户可以选择不使用BindMapping，pivot框架在调用load和stroe时会使用每个控件的内置BindMapping（无）。
　　大多数情况下使用BindMapping时，是在数据类型不匹配时，比如TextInput显示一个Integer类型的Bean属性时。此时如果只是load模式，可以不提供。如果是STROE或者BOTH模式需要提供BindMapping。
　　TextBindMappingInt类 实现了了Integer数据类型到String之间的数据绑定的转换，该类的实例可以用于 Label、TextInput、TextArea等控件内容为String绑定到整数字段的组件。
　　下面代码演示几个常用的 BindMapping

import org.apache.pivot.wtk.TextInput.TextBindMapping;

/**
* 用于实现 string <==> integer 之间的转换
*/
public class TextBindMappingInt implements TextBindMapping {
@Override
public String toString(Object value) {
// TODO Auto-generated method stub
return value.toString();
}
@Override
public Object valueOf(String text) {
// TODO Auto-generated method stub
if ( text == null || text.equals(""))
{
return 0;
}
return Integer.parseInt(text);
}
}
/*
TextBindMappingIP 类： 用于Bean属性为整数的IPv4地址时，转换为点分格式的String文本时使用。
*/
import java.net.InetSocketAddress;
import org.apache.pivot.wtk.TextInput.TextBindMapping;
public class TextBindMappingIP implements TextBindMapping {
@Override
public String toString(Object value) {
// TODO Auto-generated method stub
if ( value instanceof Integer)
{
int ip = ((Integer)value).intValue();
int [] addr = new int[4];
addr[3] =  (( (ip & 0xFF000000) >>> 24) & 0xFF);
addr[2] =  ((  (ip & 0x00FF0000) >>> 16) & 0xFF);
addr[1] =  (( (ip & 0x0000FF00) >>> 8) & 0xFF);
addr[0] =  (  (ip & 0x000000FF) & 0xFF);

return (addr[0]+"."+addr[1]+"."+addr[2]+"."+addr[3]);
}
return null;
}
@Override
public Object valueOf(String text) {
if ( text == null || text.equals(""))
return 0;
InetSocketAddress addr = new InetSocketAddress(text, 0);
byte[] ip = addr.getAddress().getAddress();
if (ip == null)
{
return 0;
}
int value = 0;
value = ( ((int)ip[3]) << 24) & 0xff000000
| ( (int)ip[2] << 16) & 0x00ff0000
| ( (int)ip[1] << 8) & 0x0000ff00
| ((int)ip[0]) & 0x000000ff;
return value;
}
}
/*
ItemBindMappingEnum 用于实现 枚举值和控件内容之间的转换，一般用于ListButton的选中项。
*/
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import org.apache.pivot.collections.List;
import org.apache.pivot.wtk.ListView.ItemBindMapping;
import com.google.protobuf.ProtocolMessageEnum;


public class ItemBindMappingEnum implements ItemBindMapping {
private String enumName;
@Override
public Object get(List<?> listData, int index) {
// TODO Auto-generated method stub
try {
//System.out.println(enumName+":"+index);
Class<?> classObj = Class.forName(enumName);
Method valueOf = classObj.getMethod("values",  new Class<?>[]{});
Object [] ar = ((Object[])valueOf.invoke(null, new Object[] { }));
//for( Object e : ar)
//{
//System.out.println(e.toString());
//}
if ( index >= ar.length )
{
//System.out.println("index error:"+index);
return ar[0];
}
return ar[index];
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IllegalArgumentException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (SecurityException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (IllegalAccessException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (InvocationTargetException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (NoSuchMethodException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return null;
}
@Override
public int indexOf(List<?> listData, Object value) {
// TODO Auto-generated method stub
if ( value instanceof ProtocolMessageEnum )
{
Enum<?> msgEnum = (Enum<?>)value;
return msgEnum.ordinal();
}else if ( value instanceof Enum<?>)
{
Enum<?> enumValue = (Enum<?>)value;
return enumValue.ordinal();
}
return 0;
}
public void setEnumName(String enumName) {
this.enumName = enumName;
}
public String getEnumName() {
return enumName;
}
}
/*
ListDataBindMappingList 用于 ListView 等控件内容为一个列表时。由于Pivot的控件支持的集合框架为org.apache.pivot.collections中的数据类型，而应用程序一般提供的数据类型都是为 java.util.List的对象，此时ListView等控件无法直接显示内容，因此需要在源数据内容和目标数据内容之间设置一个BindMapping，进行数据类型的转换。默认情况下ListView只能的Item只能显示List的元素类型为ListItem的对象，如果非ListItem的对象必须提供toString方法或者未ListView提供一个适合元素对象的ItemRenderer实例。或许你需要了解更多有关Pivot Renderer的内容。
*/
import org.apache.pivot.collections.ArrayList;
import org.apache.pivot.collections.List;
import org.apache.pivot.wtk.ListView.ListDataBindMapping;
import org.apache.pivot.wtk.content.ListItem;
import com.google.protobuf.ByteString;
import dv.Dvmessage.IPAddress; /*List元素的内容的某种数据类型*/

public class ListDataBindMappingList implements ListDataBindMapping {

private boolean toInteger = false; // 是否把 ListItem 转换为 Integer
private boolean toByteString = false;
private boolean toIP = false;
@Override
public List<?> toListData(Object value) {
// TODO Auto-generated method stub
List<Object> listData = new ArrayList<Object>();

if ( value instanceof java.util.List<?>)
{
java.util.List<?> jList = (java.util.List<?>)value;
if ( jList.size() == 0 )
{
return listData;
}
for( Object e : jList)
{
if ( toInteger )
{
ListItem item = new ListItem(e.toString());
listData.add(item);
}else if ( toByteString )
{
ByteString bs = (ByteString)e;
String strBs = new String( bs.toByteArray());
ListItem item = new ListItem(strBs);
listData.add(item);
}else if ( toIP)
{
TextBindMappingIPAndPort textToIP = new TextBindMappingIPAndPort();
if ( e instanceof IPAddress )
{
listData.add( new ListItem(textToIP.toString(e)));
}
}
else
{
listData.add(e); /*不做任何类型转换,用户需要提供代对象的 ItemRenderer或者提供 toString方法，元素内容才可以正常显示*/
}
}
}
return listData;
}

@Override
public Object valueOf(List<?> listData) {
// TODO Auto-generated method stub
java.util.List<Object> jList = new  java.util.ArrayList<Object>();
if ( listData instanceof List<?>)
{
List<?> list = ( List<?>)listData;
for( Object e: list )
{
if ( toInteger )
{
if ( e instanceof ListItem )
{
ListItem item = (ListItem)e;
jList.add( Integer.parseInt( item.getText()));
}
}else if ( toByteString )
{
if ( e instanceof ListItem)
{
ListItem item = (ListItem)e;
jList.add( ByteString.copyFrom( item.getText().getBytes()));
}
}else if ( toIP)
{
TextBindMappingIPAndPort textToIP = new TextBindMappingIPAndPort();
if ( e instanceof ListItem )
{
ListItem item = (ListItem)e;
jList.add( textToIP.valueOf(item.getText()));
}
}
else
{
jList.add(e);
}
}
}
if ( jList.size() ==  0 )
{
return java.util.Collections.emptyList();
}
return jList;
}
public void setToInteger(boolean toInteger) {
this.toInteger = toInteger;
}
public boolean isToInteger() {
return toInteger;
}
public boolean isToIP() {
return toIP;
}
public void setToIP(boolean toIP) {
this.toIP = toIP;
}
public void setToByteString(boolean toByteString) {
this.toByteString = toByteString;
}
public boolean isToByteString() {
return toByteString;
}
}

　　使用BindMapping，在wtkx文件中引用

<?xml version="1.0" ?>
<Border xmlns="org.apache.pivot.wtk"
xmlns:collections="org.apache.pivot.collections"
xmlns:content="org.apache.pivot.wtk.content"
xmlns:wtkx="http://pivot.apache.org/wtkx"
xmlns:bind="cn.dvision.bindMapping"
xmlns:renderer="cn.dvision.ui.renderer"
xmlns:custom="cn.dvision.ui">
<content>
<ScrollPane>
<view>
<Form>
<sections>
<Form.Section>
<custom:ListButtonEnumData enumName="dv.Dvenum$IPType" selectedItemKey="type" Form.label="type">
<selectedItemBindMapping>
<bind:ItemBindMappingEnum enumName="dv.Dvenum$IPType"/>
</selectedItemBindMapping>
</custom:ListButtonEnumData>
<BoxPane Form.label="ipv4">
<TextInput textKey="ipv4">
<textBindMapping>
<bind:TextBindMappingIP/>
</textBindMapping>
</TextInput>
<Checkbox selectedKey="hasIpv4"/>
</BoxPane>
<BoxPane Form.label="ipv6">
<TextInput textKey="ipv6">
<textBindMapping>
<bind:TextBindMappingByteString/>
</textBindMapping>
</TextInput>
<Checkbox selectedKey="hasIpv6"/>
</BoxPane>
<BoxPane Form.label="domain">
<TextInput textKey="domain"/>
<Checkbox selectedKey="hasDomain"/>
</BoxPane>
<TextInput textKey="port" Form.label="port">
<textBindMapping>
<bind:TextBindMappingInt/>
</textBindMapping>
</TextInput>
</Form.Section>
</sections>
</Form>
</view>
</ScrollPane>
</content>
</Border>

　　即可：