其结构如图：

所有的可视组件都位于需要经由MIDlet来显示，而MIDlet上的所有事件，包括键盘事件，按钮事件提交到ActionController 上， ActionController跟据配置文件，将事件转发给相应的Action，Action将处理结果得到的可视组件(Displayable)通过 ActionForward返回MIDlet显示。

KBOX的使用非常简单， 以一个HELLO WORLD 为例：

创建一个MIDLET:

public class TestMIDlet extends MIDlet{

…

protected void startApp() throws MIDletStateChangeException {

ActionController controller = ActionController.getInstance(true);

controller.registerViewer(this); //Register the MIDlet

MyKGameCanvas mgc = new MyKGameCanvas("MYGC"); //Create a GameCanvas

}

…

}

创建一个Canvas:

public class MyKGameCanvas extends KGameCanvas{

public MyKGameCanvas(String uniqueID) {

super(uniqueID);

}

public void showString(String string){

Graphics g = this.getGraphics();

g.setColor(0xFFFFFFFF);

g.fillRect(0, 0, this.getWidth(), this.getHeight());

g.setColor(0xFF000000);

g.drawString(string, 0, 0, Graphics.TOP|Graphics.LEFT);

this.flushGraphics();

}

}

创建相应的Action:

public class TestAction implements Action{

public void excute(KCommand cmd, Item item, Displayable dis, ActionForward forward,Hashtable parameters) {

MyKGameCanvas mkc = ((MyKGameCanvas)dis);

mkc.showString("hello world! From "+mkc.getUniqueID()+"."+cmd.getUniqueID());

}

}

将按钮事件注册给Action:

DEBUG=true //open the debug model of KBOX

CMD.MYCMD.ACTION=action.TestAction

注意这里的MyKGameCanvas 继承的KGameCanvas，而不是GameCanvas。KBOX的KGameCanvas类继承自GameCanvas，当并没有使用 GameCanvas那种使用线程监听状态的模型，而是重写了keypressed等方法来处理键盘事件。另外，KGameCanvas的重写的按钮事件 的处理已经实现了重复按键情况，而且可以指定重复按键的灵敏度，这点是非常好用的：）

KCommand是KBOX扩展的按钮组件。
KCommand kc = new KCommand("TEST BUTTON", Command.HELP,1,"MYCMD",null);
第一个参数是按钮的名字，第二参数是按钮类型，第三个参数是优先级，第四个参数是ID名，用于配置文件的映射，对应“ CMD.MYCMD.ACTION=action.TestAction”中的MYCMD，第五个参数是可传递参数，是一个Hashtable类型，用于 向Action传递参数（当然你喜欢的话，也可以将参数提到配置文件里去……）。

KBOX的Action是一个只有execute方法的接口，任何类只要实现了该接口，都可以是一个Action。

注册一个键盘事件一样很简单：

public class TestKeyAction implements Action{

public void excute(KCommand cmd, Item item, Displayable dis, ActionForward forward,Hashtable parameters) {
MyKGameCanvas mkc = ((MyKGameCanvas)dis);

…

Do your business here.

..

}

}

指定键盘事件的处理Action

DEBUG=true //open the debug model of KBOX

CMD.MYCMD.ACTION=action.TestAction

KEY.MYGC.FIRE.ACTION=action.TestKeyAction…

KBOX的另外一个很实用的特性是DEBUG MODEL。

这个功能是用于在真机测试时，调试BUG用的。由于真机与模拟器不一定相同，当真机上抛出异常（真机上的异常无法察觉，没有控制台啊！），而模拟 器又一切正常的时候，这个功能就有用了：KBOX将捕获到的异常的用一个ERROR PAGE显示出来。不过注意在发布JAR包时，记得要去掉这个DEBUG模式，否则没事按到个没定义的键盘按键都会捕获到未定义按键处理的异常……

要打开DEBUG模式需要在配置文件上指定DEBUG=true。

组织简介 | 联系我们 |   Copyright 2002 ®  UML软件工程组织 京ICP备10020922号

京公海网安备110108001071号