java导出xmind（java导出思维导图）

java导出xmind（java导出思维导图）

介绍

Xmind 对象模型是围绕许多核心接口构建的，这些接口提供了创建、操作和保存思维导图所需的几乎所有功能。这些接口定义在核心插件 中：

• – 代表一个完整的思维导图，其中可能包括多个工作表和样式信息，以及图像、附件和其他文件。

• – 表示思维导图中的单个工作表。每张纸都有一个中心主题。

• – 表示思维导图上工作表中的主题。一个主题只有一个父主题（除非它是工作表的中心主题）并且许多主题有任意数量的子主题

除了这些主要接口之外，还有几个用于特定目的的接口。其中一些是：

• – 表示任意两个主题之间的关系

• – 表示用于设置曲线的关系上的一个点

• – 一组相邻主题

• – 类似于边界，但附有主题节点

• – 附加到主题的图像

• – 附加到主题及其子主题的编号模式

• – 允许将自定义扩展添加到主题

• – 用于创建或打开工作簿文件

• – 工作簿中使用的所有样式的容器

• – 用于向各种对象添加样式信息，包括主题、工作表和关系

• – 事件监听器源

• – 触发事件监听器的机制

• – 控制用于添加附件的 xmind 文档清单

• – 包含所有标记组

• 相关标记的集合。

• – 添加到主题的小图标

• – 对标记的引用

• – 用于标记图标图像的资源

最后，还有一些需要用到的带有静态方法和字段的基类：

• – 通用事件定义，以及实例化许多接口的静态方法

• – 用于设置分离主题的坐标

• – 包含属性和值的所有样式定义

练习册

获取工作簿

第一步是为您正在处理的思维导图获取IWorkbook 。IWorkbookBuilder接口具有获取新工作簿的方法——创建一个或打开一个已经存在的工作簿。

String Workbook = “C:`*`path`*`to`*&#ind“;
String oldWorkbook = “C:`*`path`*`to`*&#ind“;
​
IWorkbookBuilder builder = WorkbookBuilder();
IWorkbook Workbook = ateWorkbook(newWorkbookPath);
IWorkbook oldWorkbook = builder.loadFromPath(oldWworkbookPath);

保存工作簿

如果你不能保存你用思维导图所做的工作，那也没什么用。IWorkbook有几种方法来实现这一点

String getFile();// 返回当前默认文件的名称
void setFile(String file);// 设置当前默认文件的名称
​
void save();// 将工作簿保存到当前默认文件
void save(String file);// 将工作簿保存到指定的文件名
void save(OutputStream output); // 将工作簿保存到指定的OutputStream
void save(IOutputTarget target);// 将工作簿保存到目标

除了工作簿之外，开发人员可能还需要了解临时存储。这是在工作簿打开时写入所有数据的地方。如果没有附件，那么开发人员将很少需要知道这些，但是在处理附件时这是至关重要的。

这里的关键方法是saveTemp()，它将所有数据写入临时存储。在将工作簿保存到临时存储之前，添加到清单的附件是不可见的，因此最好在创建新附件后调用saveTemp() 。

    void saveTemp();
​void setTempStorage(IStorage storage);IStorage getTempStorage();void setTempLocation(String tempLocation);String getTempLocation();

使用主题

创建和附加主题

访问IWorkbook后，您就可以开始添加主题了。每个IWorkbook都有一个默认工作表，每个工作表都有一个根主题。这是您开始添加其他主题的地方。

ISheet defSheet = PrimarySheet();
ITopic rootTopic = RootTopic();
rootTopic.setTitleText(“根主题”);

要创建新主题，请再次使用工作簿：

ITopic topic1 = ateTopic();
ITopic topic2 = ateTopic();
ITopic topic3 = ateTopic();

为了使用，必须将主题添加到导图中。这是通过将一个主题添加为另一个主题的子主题来完成的。有两种类型的孩子。附加子主题是其父主题的直接子主题，并且将始终与父主题保持一致直到分离。附加主题继承父主题的结构。此外，Xmind 会在绘制图表时自动放置所有附加的主题。另一方面，分离的子项被手动放置在图表上并且不会移动（除非禁用重叠，在这种情况下它们可能会被其他主题撞到）。分离主题不会从父主题继承任何内容。要控制主题是附加还是分离，请在添加子主题时设置适当的标志：

rootTopic.addChild(topic1, ITopic.ATTACHED);

主题的子项按照添加的顺序保存（并按该顺序显示）。但是，您可以通过在 addChild() 方法中指定一个（从零开始的）索引，在特定位置而不是末尾插入一个子对象。以下行将 topic2 作为思维导图中的第一个主题插入：

rootTopic.addChild(topic2, 0, ITopic.ATTACHED);

添加分离的子主题时，设置主题的位置很重要。任何没有设置位置的分离主题将默认位于图表的中心，在那里它会被中心主题向下撞。如果你添加了几个分离的主题而不指定它们的位置，那么你会在根主题下面得到一个它们的列表，这通常不是你想要的。分离的子主题也被排序，但是这个顺序只有在没有为主题指定位置时才有意义。此外，附加和分离的主题保存在单独的列表中，因此在使用索引时请注意这一点。要设置分离主题的位置，只需创建一个点具有适当 X/Y 值的对象（相对于屏幕中心（也是根主题所在的位置））。

Point detPoint = new Point(500, -400);
topic3.setPosition(detPoint);
rootTopic.addChild(topic3, ITopic.DETACHED);

主题设置

您将使用有关该主题的一些基本方法来指定有关该主题的信息。其中大部分都是简单明了的。

标题文字

标题文本是主题的关键属性；没有它，您在显示地图时通常只会看到一个空框。除了设置标题，还可以设置宽度。当显示的标题短于为其指定的宽度时，Xmind 会将标题文本换行到下一行。此外，您可以使用样式（见下文）来设置文本的对齐方式。

topic1.setTitleText(“第一个子主题”);
topic1.setTitleWidth(8);topic2.setTitleText(“第二副主题”);
topic3.setTitleText(“第三个（分离的）主题”）；

折叠主题

对于大地图，地图上的所有主题始终显示在地图上通常很不方便。有折叠（或折叠）主题的子主题的功能。折叠主题时，子主题仅显示为+图标。在 UI 中单击此按钮将再次显示子主题。这是通过setFolded(boolean folded)方法在 API 中设置的。

topic3.setFolded(true); // 隐藏子主题topic2.setFolded(false); // 显示子主题（默认）

超级链接

向主题添加超链接会在主题中放置一个图标，在 UI 中，可以单击该图标以跟随超链接。可以在主题上设置三种类型的超链接：

1. 网址

2. 话题

3. 附件（文件）

URL 是最简单的超链接类型——只需指定 URL 的字符串值

topic2.setHyperlink(“”); // 网址

主题也不难链接。但是，只能链接当前导图中的主题。主题链接的格式为xmind:#topicID – 其中 topicID 是主题的内部 ID。请注意，主题 ID 不是永久性的，每次加载地图时都会重新生成。

topic1.seHyperlink("xmind:#" + Id()); // topic

附件稍微难以管理。为了使附件起作用，文件本身必须放入 xmind 文档中。创建附件的详细信息如下，但是它们的链接设置如下

topic3.setHyperlink("xap:attachments/filename");

结构

Xmind 有几种类型的结构可用于显示地图。设置这些的方法很简单——但是需要在 API 中进行一些挖掘才能获得要使用的正确值。ITopic上的方法setStructureClass(String classname)采用一个字符串，该字符串是实现该结构的类的完整类名。``

topic2.setStructureClass(&#ind.ui.fishbone.leftHeaded");

下表列出了各种可用的结构，以及每个结构的类。始终检查您用于验证这些的版本的 API。

标签

标签显示在主题下，可以提供附加信息。一个主题可以有多个标签，每个标签单独显示一行。要设置标签，只需将Collection传递给setLabel()方法即可。

Collection labels = new ArrayList();
labels.add("label1");
labels.add("label2");
topic2.setLabels(labels);

笔记

注释在主题上显示为图标，并提供鼠标悬停图标以显示的功能，或单击它们以显示一个框并进行编辑。由于这些功能，它们比设置标签更难设置。

要创建一个新的笔记，首先要创建一个INotesContent，它有两种类型—— IPlainNotesContent和IHtmlNotesContent。对于这个讨论，我们将设置一个普通的注释内容，设置 html 内容有点复杂，但类似。一旦创建了内容对象，就会设置适当的内容。从主题中获取INotes对象。如果主题上设置了注释，则将其返回。否则，将创建一个新对象并将其附加到主题。然后将已构建的内容分配给它。

IPlainNotesContent plainContent = (IPlainNotesContent) ateNotesContent(INotes.PLAIN);
plainContent.setTextContent("这是便条");
INotes notes = Notes();
notes.setContent(INotes.PLAIN, plainContent);

编号

编号允许您像使用大纲一样使用 xmind，并自动为节点的所有后代编号。设置编号实际上有四个参数，

• 格式——描述数字格式的字符串

• prefix – 数字前附加的静态字符串

• 后缀——数字后附加的静态字符串

• prepends – 是添加到该主题编号的父主题编号

要设置编号属性，需要从主题中获取一个INumbering对象。如果不存在，则会自动为您创建。格式需要特定值来指示可用格式

INumbering num = Numbering();
num.setFormat(&#ind.numbering.arabic");
num.setPrefix("Num: ");
num.setSuffix("x");
num.setPrependsParentNumbers(true);

设置样式（或使主题看起来漂亮）

还有更多设置可用于自定义主题，包括颜色、字体、形状和结构。所有这些也都可以通过 API 获得，但由于它们不是直接在对象本身上设置的，因此访问它们需要更多的工作。

事实上，思维导图中的许多对象都有样式设置，并且所有对象的设置方式都与为主题设置的方式相同。为了更改主题的风格元素，需要一个IStyle对象。这些都保存在IWorkbook 的附加IStyleSheet中。对于一个主题，您可以在IWorkbook 的IStylesheet``中找到它当前的IStyle，如果它不存在，那么您可以创建一个并将其添加到IStyleSheet：

IStyleSheet styleSheet = StyleSheet();
IStyle style = styleSheet.StyleId());
if (style == null) {style = ateStyle(IStyle.TOPIC);styleSheet.addStyle(style, IStyleSheet.NORMAL_STYLES);
}

一旦您在IStyle上设置了属性，您就可以将它分配回主题。

topic1.Id());

但是要注意一件事——如果您在思维导图（包括查看器和编辑器）上使用听众（见下文），那么改变样式本身并不会触发听众。事实上，您可以更改现有样式的所有内容，但如果主题上的样式 id 没有更改，则不会触发任何侦听器。

有两种解决方法。一种简单的方法是清除主题上的 styleId，然后将其设置回值——但这确实会触发两次侦听器（一次清除样式，一次再次设置）。一种更好但不太明显的方法是在样式更改时手动触发侦听器：

if (topic1 instanceof ICoreEventSource) {ICoreEventSource source = (ICoreEventSource) topic1;ICoreEventSupport ces = CoreEventSupport();ces.dispatchValueChange(source, Core.Style, "", Id());
}

使用样式是存档中未包含的少数几个领域之一。它位于中。这是有道理的，因为样式更多地是关于思维导图的外观，而不是实际结构本身。

设置样式时，类是关键组件。此类没有方法，仅包含用于定义样式名称和值的静态值。一个IStyle实际上是一个名称/值对的散列图，它描述了一个对象与默认对象有何不同，如Styles所定义的那样。一旦你有一个主题的IStyle对象，那么改变风格是简单地通过设置适当的属性名称和适当的值来完成的：

style.setProperty(Styles.FillColor, “0x000000”); // 填充颜色黑色
style.setProperty(Styles.Textcolor, “0xffffff”); // 文本颜色白色

下表是Styles中定义的适当样式名称和值的列表。这并不是一个详尽的清单，而是一个快速参考。始终检查您正在使用的版本的 API。

这些值是未在 Styles 中定义的字符串

颜色是通过 RGB 配色方案指定的——这是一个 6 位十六进制数，有效地允许 1600 万种颜色，尽管使用 216 种标准网络安全颜色更为常见。

附件

文件

Xmind 以开放文档格式存储其文件，这是一个压缩文件，包含 xml 文件以及文档所需的其他文件。其中包括附件，可以是图像、文档或其他文件。使用 UI 时，只需将附件拖放到主题上，或使用菜单添加附件，就足够简单了。但是，使用 API 需要您将文件存储在文档中，然后在适当的主题中创建指向它的超链接。此外，如果这是要附加的图像，则还有其他参数可用于描述附件的位置和大小。

对于主题上不是图片的文件（即使这些文件可能是图片，也不会显示在主题中），从工作簿中获取清单，然后将文件添加到清单中，生成文件条目。然后，您可以从文件条目中获取要在主题超链接中使用的路径名。

IManifest manifest = Manifest();

有两种方法可以创建新附件——从输入流或从包含文件路径的字符串。下面两个例子是等价的。打开一个流并从中创建附件：

String directory = "C:files";
String filename = &#";
String filePath = directory + filename;FileInputStream fis = new FileInputStream(filePath);
IFileEntry entry = ateAttachmentFromStream(fis, fileName);

直接从文件路径创建附件：

String directory = "C:files";
String filename = &#";
String filePath = directory + filename;IFileEntry entry = ateAttachmentFromFilePath(filePath);

重要的是要注意附件是原始文件的副本——原始文件没有改变，对它的改变也不会反映在思维导图中。创建附件后，它会通过带有xap:协议的超链接链接到主题：

topic2.setHyperlink("xap:" + Path()); // 依恋

图片

可以通过两种方式将图像添加到思维导图中。一种是简单的附件——在这种情况下，它们被视为任何其他文件附件（见上文）。第二种是将图像嵌入主题本身，以便它显示在地图上。这需要一些额外的工作。

图像文件（.jpg、.gif、.png）必须像任何其他附件一样首先添加到文档中。然后不是向文件添加超链接，而是从主题中获取 IImage 对象（现有图像，或者如果不存在，则返回一个新对象），然后将图像文件分配给这个，以及作为其他属性。

IImage image = Image();
image.setSource("xap:" + Path());
image.setHeight(80); // 像素
image.setWidth(80); // 像素
image.setAlignment("left"); // "top", "right", "bottom", "left" 之一

标记

标记是可以添加到主题的图标。标记包含在组中，每个组只能添加一个标记到主题，但是单个主题可以包含的标记组的数量没有限制。

向主题添加标记只需将 markerId 传递到主题即可。棘手的部分是获取 markerId。API 中提供了大量标准标记，但也可以生成自定义标记。为了使用标记，需要从工作簿中获取IMarkerSheet 。该工作表包含标记组，其中包含标记。可以创建新组，并可以在组内添加新标记

IMarkerSheet markerSheet = MarkerSheet();IMarkerGroup markerGroup = markerSheet.findMarkerGroup("Flags");
List groupList = MarkerGroups();IMarker marker = Marker("flag-red");
List markerList = Markers();

使用现有标记时的一个棘手点是标记名称和标记 ID不同。一旦获得标记，就可以很简单地将它添加到主题中，或将其删除，或者查看它是否已经存在。此外，您还可以获得一个主题的所有标记

topic3.Id());Id());boolean has Marker = topic1.Id());Set markerSet = MarkerRefs();

也可以添加自定义标记。最简单的方法之一是将图标目录（只是小图像文件，而不是图标文件）导入标记表

String iconDirectory = "C:myicons";
IMarkerSheet sheet = MarkerSheet();
sheet.importFrom(iconDirectory);

另一种方法是添加单独的标记。标记是用一个 id 创建的，然后添加名称。然后从标记中获取 IMarkerResource 并将图像写入其中。

public IMarker createMarker(String markerName, String iconPath, IWorkbook workbook, IMarkerGroup group) {IMarker marker = null;IMarkerSheet ims = MarkerSheet();InputStream is = new FileInputStream(iconFile);if (is != null) {marker = Name());marker.setName(markerName);IMarkerResource resource = Resource();OutputStream os = OutputStream();ansfer(is, os, false);}group.addMarker(marker);return marker;
}

移动话题

使用 API 可以很容易地移动主题。要么给另一个父母，要么他们在父母的孩子名单中的位置。无论哪种方式，都是通过从父主题中删除主题，然后将其添加到新的父主题（可以是同一主题），设置索引值来完成的。

IBoundary boundary = ateBoundary();
boundary.setStartIndex(0);
boundary.setEndIndex(2);
topic2.addBoundary(boundary);// removing a boundary
veBoundary(boundary);// getting all the boundaries for a topic
Set boundarySet = Boundaries();

IStyleSheet styleSheet = StyleSheet();
IStyle style = styleSheet.StyleId());
if (style == null) {style = ateStyle(IStyle.BOUNDARY);styleSheet.addStyle(style, IStyleSheet.NORMAL_STYLES);
}

ISummary summary = ateSummary();
summary.setStartIndex(0);
summary.setEndIndex(2);
topic2.addSummary(summary);// removing a summary
veSummary(summary);// getting all the summaries for a topic
Set summarySet = Summaries();ITopic sumTopic = Topic();

IStyleSheet styleSheet = StyleSheet();
IStyle style = styleSheet.StyleId());
if (style == null) {style = ateStyle(IStyle.SUMMARY);styleSheet.addStyle(style, IStyleSheet.NORMAL_STYLES);
}

private static final String EXTENSION = "sample";public void setStringExtension(ITopic topic, String selectionString) {ITopicExtension extension = Extension(EXTENSION);if(extension == null) {extension = ateExtension(EXTENSION);}ITopicExtensionElement content = Content();if (content != null) {content.setTextContent(selectionString);}
}public String getStringExtension(ITopic topic) {String selection = null;ITopicExtension extension = Extension(EXTENSION);if(extension != null) {ITopicExtensionElement content = Content();if (content != null) {selection = TextContent();}}return selection;
}public void removeStringExtension(ITopid topic) {topic.deleteExtension(EXTENSION);
}

boolean hasChildren = topic1.hasChildren(ITopic.ATTACHED); // 或 ITopic.DETACHED 或 ITopic.SUMMARYList allChildren = AllChildren();
List attachedChildren = Children(ITopic.ATTACHED); // 类型是 ITopic.ATTACHED 或 ITopic.DETACHED 或 ITopic.SUMMARY

ISheet primarySheet = PrimarySheet(); // 获取主表List sheetList = Sheets(); // 获取所有表单ISheet sheet = ateSheet(); // 创建一个新工作表workbook.addSheet(sheet); // 将工作表添加到列表的末尾ISheet sheet2 = ateSheet();
workbook.addSheet(sheet, 0); // 添加工作表作为列表中的第一个工作表vesheet(2, 0); // 将位置 2 的工作表移动到列表的前面

IStyleSheet styleSheet = StyleSheet();
IStyle style = styleSheet.StyleId());
if (style == null) {style = ateStyle(IStyle.SHEET);styleSheet.addStyle(style, IStyleSheet.NORMAL_STYLES);
}

String backgroundFilePath = "C:filesbackground.jpg";
IManifest manifest = Manifest();IFileEntry entry = ateAttachmentFromFilePath(backgroundFilePath);
style.setProperty(STYLE.background, "xap:" + Path());

IRelationship relation = ateRelationship();
relation.Id());
relation.Id());
relation.setTitleText("Relationship Description");
sheet.addRelationship(relation);

IStyleSheet styleSheet = StyleSheet();
IStyle style = styleSheet.StyleId());
if (style == null) {style = ateStyle(IStyle.RELATIONSHIP);styleSheet.addStyle(style, IStyleSheet.NORMAL_STYLES);
}

Point cPoint0 = new Point(500, -400);
IControlPoint cp0 = ControlPoint(0);
cp0.setPoistion(cPoint0);Point cPoint1 = new Point(200, -100);
IControlPoint cp1 = ControlPoint(1);
cp1.setPosition(cPoint1);

ICoreEventSupport ces - (ICoreEventSupport) Adapter(ICoreEventSupport.class);

class MyCoreEventListener implements ICoreEventListener {public void handleCoreEvent(CoreEvent event) {// do something}
}

  MyCoreEventListener mcel = new MyCoreEventListener();isterGlobalListener(Core.TopicAdd, mcel); // 监听主题添加事件

public void handleCoreEvent(CoreEvent event) {String type = Type();ICoreEventSource ces = EventSource();int index = Index();Object oldValue = OldValue();Object newValue = NewValue();Object data = Data();Object object = Target();