Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||||||
ItunesExtension |
|
| 0.0;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 | * <complexType> |
|
27 | * <complexContent> |
|
28 | * <restriction base="{http://www.w3.org/2001/XMLSchema}anyType"> |
|
29 | * <sequence> |
|
30 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}category" maxOccurs="unbounded" minOccurs="0"/> |
|
31 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}keywords" minOccurs="0"/> |
|
32 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}subtitle" minOccurs="0"/> |
|
33 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}duration" minOccurs="0"/> |
|
34 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}summary" minOccurs="0"/> |
|
35 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}image" minOccurs="0"/> |
|
36 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}explicit" minOccurs="0"/> |
|
37 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}owner" minOccurs="0"/> |
|
38 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}author" minOccurs="0"/> |
|
39 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}block" minOccurs="0"/> |
|
40 | * <element ref="{http://www.itunes.com/dtds/podcast-1.0.dtd}new-feed-url" minOccurs="0"/> |
|
41 | * </sequence> |
|
42 | * </restriction> |
|
43 | * </complexContent> |
|
44 | * </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 > 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><itunes:category></code> to specify the browse category, and a nested <code><itunes:category></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 & Entertainment > Photography", it will now appear under "Arts > 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> <itunes:category text="Music" /></code></pre><br> |
|
92 | * |
|
93 | * <h4>Category with ampersand:</h4> |
|
94 | * <pre><code> <itunes:category text="TV &amp; Film" /></code></pre><br> |
|
95 | * |
|
96 | * |
|
97 | * <h4>Category with Subcategory:</h4> |
|
98 | * <pre><code> <itunes:category text="Society &amp; Culture"> |
|
99 | * <itunes:category text="History" /> |
|
100 | * </itunes:category></code></pre><br> |
|
101 | * |
|
102 | * <h4>Entry with multiple categories:</h4> |
|
103 | * |
|
104 | * <pre><code> <itunes:category text="Society &amp; Culture"> |
|
105 | * <itunes:category text="History" /> |
|
106 | * </itunes:category> |
|
107 | * <itunes:category text="Technology"> |
|
108 | * <itunes:category text="Gadgets" /> |
|
109 | * |
|
110 | * </itunes:category></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 <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><itunes:email></strong></code>element.</p> |
|
316 | * <p>Put the name of the owner in a nested <code><strong><itunes:name></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><author></code> tag. If <code><itunes:author></code> is not present at the feed level, iTunes will use the contents of <code><managingEditor></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><channel></code> element to prevent the entire podcast from appearing in the iTunes Podcast directory. Use this inside an <code><item></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><channel></code> level. The feed format is:</p> |
|
400 | * |
|
401 | * <code><itunes:new-feed-url>http://newlocation.com/example.rss</itunes:new-feed-url></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 | } |