Kefu Working & Learning Center

Eclipse插件基础知识梳理

  • May 18, 2020

1. SWT基础

1.Display&Shell
// 1. 创建、获取当前的UI线程
Display display = Display.getDefault();
// 2. 创建窗口（一个shell实例就代表一个窗口）
Shell shell = new Shell(display);
// 3. Display的事件队列和事件循环
while(!shell.isDisposed()){
	if(!display.readAndDispatch()){
		display.sleep();
	}
}
// 图形操作系统会为每一个GUI程序分配一个事件队列，用户操作鼠标或键盘时，操作系统负责将这些事件放到对应程序的事件队列中
2.显示器、边界和客户区域
// 获得主显示器对象，显示器对象主要包含边界和客户区域两个部分
// 边界代表了这个显示器的屏幕大小，客户区域则代表可以用来显示窗口屏幕部分大小
Monitor monitor = Display.getDefault().getPrimaryMonitor();
// 边界
monitor.getBounds();
// 客户区域
monitor.getClientArea();
3.SWT中的多线程
// 同步调用
Display.syncExec(Runnable runnable)
// 通知UI线程在下一个事件循环中执行runnable参数的run方法。调用这个方法的线程将被阻塞到runnable执行完成为止。

//异步调用
Display.asyncExec(Runnable runnable)
// 通知UI线程在下一个事件循环中执行runnable参数的run方法。调用这个方法的线程将，不会被阻塞， 而且在runnable执行完成后不会得到通知

2. 控件（Control）

所有的控件类都从org.eclipse.swt.widget.Control继承而来，而Control的父类为Widget。
Widget是所有和窗口相关的部件的父类，它为所有的窗口组件提纲了创建对象（申请资源）、释放资源和事件监听的功能。
Widget有两个比较重要的子类，Control类是所有控件的父类；而Item类则是控件的辅助部分，它代表了复杂控件中的某一“项”。

1.控件的用户数据（getData/setData）

控件的用户数据是开发者自定义的一些存储在控件中的属性，添加或删除属性对控件的使用没有任何影响。

2.控件的释放

控件也会占用系统资源，这部分资源的分配实在控件的构造函数中完成的。
控件是存在于shell之中的，所有它的父资源是shell控件，当窗口关闭的时候，所有的控件资源都会被释放。
手动释放控件资源会导致一系列问题，如果不是万不得已，最后不要手动释放一个控件，而应该交给SWT系统自动释放它们。

3. 图形资源

SWT中几种常见的图形资源，都继承自org.eclipse.swt.graphics.Resource.

1.Color
// 自己创建的Color对象，不需要时，必须释放
Color color = new Color(Display.getDefault(),255,0,0);
// 使用系统的color不用手动释放
Color cyanColor = Display.getDefault().getSystemColor(SWT.COLOR_CYAN);
2.Image
// 自己创建的对象，同样需要手动释放
Image image = new Image(Display.getDefault(), "image_path");
// 使用系统的图片
Image sysImage = Display.getDefault().getSystemImage(SWT.ICON_ERROR);
3.Font

Font管理者显示文本时所使用的字体、字号、格式等各种样式。

// 自己创建，需要手动释放
Font font = new Font(Display.getDefault(), "Tahoma", 10, SWT.BOLD);
// 使用系统的
Font sysFont = Display.getDefault().getSystemFont();
// 应用在label上
label.setFont(font);
4. SWT中使用Swing

SWT提供了一个org.eclipse.swt.awt.SWT_AWT类（SWT_AWTSWT_AWT桥）

Frame frame = SWT_AWT.new_Frame(composite);
frame.setLayout(new BorderLayout());
JPanel panel = new JPanel();
panel.setLayout(null);
frame.add(panel, BorderLayout.CENTER);

4. 基本控件和对话框的使用

1. 控件的使用

使用样式SWT.BORDER显示边框，SWT.NONE无边框。
Label是不能被用户操作的控件，对Label使用样式SWT.SEPARATORSWT.SEPARATOR可以使控件显示成一条水平或竖直的分割线。
Text只读，SWT.READONLY样式
SWT.MULTI多行文本框，SWT.WRAP对于多行文本框，可以时文字自动换行。如果使用了SWT.WRAP样式，H_SCROLL样式将被忽略。
Combo只读，SWT.READONLY样式，并且只能单选，多选可以使用List，样式设为SWT.MULTI。
CoolBar可以拖动按钮的位置

2. Menu和MenuItem（窗口菜单）

为一个窗口（shell）添加菜单栏时，需要使用Menu的Bar样式，菜单栏只能处于窗口顶部，无法调整位置，并且不能在一个窗口中显示多个菜单栏。

// 创建菜单栏中的Menu对象
Menu bar = new Menu(shell, SWT.BAR);
shell.setMenuBar(bar);

// 在菜单栏创建一个菜单项
MenuItem fileMenuItem = new MenuItem(bar, SWT.NONE);
fileMenuItem.setText("File");

// 对File创建下拉菜单
final Menu fileMenu = new Menu(fileMenuItem, SWT.PUSH);
fileMenuItem.setMenu(fileMenuItem);
final MenuItem openMenuItem = new MenuItem(fileMenu, SWT.PUSH);
openMenuItem.setText("Open");
final MenuItem exitMenuItem = new MenuItem(fileMenu, SWT.NONE);
exitMenuItem.setText("Exit");

// 对Open 添加子菜单
final Menu openMenu = new Menu(openMenuItem);
openMenuItem.setMenu(openMenu);

final MenuItem dirMenuItem = new MenuItem(openMenu, SWT.PUSH);
dirMenuItem.setText("Directory");

MenuItem的样式，CASCADE,PUSH,CHECK,RADIO,SEPRATOR

3. TabFolder和TabItem（选项卡）
//默认选项卡在上端，可以用SWT.BOTTOM显示在下端
final TabFolder tabFolder = new TabFolder(shell, SWT.NONE);
tabFolder.setBounds(10,10,242,234);

final TabItem tab1 = new TabItem(tabFolder, SWT.NONE);
tab1.setText("Tab 1");
//composite存放选项卡中的内容
final Composite comp1 = new Composite(tabFolder, SWT.NONE);
tab1.setControl(comp1);

final TabItem tab2 = new TabItem(tabFolder, SWT.NONE);
tab1.setText("Tab 2");
final Composite comp2 = new Composite(tabFolder, SWT.NONE);
tab2.setControl(comp2);

// 切换选项卡的时候
tabFolder.addSelectionListener(new SelectionAdapter(){
	public void widgetSelected(final SelectionEvent e){
		int index = tabFolder.getSelectionIndex();
		TabItem item = tabFolder.getItem(index);
	}
})
4. 消息框
MessageBox mb = new MessageBox(shell, SWT.ICON_ERROR | SWT.OK);
mb.setText("Error");
mb.setMessage("Error message");
int result = mb.open();
if(SWT.OK == result) {

} else {

}

图标样式：ICON_ERROR, ICON_WARNING, ICON_INFORMATION, ICON_WORKING, ICON_QUESTION
按扭组合：SWT.OK|SWT.CANCEL(确定，取消)；SWT.YES|SWT.NO|SWT.CANCEL(是，否，取消)；SWT.ABORT|SWT.RETRY|SWT.INGNORE(终止，忽略，重试)

5. 文件与目录对话框

文件对话框：FileDialog, 样式为SWT.SAVESWT.SAVE时，表示另存为。OPEN/MULTI样式时，为打开，OPEN单文件，MULTI多文件。

FileDialog fileDialog = new FileDialog(shell, SWT.OPEN);
// 文件后缀过滤器   
fileDialog.setFilterExtensions(new String[] {".txt", "*.exe"});
// 默认目录  
fileDialog.setFilterPath("path") 
fileDialog.open();

目录对话框：DirectoryDialog

5. 容器和布局管理器

1. Composite

创建有边框的Composite：
Composite composite = new Composite(shell, SWT.BORDER);
对于Radio Button，Composite容器默认提供了排他性，也就是在一个composite里面，只能有一个处于选中状态。若使用了NO_RADIO_GROUP样式，两个Radio Button可以同时被选中。
RIGHT_TO_LEFT样式：会影响到所有包含在容器内的控件。
EMBERDDED样式：与其他样式不同，使用这种样式的Composite容器通常不用来摆放SWT控件，而是用来显示非SWT（AWT，Swing等）的GUI内容，起到了桥梁作用。

2. Group

Group是Composite的子类，BORDER，NO_RADIO_GROUP和RIGHT_TO_LEFT等样式，可以直接应用。
Group会默认显示边框。
BORDER样式：会显示下凹的边框

3. Shell

Shell是Composite的子类，但是它只能作为顶层的父容器出现，无法嵌套在其他容器内。
SHELL_TRIM样式：默认的窗口样式，由CLOSE，TITLE，MIN，MAX和RESIZE这几种组成；
DIALOG_TRIM样式：对话框窗口样式，有TITLE，CLOSE和BORDER组成； TOOL样式：浮动工具栏样式，标题栏比较窄，字体也要小几号，TOOL和TITLE；
NO_TRIM样式：去掉所有的样式；
ON_TOP样式：使窗口永远处于用户桌面的最上层。
模态(Modality)样式：MODELLESS，默认模态样式，使子窗口不对任何消息进行阻截；PRIMARY_MODAL，使子窗口阻截所有发送到其父窗口的操作消息，如果不管掉这个窗口，就无法对父窗口操作；APPLICATION_MODALAPPLICATION_MODAL，使窗口阻截所有发到与它共享一个DISPLAY实例的窗口的操作消息；SYSTEM_MODAL，它允许窗口拦截操作系统中所有其他窗口的消息，极少使用这种样式。对于同一个Shell容器，只能选择一种静态模式。
Shell容器的事件：通过添加ShellListener来监听
Activate事件：Shell成为活动窗口，或窗口被创建时；
Close事件：Shell被关闭后；
Deactivate事件：Shell从活动窗口变成非活动窗口；
Deiconify事件：Shell从最小化状态恢复时；
Iconify事件：Shell被最小化时。

4. 容器上下文菜单
// 在创建Menu的时候，可以直接调用Menu(Control control)的构造函数，
// 这个构造函数会自己寻找Control实例最上层的Shell容器，并以POP_UP为默认样式
// Menu menu = new Menu(container)效果与下面的实例化一样
Menu menu = new Menu(shell, SWT.POP_UP);
container.setMenu(menu);
MenuItem menuItem1 = new MenuItem(menu, SWT.NONE);
menuItem1.setText("Item1");
5. 容器颜色、背景和鼠标指针设置

setBackground设置背景色
setBackgroundMode设置背景模式：INHERITE_NONE模式，子控件不继承容器的背景色；INHERITE_DEFAULT模式，同样使用了这种模式的子控件才会继承容器的背景色；INHERITE_FORCE模式，强制子控件继承容器的背景色。
鼠标指针：
Cursor handCursor = Display.getSystemCursor(SWT.CURSOR_CROSS); composite.setCursor(handCursor);

6. 布局管理

composite.setLayout(new GridLayout())
为composite容器安装一个GridLayout布局管理器，安装了之后，需要容器调用layout方法，才能生效，只需要在最高层容器（Shell）调用一次layout()就行。当布局管理器改变时，也需要重新调用layout()方法。
控件的偏好尺寸（Preferred Size）：控件按照自己的属性，显示出控件最佳的效果，调用Control.pack()方法可以将控件恢复到它的偏好尺寸。
坐标系：父容器的左上角为原点，横轴为x，纵轴为y，坐标的单位时像素，用4个数字确定一个矩形，(x,y,weight,height)，坐标可为负值

1. FillLayout布局

保证容器中所有的子控件都显示出来，但是无法手动指定子控件的大小，因此子控件在创建的时候，不需要设置其位置和尺寸。

// 设置FillLayout布局
// 默认是横向(SWT.HORIZONTAL)，设成纵向：SWT.VERTICAL
FillLayout layout = new FillLayout();
// 间距
layout.spacing = 8;
// 横向页边空白
layout.marginWidth = 10;
// 纵向页边空白
layout.marginHeight = 5;
shell.setLayout(layout);
// 调用layout方法，通知容器开始布局
shell.layout();
2. GridLayout布局

此布局管理器会将容器的空间划分为网格（Grid），Grid的列数由属性numColumns指定。行高和列宽均由这个一行/列中最高/宽的控件决定。

final GridLayout gridlayout = new GridLayout();
gridlayout.numColumns = 2;
shell.setLayout(gridlayout);

final Text addressText = new Text(shell, SWT.BORDER);
addressText.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false));
shell.layout();

GridData为GridLayout的布局信息类，入参：horizontalAlignment(水平方向如何对齐)，verticalAlignment(竖直方向如何对齐)，grabExcessHorizontalSpace(是否占用水平方向剩余空间)，grabExcessVerticalSpace(是否占用竖直方向剩余空间)，horizontalSpan(水平跨列数)，verticalSpan(竖直跨行数)
设置子控件的尺寸：通过Griddata.widthHint和GridData.heightHint来设置。 GridData.exclude:如果设为true，GridLayout将按照AbsoluteLayout(No layout)的方式来布局

3. StackLayout布局

此布局管理的所有子控件中，只有一个显示能够显示出来，通过topControl来指定哪一个子控件当前处于栈顶，然后再调用Composite的layout()进行重新布局，就可以切换处于可见状态的子控件。

final StackLayout layout = new StackLayout();
composite.setLayout(layout);

layout.topControl = ~
composite.layout();

6. 高级控件

1. List、Tree和Table

ContentProvider:解析模型，取得查看器所需要的内容；监听数据模型的变化(PropertyChangeListener)
List: IStructuredContentProvider(inputchanged(),getElements())；LableProvider()
Table: IStructuredContentProvider(inputchanged(),getElements()); ITableLabelProvider()
Tree: ITreeContentProvider(inputchanged(),getElements(),getChildren(),getParent(),hasChildren());ITableLabelProvider()
查看器方法：
refresh(): 刷新整个查看器的内容
refresh(Object element): 刷新指定的元素（包含子元素）
update(Object element, String[] properties): 更新指定的元素，只会更新元素本身显示的内容，properties用于通知查看器该元素中哪些属性发生了变化
查看器框架中各对象之间的关系：
a.外部调用setInput为查看器指定模型;
b.查看器将新的模型传递给内容提供方；
c.内容提供方再模型上注册监听器，开始监听模型； d.内容提供方将模型中的元素集合提取出来提供给查看器； e.查看器将元素交给标签提供方；
f.标签提供方将元素中用于显示的文字/图片信息取出返回给查看器； g.查看器把信息显示在控件里。
样式：
FULL_SELECTION:整个item都被选中；
HIDE_SELECTION:窗口失去焦点时，是否还显示选中状态 SIMPLE和MULTI：控制能否同时多行选择

2. 文本编辑器
Font tahoma = new Font(display, "Tahoma", 16, SWT.BOLD);

StyledText text = new StyledText(shell, SWT.BORDER);
text.setText("The quick brown fox jumps over the lazy dog.");

StyleRange style1 = new StyleRange();
// 从第0个字符开始，长度为9
style1.start = 0;
style1.length = 9;
style1.font = tahoma;
style1.foreground = display.getSystemColor(SWT.COLOR_RED);
// 上移5像素
style1.rise = 5;
// 加下划线
style1.underline = true;
text.setStyleRange(style1);

// 以行为单位，进行文字的调整
// fromline：起始行，lineCount：需要应用该格式的行数
// 首行缩进50像素
style1.setLineIndent(0,1,50);
// 第二行居中
style1.setLineAlignment(2,1,SWT.CENTER);
// 设置段落背景色
style1.setBackground(1,1, new Color());
// 将段落设置成单词间距相等
style1.setLineJustify(3,1, true);
3. 滑动条相关

滚动条组成：后退箭头、后翻页、滑动块、前翻页和前进箭头。
单机前进/后退箭头时，滑动条滑动一行，点击前/后翻页区域时，滚动条滚动一页
setIncrement/setPageIncremnet设置行/页的宽度
setThumb设置滑块的大小
单独使用滚动条，使用滑动条来（Slider）替代
Slider slider = new Slider(shell, SWT.HORIZONTAL)

4. 进度条与进度指示器

进度条（ProgressBar）：ProgressBar progressbar = new ProgressBar(this, SWT.NONE)
样式：INDETERMINA不停滚动，SMOOTH进度条显示成连续的一条色块
进度指示器（ProgressIndicator）：以ProcessBar为基础写的，克服了它的一些缺陷

5. 浏览器
Browser browser = new Browser(shell, SWT.NONE);
browser.setUrl("http://www.eclipse.org")

7. SWT/JFace的事件处理

1. SWT中的高级事件
  • Button
    • Selection:Button被选中
  • Text
    • DefaultSelection:用户再Text中输入回车键时激发
    • Modify:Text内容已经被更改
    • Verify:Text内容将要被更改
  • Combo
    • DefaultSelection:用户再Combo输入回车
    • Modify:Combo内容被更改
    • Verify:Combo内容将被改变
  • ToolItem
    • Selection:用户单击工具栏按钮
  • MenuItem
    • Selection：用户单机菜单项
    • Arm：鼠标移动到菜单项上
    • Help：鼠标停在菜单项上按帮助键
  • List
    • Selection：用户单机List
    • DefaultSelection：用户双击List
  • Tree
    • Selection：用户单机Tree
    • DefaultSelection：用户双击Tree
    • Expand：展开
    • Collapse：折叠
2. 鼠标事件

MouseEvent：左键的值为1，右键为2，中键为3，0代表没有键被按下

3. 使用SWT模拟键盘/鼠标事件

先创建一个org.eclipse.swt.widgets.Event实例，然后使用Display.post()将它加到操作系统的事件队列中

//首先将焦点定位到Text，这样后续的KeyEvent才会发到Text中
display.syncExec(new Runnable(){
	public void run(){
		text.setFocus();
	}
})
Event event = new Event();
event.type = SWT.KeyDown;
event.character = "a";
display.post(event);
4. JFace事件处理

Action可以直接继承org.eclipse.jface.action.Action

public class MyAction extends Action{
	public static String ID = "MyAction";
	//在构造函数中设置各种用于显示的内容
	public MyAction(){
		super();
		setId(ID);
		setText("My Action");
		setToolTip...;
		setImageDescriptor...;
	}

	public void run(){
		//具体的用户操作
	}
}

MenuManager创建菜单：可以使用已有的action

MenuManager barMgr = new MenuManager();
barMgr.add(new MyAction);
Menu bar = barMgr.createMenuBar(shell);
shell.setMenuBar(bar);

// 第一个参数：菜单显示文字，第二个：菜单ID
MenuManager childMgr = new MenuManager("child menu", "childMgr");
childMgr.add(new MyAction());
barMgr.add(childMgr);
// 菜单已经生产，需要刷新它的内容
barMgr.update(true);

由于action具有一定的局限性，现在用commands来代替action
Eclipse的commands是一个组件的说明和声明的实施细则，从独立。一个commands可以被归类，分配给用户界面和一键绑定可以为命令定义。commands的行为可以通过定义一个处理程序。
因此，你必须要定义和使用一个commands

  • 描述该组件的声明 - 通过定义扩展点org.eclipse.ui.commands
  • Handler - 定义行为（继承org.eclipse.core.commands.AbstractHandler）
  • UI的分配 - 在哪里，怎样的commands包含在用户界面

8. Eclipse插件体系结构

1. Eclipse工作台各层次结构
  • 工作台（workbench）：定义了eclipse的UI聚合体，是不可见的，包括一个或多个Eclipse工作窗口
  • 工作台窗口(IWorkbenchWindow)：是顶层窗口，包含菜单栏、工具栏和多个工作页面
  • 工作台页面(IWorkenbenPage)：包含视图和编辑器，透视图在它的上面
  • 透视图(Perspective)：是页面的附加层，用来定义工作各部件的可视化排列方式
  • 视图(View)：ViewPart
  • 编辑器(Editor)：EditorPart
2. 常用扩展点
  • 视图：org.eclipse.ui.views
  • 编辑器：org.eclipse.ui.editors
  • 上下文菜单：org.eclipse.ui.popupMenus(DEPRECATED)
  • 菜单和工具栏：org.eclipse.ui.actionSets(DEPRECATED)
  • 为已存在view添加操作：org.eclipse.ui.viewActions(DEPRECATED)
  • 为已存在editor添加操作：org.eclipse.ui.editorActions(DEPRECATED)
  • commands：org.eclipse.ui.commands
  • handlers: org.eclipse.ui.handlers
  • 菜单：org.eclipse.ui.menus(menu,popup,toolbar)

commands方式创建menu：

  1. 添加org.eclipse.ui.commands扩展，创建一个command
  2. 添加org.eclipse.ui.handlers扩展，创建一个handler，command id指向步骤1中创建的command，并为其编写实现类
  3. 添加org.eclipse.ui.menus扩展，创建一个menuContribution
  4. 为步骤2中创建的handler指定激活状态的表达式
3. Activicator

控制插件生命周期的插件类是激活器（Activicator），如果对UI进行操作的，将扩展org.eclipse.ui.plugin.AbstractUIPlugin类；若非UI，扩展org.eclipse.core.runtime.Plugin

9. Views

所有的视图需要继承org.eclipse.ui.ViewPart
预定义视图：

  • ResourceNavigator(DEPRECATED), 现在使用CommonNavigator
  • PageBookView：包含多个页面
  • ContentOutline：大纲视图，无法被再次实例化或拥有子类，id：org.eclipse.ui.views.ContentOutline
  • PropertySheet:属性视图，无法被再次实例化或拥有子类，id：org.eclipse.ui.views.PropertySheet
  • BookmarkNavigator：书签栏，无法被再次实例化或拥有子类，id：org.eclipse.ui.views.BookmarkNavigator
  • TaskList：任务栏，无法被再次实例化或拥有子类，id：org.eclipse.ui.views.TaskList
1. 创建视图
  • 添加category，在org.eclipse.ui.views扩展点上，右键，新建category
  • 右键，新建视图：fastViewWidthRatio定义视图出现在工作台窗口时的宽度百分比（0.5f~0.95f）,allowMuntiple是否允许在工作台页面中出现多个该视图的实例
  • 创建视图，继承org.eclipse.ui.ViewPart，createPartControl(Composite)定义视图的用户界面，setFocus()也是必须实现的方法，它将焦点设定到视图中合适的控件上
2. 视图类

通常在视图中仅包含一个单一的JFace表或树，当然在视图中也可以直接使用SWT控件或多个查看器，但是作为良好的设计喜欢，应该尽可能保证视图有一个简洁的结构。

  • 对于TableViewer的排序，通过实现ViewerComparator的compare方法
  • 过滤，实现ViewerFilter的setPattern(String newPattern)方法
  • 上下文菜单：参考之前的内容
  • 获取工具栏：getViewSite().getActionBars().getToolBarManager();
  • 获取下拉菜单：getViewSite().getActionBars().getMenuManager();
  • 绑定快捷键：viewer.getControl.addKeyListener(new KeyAdapter(){public void keyReleased(KeyEvent event){…}})
3. 视图间通信

视图中共享被选中的内容，必须调用WorkbenchSite，代码如下：
getViewSite().setSelectionProvider(viewer);
org.eclipse.core.runtime.IAdaptable接口，允许一个对象将它不理解的类型对象转换成另一种可以询问和控制的类型对象。

public class AddressItem implements IAdaptable{
	....
	public Object getAdapter(Class adapter){
		return new AddressItemPropertySource(this);
	}
	return null;
}

监听其他workbench部分被选中的内容，只要在本视图中实现ISelectionListener接口，就可以监听其他Workbench部分了。

public class AddressView extends ViewPart implements ISelectionListener{
	....
	public void createPartContrl(Composite parent){
		getSite().getPage().addSelectionListener(this);
	}

  // 对于选择事件的处理
	public void selectionChanged(){

	}
}
4. 持久化排序和过滤信息
  • 在sort中添加saveState()和init()方法
  • 重写ViewPart中的init()和saveState()方法来获取和保存IMemento对象

10. Editors

编辑器必须实现org.eclipse.ui.IEditorPart接口，可以通过继承其子类org.eclipse.ui.part.EditorPart和org.eclipse.ui.part.WorkbenchPart
数据源：IEditorInput，IPathEditorInput描述了本地文件的数据格式源，IFileEditorInput描述了基本的基于文件的输入数据源
当编辑器被创建后，在init()来设定，也可通过getEditorInput()的方法来重新获取

1. 几种主要的Editors
  • AbstractTextEditor:基于文本的编辑器
  • MultiEditor:一个GUI中合并了不同的编辑器
  • MultiPageEditorPart：多页面编辑器
  • FormEditor：继承了MultiPageEditorPart用来实现基于表格的编辑器
2. FormEditor的使用
  1. 扩展org.eclipse.ui.editors
  2. editor继承FormEditor，实现addPages()
  3. 编辑器的输入，继承FormEditorInput
  4. 各个页面继承FormPage
  5. Master-Details风格的页面，可继承MasterDetailsBlock来实现
  6. FormText中支持部分html标签
  7. editor的工具栏：form.getToolBarManager()

11. 透视图(Perspectives)

透视图时UI层的概念，它实际上视图和操作的集合，一个工作台窗口可以包括多个透视图

1. 创建透视图
  • 扩展org.eclipse.ui.perspectives
  • 实现IPerspectiveFactory接口
2. IPageLayout
  • createFolder(String, int, float, String):在页面布局中创建给定ID的文件夹
  • createPlaceholderFolder(String, int, float, String):在页面布局中创建给定ID的新文件夹占位符
  • addView(String, int, float, String)：在页面布局中添加给定ID的视图
  • addPlaceholder(String, int, float, String):添加给定ID视图的占位符
  • getEditorArea():返回该页面布局中的编辑器区域的特定标识符
3. 扩展现有的透视图

使用org.eclipse.ui.perspectiveExtensions扩展点

  • id：要添加的视图的id
  • relative：基础视图的id
  • relationShip：应该如何相对于目标视图（fast，stack，left，right，top，bottom）

12. Dialog and Wizard

对话框和向导不属于Workbench的一部分，是eclipse的第三类用户界面元素
SWT的对话框类，是基于内置平台的；JFace对话框是独立于平台的

1. JFace对话框

可继承org.eclipse.jface.dialogs.Dialog,org.eclipse.jface.dialogs.TitleAreaDialog,org.eclipse.ui.dialogs.SelectionDialog

2. 向导Wizard
  • 定义向导扩展：org.eclipse.ui.newWizard(INewWizard),org.eclipse.ui.importWizard(IImportWizard),org.eclipse.ui.exportWizard(IExportWizard)
  • 向导：继承Wizard类，实现对应的接口，重写init(),performFinish(),addPages()等方法
  • 向导页面：继承WizardPage类
  • 添加向导处理逻辑
  • 点击下一步按钮，可重写setVisible()方法来，根据前一个页面的内容，将页面赋值

13. 首选项Preferences

扩展org.eclipse.ui.preferencePages,选择它给的模板，然后更改模板的类名和名称
首选项页面必须实现org.eclipse.ui.IWorkbenchPreferencePage接口，可以继承org.eclipse.jface.prefrence.PreferencePage来简化处理过程，FieldEditorPreferencePage可以进一步简化，不过在继承此类时，还需要实现IWorkbenchPreferencePage

public class AddressPreferencePage extends FieldEditorPreferencePage implements IWorkbenchPreferencePage{
	public AddressPreferencePage(){
		// 布局样式GRID或FLAT
		super(GRID);
		// 关联首选项的存储
		setPreferenceStore(Activator.getDefault().getPreferenceStore());
		setDescription("A demo of a preference page")
	}

  // 字段编辑器
	public void createFieldEditors(){
		// 添加目录字段编辑器
		addFiled(new DirectoryFieldEditor(PreferenceConstants.P_PATH, "&Directory preference:", getFieldEditorParent()));
 
		addFiled(new BooleanFiledEditor(PreferenceConstants.P_BOOLEAN, "&An example of a boolean preference", getFieldEditorParent()));
// new RadioGroupFieldEditor(PreferenceConstants.P_CHOICE

		addFiled(new StringFieldEditor(PreferenceConstants.P_STRING, "A text prefrence:", getFieldEditorParent()));
// new ComboFieldEditor(PreferenceConstants.P_VIEW_COMBO
	}
}

添加子首选项页面，需要标明category，多层需要用/分隔

14. 插件开发的高级内容

1. Eclipse帮助系统

将已有的html，pdf导入帮助系统，需要扩展org.eclipse.help.toc，在上下文中提供帮助系统，需要扩展org.eclipse.help.contexts

2. 备忘单

扩展org.eclipse.ui.cheatsheets.cheatSheetContent

3. 扩展点与扩展被读取和装载的过程
  • Eclipse平台启动时，首先读取所有插件的plugin.xml中声明的扩展点，并建立一个注册表
  • Eclipse平台读取所有的扩展声明并根据point元素的值将扩展与扩展点一一对应，同时根据扩展点的Schema检查扩展的格式。

在代码中获取这个注册表：

IExtensionRegistry registry = org.eclipse.core.runtime.Platform.getExtensionRegistry();
IExtensionPoint point = registry.getExtensionPoint("org.eclipse.ui.actionSets");
IExtension[] extensions = point.getExtensions();
IExtension extension = registry.getExtension("myActions");
4. 使用资源束（ResourceBundle）进行文本翻译
ResourceBundle bundle = ResourceBundle.getBundle("Message", Locale.getDefault());
String welcomeMsg = bundle.getString("Message_1");
5. 功能部件（feature）

一个基于插件的软件产品出于灵活性考虑，都不会只由一个插件构成，而是设计成相对独立又相互关联的多个插件组合。一个功能部件就是由一个或多个插件及它们的附加数据构成的软件产品。

15. RCP技术

1. RCP框架结构
  1. 由Equinox和Runtime组成，负责管理整个插件结构体系。其中Eclipse Runtime模块负责解析和管理插件之间的扩展点和扩展的相互关联；而Equinox则管理插件的版本，依赖关系以及动态的载入、卸载等内容。
  2. UI相关的插件，由SWT和JFace，以及基于其上的Eclipse UI框架构成。Eclipse UI框架的插件包含了透视图、编辑器、视图、首选项、向导页和操作集等扩展点。
  3. 自动升级、帮助系统等可选模块
2. OSGi框架
  • 模块层(Modules)：模块层为了每个模块提供了独立的类读取器，这意味着用户可以创建只在模块内可见的类、对象或资源，模块层还为模块之间的访问提供了完善的控制机制
  • 生命周期管理(Life Cycle)：生命周期管理层负责在运行时对组件进行管理，通过这一层提供的服务，开发者可以动态地添加、删除、升级、启动或禁用各个组件。
  • 服务注册表(Service Registry)：服务注册表帮助动态变化的组件维护相互引用的关系。在服务注册表中，每一个需要共享的Java对象都是一项服务(service)，当某一项服务可用或不可用时，服务注册表都会发出对应的事件，组件可以通过这些事件了解服务的变化并相应的作出反应。
3. RCP程序的结构

RCP插件与普通插件的区别，就在于org.eclipse.core.runtime.applications这个扩展点。
applications扩展点时Eclipse平台运行的入口。默认情况下，启动eclipse.exe时，平台会根据configuration/config.ini文件中设定的eclipse.application的属性值来巨顶要启动的入口点。
org.eclipse.core.runtime.products扩展点用于指定与工作的装饰，每一个products扩展唯一地关联着一个applications扩展，因为通过products扩展也可以找到启动入口点，如果通过products启动的applications创建了工作台，那么在products中指定的装饰就会应用到工作台窗口中。

4. 创建RCP程序

会扩展两个扩展点，生成五个java文件，Application, ApplicationActionBarAdvisor, ApplicationWorkbenchAdvisor, ApplicationWorkbenchWindowAdvisor, Perspective

5. 第三方安装程序制作软件

如InstallShield，将其制成安装程序发布到最终用户。

6. 欢迎页（Intro）

扩展org.eclipse.ui.intro和org.eclipse.ui.intro.config

Platform Command Framework
Eclipse Commands 指南(一)
Eclipse Commands 指南(二)
Eclipse 插件开发 – 深入理解菜单（Menu）功能及其扩展点
org.eclipse.ui.menus扩展点学习

Search