Annotations: Difference between revisions

Annotations (view source)

991 bytes added , 3 October 2005

202

edits

@@ Line 87: / Line 87: @@
      void removePageAnnotations(in nsIURI aURI);
-Issues: do we want to namespace annotation names?
+    /**
+     * Get the values of several annotations with arbitrary URI/name pairs.
+     * There is some latency associated with each annotation query, so it is
+     * a good idea to use this function if it is possible for you to batch
+     * your requests together.
+     *
+     * This will return an array with the same number of values you requested.
+     * If the requested URI/name pair does not exist, the corresponding result
+     * element will be NULL.
+     *
+     * @param aURIList The list of URIs
+     */
+    void getMultipleAnnotations([array, size_is(aCount)] in nsIURI aURIList,
+      [array, size_is(aCount)] in wstring aNameList, in unsigned long aCount,
+      out unsigned long aResultCount,
+      [retval, array, size_is(aResultCount)] out wstring aResultList);
+Issues: do we want to namespace annotation names? Probably we should just say that people should always namespace their names, but do it manually with the names they pick for their annotations. For example "history:thumbnail" or "my_extension:annoying_data".
 Do we want to support more advanced queries? Examples: Give me all pages with annotation X. Give me all pages where annotation X > Y, etc.