toolkit/components/feeds/nsIFeed.idl

changeset 0
6474c204b198
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/toolkit/components/feeds/nsIFeed.idl	Wed Dec 31 06:09:35 2014 +0100
     1.3 @@ -0,0 +1,86 @@
     1.4 +/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
     1.5 +/* This Source Code Form is subject to the terms of the Mozilla Public
     1.6 + * License, v. 2.0. If a copy of the MPL was not distributed with this
     1.7 + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
     1.8 +
     1.9 +#include "nsIFeedContainer.idl"
    1.10 +
    1.11 +interface nsIArray;
    1.12 +interface nsIFeedGenerator;
    1.13 +
    1.14 +/**
    1.15 + * An nsIFeed represents a single Atom or RSS feed.
    1.16 + */
    1.17 +[scriptable, uuid(3b8aae33-80e2-4efa-99c8-a6c5b99f76ea)]
    1.18 +interface nsIFeed : nsIFeedContainer
    1.19 +{
    1.20 +  /** 
    1.21 +  * Uses description, subtitle, and extensions
    1.22 +  * to generate a summary. 
    1.23 +  */
    1.24 +  attribute nsIFeedTextConstruct subtitle;
    1.25 +
    1.26 +  // All content classifies as a "feed" - it is the transport.
    1.27 +  const unsigned long TYPE_FEED = 0;
    1.28 +  const unsigned long TYPE_AUDIO = 1;
    1.29 +  const unsigned long TYPE_IMAGE = 2;
    1.30 +  const unsigned long TYPE_VIDEO = 4;
    1.31 +
    1.32 +  /**
    1.33 +  * The type of feed. For example, a podcast would be TYPE_AUDIO.
    1.34 +  */
    1.35 +  readonly attribute unsigned long type;
    1.36 +  
    1.37 +  /**
    1.38 +  * The total number of enclosures found in the feed.
    1.39 +  */
    1.40 +  attribute long enclosureCount;
    1.41 +
    1.42 +  /**
    1.43 +  * The items or entries in feed.
    1.44 +  */
    1.45 +  attribute nsIArray items;
    1.46 +
    1.47 +  /**
    1.48 +  * No one really knows what cloud is for.
    1.49 +  *
    1.50 +  * It supposedly enables some sort of interaction with an XML-RPC or
    1.51 +  * SOAP service.
    1.52 +  */
    1.53 +  attribute nsIWritablePropertyBag2 cloud;
    1.54 +
    1.55 +  /**
    1.56 +  * Information about the software that produced the feed.
    1.57 +  */
    1.58 +  attribute nsIFeedGenerator generator;
    1.59 +
    1.60 +  /**
    1.61 +  * An image url and some metadata (as defined by RSS2).
    1.62 +  *
    1.63 +  */
    1.64 +  attribute nsIWritablePropertyBag2 image;
    1.65 +
    1.66 +  /**
    1.67 +  * No one really knows what textInput is for.
    1.68 +  *
    1.69 +  * See
    1.70 +  * <http://www.cadenhead.org/workbench/news/2894/rss-joy-textinput>
    1.71 +  * for more details.
    1.72 +  */
    1.73 +  attribute nsIWritablePropertyBag2 textInput;
    1.74 +
    1.75 +  /**
    1.76 +  * Days to skip fetching. This field was supposed to designate
    1.77 +  * intervals for feed fetching. It's not generally implemented. For
    1.78 +  * example, if this array contained "Monday", aggregators should not
    1.79 +  * fetch the feed on Mondays.
    1.80 +  */
    1.81 +  attribute nsIArray skipDays;
    1.82 +
    1.83 + /**
    1.84 +  * Hours to skip fetching. This field was supposed to designate
    1.85 +  * intervals for feed fetching. It's not generally implemented. See
    1.86 +  * <http://blogs.law.harvard.edu/tech/rss> for more information.
    1.87 +  */
    1.88 +  attribute nsIArray skipHours;
    1.89 +};

mercurial