什麼是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

從JavaDoc for ExtensionProfile：

配置文件是針對每種類型的一組允許的 擴展一起與 附加屬性。

通常情況下，如果您有服務，您可以使用Service.getExtensionProfile()要求其擴展功能。

Answer 2

闡述Jon Skeet's answer，你需要實例化一個像這樣的服務：

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; 
}