RCP之病人信息系统开发总结（5）：MVC模式之View层—视图

项目中大致有四个视图，我只写了其中一个很重要的导航视图





一个完整的导航视图开发过程：

1.继承自ViewPart类的NavigatorView类，主要内容如下：
（1）定义一个树查看器 TreeViewer
（2）给TreeViewer设置ContentProvider和LabelProvider
（3）设置TreeViewer的数据Input
（4）设置视图上的工具栏CoolBar和菜单栏MenuBar

package com.yinger.patientims.views;

import org.eclipse.jface.action.IMenuManager;
import org.eclipse.jface.action.IToolBarManager;
import org.eclipse.jface.viewers.DoubleClickEvent;
import org.eclipse.jface.viewers.IDoubleClickListener;
import org.eclipse.jface.viewers.ISelection;
import org.eclipse.jface.viewers.IStructuredSelection;
import org.eclipse.jface.viewers.TreeViewer;
import org.eclipse.swt.SWT;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.ui.IActionBars;
import org.eclipse.ui.IEditorInput;
import org.eclipse.ui.IEditorPart;
import org.eclipse.ui.IWorkbenchPage;
import org.eclipse.ui.part.DrillDownAdapter;
import org.eclipse.ui.part.ViewPart;

import com.yinger.patientims.actions.OpenSearchViewAction;
import com.yinger.patientims.navigator.NavigatorEntityElement;
import com.yinger.patientims.navigator.NavigatorEntityFactory;
import com.yinger.patientims.util.PluginUtil;
import com.yinger.patientims.views.viewerProvider.NavigatorTreeViewerContentProvider;
import com.yinger.patientims.views.viewerProvider.NavigatorTreeViewerLabelProvider;

/**
* 导航视图
*
*/
public class NavigatorView extends ViewPart {

private TreeViewer treeViewer; // 树查看器

@Override
public void createPartControl(Composite parent) {
// 创建树查看器
treeViewer = new TreeViewer(parent, SWT.MULTI | SWT.V_SCROLL | SWT.H_SCROLL);
// 设置内容提供其和标签提供器
treeViewer.setContentProvider(new NavigatorTreeViewerContentProvider());
treeViewer.setLabelProvider(new NavigatorTreeViewerLabelProvider());
// 读入数据
treeViewer.setInput(NavigatorEntityFactory.setNavigatorEntity());
// 自定义的方法
// 设置视图的工具栏
setViewToolBar();
// 自定义的方法，实现双击打开相应的编辑器的功能
hookDoubleClickAction();
}

// 这个方法实际上就是给treeviewer添加了一个处理双击事件的监听器
private void hookDoubleClickAction() {
treeViewer.addDoubleClickListener(new IDoubleClickListener() {
@Override
public void doubleClick(DoubleClickEvent event) {
ISelection selection = treeViewer.getSelection();
// 得到选中的项，注意方法是将得到的选项转换成 IStructuredSelection，再调用 getFirstElement 方法
Object object = ((IStructuredSelection) selection).getFirstElement();
// 再将对象转为实际的树节点对象
NavigatorEntityElement element = (NavigatorEntityElement) object;
// 得到该对象的editorInput
IEditorInput editorInput = element.getEditorInput();
// 得到当前工作台的page
IWorkbenchPage workbenchPage = getViewSite().getPage();
// 如果点击的是 信息查询
if (element.getName().equals("Information Search")) {
new OpenSearchViewAction(getSite().getWorkbenchWindow()).run();
return;
}
String editorID = null;
// 这里要结合NavigatorEntityFactory类的setNavigatorEntity方法
// 这一部分对原书作了修改，化繁为简
if (element.getName().equals("Patient Information")) {// 病人信息管理
editorID = PluginUtil.PatientInfoEditor_ID;
}else if (element.getName().equals("Diagnose Information")) {// 诊断信息管理
editorID = PluginUtil.DiagnoseInfoEditor_ID;
}else if (element.getName().equals("Expense Information")) {// 费用信息管理
editorID = PluginUtil.ExpenseInfoEditor_ID;
}else{
return;
}
//IEditorPart:An editor is a visual component within a workbench page.
IEditorPart editorPart = workbenchPage.findEditor(editorInput);
if(editorPart != null){//已经打开了所需的编辑器
workbenchPage.bringToTop(editorPart);
}else {//没有打开就打开来
try {
editorPart = workbenchPage.openEditor(editorInput, editorID);
} catch (Exception e) {
e.printStackTrace();
}
}
}
});
}

private void setViewToolBar() {
// IActionBars:Used by a part to access its menu, toolbar, and
// status line managers.
IActionBars bars = getViewSite().getActionBars();
// 定义工具栏
IToolBarManager toolBarManager = bars.getToolBarManager();
// 定义下拉菜单栏
IMenuManager menuManager = bars.getMenuManager();
// DrillDownAdapter:Implements a simple web style navigation
// metaphor for a TreeViewer. Home, back,
// and "drill into" functions are supported for the viewer,
DrillDownAdapter drillDownAdapter = new DrillDownAdapter(treeViewer);
// 为工具栏添加“goHome”，“goBack”，“goInto”操作
drillDownAdapter.addNavigationActions(menuManager);
// 为菜单栏添加“goHome”，“goBack”，“goInto”操作
drillDownAdapter.addNavigationActions(toolBarManager);
}

@Override
public void setFocus() {

}

}

2.树结构的各个类



接口ITreeElement

package com.yinger.patientims.navigator;

import java.util.List;

/**
* 定义导航视图内部的节点的接口
*
* 我觉得不好的地方就是没在这里是用泛型机制！
*/
public interface ITreeElement {

public void setName(String name);

public String getName();

public void setChildren(List children);

public List getChildren();

public boolean hasChildren();

public void addChildren(ITreeElement iElement);

}

树节点实现类：NavigatorEntityElement 类

package com.yinger.patientims.navigator;

import java.util.ArrayList;
import java.util.List;

import org.eclipse.ui.IEditorInput;

/**
* 实现了导航视图内部的节点的接口ITreeElement
*
* 我个人感觉可以定义一个int变量，表示这个element节点的level！[OK!我已经实现了]
*/
public class NavigatorEntityElement implements ITreeElement {

private String name;// 节点名称
private int level = 0;// 节点深度，0表示根节点，是默认值
private List children = new ArrayList();// 节点孩子
private IEditorInput editorInput;// 节点的IEditorInput对象
//IEditorInput是新增的，在接口中没有定义，它在元素上绑定一个editor，这样就可以知道双击这个节点需要打开的editor

public NavigatorEntityElement() {

}

public NavigatorEntityElement(String name) {
this.name = name;
}

public NavigatorEntityElement(int level, String name) {
this(name);
this.level = level;
}

public int getLevel() {
return level;
}

public void setLevel(int level) {
this.level = level;
}

public IEditorInput getEditorInput() {
return editorInput;
}

public void setEditorInput(IEditorInput editorInput) {
this.editorInput = editorInput;
}

@Override
public void setName(String name) {
this.name = name;
}

@Override
public String getName() {
return name;
}

@Override
public void setChildren(List children) {
this.children = children;
}

@Override
public List getChildren() {
return children;
}

@Override
public boolean hasChildren() {
if (children.size() > 0) {
return true;
}
return false;
}

@Override
public void addChildren(ITreeElement iElement) {
children.add(iElement);
}

}

树结构的类NavigatorEntityFactory 类

package com.yinger.patientims.navigator;

import java.util.ArrayList;
import java.util.List;

import com.yinger.patientims.editors.editorInput.DiagnoseInfoEditorInput;
import com.yinger.patientims.editors.editorInput.ExpenseInfoEditorInput;
import com.yinger.patientims.editors.editorInput.PatientInfoEditorInput;
/**
* 这个工厂类主要任务就是负责设置在导航视图中要显示的TreeViewer中的节点元素
* 实体工厂类将实体类中的各个节点数据关联起来，起到统筹的作用
*/
public class NavigatorEntityFactory {

public static Object setNavigatorEntity() {
/**
* 这里涉及到一个统一化的问题，有些String在其他的地方引用了，不便于修改！
* 保存起来？！
*/

// Level one 一级节点
NavigatorEntityElement root1 = new NavigatorEntityElement(0, "Hospital Management");
NavigatorEntityElement root2 = new NavigatorEntityElement(0, "Expense Management");
NavigatorEntityElement root3 = new NavigatorEntityElement(0, "Information Search");

// level two 二级节点
NavigatorEntityElement element1 = new NavigatorEntityElement(1, "Patient Information");
NavigatorEntityElement element2 = new NavigatorEntityElement(1, "Diagnose Information");
NavigatorEntityElement element3 = new NavigatorEntityElement(1, "Expense Information");

// 将下级节点添加到上级
root1.addChildren(element1);
root1.addChildren(element2);
root2.addChildren(element3);

// 设置编辑器
element1.setEditorInput(new PatientInfoEditorInput());
element2.setEditorInput(new DiagnoseInfoEditorInput());
element3.setEditorInput(new ExpenseInfoEditorInput());

// 要返回的list
List list = new ArrayList();
list.add(root1);
list.add(root2);
list.add(root3);
return list;
}
}

3.树的内容提供器ContentProvider和标签提供器LabelProvider

内容提供器：类NavigatorTreeViewerContentProvider

package com.yinger.patientims.views.viewerProvider;

import java.util.List;

import org.eclipse.jface.viewers.ITreeContentProvider;
import org.eclipse.jface.viewers.Viewer;

import com.yinger.patientims.navigator.ITreeElement;
/**
* 导航视图中的TreeViewer的内容提供器
*
* 内容提供器提供的是查看器的内容，也就是查看器中的元素是什么对象
* 注意：TreeViewer的内容提供器要实现的接口是ITreeContentProvider，而不是IContentProvider
* IContentProvider接口提供了基本的生存期协议，用于将内容提供器与输入元素进行关联
* 以及处理输入元素的更改
*
* 通常，内容提供器知道如何在输入元素和期望的查看器内容之间进行映射
*
*/
public class NavigatorTreeViewerContentProvider implements ITreeContentProvider {

public NavigatorTreeViewerContentProvider(){
//最好是写上一个默认的构造器
}

@Override
public void dispose() {

}

@Override
public void inputChanged(Viewer viewer, Object oldInput, Object newInput) {

}

@Override//当输入是设定的元素时，返回查看器中显示的元素
public Object[] getElements(Object inputElement) {
if (inputElement instanceof List) {
return ((List) inputElement).toArray();
}else{
return new Object[0];//为什么在不是list的时候要返回的是一个空的Object数组呢？
}
}

@Override//得到指定父元素的子元素
public Object[] getChildren(Object parentElement) {
ITreeElement treeElement = (ITreeElement)parentElement;
List children = treeElement.getChildren();
if(children == null || children.isEmpty()){
return new Object[0];
}else{
return children.toArray();
}
}

@Override//没有去实现
public Object getParent(Object element) {
return null;
}

@Override//是否有子节点
public boolean hasChildren(Object element) {
ITreeElement treeElement = (ITreeElement)element;
List children = treeElement.getChildren();
if(children == null || children.isEmpty()){
return false;
}else{
return true;
}
}

}

标签提供器 ：NavigatorTreeViewerLabelProvider 类

package com.yinger.patientims.views.viewerProvider;

import org.eclipse.jface.viewers.ILabelProvider;
import org.eclipse.jface.viewers.ILabelProviderListener;
import org.eclipse.swt.graphics.Image;
import org.eclipse.ui.ISharedImages;
import org.eclipse.ui.PlatformUI;

import com.yinger.patientims.navigator.NavigatorEntityElement;

/**
* 导航视图中TreeViewer的标签提供器
*
* 标签提供器提供的是用于显示的文本或者图片
* 注意：TreeViewer的标签提供器最好是实现ILabelProvider，而不是IBaseLabelProvider
*
* 标签提供器可以帮助保存图标资源，因为它可以确保图标的相同实例用于查看器中所有的相似类型
*/
public class NavigatorTreeViewerLabelProvider implements ILabelProvider {

public NavigatorTreeViewerLabelProvider(){
//最好是写上一个默认的构造器
}

@Override
public void addListener(ILabelProviderListener listener) {

}

@Override
public void dispose() {

}

@Override
public boolean isLabelProperty(Object element, String property) {
return false;
}

@Override
public void removeListener(ILabelProviderListener listener) {

}

//重点：学会得到系统提供的图片的方法：PlatformUI.getWorkbench().getSharedImages().getImage( ISharedImages.XX)
@Override//要显示的图片
public Image getImage(Object element) {
String image1 = ISharedImages.IMG_OBJ_FOLDER;
String image2 = ISharedImages.IMG_OBJ_FILE;
NavigatorEntityElement entityElement = (NavigatorEntityElement) element;
if(entityElement.hasChildren()){
return PlatformUI.getWorkbench().getSharedImages().getImage(image1);
}else{
return PlatformUI.getWorkbench().getSharedImages().getImage(image2);
}
}

@Override//要显示的文本
public String getText(Object element) {
NavigatorEntityElement entityElement = (NavigatorEntityElement) element;
return entityElement.getName();
}

}

整个过程的执行流程图



4.其他的类或者方法会在后面的相关部分中涉及，例如编辑器的输入类会在编辑器中涉及
其他视图根据需求设计它们的界面

通过 Wiz 发布