使用沙丁鱼报表方法查询CalDAV服务器上的事件

Question

我正在尝试使用CalDAV (和双周)从沙丁鱼服务器获取事件。获取一个完整的日历对我是有用的：

Sardine sardine = SardineFactory.begin();
InputStream is = sardine.get(CALDAV_URL_STRING);
ICalendar iCalendar = Biweekly.parse(is).first();

现在我想获取特定时间范围的事件。基于这篇"构建CalDAV客户端“文章，我想您应该使用沙丁鱼report方法来做到这一点，对吗？

如果是这样的话，你应该如何使用这种方法？它没有在wiki中被记录下来，Javadoc也不是很清楚。

我应该写我自己的SardineReport吗？我看起来应该以这样的方式结束：

Sardine sardine = SardineFactory.begin();
SardineReport<List<VEvent>> report = new MyRangeReport(FROM_DATE, END_DATE);
List<VEvent> result = sardine.report(CALDAV_URL_STRING, 1, report);

我在正确的轨道上吗？有没有人知道如何写你自己的沙丁鱼报告？

Answer 1

您是正确的，要运行时间范围查询，您需要发出包含一个REPORT的HTTP calendar-query请求。您可以在RFC 4719 7.8.1节中找到一个示例。我不知道沙丁鱼，但是的，report听起来是对的;-)

进一步简化如下：

 REPORT /bernard/work/ HTTP/1.1
 Host: cal.example.com
 Depth: 1
 Content-Type: application/xml; charset="utf-8"
 Content-Length: xxxx

 <?xml version="1.0" encoding="utf-8" ?>
 <calendar-query xmlns:D="DAV:" xmlns="urn:ietf:params:xml:ns:caldav">
   <D:prop>
     <D:getetag/>
     <calendar-data />
   </D:prop>
   <filter>
     <comp-filter name="VCALENDAR">
       <comp-filter name="VEVENT">
         <time-range start="20060104T000000Z" end="20060105T000000Z"/>
       </comp-filter>
     </comp-filter>
  </filter>
</calendar-query>

我应该写我自己的SardineReport吗？

看起来，扫描沙丁鱼的GitHub，它似乎不包括CalDAV查询。你也许可以把你的SyncCollectionReport.java建立在他们的基础上。

注意，对calendar-query REPORT的响应只是一个常规的WebDAV 207 multi-status响应。没有额外的要求。( Result对象在它们的SyncCollectionReport中将是相同的，但是w/o是额外的syncToken)。

Answer 2

我已经实现了一个报告类，但是激进主义返回的结果似乎是不正确的。看起来激进分子不支持time-range过滤器。

值得注意的是，下面是报告的相关部分：

public class VEventsTimeRangeSardineReport extends SardineReport<List<VEvent>>
{

    ...

    @Override
    public String toXml() throws IOException
    {
        // Hardcode for now
        String xml = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n" +
                     "<c:calendar-query xmlns:d=\"DAV:\" xmlns:c=\"urn:ietf:params:xml:ns:caldav\">\n" +
                     "  <d:prop>\n" +
                     "    <c:calendar-data/>\n" +
                     "    <d:getetag/>\n" +
                     "  </d:prop>\n" +
                     "  <c:filter>\n" +
                     "    <c:comp-filter name=\"VCALENDAR\">\n" +
                     "      <c:comp-filter name=\"VEVENT\">\n" +
                     "        <c:time-range start=\"%s\" end=\"%s\"/>\n" +
                     "      </c:comp-filter>\n" +
                     "    </c:comp-filter>\n" +
                     "  </c:filter>\n" +
                     "</c:calendar-query>";
        return String.format(xml, SDF.format(fromDate), SDF.format(toDate));
    }


    @Override
    public List<VEvent> fromMultistatus(Multistatus multistatus)
    {
        List<VEvent> events = new ArrayList<>(multistatus.getResponse().size());
        for (Response response : multistatus.getResponse()) {
            // Here response.getPropstat().get(0).getProp().getAny().get(0).getFirstChild().getTextContent() is parsed
            events.addAll(ICalendarSardineReport.getICalendar(response).getEvents());
        }
        return events;
    }


    @Override
    public Object toJaxb()
    {
        return null;
    }

}