用Java打造的图形化表格类库

用Java打造的图形化表格类库

杨恒贤 （yanghx@70345.com）

 

关键词： Java  UML  Together

 

  本文通过Together建模设计一种与Web页中表格元素相近的图形化组建。主要用于图形表格的动态生成。本文用UML建立的类图关系，并用Java实现，全部类继承自定义的HTMLElement类，并且能很容易扩展。

 

1． 简介

本文讨论了怎么利用建模工具和Java打造一个复杂的类库。我们用Java与Together来实现一个图形化表格的类库，并且如何来使用这个类库生成多彩的图形化界面，并且支持JSP。

 

2． 要求功能描述

a)        我们要求这个类库实现Web页面上表格元素的功能，用于显示相应数据。所以每一个表格就是一个对象，所以我们定义表格类HTMLTable，要提供额外的功能我们只要从HTMLTable继承扩展就行了。

b)        可以方便的进行自定义设计，定义每一列的各种属性。我们把列也定义成一个类HTMLColumn。扩展列的属性只要从HTMLColumn扩展就行了。

c)         我们可以定义每一个单元个的属性，所以我们定义每一个单元个就是一个类。HTMLTableCell。扩展单元格的属性只要从HTMLTableCell扩展就行了。

d)        每一个Tanle多有几个单元块(例如上图的A，B)组成。我们将这种单元块定义为一种类HTMLTableSection。用于管理表格中的块。

e)        每一个单元块由一个合并了的单元个与一系列行组成，我们将合并了单元个定义成HTMLTableSectionCell，并且它与HTMLTableCell相近，所以我们在这2个类上导出一个共同基类HTMLBaseTableCell

f)         上面说到的行也是一种对象，所以我们将其定义为一种对象HTMLTableRow。

 

当你要定制其中某一种类的属性时，只要继承类重写其中的虚拟函数。以HTML开头的类实现了Web页中表格的功能。下面演示的以MV开头的就是继承来实现上面那种形式的表格。

 

3． 用UML工具进行类库设计

我们选用了Borland的建模工具Together。这个类图框架如下：

上面那幅图就是Together中画出的各类关系图。

l         为了使各类关系紧密连接起来，我们设计了一个公共父类HTMLElememt,提供一些共有的功能。提供属性如下
水平对齐属性m_nHAlign，表明元素里面的内容水平对其方式
竖直对其属性m_nVAlign，表明元素里面的内容竖直对其方式
元素父类组件m_parentTable，表明此元素的在哪一个元素上。
提供了相关的虚函数。
getWidth()   取得该对象的宽度。

l         在这里我们大量使用了Java中的ArrayList来管理对象的集合。在使用过程中由于全部是从HTMLElement继承，我们就使用了强制对象转化，从父类转化到子类（因为Java1.4还不支持泛型）。

l         我们为那种实现特定功能的函数尽量放在一个虚拟函数中，这样就可以使继承时用最少的代码实现定制功能。

 

具体的看提供的类库源代码。

4． 扩展

下面重点说一下我们怎么扩展这个类库，实现我们需要的功能。我们下面以实例来说明如何扩展。

最简单的就是如何定制某一个单元个的边框等属性。

单元格定制

我们继承单元格类HTMLTableCell

重载drawBorder（）画出Cell的边框。

Class MyTableCell extends HTMLTableCell{

       protected void drawBorder(java.awt.Graphics2D g, int left, int top, int width,

                            int height) {

    Color prev=g.getColor();

    g.setColor(Color.RED);

    g.drawRect(left, top, width, height);

    g.setColor(prev);

  }

}

运行效果如下

当我们要更高级别的定制时，我们就需要重写

public void draw(Graphics2D g, Point pt)，他就是提供了那个单元个的全部功能。这样你要怎么写就怎么写。

行的定制：

以实线分割：

public class MyRow extends HTMLTableRow{

  public MyRow(){

  }

  protected void drawLine(Graphics2D g,int left,int top,int right){

    g.drawLine(left,top,right,top);

  }

}

运行效果

当然由于每一个类多有一个函数实现自己全部的图画过程draw（），所以当你想全部自己重画的时候就利用提供参数进行作画。

 

5． 使用

关于本类库的使用，遵循的是

Table是由一系列TableSection组成的，而TableSection是由一系列TableRow与一个TableSectionCell组成，每一个TableRow是由一些列TableCell组成。

 

当你想定制元素属性时，当定制有冲突时，其遵循的原则是:

TableCell优先级>TableRow优先级>TableSection优先级>Table优先级>TableColumn优先级.

 

下面演示一下怎么使用这些类：

Public class TestClass{

public static void main(String[] args) throws FileNotFoundException,

    ImageFormatException, IOException {

    TestFrame frame=new TestFrame();

    frame.setSize(700,600);

    frame.show();

    BufferedImage image = (BufferedImage) frame.createImage(600,400);

    Graphics2D g=(Graphics2D) image.getGraphics();//g就是要在这上面作画

    MVTable table=new MVTable();//创建表格对象

    table.addColumn(new HTMLTableColumn(30));

    table.addColumn(new HTMLTableColumn(30));

    table.addColumn(new HTMLTableColumn(150));

    for(int i=0;i<5;i++){

      table.addColumn(new HTMLTableColumn(60,i+2,1,new Color(i*25,i*10+125,255-i*50)));

}

//上面是定义表格的列的属性

HTMLTableSection sec=new HTMLTableSection();

//创建一个TableSection

    HTMLSectionCell cell=new HTMLSectionCell(new Color(0x008080),"A");

    sec.createSection(cell);

    HTMLTableRow row=new MVTableRow(3.0,Color.CYAN);

    HTMLTableCell c=new HTMLTableCell();

    c.setCaption("1-1");

    row.addCell(c);

    c=new HTMLTableCell(Color.GRAY,"定制单元背景");

    row.addCell(c);

    for(int i=0;i<5;i++){

      c=new HTMLTableCell();

      row.addCell(c);

    }

    sec.addRow(row);//增加一个HTMLTableRow对象

    row=new MVTableRow(3.5,Color.RED);

    c=new HTMLTableCell(new Color(0x00ccff),"1-2");

    row.addCell(c);

    Font temp=new Font("宋体",Font.BOLD,14);

    c=new HTMLTableCell(temp,null,"定制单元格字体");

    row.addCell(c);

    for(int i=0;i<5;i++){

      c=new HTMLTableCell();

      row.addCell(c);

    }

    sec.addRow(row);

    table.addSection(sec);

   //-----------------------

   sec=new HTMLTableSection();

   cell=new HTMLSectionCell(new Color(0x99ccff),"B");

   sec.createSection(cell);

    row=new MVTableRow(4.1,Color.BLUE);

    c=new HTMLTableCell();

    c.setCaption("2-1");

    row.addCell(c);

    c=new HTMLTableCell();

    c.setCaption("定制行高");

    row.addCell(c);

    for(int i=0;i<5;i++){

      c=new HTMLTableCell();

      row.addCell(c);

    }

    row.setHeight(60);

    sec.addRow(row);

    row=new MVTableRow(5.1,Color.PINK);

    c=new HTMLTableCell(Color.YELLOW,"2-2");

    row.addCell(c);

    c=new MyTableCell();

    c.setCaption("重写drawBorder");

 

    row.addCell(c);

    for(int i=0;i<5;i++){

      c=new HTMLTableCell();

      row.addCell(c);

    }

 

    sec.addRow(row);

    row=new MyRow();

    c=new HTMLTableCell(Color.YELLOW,"2-3");

    row.addCell(c);

    c=new HTMLTableCell();

    c.setCaption("重写行的drawLine");

 

    row.addCell(c);

    for(int i=0;i<5;i++){

      c=new HTMLTableCell();

      row.addCell(c);

    }

 

    sec.addRow(row);

    row=new HTMLTableRow();

    c=new HTMLTableCell(Color.YELLOW,"2-3");

    row.addCell(c);

    c=new HTMLTableCell();

    c.setCaption("重写");

 

    row.addCell(c);

    for(int i=0;i<5;i++){

      c=new HTMLTableCell();

      row.addCell(c);

    }

 

    sec.addRow(row);

    table.addSection(sec);

   

    table.addInfo("继承定制单元格",3,2);

    table.addInfo("行的也可被定制",5,1);

    table.addInfo("表格也可以",6,1);

    table.addInfo("大不了我不调用基类功能，完全重写 ",7,1);

    table.draw(g);

    //========================================================

    OutputStream out=new FileOutputStream("C://1.jpg");

    JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder(out);

   // encoder.setJPEGEncodeParam();

    encoder.encode(image);

    out.close();

  }

}

 

6． 小结

这个类库构建过程中，我们用Borland的Together来构建相关的功能类图，并指明其关系。我们以关键数据与关键功能自我管理的原则来构建，这样的系统比较利于用继承的方法来进行功能续加。

 

小弟水平有限，如有不足请批评指正，谢谢。

 

类库下载地址：下载源代码