sbIBundle.idl
Go to the documentation of this file.
1 /*
2 //
3 // BEGIN SONGBIRD GPL
4 //
5 // This file is part of the Songbird web player.
6 //
7 // Copyright(c) 2005-2008 POTI, Inc.
8 // http://songbirdnest.com
9 //
10 // This file may be licensed under the terms of of the
11 // GNU General Public License Version 2 (the "GPL").
12 //
13 // Software distributed under the License is distributed
14 // on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either
15 // express or implied. See the GPL for the specific language
16 // governing rights and limitations.
17 //
18 // You should have received a copy of the GPL along with this
19 // program. If not, go to http://www.gnu.org/licenses/gpl.html
20 // or write to the Free Software Foundation, Inc.,
21 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
22 //
23 // END SONGBIRD GPL
24 //
25 */
26 
27 #include "nsISupports.idl"
28 
37 interface sbIBundleDataListener;
38 interface sbIBundleInstallListener;
39 interface nsIDOMDocument;
40 interface nsIDOMWindow;
49 [scriptable, uuid(656eda3e-aeff-11db-96e1-005056c00008)]
51 {
58  attribute AString bundleId;
59 
66  attribute AString bundleURL;
67 
75  void retrieveBundleData(in long aTimeout);
76 
81 
90 
98 
106  readonly attribute long bundleDataStatus;
107  const long BUNDLE_DATA_STATUS_ERROR = -1;
110 
115  readonly attribute nsIDOMDocument bundleDataDocument;
116 
121  readonly attribute AString bundleDataText;
122 
127  readonly attribute AString bundleDataVersion;
128 
133  readonly attribute long bundleExtensionCount;
134 
139  void removeExtension(in long aIndex);
140 
149  AString getExtensionAttribute(in long aIndex, in AString aAttributeName);
150 
160  boolean getExtensionInstallFlag(in long aIndex);
161 
168  void setExtensionInstallFlag(in long aIndex, in boolean aInstallFlag);
169 
177 
185 
198  long installFlaggedExtensions(in nsIDOMWindow aWindow);
199  const long BUNDLE_INSTALL_ERROR = 0;
200  const long BUNDLE_INSTALL_SUCCESS = 1;
201 
208  readonly attribute boolean restartRequired;
209 };
210 
211 
void retrieveLocalBundleData()
Download the bundle data synchronously from a local file.
Songbird Bundle Data Listener Interface.
readonly attribute boolean restartRequired
Gets the flag indicating that a restart is needed This method gets the flag indicating whether a rest...
Definition: sbIBundle.idl:208
void removeExtension(in long aIndex)
Remove an extension from the bundle extension list.
attribute AString bundleURL
Bundle URL Sets the bundle URL. This is the location of the bundle. Use sbIBundleDataListener to moni...
Definition: sbIBundle.idl:66
void removeBundleInstallListener(in sbIBundleInstallListener aListener)
Remove a bundle install listener This method unregisters a bundle install listener object from the li...
readonly attribute AString bundleDataVersion
Version of the downloaded bundle data. The Version of the downloaded bundle, as extracted from the do...
Definition: sbIBundle.idl:127
var uuid
void addBundleInstallListener(in sbIBundleInstallListener aListener)
Add a bundle install listener This method registers a bundle install listener in order to get error a...
readonly attribute long bundleDataStatus
Status of the bundle download.
Definition: sbIBundle.idl:106
void setExtensionInstallFlag(in long aIndex, in boolean aInstallFlag)
Sets the installation flag for a bundled extension This method sets the installation flag associated ...
const nsIDOMWindow
const long BUNDLE_INSTALL_ERROR
Definition: sbIBundle.idl:199
void addBundleDataListener(in sbIBundleDataListener aListener)
Add a bundle data listener This method registers a bundle observer object associated with the downloa...
void removeBundleDataListener(in sbIBundleDataListener aListener)
Remove a bundle data listener This method unregisters a bundle observer object from the list of bundl...
Songbird Bundle Installation Listener Interface.
AString getExtensionAttribute(in long aIndex, in AString aAttributeName)
Gets an extension's attribute from its xml document source This method returns the corresponding attr...
const long BUNDLE_DATA_STATUS_DOWNLOADING
Definition: sbIBundle.idl:108
boolean getExtensionInstallFlag(in long aIndex)
Gets the installation flag for a bundled extension This method returns the installation flag associat...
const long BUNDLE_INSTALL_SUCCESS
Definition: sbIBundle.idl:200
const long BUNDLE_DATA_STATUS_SUCCESS
Definition: sbIBundle.idl:109
readonly attribute long bundleExtensionCount
Number of extensions in the bundle document.
Definition: sbIBundle.idl:133
const long BUNDLE_DATA_STATUS_ERROR
Definition: sbIBundle.idl:107
Songbird Bundle Interface This is the main bundle management interface, used to get the bundle data...
Definition: sbIBundle.idl:50
long installFlaggedExtensions(in nsIDOMWindow aWindow)
Install specified bundled extensions This method installs the extensions whose install flags are set ...
readonly attribute nsIDOMDocument bundleDataDocument
DOM document for the bundle data. The interface to the bundle DOM document describing the bundled ext...
Definition: sbIBundle.idl:115
attribute AString bundleId
Bundle channel ID Sets the bundle channel ID. This is used to construct the bundle data url...
Definition: sbIBundle.idl:58
readonly attribute AString bundleDataText
Bundle document xml in text format. The XML for the bundle document describing the bundled extension...
Definition: sbIBundle.idl:121
void retrieveBundleData(in long aTimeout)
Begin downloading the bundle data asynchronously This method begins the asynchronous download of bund...