Coverage Report - yarfraw.generated.itunes.elements.ItunesExtension
 
Classes in this File Line Coverage Branch Coverage Complexity
ItunesExtension
85% 
100% 
0
 
 1  
 //
 2  
 // This file was generated by the JavaTM Architecture for XML Binding(JAXB) Reference Implementation, v2.1.5-b01-fcs 
 3  
 // See <a href="http://java.sun.com/xml/jaxb">http://java.sun.com/xml/jaxb</a> 
 4  
 // Any modifications to this file will be lost upon recompilation of the source schema. 
 5  
 // Generated on: 2008.06.11 at 12:15:45 AM EDT 
 6  
 //
 7  
 
 8  
 
 9  
 package yarfraw.generated.itunes.elements;
 10  
 
 11  
 import java.util.ArrayList;
 12  
 import java.util.List;
 13  
 import javax.xml.bind.annotation.XmlAccessType;
 14  
 import javax.xml.bind.annotation.XmlAccessorType;
 15  
 import javax.xml.bind.annotation.XmlElement;
 16  
 import javax.xml.bind.annotation.XmlRootElement;
 17  
 import javax.xml.bind.annotation.XmlType;
 18  
 
 19  
 
 20  
 /**
 21  
  * <p>Java class for anonymous complex type.
 22  
  * 
 23  
  * <p>The following schema fragment specifies the expected content contained within this class.
 24  
  * 
 25  
  * <pre>
 26  
  * &lt;complexType>
 27  
  *   &lt;complexContent>
 28  
  *     &lt;restriction base="{http://www.w3.org/2001/XMLSchema}anyType">
 29  
  *       &lt;sequence>
 30  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}category" maxOccurs="unbounded" minOccurs="0"/>
 31  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}keywords" minOccurs="0"/>
 32  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}subtitle" minOccurs="0"/>
 33  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}duration" minOccurs="0"/>
 34  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}summary" minOccurs="0"/>
 35  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}image" minOccurs="0"/>
 36  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}explicit" minOccurs="0"/>
 37  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}owner" minOccurs="0"/>
 38  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}author" minOccurs="0"/>
 39  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}block" minOccurs="0"/>
 40  
  *         &lt;element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}new-feed-url" minOccurs="0"/>
 41  
  *       &lt;/sequence>
 42  
  *     &lt;/restriction>
 43  
  *   &lt;/complexContent>
 44  
  * &lt;/complexType>
 45  
  * </pre>
 46  
  * 
 47  
  * 
 48  
  */
 49  
 @XmlAccessorType(XmlAccessType.FIELD)
 50  
 @XmlType(name = "", propOrder = {
 51  
     "category",
 52  
     "keywords",
 53  
     "subtitle",
 54  
     "duration",
 55  
     "summary",
 56  
     "image",
 57  
     "explicit",
 58  
     "owner",
 59  
     "author",
 60  
     "block",
 61  
     "newFeedUrl"
 62  
 })
 63  
 @XmlRootElement(name = "itunesExtension")
 64  6
 public class ItunesExtension {
 65  
 
 66  
     protected List<ItunesCategoryType> category;
 67  
     protected String keywords;
 68  
     protected String subtitle;
 69  
     protected String duration;
 70  
     protected String summary;
 71  
     protected ItunesImageType image;
 72  
     protected String explicit;
 73  
     protected ItunesOwnerType owner;
 74  
     protected String author;
 75  
     protected String block;
 76  
     @XmlElement(name = "new-feed-url")
 77  
     protected String newFeedUrl;
 78  
 
 79  
     /**
 80  
      *  
 81  
      * <p>There are two ways to browse podcast subject categories on iTunes: click Browse in the Quick Links box or click a selection in the Category box. The former method leads to a text-based table, while the latter leads to pages that include the podcast art.</p> 
 82  
      *                                         <p>For placement within the older, text-based browse system, podcast feeds may list up to 3 category/subcategory pairs. (For example, "Music" counts as 1, as does "Business &gt; Careers.") For placement within the newer browse system based on Category links, however, and for placement within the Top Podcasts lists that appear in the right column of most podcast pages, only the first category listed in the feed is used.</p>
 83  
      * 
 84  
      *                                         <p>Categories and subcategories can be specified as follows. Use a top level <code>&lt;itunes:category&gt;</code> to specify the browse category, and a nested <code>&lt;itunes:category&gt;</code> to specify the browse subcategory. Choose from the existing categories and subcategories in iTunes. Be sure to properly escape ampersands. A complete list is included at the end of this document.</p>
 85  
      *                                         <p>Note that a separate set of categories was active until July 2006, when it was replaced by the new set at the end of this document. During a transition period, most of the old categories and subcategories will be automatically mapped to corresponding ones within the new system. For example, if your podcast was listed under "Arts &amp; Entertainment &gt; Photography", it will now appear under "Arts &gt; Visual Arts." However, 3 categories have been removed and do not have a similar replacement: "International", "Talk Radio", and "Public Radio". Those categories overlapped with others in the old system, making some podcasts difficult to discover. If one of these categories is listed as the first subject in your podcast feed, that category information will be ignored and the second category will be used to determine eligibility and placement in that feature page.</p>
 86  
      * 
 87  
      *                                         
 88  
      *                                         <h4>Examples:</h4>
 89  
      *         
 90  
      *                                         <h4>Single category:</h4>
 91  
      *                                         <pre><code>        &lt;itunes:category text="Music" /&gt;</code></pre><br>
 92  
      *         
 93  
      *                                         <h4>Category with ampersand:</h4>
 94  
      *                                         <pre><code>        &lt;itunes:category text="TV &amp;amp; Film" /&gt;</code></pre><br>
 95  
      * 
 96  
      *         
 97  
      *                                         <h4>Category with Subcategory:</h4>
 98  
      *                                         <pre><code>        &lt;itunes:category text="Society &amp;amp; Culture"&gt;
 99  
      *                 &lt;itunes:category text="History" /&gt;
 100  
      *                 &lt;/itunes:category&gt;</code></pre><br>
 101  
      *         
 102  
      *                                         <h4>Entry with multiple categories:</h4>
 103  
      * 
 104  
      *                                         <pre><code>        &lt;itunes:category text="Society &amp;amp; Culture"&gt;
 105  
      *                 &lt;itunes:category text="History" /&gt;
 106  
      *                 &lt;/itunes:category&gt;
 107  
      *                 &lt;itunes:category text="Technology"&gt;
 108  
      *                 &lt;itunes:category text="Gadgets" /&gt;
 109  
      * 
 110  
      *                 &lt;/itunes:category&gt;</code></pre>
 111  
      *                                                  
 112  
      *                                                 Gets the value of the category property.
 113  
      * 
 114  
      * <p>
 115  
      * This accessor method returns a reference to the live list,
 116  
      * not a snapshot. Therefore any modification you make to the
 117  
      * returned list will be present inside the JAXB object.
 118  
      * This is why there is not a <CODE>set</CODE> method for the category property.
 119  
      * 
 120  
      * <p>
 121  
      * For example, to add a new item, do as follows:
 122  
      * <pre>
 123  
      *    getCategory().add(newItem);
 124  
      * </pre>
 125  
      * 
 126  
      * 
 127  
      * <p>
 128  
      * Objects of the following type(s) are allowed in the list
 129  
      * {@link ItunesCategoryType }
 130  
      * 
 131  
      * 
 132  
      */
 133  
     public List<ItunesCategoryType> getCategory() {
 134  12
         if (category == null) {
 135  6
             category = new ArrayList<ItunesCategoryType>();
 136  
         }
 137  12
         return this.category;
 138  
     }
 139  
 
 140  
     /**
 141  
      *  
 142  
      * This tag allows users to search on a maximum of 12 text keywords. Use commas to separate keywords.
 143  
      *                                                  
 144  
      *                                                 
 145  
      * 
 146  
      * @return
 147  
      *     possible object is
 148  
      *     {@link String }
 149  
      *     
 150  
      */
 151  
     public String getKeywords() {
 152  6
         return keywords;
 153  
     }
 154  
 
 155  
     /**
 156  
      * Sets the value of the keywords property.
 157  
      * 
 158  
      * @param value
 159  
      *     allowed object is
 160  
      *     {@link String }
 161  
      *     
 162  
      */
 163  
     public void setKeywords(String value) {
 164  6
         this.keywords = value;
 165  6
     }
 166  
 
 167  
     /**
 168  
      *  
 169  
      * The contents of this tag are shown in the Description column in iTunes. The subtitle displays best if it is only a few words long.
 170  
      *                                                  
 171  
      *                                                 
 172  
      * 
 173  
      * @return
 174  
      *     possible object is
 175  
      *     {@link String }
 176  
      *     
 177  
      */
 178  
     public String getSubtitle() {
 179  6
         return subtitle;
 180  
     }
 181  
 
 182  
     /**
 183  
      * Sets the value of the subtitle property.
 184  
      * 
 185  
      * @param value
 186  
      *     allowed object is
 187  
      *     {@link String }
 188  
      *     
 189  
      */
 190  
     public void setSubtitle(String value) {
 191  6
         this.subtitle = value;
 192  6
     }
 193  
 
 194  
     /**
 195  
      *  
 196  
      * <p>The content of this tag is shown in the Time column in iTunes.</p>
 197  
      * <p>The tag can be formatted HH:MM:SS, H:MM:SS, MM:SS, or M:SS (H = hours, M = minutes, S = seconds). If an integer is provided (no colon present), the value is assumed to be in seconds. If one colon is present, the number to the left is assumed to be minutes, and the number to the right is assumed to be seconds. If more than two colons are present, the numbers furthest to the right are ignored.</p>
 198  
      *                                                  
 199  
      *                                                 
 200  
      * 
 201  
      * @return
 202  
      *     possible object is
 203  
      *     {@link String }
 204  
      *     
 205  
      */
 206  
     public String getDuration() {
 207  6
         return duration;
 208  
     }
 209  
 
 210  
     /**
 211  
      * Sets the value of the duration property.
 212  
      * 
 213  
      * @param value
 214  
      *     allowed object is
 215  
      *     {@link String }
 216  
      *     
 217  
      */
 218  
     public void setDuration(String value) {
 219  9
         this.duration = value;
 220  9
     }
 221  
 
 222  
     /**
 223  
      *  
 224  
      * The contents of this tag are shown in a separate window that appears when the "circled i" in the Description 
 225  
      * column is clicked. It also appears on the iTunes page for your podcast. This field can be up to 4000 characters. 
 226  
      * If &lt;itunes:summary> is not included, the contents of the <description> tag are used.
 227  
      *                                                  
 228  
      *                                                 
 229  
      * 
 230  
      * @return
 231  
      *     possible object is
 232  
      *     {@link String }
 233  
      *     
 234  
      */
 235  
     public String getSummary() {
 236  6
         return summary;
 237  
     }
 238  
 
 239  
     /**
 240  
      * Sets the value of the summary property.
 241  
      * 
 242  
      * @param value
 243  
      *     allowed object is
 244  
      *     {@link String }
 245  
      *     
 246  
      */
 247  
     public void setSummary(String value) {
 248  6
         this.summary = value;
 249  6
     }
 250  
 
 251  
     /**
 252  
      *  
 253  
      * <p>This tag specifies the artwork for your podcast. Put the URL to the image in the href attribute. iTunes prefers square .jpg images that are at least 300 x 300 pixels, which is different than what is specified for the standard RSS image tag.</p>
 254  
      * <p>iTunes supports images in JPEG and PNG formats. The URL must end in ".jpg" or ".png". If the itunes:image tag is not present, iTunes will use the contents of the RSS image tag.</p>
 255  
      * <p>If you change your podcast’s image, also change the file’s name. iTunes may not change the image if it checks your feed and the image URL is the same.</p>
 256  
      * <p>Spend some time developing an attractive, original image that represents your podcast well. Potential subscribers will see it on your podcast’s page and a much smaller version of the image in search results and feature placements. Make sure your design is effective in both sizes.</p>
 257  
      * 
 258  
      * <p>The itunes:image tag is <b>not</b> supported at the item level. It is possible to include art within individual episodes, but the art is included within the media file’s metadata, not in the RSS feed. To add artwork to an episode using iTunes, highlight the episode and select "Get Info" from the "File" menu. Click the Artwork tab. Then click "Add," navigate to and select an image file, and click "Choose." </p>
 259  
      *                                                  
 260  
      *                                                 
 261  
      * 
 262  
      * @return
 263  
      *     possible object is
 264  
      *     {@link ItunesImageType }
 265  
      *     
 266  
      */
 267  
     public ItunesImageType getImage() {
 268  9
         return image;
 269  
     }
 270  
 
 271  
     /**
 272  
      * Sets the value of the image property.
 273  
      * 
 274  
      * @param value
 275  
      *     allowed object is
 276  
      *     {@link ItunesImageType }
 277  
      *     
 278  
      */
 279  
     public void setImage(ItunesImageType value) {
 280  6
         this.image = value;
 281  6
     }
 282  
 
 283  
     /**
 284  
      *  
 285  
      * <p>This tag should be used to indicate whether or not your podcast contains explicit material. The three values for this tag are "yes", "no", and "clean".</p>
 286  
      * 
 287  
      * <p>If you populate this tag with "yes", an "explicit" parental advisory graphic will appear next to your podcast artwork on the iTunes Music Store, and in the Name column in iTunes. If the value is "clean", the parental advisory type is considered Clean, meaning that no explicit language or adult content is included anywhere in the episodes, and a "clean" graphic will appear. If the explicit tag is present and has any other value (e.g. "no") you see no indicator — blank is the default advisory type.</p>
 288  
      * <p>This tag contains information that will be used to contact the owner of the podcast for communication specifically about their podcast. It will not be publicly displayed.</p>
 289  
      *                                                  
 290  
      *                                                 
 291  
      * 
 292  
      * @return
 293  
      *     possible object is
 294  
      *     {@link String }
 295  
      *     
 296  
      */
 297  
     public String getExplicit() {
 298  6
         return explicit;
 299  
     }
 300  
 
 301  
     /**
 302  
      * Sets the value of the explicit property.
 303  
      * 
 304  
      * @param value
 305  
      *     allowed object is
 306  
      *     {@link String }
 307  
      *     
 308  
      */
 309  
     public void setExplicit(String value) {
 310  6
         this.explicit = value;
 311  6
     }
 312  
 
 313  
     /**
 314  
      *  
 315  
      * <p>Put the email address of the owner in a nested <code><strong>&lt;itunes:email&gt;</strong></code>element.</p>
 316  
      * <p>Put the name of the owner in a nested <code><strong>&lt;itunes:name&gt;</strong></code>element.</p>
 317  
      *                                                  
 318  
      *                                                 
 319  
      * 
 320  
      * @return
 321  
      *     possible object is
 322  
      *     {@link ItunesOwnerType }
 323  
      *     
 324  
      */
 325  
     public ItunesOwnerType getOwner() {
 326  6
         return owner;
 327  
     }
 328  
 
 329  
     /**
 330  
      * Sets the value of the owner property.
 331  
      * 
 332  
      * @param value
 333  
      *     allowed object is
 334  
      *     {@link ItunesOwnerType }
 335  
      *     
 336  
      */
 337  
     public void setOwner(ItunesOwnerType value) {
 338  6
         this.owner = value;
 339  6
     }
 340  
 
 341  
     /**
 342  
      *  
 343  
      * <p>The content of this tag is shown in the Artist column in iTunes. If the tag is not present, iTunes uses the contents of the <code>&lt;author&gt;</code> tag. If <code>&lt;itunes:author&gt;</code> is not present at the feed level, iTunes will use the contents of <code>&lt;managingEditor&gt;</code>.</p>
 344  
      *                                                  
 345  
      *                                                 
 346  
      * 
 347  
      * @return
 348  
      *     possible object is
 349  
      *     {@link String }
 350  
      *     
 351  
      */
 352  
     public String getAuthor() {
 353  0
         return author;
 354  
     }
 355  
 
 356  
     /**
 357  
      * Sets the value of the author property.
 358  
      * 
 359  
      * @param value
 360  
      *     allowed object is
 361  
      *     {@link String }
 362  
      *     
 363  
      */
 364  
     public void setAuthor(String value) {
 365  6
         this.author = value;
 366  6
     }
 367  
 
 368  
     /**
 369  
      *  
 370  
      * <p>Use this inside a <code>&lt;channel&gt;</code> element to prevent the entire podcast from appearing in the iTunes Podcast directory. Use this inside an <code>&lt;item&gt;</code> element to prevent that episode from appearing in the iTunes Podcast directory. For example, you may want a specific episode blocked from iTunes if its content might cause the feed to be removed from iTunes.</p>
 371  
      * <p>If this tag is present and set to "yes" (case insensitive), that means to block the feed or the episode. If the tag’s value is any other value, including empty string, it’s indicated as a signal to unblock the feed or episode. At the feed level, if there is no block tag, then the block status of the feed is left unchanged. At the episode level, if there is no block tag, it is the same as if a block=no were present.</p>
 372  
      *         
 373  
      *                                                  
 374  
      *                                                 
 375  
      * 
 376  
      * @return
 377  
      *     possible object is
 378  
      *     {@link String }
 379  
      *     
 380  
      */
 381  
     public String getBlock() {
 382  0
         return block;
 383  
     }
 384  
 
 385  
     /**
 386  
      * Sets the value of the block property.
 387  
      * 
 388  
      * @param value
 389  
      *     allowed object is
 390  
      *     {@link String }
 391  
      *     
 392  
      */
 393  
     public void setBlock(String value) {
 394  6
         this.block = value;
 395  6
     }
 396  
 
 397  
     /**
 398  
      *  
 399  
      * This tag allows you to change the URL where the podcast feed is located. It is added at the <code>&lt;channel&gt;</code> level. The feed format is:</p>
 400  
      * 
 401  
      * <code>&lt;itunes:new-feed-url&gt;http://newlocation.com/example.rss&lt;/itunes:new-feed-url&gt;</code>
 402  
      * <p>After adding the tag to your old feed, you should maintain the old feed for 48 hours before retiring it. At that point, iTunes will have updated the directory with the new feed URL. For more information, please see the "Changing Your Feed URL" section above.</p>
 403  
      *                                                  
 404  
      *                                                 
 405  
      * 
 406  
      * @return
 407  
      *     possible object is
 408  
      *     {@link String }
 409  
      *     
 410  
      */
 411  
     public String getNewFeedUrl() {
 412  0
         return newFeedUrl;
 413  
     }
 414  
 
 415  
     /**
 416  
      * Sets the value of the newFeedUrl property.
 417  
      * 
 418  
      * @param value
 419  
      *     allowed object is
 420  
      *     {@link String }
 421  
      *     
 422  
      */
 423  
     public void setNewFeedUrl(String value) {
 424  0
         this.newFeedUrl = value;
 425  0
     }
 426  
 
 427  
 }