协同合作和编辑不仅仅是发生在页面中，很多时候你需要与你的项目小组针对文档，报告，图片，表格进行协同操作。不管是针对性的市场计划或者一个完整的项目计划，你可以在 Confluence 中让你的项目小组成员针对你的文档提供反馈，并让你们能够协同进行工作。 分享一个文件 在一个页面中你可能有很多文件，但是你只希望你的项目小组成员只针对其中的一个文件提供反馈。你可以简单的对需要反馈的文件分享到你的项目小组中。 与分享页面的方法相同： 单击缩略图或者链接来对文件进行预览。 选择 分享（Share）按钮。 输入一个邮件地址，用户名或者用户组名，然后添加你的消息后单击发送。 你的项目组成员将会获得你的邮件和你的消息，以及分享文件的链接来查看分享的文件。 分享的通知只会通过邮件进行发送，这个通知不会显示在 工作盒（workbox）  中。 https://www.cwiki.us/display/CONF6ZH/Share+and+Comment+on+Files

有下面 2 种方法可以让你查看空间的所有附件。你可以： 使用 Space Attachments Macro 来在一个页面中显示列表文件。 进入空间后，然后从边栏的底部选择 空间工具（Space tools）> 内容工具（Content Tools）。 然后选择 附件（Attachments）。 你可以对显示的文件进行过滤，仅仅显示具有特定标签或者扩展名的文件。 屏幕截图：空间附件宏 https://www.cwiki.us/display/CONF6ZH/Manage+Files

你需要具有空间的 添加附件（Add Attachment）权限来编辑文件的属性。 希望编辑一个附加文件的属性： Go to  > Attachments 单击你希望编辑附件边上的 属性（Properties）。 你可以： 修改文件名 修改备注（在文件版本列表中进行使用，同时也会在文件缩略图中使用） 修改 MIME 类型 移动附件到其他页面 添加标签（Label） 修改文件 MIME 类型可能会导致文件显示错误。 https://www.cwiki.us/display/CONF6ZH/Manage+Files

你需要同时具有 添加页面（Add Page），添加附件（Add Attachment）和删除附件（Remove Attachment）空间权限来移动一个附件文件到其他页面。 希望修改附件附加的页面到其他页面： Go to  > Attachments 选择你希望移动附件边上的 属性（Properties）。 输入你希望附件文件移动到新的页面的名字（例如 My Destination Page）。 选择 保存（Save）。 如果你希望移动文件到其他空间的页面中，在页面名字的前面添加空间的标识（Space Key），例如可以采用下面的个格式  DOC:My Destination Page。 https://www.cwiki.us/display/CONF6ZH/Manage+Files

有下面 2 种方法来上传一个附加文件的新版本，你可以： 上传与已有附件具有相同文件名的版本。 使用 上传一个新版本（Upload a new version）   按钮来进行上传（这个在文件预览界面中才能进行上传）不同文件名的附件，这个操作只针对图片和 PDF 文件。 希望查看附件的版本： Go to  > Attachments 单击附件名字边上的扩展箭头。 所有文件的早期版本都会显示出来。 你不能还原一个文件的早期版本，如果你具有空间管理员权限的话，你可以选择删除一个早期的版本。   https://www.cwiki.us/display/CONF6ZH/Manage+Files

你需要具有 删除附件（Delete Attachment）的空间权限来删除一个附加的文件。 希望删除一个附加文件的所有版本： 进入含有附件的页面中。 Go to  > Attachments 选择你希望删除文件的后面的 删除（Delete）按钮。 选择 删除（Delete）来确定你的操作。 删除的文件可以从垃圾箱中进行恢复，你需要具有空间管理员的权限才能进行这个操作。 空间管理员可以删除一个附件的特定版本： Go to  > Attachments 单击附件名边上的扩展箭头来查看附件的所有版本。 针对需要删除的版本，选择 删除（Delete）来进行删除。 删除文件的版本是不能从垃圾箱中进行恢复的。 屏幕截图：附件和附件的版本 https://www.cwiki.us/display/CONF6ZH/Manage+Files

文件是被附加到 Confluence 的页面上的。请参考 Upload Files 页面中的内容来了解如何附加文件到页面中。 一旦文件被附加到页面上了，你可以下载，删除和编辑这些文件。例如，你可以根据需要上传一个文件的新版本，或者修改附加的页面为别的页面。 下载附加文件 任何具有查看页面权限的用户同时也可以下载页面中附加的任何文件。 希望下载一个单独的文件： 在文件预览中，单击 下载（Download） Go to  > Attachments 然后在文件名上单击右键线程保存链接。 希望将页面中附加的所有文件下载成 zip 文件： Go to  > Attachments 单击 下载全部（Download All）。 Confluence 没有提供下载一个空间中所有附件的功能。   https://www.cwiki.us/display/CONF6ZH/Manage+Files

我们在使用 MessagePack 对 List 对象数据进行序列化的时候，发现序列化以后的二进制数组数据偏大的情况。 请注意，不是所有的 List 对象都会出现这种情况，这个根据你 List 对象中存储的内容有关。 有关本问题的测试源代码请参考：https://github.com/cwiki-us-demo/serialize-deserialize-demo-java/blob/master/src/test/java/com/insight/demo/serialize/MessagePackDataTest.java 中的内容。 考察下面的代码： List<MessageData> dataList = MockDataUtils.getMessageDataList(600000); ObjectMapper objectMapper = new ObjectMapper(new MessagePackFactory()); raw = objectMapper.writeValueAsBytes(dataList); FileUtils.byteCountToDisplaySize(raw.length); logger.debug("Raw Size: [{}]", FileUtils.byteCountToDisplaySize(raw.length)); 我们会发现，针对这个 60 万个对象的 List 的序列化后的数据达到了 33MB。 如果我们再定义  ObjectMapper 对象的时候添加一部分参数，我们会发现大小将会有显著改善。 请参考下面的代码： List<MessageData> dataList = MockDataUtils.getMessageDataList(600000); ObjectMapper objectMapper = new ObjectMapper(new MessagePackFactory()); objectMapper.configure(JsonParser.Feature.ALLOW_SINGLE_QUOTES, true); objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL); objectMapper.setAnnotationIntrospector(new JsonArrayFormat()); rawJsonArray = objectMapper.writeValueAsBytes(dataList); logger.debug("rawJsonArray Size: [{}]", FileUtils.byteCountToDisplaySize(rawJsonArray.length)); 如果你运行上面的代码，你会看到程序的输出字符串将会降低到 23MB。 这里面主要是 objectMapper.setAnnotationIntrospector(new JsonArrayFormat()); 这句话起了作用。 在正常的场景中，我们可以通过 注解 JsonIgnore, 将其加到属性上，即解析时即会过滤到属性。 而实际实现，则是由类 JacksonAnnotationIntrospector 中 的 hasIgnoreMarker 来完成，则就是通过读取注解来判断属性是否应该被exclude掉。ObjectMapper中默认的 AnnotationIntrospector 即是 JacksonAnnotationIntrospector 来完成，但我们可以通过 方法 ObjectMapper.setAnnotationIntrospector 来重新指定自定义的实现。   https://www.cwiki.us/display/Serialization/MessagePack+Jackson+Data+Size

当你希望在 Map 中不使用 String 为 Key，那么你需要使用 MessagePackKeySerializer 来为 key 进行序列化。 本测试方法，可以在 https://github.com/cwiki-us-demo/serialize-deserialize-demo-java/blob/master/src/test/java/com/insight/demo/serialize/MessagePackSerializer.java 中找到。 /** * testMessagePackSerializationMapKey */ @Test @JsonSerialize(keyUsing = MessagePackKeySerializer.class) public void testMessagePackSerializationMapKey() { logger.debug("testMessagePackSerializationNotCloseInputStream"); byte[] bytes = new byte[0]; Integer uuid_a = 101; Integer uuid_b = 102; // Instantiate ObjectMapper for MessagePack ObjectMapper objectMapper = new ObjectMapper(new MessagePackFactory()); Map<Integer, MessageData> map = new HashMap<>(); MessageData messageData = new MessageData(); // Element A in MAP messageData.setUuid(UUID.randomUUID().toString()); messageData.setName("CWIKI.US - A"); map.put(uuid_a, messageData); // Element B in MAP messageData = new MessageData(); messageData.setUuid(UUID.randomUUID().toString()); messageData.setName("CWIKI.US - B"); map.put(uuid_b, messageData); try { // Serialize a Java object to byte array bytes = objectMapper.writeValueAsBytes(map); logger.debug("Length of Bytes: [{}]", bytes.length); // Deserialize the byte array to a MAP Map<String, MessageData> deserialized = objectMapper.readValue(bytes, new TypeReference<Map<Integer, MessageData>>() { }); logger.debug("Deserialized MAP Count: [{}]", deserialized.size()); logger.debug("MAP index 0: [{}]", deserialized.get(uuid_a).getName()); assertEquals("CWIKI.US - A", deserialized.get(uuid_a).getName()); } catch (JsonProcessingException ex) { logger.error("Serialize Error", ex); } catch (IOException e) { e.printStackTrace(); } }   https://www.cwiki.us/display/Serialization/MessagePack+Jackson+Dataformat

老的 msgpack-java（例如 0.6.7）并不支持 MessagePack str8 数据类型。 当你的希望的你的应用程序需要支持老的版本的话，你需要禁用这个数据类型，例如使用下面的语句： MessagePack.PackerConfig config = new MessagePack.PackerConfig().withStr8FormatSupport(false); ObjectMapper mapperWithConfig = new ObjectMapper(new MessagePackFactory(config)); // This string is serialized as bin8 type byte[] resultWithoutStr8Format = mapperWithConfig.writeValueAsBytes(str8LengthString); https://www.cwiki.us/display/Serialization/MessagePack+Jackson+Dataformat