GMF常见问题
1、问题：连接线旁边没有文字标签和箭头
文字标签：在gmfmap里的Connection Mappping下增加Label Mapping元素；箭头：在gmfgraph里为Polyline Connection指定一个Polyline Decorator作为source/target decoration，要为这个Decorator创建一些Template Point来决定箭头的形状，例如指定(-1,-1), (0,0), (-1,1)。
2、让一个图形可以在另一个图形里随意改变位置
在gmfgen里把作为容器的那个图形的Gen Compartment里把Listlayout属性改为false。
3、隐藏图形标签文字前的小图标
在gmfgen里把相应的Gen Node Label元素的Element Icon属性改为false（但重新生成gmfgen时这个属性会被覆盖）
4、让标签里同时显示和编辑多个属性
在gmfmap里把相应的Label Mapping元素的View Pattern属性改为类似“属性1：{0},属性2：{1}”的形式。
5、问题：跨Compartment进行连线操作时会创建两条连线
GMF的bug，见https://bugs.eclipse.org/bugs/show_bug.cgi?id=148021，在你的XXXDiagramCanonicalEditPolicy里覆盖方法：
protected boolean shouldHandleNotificationEvent(Notification event) {
return false;
}
6、让Label出现在图元外面
在gmfgraph里定义这个Figure时把Label定义在外面，而非定义为Figure的子元素。
7、在gmfgraph里设置一个Figure使用GridLayout后生成的代码无法正确编译
GMF的bug，见https://bugs.eclipse.org/bugs/show_bug.cgi?id=133279
8、改变Figure的缺省大小
在gmfgraph里为Figure增加Preferred Size子元素；若想让图形尺寸小于40x40象素，要覆盖XXXEditPart里的createNodePlate()方法。在GMF2.0里，使用DefaultSizeFacet，见http://dev.eclipse.org/newslists/news.eclipse.modeling.gmf/msg01546.html
9、禁止用户修改图元的尺寸
在gmfgraph里将此Node的Resize Constraint属性值改为“NONE”(但size-on-drop功能仍存在，也就是用户仍然可以在创建时指定尺寸)。
10、让Compartment在容纳不下子图形时自动显示滚动箭头
在genmodel的GenDiagram元素里改Units属性为“himetric”(经测试对GMF1.0不起作用)，见https://bugs.eclipse.org/bugs/show_bug.cgi?id=140789
11、为画布Canvas指定Layout
GMF1.0不支持，需要手工改代码，见https://bugs.eclipse.org/bugs/show_bug.cgi?id=139951
12、Border Item
Border Item是指只能紧贴其他图元运动的图形，GMF1.0可通过打patch实现这个功能，见https://bugs.eclipse.org/bugs/show_bug.cgi?id=124826；GMF2.0开始支持。
13、规定连接线的约束，例如规定source和target不能是同一对象
在gmfmap里定义，在Link Mapping元素下定义Link Constraint元素，缺省使用OCL，见教程http://wiki.eclipse.org/index.php/GMF_Tutorial_Part_2#Link_Constraints;不论使用OCL或是Java，在XXXBaseItemSemanticEditPolicy里会生成LinkConstraint类，在生成command前检查是否满足这些constraint。
14、Audit
定义的constraint出现在com.your.diagram项目的plugin.xml里，作为constraintProvider扩展；为了让这些constraint生效，要在gmfgen的Gen Diagram元素里设定Validate Enabled/Decorator属性值为true，并将优先级(Validation Provider Priority, Validation Decorator Provider Priority)设定为medium（非lowest）才会在Diagram菜单里出现Validate命令。
若是在gmfmap里选择使用Java验证，则在gmfmap里指定的是一个Java方法名，生成代码后，应在XXXValidationProvider类里应实现这个方法。
15、GMF里从EditPart得到Semantic Model
因为GMF里EditPart#getModel()方法得到的是Notation Model里的对象，如Node或Edge，所以可以使用这样的方法得到真正的业务对象：((org.eclipse.gmf.runtime.notation.View) EditPart.getModel()).getElement()或ViewUtil.resolveSemanticElement(view)
16、问题：从gmfgen生成代码时产生java.lang.ClassCastException: org.eclipse.jdt.internal.core.jdom.DOMMethod
删除原先生成的代码中无法编译的类,重新生成。
17、在gmfgraph里定义Polyline的图形
在Rectangle上画Polyline,注意是固定大小的
18、问题：每次重新生成代码后，在plugin.xml里的修改会丢失
GMF1.0里生成代码时不能保留plugin.xml里的任何修改，从GMF2.0开始用户可以在plugin.xml里标记不要覆盖的区域
19、问题：Outline树视图里的节点没有图标
在plugin.xml里找到org.eclipse.gmf.runtime.emf.type.core.elementTypes扩展点，在下面相应的元素里指定icon属性，见http://dev.eclipse.org/newslists/news.eclipse.modeling.gmf/msg00341.html，但我在GMF1.0里测试不起作用，何况每次生成代码时这个文件都会被覆盖。
20、问题：提示java.lang.IllegalStateException: Cannot modify resource set without a write transaction异常
在GMF里修改Model要通过在TransactionalEditingDomain里执行命令完成，GMF提供的RecordingCommand是不错的选择，它为我们提供了Undo支持，我们只要实现执行部分的代码就可以了，下面是一个例子：
TransactionalEditingDomain domain = TransactionUtil.getEditingDomain(myElement);
domain.getCommandStack().execute(new RecordingCommand(domain) {
@Override
protected void doExecute() {
//Do anything
}
});
若是在EditPolicy里需要返回一个Command，用下面的代码：
AbstractTransactionalCommand command = new AbstractTransactionalCommand(TransactionUtil
.getEditingDomain(myElement), "Command Name", Collections.EMPTY_LIST) {
@Override
protected CommandResult doExecuteWithResult(IProgressMonitor monitor, IAdaptable info)
throws ExecutionException {
//Any modification to the model
return CommandResult.newOKCommandResult();
}
};
21、问题：创建图元时提示异常“java.lang.IllegalArgumentException: Figure must be a child”
Workaround：注释掉产生异常的setRatio()方法里的全部内容。
22、问题：在AbstractBorderItemEditPart子类的getPrimaryDragEditPolicy()方法里提示ClassCastException异常
在gmfgraph里检查作为BorderItem的那个Node的Resize Constraint属性是否改过，若为缺省的NSEW则对应的editpart不会生成这个方法，对BorderItem（即Affixed Node Side属性不为NONE的Node）来说这个属性虽然设置为NSEW也无法改变大小。相关链接：https://bugs.eclipse.org/bugs/show_bug.cgi?id=155698
23、如何禁用PopupBar和ConnectionHandler功能（鼠标停止在图形上时出现的连线符号）
在需要禁用该功能的EditPart的createDefaultEditPolicies()方法的最后加下面的语句：
//禁用PopupBar removeEditPolicy(EditPolicyRoles.POPUPBAR_ROLE); //禁用ConnectionHandler removeEditPolicy(EditPolicyRoles.CONNECTION_HANDLES_ROLE);
24、使用ConnectionHandler连接到canvas上已存在的图形或创建新的图形
覆盖XXXModelingAssistantProvider里的几个get方法，要连接到已存在的图形覆盖getRelTypesOnSourceAndTarget()方法，创建新的作为源的图形覆盖getRelTypesOnSource()和getTypesForTarget()方法，创建新的作为目标的图形应覆盖getRelTypesOnTarget()和getTypesForSource()方法。具体代码可参考LogicModelingAssistantProvider里的实现。
25、给画布加背景图
http://www.cnblogs.com/bjzhanghao/archive/2007/03/13/673273.html
BTW, 以上所有问题只针对GMF1.0，GMF2.0的gmfmap模型和gmfgen模型与前一版本有所不同，一些问题可能也在GMF2.0里不存在了。
26、使用Label作为一个editpart的figure
在.gmfgraph里不用创建Node，只用Diagram Label即可；在.gmfmap里，Node Mapping的Diagram Node属性指定为这个Diagram Label，下面的Feature Label Mapping的Diagram Label属性也是这个Diagram Label。在parent使用ListLayout的时候这个方法比较有用。GMF的mindmap例子里的ThreadItem就是这样一个例子。
27、若类A包含B和C，且C继承B，则试图让A的图形同时包含B和C会造成运行时异常，异常信息是无法创建C的View，可能是GMF目前版本的bug。解决办法是建立抽象类D，让B和C都继承D，并且让A包含D。（update 2007/7/23: 有一点像这个bug，异常信息差不多）
update(2008/10/09): 今天再次遇到了这个问题，复制异常信息如下以便查找：
org.eclipse.core.commands.ExecutionException: While executing the operation, an exception occurred
at org.eclipse.core.commands.operations.DefaultOperationHistory.execute(DefaultOperationHistory.java:519)
...
Caused by: org.eclipse.core.runtime.AssertionFailedException: null argument:failed to create a view
at org.eclipse.core.runtime.Assert.isNotNull(Assert.java:86)
at org.eclipse.gmf.runtime.diagram.ui.commands.CreateCommand.doExecuteWithResult(CreateCommand.java:99)
28、用渐变色填充非矩形图形
覆盖图形的fillShape()方法，利用swt的Path，但draw2d的graphics对它的支持似乎不好。http://dev.eclipse.org/newslists/news.eclipse.tools.gef/msg13928.html
29、（这条实际是关于EMF的，anyway）为TableViewer增加Drag and Drop支持
非常简单，见下面的代码（tv是TreeViewer的一个实例）
int dndOperations = DND.DROP_COPY | DND.DROP_MOVE | DND.DROP_LINK;
Transfer[] transfers = new Transfer[] { LocalTransfer.getInstance() };
tv.addDragSupport(dndOperations, transfers, new ViewerDragAdapter(tv));
tv.addDropSupport(dndOperations, transfers, new EditingDomainViewerDropAdapter(editingDomain, tv));
30、从EObject得到TransactionalEditingDomain
TransactionalEditingDomain editingDomain = TransactionUtil.getEditingDomain(eobject);
31、让Label换行
.gmfgraph里无法指定Label是否换行，要修改生成的代码：
fFigureXXXFigure = new WrapLabel();
fFigureXXXFigure.setTextWrap(true);//add this line
fFigureXXXFigure.setText("<>");
另外可以在.gmfgraph里指定需要的布局以便让换行Label更好的显示。给Label设置Margin Border会有问题（Label被推向右侧），可以给Parent图形设置Margin Border，或建一个RectangleFigure来实现设置文字边距的需求。
32、定制Project Exploerer里显示的内容
修改.gmfgen里Gen Navigator节点下面的元素，见http://wiki.eclipse.org/index.php/GMF_Tutorial_Part_4#Project_Navigator
33、可缩放的多边形
在.gmfgraph里定义为Scalable Polygon，和普通Polygon一样要定义template points，每个点的坐标绝对值不是关键，但它们之间的位置关系要保证。我发现绝对值定义得大一些时，得到的结果会更精确。下面是一个可缩放菱形的定义：
<descriptors name="ConditionFigure">
<actualFigure xsi:type="gmfgraph:ScalablePolygon" name="MyDiamondFigure">
<template x="200" y="0"/>
<template x="0" y="200"/>
<template x="200" y="400"/>
<template x="400" y="200"/>
<template x="200" y="0"/>
</actualFigure>
</descriptors>
34、生成的RCP应用里，保存操作后经常提示“the file has been modifying on the file system...”信息。
GMF太“聪明”了，每次save后都要记录文件修改的timestamp，一旦发现不符则认为有其他程序修改了这个文件。要让RCP应用不检查当前编辑的文件是否被其他程序修改，可覆盖XXXDocumentProvider的isSynchronized()方法，让它直接“return super.isSynchronized(element);”。（但要小心，这有可能造成用户的修改无法被保存的情况。）
35、生成的GMF应用程序里，打印功能是禁用状态。
打开.gmfgen文件，修改Gen Plugin的"Printing Enabled"属性为true，再重新生成代码。这样除了 Print变为可用外，GMF还会生成一个XXXContributionItemProvider类在主菜单上添加Print Preview选项。http://dev.eclipse.org/newslists/news.eclipse.modeling.gmf/msg02207.html
36、（实际是Eclipse OCL问题）脱离Eclipse环境使用OCL时，报异常java.lang.NoClassDefFoundError: lpg/lpgjavaruntime/RuleAction
Eclipse OCL依赖lpg库（LALR parser generator，使用EPL协议），在RCP里使用OCL需要把net.sourceforge.lpg.lpgjavaruntime这个插件加在dependencies列表里。参考链接
37、（还是OCL问题）Eclipse OCL实现里，OCL语句里各集合类型与ecore里集合类型的映射：
| Collection Type | isUnique | isOrdered |
| Bag | N | N |
| Sequence | N | Y |
| Set | Y | N |
| OrderedSet | Y | Y |
所以，如果一个EList在ecore里定义为Unique且Ordered（即缺省定义）时，在OCL里应该用OrderedSet类型，例如：XXX->allInstances()->asOrderedSet()或OrderedSet{object1, object2}，等等。
38、在画布上创建一个元素（包括连接）后根据当前模型状态自动设置某属性值：
（GMF允许通过多种语言如ocl、regexp和java来实现初始值的设置，这里以java为例）在xxx.gmfmap文件里，找到这个元素对应的Mapping节点（如Node Mapping或Link Mapping），点右键新建一个Feature Seq Initializer元素，在这个元素上点右键再新建一个Feature Value Spec元素，设置后者的Feature为想要设置的类型，语言选java，在Body属性里输入一个方法名，例如“initialMyFeature”。重新生成.gmfgen和代码，GMF会在名为ElementInitializers.java的文件里生成initialMyFeature()这个空壳方法，实现它即可。
39、新建向导结束后，生成一个非空的模型文件。（Customize新创建的模型文件）
修改XXXDiagramEditorUtil#createInitialModel()方法。
40、在partition diagram里，从shortcut到一个正常节点间的连线在关闭editor后再次打开时丢失(2008.1.4)
原因不明，暂时的解决方法是注释掉XXXCanonicalEditPolicy#refreshConnections()方法里的deleteViews(existingLinks.iterator())，其中XXX代表link元素的父元素，例如Diagram。（这个解决方法有严重问题，会造成Initialize Diagram时丢失全部连接）。新探索出来的解决方法如下，覆盖XXXCanonicalEditPolicy#sholdDeleteView()方法：
/**
* @generated NOT
*/
protected boolean shouldDeleteView(View view) {
if(view instanceof Edge){
Edge edge = (Edge)view;
View sourceView = edge.getSource();
View targetView = edge.getTarget();
if(sourceView.getEAnnotation("Shortcut")!=null
|| targetView.getEAnnotation("Shortcut")!=null){
return false;
}
}
return true;
}
41、删除右键菜单里不需要的菜单项
在plugin.xml里声明contributionItemProviders扩展点，在popupContribution下指定如下元素：
<popupPredefinedItem id="autoSizeAction"remove="true"/>
一些GMF Runtime定义的ID：deleteFromModelAction, navigateGroup, fileMenu, toolbarArrangeAllAction, addGeoShapesGroup, addGeoShapes2Group
详见org.eclipse.gmf.runtime.diagram.ui.actions.ActionIds
42、在单独的编辑窗口里编辑子图（Diagram Partitioning）
http://wiki.eclipse.org/Diagram_Partitioning
43、在单独的项目（非GMF生成的xxx.diagram项目）里扩展DiagramEditor能识别的adapter类型：
在单独项目的Activator的start()方法里用类似下面的代码，这样就不需要直接修改生成的XXXDiagramEditor#getAdapter()方法了（因为我们希望把定制的内容尽量放在生成的项目以外）：
//Register adapters for ERM reports and charts
Platform.getAdapterManager().registerAdapters(new IAdapterFactory() {
/**
* @see org.eclipse.core.runtime.IAdapterFactory
*/
public Object getAdapter(Object adaptableObject, Class adapterType) {
ErmDiagramEditor editor = (ErmDiagramEditor) adaptableObject;
Process process = (Process) editor.getDiagram().getElement();
if (adapterType == IRiskImportancePage.class) {
return new RiskImportancePage(process);
} else if (adapterType == IRiskDrillDownPage.class) {
return new RiskDrillDownPage(process);
}
return null;
}
/**
* @see org.eclipse.core.runtime.IAdapterFactory
*/
public Class[] getAdapterList() {
return new Class[] { IRiskImportancePage.class, IRiskDrillDownPage.class };
}
}, ErmDiagramEditor.class);
44. 允许创建shortcut
在.gmfgen的Gen Diagram元素的属性“Shortcuts Provided”和"Contains Shortcuts To"里设置相应的model名字，然后重新生成代码，这样画布的右键菜单里将出现“Create Shortcut...”菜单项。参考http://wiki.eclipse.org/GMF_Tutorial_Part_2#Shortcuts
45. 提示“Cannot activate read/write transaction in read-only transaction context”
在editpolicy的getXXXCommand()里不能直接对模型进行操作，否则将提示上面的异常，应该返回一个ICommandProxy(yourCommand) ，其中yourCommand一般继承自AbstractTransactionalCommand。参考http://dev.eclipse.org/mhonarc/newsLists/news.eclipse.modeling.gmf/msg04366.html
46. （实际是OCL问题）在ocl语句里增加预定义的变量，当变量是集合类型时，如何setType：
OCL<?, EClassifier, ?, ?, ?, ?, ?, ?, ?, Constraint, EClass, EObject> ocl;
ocl = OCL.newInstance(EcoreEnvironmentFactory.INSTANCE);
//Customize this OCL environment
Variable appContextVar = ExpressionsFactory.eINSTANCE.createVariable();
appContextVar.setName("customers");
EClassifier type = TypeUtil.resolveSequenceType(ocl.getEnvironment(), EcorePackage.Literals.ORDERED_SET_TYPE);
appContextVar.setType(type);
ocl.getEnvironment().addElement(appContextVar.getName(), appContextVar, true);
try {
OCLHelper<EClassifier, ?, ?, Constraint> helper = ocl.createOCLHelper();
helper.setContext(SpmsPackage.Literals.SP_SERVICE_PLAN);
OCLExpression<EClassifier> exp = helper.createQuery(metric.getFormula());//Seems this call is time costly
Query<EClassifier, EClass, EObject> query = ocl.createQuery(exp);
query.getEvaluationEnvironment().add(appContextVar.getName(),
SpmsResourceManager.getInstance().getCustomerModel().getCustomers());
Object object = query.evaluate(servicePlan);
System.out.println(object);
if (object instanceof Number) {
result = ((Number) object).doubleValue();
}
} catch (ParserException e) {
e.printStackTrace();
}
ocl.dispose();
47、创建一个新的Diagram实例
GMF生成代码时同时生成了工具类XXXDiagramEditorUtil，调用XXXDiagramEditorUtil.createDiagram()即可创建新的Diagram实例。
