什么是 GDATA 扩展配置文件？

Question

我想使用 SpreadsheetEntry 继承的类 BaseEntry 的 [generateAtom(..,..)][1] 方法获取 GoogleDocs 电子表格的原子格式的 XML。但我不明白该方法中的第二个参数ExtensionProfile。它是什么？如果我只想获取原子格式的 XML，调用这个方法是否足够？

XmlWriter x = new XmlWriter();
spreadSheetEntry.generateAtom(x,new ExtensionProfile());

[1]：http://code.google.com/apis/gdata/javadoc/com/google/gdata/data/BaseEntry.html#generateAtom(com.google.gdata.util.common. xml.XmlWriter、com.google.gdata.data.ExtensionProfile)

Answer 1

来自 ExtensionProfile 的 JavaDoc：

配置文件是一组允许的
每种类型的扩展以及
附加属性。

通常，如果您有服务，则可以使用 Service.getExtensionProfile()。

Answer 2

详细阐述 Jon Skeet 的答案，您需要实例化这样的服务：

String developer_key = "mySecretDeveloperKey";
String client_id = "myApplicationsClientId";
YouTubeService service = new YouTubeService(client_id, developer_key);

然后您可以使用扩展配置文件写入文件您的服务：

static void write_video_entry(VideoEntry video_entry) {
    try {
        String cache_file_path = Layout.get_cache_file_path(video_entry);
        File cache_file = new File(cache_file_path);
        Writer writer = new FileWriter(cache_file);
        XmlWriter xml_writer = new XmlWriter(writer);
        ExtensionProfile extension_profile = service.getExtensionProfile();
        video_entry.generateAtom(xml_writer, extension_profile);
        xml_writer.close();
        writer.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

类似地，您可以使用服务的扩展配置文件读取文件：

static VideoFeed read_video_feed(File cache_file_file) {
    VideoFeed video_feed = new VideoFeed();
    try {
        InputStream input_stream = new FileInputStream(cache_file_file);
        ExtensionProfile extension_profile = service.getExtensionProfile();
        try {
            video_feed.parseAtom(extension_profile, input_stream);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        input_stream.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
    return video_feed;
}