gdata-java-api 的 CalendarEventEntry.getTimes() 返回什么？

Question

我一直在 api 文档中查找，但无法确定该方法是否以及何时返回多个 When 实例。 代码 似乎解析重复出现的 元素，common elements部分在gd:when属性后面有一个*，表示可以有多个该类型的元素。但描述暗示只有一个事件元素。

那么在哪种情况下 CalendarEventEntry.getTimes() 返回多个 When 实例呢？似乎可以通过 addTime() 添加多个实例，但是可以通过默认的 Web 界面来完成吗？

Answer 1

答案可以在数据 API 开发人员指南：协议：部分中找到“创建重复事件”：

---

• 无查询参数：重复事件作为单个元素或对象返回，并带有重复子元素或属性。当元素或属性包含在重复事件中时，否。
• 指定 start-min 和/或 start-max：重复发生的事件表示为单个元素或对象，在指定范围内每次出现时具有多个 when 元素或对象。还包括复发。
• singleevents=true：重复事件以与单个事件相同的格式表示，每次事件发生时使用单个元素或对象。 每个事件都包含一个when元素或对象，但不包含重复语法。但是，它包含一个originalEvent元素或属性。