From 6e2a56066b3a5807098f8a84301d00b57cefefed Mon Sep 17 00:00:00 2001
From: Patrick Gotthard
* A group has no additional components. - * + * * @author robert.cooper */ public class Group { diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/HasLocation.java b/src/main/java/org/rometools/feed/module/activitystreams/types/HasLocation.java index be3aca0..688a36e 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/HasLocation.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/HasLocation.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -38,7 +38,7 @@ import org.rometools.feed.module.portablecontacts.ContactModule; * *
** <entry> * <id>tag:world:activity:1212121212121</id> @@ -72,7 +72,7 @@ import org.rometools.feed.module.portablecontacts.ContactModule; * <activity:verb>http://activitystrea.ms/schema/1.0/like</activity:verb> * </entry> *- * + * *
*
* A list has no additional components. *
- * + * * @author robert.cooper */ public class List extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/list"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Mood.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Mood.java index c649638..9773f0d 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Mood.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Mood.java @@ -17,7 +17,7 @@ package org.rometools.feed.module.activitystreams.types; /** - * + * ** Mood describes the mood of the user when the activity was performed. This is usually collected via an extra field in the user interface used to perform the * activity. For the purpose of this schema, a mood is a freeform, short mood keyword or phrase along with an optional mood icon image. @@ -32,7 +32,7 @@ package org.rometools.feed.module.activitystreams.types; * The mood element may have an optional icon attribute which contains the URL of a mood icon image. The mood icon image SHOULD be small and * appropriate to be displayed alongside the mood keyword at a normal text size. *
- * + * * @author robert.cooper */ public class Mood { @@ -41,7 +41,7 @@ public class Mood { /** * Set the value of iconUrl - * + * * @param newiconUrl new value of iconUrl */ public void setIconUrl(final String newiconUrl) { @@ -50,7 +50,7 @@ public class Mood { /** * Get the value of iconUrl - * + * * @return the value of iconUrl */ public String getIconUrl() { @@ -59,7 +59,7 @@ public class Mood { /** * Set the value of text - * + * * @param newtext new value of text */ public void setText(final String newtext) { @@ -68,7 +68,7 @@ public class Mood { /** * Get the value of text - * + * * @return the value of text */ public String getText() { diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Note.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Note.java index adc01ad..a242a1c 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Note.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Note.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -42,11 +42,16 @@ package org.rometools.feed.module.activitystreams.types; * any links that the service automatically adds. Processors MAY remove all HTML markup and consider the comment to be plain text. * * - * + * * @author robert.cooper */ public class Note extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/note"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Person.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Person.java index 8d67e88..48cb650 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Person.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Person.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -41,11 +41,16 @@ import com.sun.syndication.feed.atom.Link; ** The "playlist" object type represents an ordered list of time-based media items, such as video and audio objects. *
@@ -28,11 +28,16 @@ package org.rometools.feed.module.activitystreams.types; ** A playlist has no additional components. *
- * + * * @author robert.cooper */ public class Playlist extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/playlist"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Product.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Product.java index 045a012..0de1c8b 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Product.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Product.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -39,11 +39,16 @@ package org.rometools.feed.module.activitystreams.types; * fullImage whose value is a JSON object with properties as defined in [TODO: xref the JSON serialization of a Media Link Construct]. * * - * + * * @author robert.cooper */ public class Product extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/product"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Review.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Review.java index 009f1d7..ffe6dcc 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Review.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Review.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -46,11 +46,16 @@ package org.rometools.feed.module.activitystreams.types; * rating whose value is a JSON number giving the rating. * * - * + * * @author robert.cooper */ public class Review extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/review"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Service.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Service.java index 922b613..c9748bd 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Service.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Service.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -38,11 +38,16 @@ package org.rometools.feed.module.activitystreams.types; * one (horizontal) to one (vertical) and SHOULD be suitable for presentation at a small size. * * - * + * * @author robert.cooper */ public class Service extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/service"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Song.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Song.java index 15bf7de..0f3495a 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Song.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Song.java @@ -32,15 +32,19 @@ package org.rometools.feed.module.activitystreams.types; ** A song has no additional components. *
- * + * * @author robert.cooper */ public class Song extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; private Audio audio; /** * Set the value of audio - * + * * @param newaudio new value of audio */ public void setAudio(final Audio newaudio) { @@ -49,7 +53,7 @@ public class Song extends ActivityObject { /** * Get the value of audio - * + * * @return the value of audio */ public Audio getAudio() { diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Status.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Status.java index f51c6a9..e7f8c0e 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Status.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Status.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -35,11 +35,16 @@ package org.rometools.feed.module.activitystreams.types; ** A status has the same components as a note. *
- * + * * @author robert.cooper */ public class Status extends ActivityObject { + /** + * + */ + private static final long serialVersionUID = 1L; + @Override public String getTypeIRI() { return "http://activitystrea.ms/schema/1.0/status"; diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Verb.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Verb.java index a540ade..0794d79 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Verb.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Verb.java @@ -17,7 +17,7 @@ package org.rometools.feed.module.activitystreams.types; /** - * + * * @author robert.cooper */ public enum Verb { @@ -31,49 +31,49 @@ public enum Verb { /** * The "start following" Verb indicates that the Subject began following the activity of the Object. In most cases, the Object of this Verb will be a user, * but it can potentially be of any type that can sensibly generate activity. - * + * * The verb URI for the "start following" Verb is http://activitystrea.ms/schema/1.0/follow. - * + * * Processors MAY ignore (silently drop) successive identical "start following" activities regardless of whether they maintain state sufficient to determine * (A), (B), or (C) above. */ START_FOLLOWING("http://activitystrea.ms/schema/1.0/follow"), /** * The "mark as liked" verb indicates that the actor indicated that it likes the object. - * + * * The verb URI for the "mark as liked" Verb is http://activitystrea.ms/schema/1.0/like. */ MARK_AS_LIKED("http://activitystrea.ms/schema/1.0/like"), /** * The "make friend" Verb indicates the creation of a friendship that is reciprocated by the object. - * + * * Since this verb implies an activity on the part of its object, processors MUST NOT accept activities with this Verb unless they are able to verify * through some external means that there is in fact a reciprocated connection. For example, a processor MAY have received a guarantee from a particular * publisher that the publisher will only use this Verb in cases where a reciprocal relationship exists. - * + * * The verb URI for the "make friend" Verb is http://activitystrea.ms/schema/1.0/make-friend. */ MAKE_FRIEND("http://activitystrea.ms/schema/1.0/make-friend"), /** * The "join" Verb indicates that the actor has become a member of the Object. This specification only defines the meaning of this Verb when its Object is a * Group, though implementors SHOULD be prepared to handle other Object types as meaning MAY be provided by extension specifications. - * + * * Processors MAY ignore (silently drop) successive identical "join" activities regardless of whether they maintain state sufficient to determine (A) or (B) * above. - * + * * The "join" Verb is identified by the URI http://activitystrea.ms/schema/1.0/join. */ JOIN("http://activitystrea.ms/schema/1.0/join"), /** * The "play" verb indicates that the subject spent some time enjoying the object. For example, if the object is a video this indicates that the subject * watched all or part of the video. - * + * * The "play" Verb is identified by the URI http://activitystrea.ms/schema/1.0/play. */ PLAY("http://activitystrea.ms/schema/1.0/play"), /** * The "Post" Verb is described in section 8 of the AtomActivity specification. It is only referenced here for completeness. - * + * * http://activitystrea.ms/schema/1.0/post */ POST("http://activitystrea.ms/schema/1.0/post"), @@ -81,38 +81,38 @@ public enum Verb { * The "save" Verb indicates that the Subject has called out the Object as being of interest primarily to him- or herself. Though this action MAY be shared * publicly, the implication is that the Object has been saved primarily for the actor's own benefit rather than to show it to others as would be indicated * by the "share" Verb (Section 3.1.9). - * + * * The "save" Verb is identified by the URI http://activitystrea.ms/schema/1.0/save. */ SAVE("http://activitystrea.ms/schema/1.0/save"), /** * The "share" Verb indicates that the Subject has called out the Object to readers. In most cases, the actor did not create the Object being shared, but is * instead drawing attention to it. - * + * * The "share" Verb is identified by the URI http://activitystrea.ms/schema/1.0/share. */ SHARE("http://activitystrea.ms/schema/1.0/share"), /** * The "tag" verb indicates that the actor has identified the presence of a target inside another object. For example, the actor may have specified that a * particular user appears in a photo. - * + * * The "tag" verb is identified by the URI http://activitystrea.ms/schema/1.0/tag. - * + * * The target of the "tag" verb gives the object in which the tag has been added. For example, if a user appears in a photo, the activity:object is the user * and the activity:target is the photo. */ TAG("http://activitystrea.ms/schema/1.0/tag"), /** * The "update" Verb indicates that the Subject has modified the referenced Object. - * + * * Implementors SHOULD use verbs such as Section 3.1.7 where the Subject is adding new items to a Section 3.2.8 or similar. Update is reserved for * modifications to existing Objects or data such as changing a user's profile information. - * + * * The "update" Verb is identified by the URI http://activitystrea.ms/schema/1.0/update. */ UPDATE("http://activitystrea.ms/schema/1.0/update"), /** - * + * ** The "positive RSVP" verb indicates that the actor has made a positive RSVP for the object. This specification only defines the meaning of this verb when * its object is an event (see Section 4.2.1 (Event)), though @@ -172,7 +172,7 @@ public enum Verb { } /** - * + * * @param iri * @return */ diff --git a/src/main/java/org/rometools/feed/module/activitystreams/types/Video.java b/src/main/java/org/rometools/feed/module/activitystreams/types/Video.java index 72a2714..ef0e959 100644 --- a/src/main/java/org/rometools/feed/module/activitystreams/types/Video.java +++ b/src/main/java/org/rometools/feed/module/activitystreams/types/Video.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -39,7 +39,7 @@ package org.rometools.feed.module.activitystreams.types; * called embedCode whose value is a JSON string containing the fragment of HTML. * * - * + * * @author robert.cooper */ public class Video { diff --git a/src/main/java/org/rometools/feed/module/atomthread/ThreadModule.java b/src/main/java/org/rometools/feed/module/atomthread/ThreadModule.java index 61d4be4..58ba127 100644 --- a/src/main/java/org/rometools/feed/module/atomthread/ThreadModule.java +++ b/src/main/java/org/rometools/feed/module/atomthread/ThreadModule.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -18,7 +18,7 @@ package org.rometools.feed.module.atomthread; /** - * + * * @author robert.cooper */ public interface ThreadModule { diff --git a/src/main/java/org/rometools/feed/module/base/Article.java b/src/main/java/org/rometools/feed/module/base/Article.java index 3c5cc58..45045ec 100644 --- a/src/main/java/org/rometools/feed/module/base/Article.java +++ b/src/main/java/org/rometools/feed/module/base/Article.java @@ -43,7 +43,7 @@ import java.util.Date; /** * This is an interface for the GoogleBase plug in that exposes methods used for Article or News entry types. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.2 $ */ @@ -51,34 +51,34 @@ public interface Article extends GlobalInterface { /** * Array of Author Names. Limit 10. *
publish_date | - * + * *|
- * + * * Details | *Date the item was published in ISO 8601 format: * YYYY-MM-DD | - * + * *
- * + * * Example | *<g:publish_date>2005-12-20</g:publish_date> | *
Attribute of | - * + * *Reference Items | *
- * + * * Content type | *- * + * * date | *
publish_date | - * + * *|
- * + * * Details | *Date the item was published in ISO 8601 format: * YYYY-MM-DD | - * + * *
- * + * * Example | *<g:publish_date>2005-12-20</g:publish_date> | *
Attribute of | - * + * *Reference Items | *
- * + * * Content type | *- * + * * date | *
course_date_range | *||||||
Date and time range a class is in session, in ISO
* 8601. Two sub-attributes are included in course_date_range attribute.
*
Example |
* <g:course_date_range> |
* - * + * * <g:start>2005-12-20T09:30:01</g:start> * <g:end>2005-12-29T10:30:59</g:end> * </g:course_date_range>
- *
+ *
* Attribute of |
* Course schedules |
*
- *
+ *
* Content type |
- *
+ *
* dateTimeRange |
* |
course_date_range | *||||||
Date and time range a class is in session, in ISO
* 8601. Two sub-attributes are included in course_date_range attribute.
*
Example |
* <g:course_date_range> |
* - * + * * <g:start>2005-12-20T09:30:01</g:start> * <g:end>2005-12-29T10:30:59</g:end> * </g:course_date_range>
- *
+ *
* Attribute of |
* Course schedules |
*
- *
+ *
* Content type |
- *
+ *
* dateTimeRange |
* |
Details | - * + * *ID code associated with a course | - * + * *
Example | *<g:course_number>HIST-90A</g:course_number> | - * + * *
Attribute of | *Course schedules | *
Content type | - * + * *string | - * + * *
Details | - * + * *ID code associated with a course | - * + * *
Example | *<g:course_number>HIST-90A</g:course_number> | - * + * *
Attribute of | *Course schedules | *
Content type | - * + * *string | - * + * *
- * + * *will be true, and that the expression:* x.clone() != x *- * + * *
- * + * *will be true, but these are not absolute requirements. While it is typically the case that:* x.clone().getClass() == x.getClass() *- * + * *
- * + * *will be true, this is not an absolute requirement. ** x.clone().equals(x) *- * + * *
* By convention, the returned object should be obtained by calling super.clone. If a class and all of its superclasses (except Object) @@ -184,7 +184,7 @@ public class CustomTagImpl implements CustomTag { *
* The class Object does not itself implement the interface Cloneable, so calling the clone method on an object whose class is
* Object will result in throwing an exception at run time.
- *
+ *
* @return a clone of this instance.
* @exception CloneNotSupportedException if the object's class does not support the Cloneable
interface. Subclasses that override the
* clone
method can also throw this exception to indicate that an instance cannot be cloned.
diff --git a/src/main/java/org/rometools/feed/module/base/CustomTagsImpl.java b/src/main/java/org/rometools/feed/module/base/CustomTagsImpl.java
index 589e383..0c5f77b 100644
--- a/src/main/java/org/rometools/feed/module/base/CustomTagsImpl.java
+++ b/src/main/java/org/rometools/feed/module/base/CustomTagsImpl.java
@@ -31,6 +31,10 @@ import com.sun.syndication.feed.CopyFrom;
*/
public class CustomTagsImpl implements CustomTags {
+ /**
+ *
+ */
+ private static final long serialVersionUID = 1L;
private List values;
/** Creates a new instance of CustomTagsImpl */
diff --git a/src/main/java/org/rometools/feed/module/base/Event.java b/src/main/java/org/rometools/feed/module/base/Event.java
index c781c7d..a21c737 100644
--- a/src/main/java/org/rometools/feed/module/base/Event.java
+++ b/src/main/java/org/rometools/feed/module/base/Event.java
@@ -48,98 +48,98 @@ import org.rometools.feed.module.base.types.ShippingType;
/**
* This is an interface for the GoogleBase plug in that exposes methods used for Event entry types.
- *
+ *
* @author Robert "kebernet" Cooper
* @version $Revision: 1.1 $
*/
public interface Event extends GlobalInterface {
/**
* Currency of the price amount for an item.
- *
+ *
*
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -165,19 +165,19 @@ public interface Event extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -203,12 +203,12 @@ public interface Event extends GlobalInterface { *|
Content type | - * + * *string | *
event_date_range | - * + * *|
Details | *
- *
+ *
* Information on the date and time an event will take place, in ISO 8601
* format. Two sub-attributes are included in the event_date_range attribute:
*
|
*
Example | * <g:event_dateTime> - * + * * <g:from>2005-12-20T14:00:00</g:from> * <g:to>2005-12-20T19:00:00</g:to> - * + * * </g:eventdateTime> |
*
Attribute of | *Events | - * + * *
Content type | - * + * *dateTimeRange | *
event_date_range | - * + * *|
Details | *
- *
+ *
* Information on the date and time an event will take place, in ISO 8601
* format. Two sub-attributes are included in the event_date_range attribute:
*
|
*
Example | * <g:event_dateTime> - * + * * <g:from>2005-12-20T14:00:00</g:from> * <g:to>2005-12-20T19:00:00</g:to> - * + * * </g:eventdateTime> |
*
Attribute of | *Events | - * + * *
Content type | - * + * *dateTimeRange | *
Details | - * + * *Date that the item expires in ISO 8601 format: * YYYY-MM-DD | *
Example | *<g:expiration_date>2005-20-12</g:expiration_date> - * + * * | *
Content type | - * + * *date | *
Details | - * + * *Date that the item expires in ISO 8601 format: * YYYY-MM-DD | *
Example | *<g:expiration_date>2005-20-12</g:expiration_date> - * + * * | *
Content type | - * + * *date | *
expiration_date_time | - * + * *|
Details | *Date and time that the item expires in ISO 8601 * format: YYYY-MM-DDThh:mm:ss | *
Example | - * + * *<g:expiration_date_time>12-20-05T11:59:59</g:expiration_date_time> | *
Attribute of | - * + * *Reference Items, Events, Housing, Jobs, People profiles, Products, Services, Travel, Vehicles, Wanted Ads. | - * + * *
Content type | *dateTime | *
expiration_date_time | - * + * *|
Details | *Date and time that the item expires in ISO 8601 * format: YYYY-MM-DDThh:mm:ss | *
Example | - * + * *<g:expiration_date_time>12-20-05T11:59:59</g:expiration_date_time> | *
Attribute of | - * + * *Reference Items, Events, Housing, Jobs, People profiles, Products, Services, Travel, Vehicles, Wanted Ads. | - * + * *
Content type | *dateTime | *
* It supports all the individual data "types". If you want to work with, for instance, just the Article or Job datatype, you can cast it to the respective * interface and see only methods related to a particular entry type. *
- * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.1 $ */ public interface GoogleBase extends Module, Article, Course, Event, Job, Person, Product, Review, ScholarlyArticle, Service, Travel, Unknown, Vehicle, Wanted, - Housing { +Housing { /** This is the URI for the Google Base Schema. */ public static final String URI = "http://base.google.com/ns/1.0"; } diff --git a/src/main/java/org/rometools/feed/module/base/GoogleBaseImpl.java b/src/main/java/org/rometools/feed/module/base/GoogleBaseImpl.java index fa51137..12cd7f9 100644 --- a/src/main/java/org/rometools/feed/module/base/GoogleBaseImpl.java +++ b/src/main/java/org/rometools/feed/module/base/GoogleBaseImpl.java @@ -60,11 +60,16 @@ import com.sun.syndication.feed.impl.EqualsBean; /** * This is the implementation class for the GoogleBase module interface. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.2 $ */ public class GoogleBaseImpl implements GoogleBase { + /** + * + */ + private static final long serialVersionUID = 1L; + /** boolean:listing_type */ private Boolean listingType; @@ -343,7 +348,7 @@ public class GoogleBaseImpl implements GoogleBase { /** * DOCUMENT ME! - * + * * @param actors */ @Override diff --git a/src/main/java/org/rometools/feed/module/base/Housing.java b/src/main/java/org/rometools/feed/module/base/Housing.java index fb84963..6882234 100644 --- a/src/main/java/org/rometools/feed/module/base/Housing.java +++ b/src/main/java/org/rometools/feed/module/base/Housing.java @@ -48,7 +48,7 @@ import org.rometools.feed.module.base.types.YearType; /** * This is an interface for the GoogleBase plug in that exposes methods used for Housing entry types. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.1 $ */ @@ -59,32 +59,32 @@ public interface Housing extends GlobalInterface { * *currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Monthly dues paid to a homeowners association. | - * + * *
Example | *<g:hoa_dues>100</g:hoa_dues> | - * + * *
Attribute of | - * + * *Housing | *
Content type | - * + * *float | *
Details | - * + * *Monthly dues paid to a homeowners association. | - * + * *
Example | *<g:hoa_dues>100</g:hoa_dues> | - * + * *
Attribute of | - * + * *Housing | *
Content type | - * + * *float | *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Ethnicity of the individual in the People profiles bulk upload entry. | - * + * *
Example | *<g:ethnicity>Latino</g:ethnicity> | - * + * *
Attribute of | - * + * *People profiles | *
Content type | - * + * *string | *
Details | - * + * *Ethnicity of the individual in the People profiles bulk upload entry. | - * + * *
Example | *<g:ethnicity>Latino</g:ethnicity> | - * + * *
Attribute of | - * + * *People profiles | *
Content type | - * + * *string | *
- * + * * Details | - * + * *Sexual orientation of an individual in a People profiles information type.. | *
Example | - * + * *<g:sexual_orientation>straight</g:sexual_orientation> | - * + * *
Attribute of | *- * + * * Personal | *
Content type | *string | - * + * *
- * + * * Details | - * + * *Sexual orientation of an individual in a People profiles information type.. | *
Example | - * + * *<g:sexual_orientation>straight</g:sexual_orientation> | - * + * *
Attribute of | *- * + * * Personal | *
Content type | *string | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -683,12 +683,12 @@ public interface Product extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -153,19 +153,19 @@ public interface Review extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -191,12 +191,12 @@ public interface Review extends GlobalInterface { *|
Content type | - * + * *string | *
publish_date | - * + * *|
Details | - * + * *Date the item was published in ISO 8601 format: * YYYY-MM-DD | - * + * *
Example | - * + * *<g:publish_date>2005-12-20</g:publish_date> | *
Attribute of | *- * + * * Reference Items | *
- * + * * Content type | *date | - * + * *
publish_date | - * + * *|
Details | - * + * *Date the item was published in ISO 8601 format: * YYYY-MM-DD | - * + * *
Example | - * + * *<g:publish_date>2005-12-20</g:publish_date> | *
Attribute of | *- * + * * Reference Items | *
- * + * * Content type | *date | - * + * *
- * + * * Details | - * + * *The category of the item being reviewed. | *
Example | - * + * * <g:review_type>toy</g:review_type> - * + * * <g:review_type>music</g:review_type> * <g:review_type>restaraunt</g:review_type> |
*
Attribute of | - * + * *Reviews | *
Content type | *string | - * + * *
- * + * * Details | - * + * *The category of the item being reviewed. | *
Example | - * + * * <g:review_type>toy</g:review_type> - * + * * <g:review_type>music</g:review_type> * <g:review_type>restaraunt</g:review_type> |
*
Attribute of | - * + * *Reviews | *
Content type | *string | - * + * *
publish_date | - * + * *|
- * + * * Details | *Date the item was published in ISO 8601 format: * YYYY-MM-DD | - * + * *
- * + * * Example | *<g:publish_date>2005-12-20</g:publish_date> | *
Attribute of | - * + * *Reference Items | *
- * + * * Content type | *- * + * * date | *
publish_date | - * + * *|
- * + * * Details | *Date the item was published in ISO 8601 format: * YYYY-MM-DD | - * + * *
- * + * * Example | *<g:publish_date>2005-12-20</g:publish_date> | *
Attribute of | - * + * *Reference Items | *
- * + * * Content type | *- * + * * date | *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -164,19 +164,19 @@ public interface Service extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -202,12 +202,12 @@ public interface Service extends GlobalInterface { *|
Content type | - * + * *string | *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -165,19 +165,19 @@ public interface Travel extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -203,12 +203,12 @@ public interface Travel extends GlobalInterface { *|
Content type | - * + * *string | *
travel_date_range | - * + * *|||||||
Details | * Departure date and time of the trip in ISO 8601
* format: YYYY-MM-DD,hh:mmAM (12 hour clock) or YYYY-MM-DD,hh:mm (24 hour clock). Two sub-attributes are included in travel_date_range attribute.
*
Example |
* <g:travel_date_range> |
* - * + * * <g:start>2005-12-20T06:00:00</g:start> * <g:end>2005-12-29T13:00:00</g:end> * </g:travel_date_range>
- *
+ *
* Attribute of |
* Travel |
*
- *
+ *
* Content type |
- *
+ *
* dateTimeRange |
* |
travel_date_range | - * + * *|||||||
Details | * Departure date and time of the trip in ISO 8601
* format: YYYY-MM-DD,hh:mmAM (12 hour clock) or YYYY-MM-DD,hh:mm (24 hour clock). Two sub-attributes are included in travel_date_range attribute.
*
Example |
* <g:travel_date_range> |
* - * + * * <g:start>2005-12-20T06:00:00</g:start> * <g:end>2005-12-29T13:00:00</g:end> * </g:travel_date_range>
- *
+ *
* Attribute of |
* Travel |
*
- *
+ *
* Content type |
- *
+ *
* dateTimeRange |
* |
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
currency | - * + * *|
Details | - * + * *Currency of the price amount for an item. Values must be in ISO 4217 currency code format. | *
Example | - * + * *Acceptable: * <g:currency>USD</g:currency> - * + * * Not acceptable: * <g:currency>US Dollars</g:currency> |
*
Attribute of | *Events, Housing, Products, Services, Travel, Vehicles | - * + * *
Content type | *currencyEnumeration | - * + * *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -321,19 +321,19 @@ public interface Vehicle extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -359,12 +359,12 @@ public interface Vehicle extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -76,19 +76,19 @@ public interface Wanted extends GlobalInterface { *|
Content type | - * + * *string | *
Details | - * + * *Additional instructions to explain the item’s delivery process. | *
Example | *
* <g:delivery_notes>Items usually shipped within 24 hours.<g:/delivery_notes> - * + * * |
- *
+ *
*
Attribute of | @@ -114,12 +114,12 @@ public interface Wanted extends GlobalInterface { *|
Content type | - * + * *string | *
@@ -76,7 +81,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Defined by the ROME module API - * + * * @param obj Object to copy from */ @Override @@ -84,7 +89,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Defined by the ROME API - * + * * @return Class of the Interface for this module. */ @Override @@ -94,7 +99,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * The URI this module implements - * + * * @return "http://www.itunes.com/dtds/podcast-1.0.dtd" */ @Override @@ -104,7 +109,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Required by the ROME API - * + * * @return A clone of this module object */ @Override @@ -112,7 +117,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Returns the author string for this feed or entry - * + * * @return Returns the author string for this feed or entry */ @Override @@ -122,7 +127,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Sets the author string for this feed or entry - * + * * @param author Sets the author string for this feed or entry */ @Override @@ -132,7 +137,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Boolean as to whether to block this feed or entry - * + * * @return Boolean as to whether to block this feed or entry */ @Override @@ -142,7 +147,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Boolean as to whether to block this feed or entry - * + * * @param block Boolean as to whether to block this feed or entry */ @Override @@ -152,7 +157,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Boolean as to whether this feed or entry contains adult content - * + * * @return Boolean as to whether this feed or entry contains adult content */ @Override @@ -162,7 +167,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * Boolean as to whether this feed or entry contains adult content - * + * * @param explicit Boolean as to whether this feed or entry contains adult content */ @Override @@ -172,9 +177,9 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * A list of keywords for this feed or entry - * + * * Must not contain spaces - * + * * @return A list of keywords for this feed or entry */ @Override @@ -184,9 +189,9 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * A list of keywords for this feed or entry - * + * * Must not contain spaces - * + * * @param keywords A list of keywords for this feed or enty */ @Override @@ -196,7 +201,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * A subtitle for this feed or entry - * + * * @return A subtitle for this feed or entry */ @Override @@ -206,7 +211,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * A subtitle for this feed or entry - * + * * @param subtitle A subtitle for this feed or entry */ @Override @@ -216,7 +221,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * A subtitle for this feed or entry - * + * * @return A subtitle for this feed or entry */ @Override @@ -226,7 +231,7 @@ public abstract class AbstractITunesObject implements ITunes, java.lang.Cloneabl /** * A subtitle for this feed or entry - * + * * @param summary A subtitle for this feed or entry */ @Override diff --git a/src/main/java/org/rometools/feed/module/itunes/EntryInformation.java b/src/main/java/org/rometools/feed/module/itunes/EntryInformation.java index 17bba08..d44e4a7 100644 --- a/src/main/java/org/rometools/feed/module/itunes/EntryInformation.java +++ b/src/main/java/org/rometools/feed/module/itunes/EntryInformation.java @@ -45,23 +45,23 @@ import org.rometools.feed.module.itunes.types.Duration; /** * This class contains information for iTunes podcast feeds that exist at the Item level. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.2 $ - * + * */ public interface EntryInformation extends ITunes { /** * Returns the Duration object for this Item - * + * * @return Returns the Duration object for this Item */ public Duration getDuration(); /** * Sets the Duration object for this Item - * + * * @param duration Sets the Duration object for this Item */ public void setDuration(Duration duration); diff --git a/src/main/java/org/rometools/feed/module/itunes/EntryInformationImpl.java b/src/main/java/org/rometools/feed/module/itunes/EntryInformationImpl.java index 4354b51..0f9e961 100644 --- a/src/main/java/org/rometools/feed/module/itunes/EntryInformationImpl.java +++ b/src/main/java/org/rometools/feed/module/itunes/EntryInformationImpl.java @@ -46,11 +46,15 @@ import com.sun.syndication.feed.CopyFrom; /** * This class contains information for iTunes podcast feeds that exist at the Item level. - * + * * @version $Revision: 1.2 $ * @author Robert "kebernet" Cooper */ public class EntryInformationImpl extends AbstractITunesObject implements EntryInformation { + /** + * + */ + private static final long serialVersionUID = 1L; private Duration duration; /** @@ -61,7 +65,7 @@ public class EntryInformationImpl extends AbstractITunesObject implements EntryI /** * Returns the Duration object for this Item - * + * * @return Returns the Duration object for this Item */ @Override @@ -71,7 +75,7 @@ public class EntryInformationImpl extends AbstractITunesObject implements EntryI /** * Sets the Duration object for this Item - * + * * @param duration Sets the Duration object for this Item */ @Override @@ -81,7 +85,7 @@ public class EntryInformationImpl extends AbstractITunesObject implements EntryI /** * Defined by the ROME module API - * + * * @param obj Object to copy from */ @Override @@ -106,7 +110,7 @@ public class EntryInformationImpl extends AbstractITunesObject implements EntryI /** * Required by the ROME API - * + * * @return A clone of this module object */ @Override diff --git a/src/main/java/org/rometools/feed/module/itunes/FeedInformation.java b/src/main/java/org/rometools/feed/module/itunes/FeedInformation.java index e2fd226..7e1d59e 100644 --- a/src/main/java/org/rometools/feed/module/itunes/FeedInformation.java +++ b/src/main/java/org/rometools/feed/module/itunes/FeedInformation.java @@ -45,7 +45,7 @@ import java.util.List; /** * This class contains information for iTunes podcast feeds that exist at the Channel level. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.2 $ */ @@ -53,60 +53,60 @@ public interface FeedInformation extends ITunes { /** * The parent categories for this feed - * + * * @return The parent categories for this feed */ public List getCategories(); /** * The parent categories for this feed - * + * * @param categories The parent categories for this feed */ public void setCategories(List categories); /** * Sets the URL for the image. - * + * * NOTE: To specification images should be in PNG or JPEG format. - * + * * @param image Sets the URL for the image. */ public void setImage(URL image); /** * Returns the URL for the image. - * + * * NOTE: To specification images should be in PNG or JPEG format. - * + * * @return Returns the URL for the image. */ public URL getImage(); /** * Sets the owner email address for the feed. - * + * * @param ownerEmailAddress Sets the owner email address for the feed. */ public void setOwnerEmailAddress(String ownerEmailAddress); /** * Returns the owner email address for the feed. - * + * * @return Returns the owner email address for the feed. */ public String getOwnerEmailAddress(); /** * Sets the owner name for the feed - * + * * @param ownerName Sets the owner name for the feed */ public void setOwnerName(String ownerName); /** * Returns the owner name for the feed - * + * * @return Returns the owner name for the feed */ public String getOwnerName(); diff --git a/src/main/java/org/rometools/feed/module/itunes/FeedInformationImpl.java b/src/main/java/org/rometools/feed/module/itunes/FeedInformationImpl.java index 7277460..87629af 100644 --- a/src/main/java/org/rometools/feed/module/itunes/FeedInformationImpl.java +++ b/src/main/java/org/rometools/feed/module/itunes/FeedInformationImpl.java @@ -51,11 +51,15 @@ import com.sun.syndication.feed.CopyFrom; /** * This class contains information for iTunes podcast feeds that exist at the Channel level. - * + * * @version $Revision: 1.2 $ * @author Robert "kebernet" Cooper */ public class FeedInformationImpl extends AbstractITunesObject implements FeedInformation { + /** + * + */ + private static final long serialVersionUID = 1L; private String ownerName; private String ownerEmailAddress; private URL image; @@ -69,7 +73,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * The parent categories for this feed - * + * * @return The parent categories for this feed */ @Override @@ -79,7 +83,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * The parent categories for this feed - * + * * @param categories The parent categories for this feed */ @Override @@ -89,7 +93,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Returns the owner name for the feed - * + * * @return Returns the owner name for the feed */ @Override @@ -99,7 +103,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Sets the owner name for the feed - * + * * @param ownerName Sets the owner name for the feed */ @Override @@ -109,7 +113,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Returns the owner email address for the feed. - * + * * @return Returns the owner email address for the feed. */ @Override @@ -119,7 +123,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Sets the owner email address for the feed. - * + * * @param ownerEmailAddress Sets the owner email address for the feed. */ @Override @@ -129,9 +133,9 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Returns the URL for the image. - * + * * NOTE: To specification images should be in PNG or JPEG format. - * + * * @return Returns the URL for the image. */ @Override @@ -141,9 +145,9 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Sets the URL for the image. - * + * * NOTE: To specification images should be in PNG or JPEG format. - * + * * @param image Sets the URL for the image. */ @Override @@ -153,7 +157,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Required by the ROME API - * + * * @param obj object to copy property values from */ @Override @@ -189,7 +193,7 @@ public class FeedInformationImpl extends AbstractITunesObject implements FeedInf /** * Returns a copy of this FeedInformationImpl object - * + * * @return Returns a copy of this FeedInformationImpl object */ @Override diff --git a/src/main/java/org/rometools/feed/module/itunes/ITunes.java b/src/main/java/org/rometools/feed/module/itunes/ITunes.java index baf66d5..08b3465 100644 --- a/src/main/java/org/rometools/feed/module/itunes/ITunes.java +++ b/src/main/java/org/rometools/feed/module/itunes/ITunes.java @@ -44,7 +44,7 @@ import com.sun.syndication.feed.module.Module; /** * This interface contains the methods common to all iTunes module points. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.3 $ */ @@ -54,88 +54,88 @@ public interface ITunes extends Module { /** * Returns the author string for this feed or entry - * + * * @return Returns the author string for this feed or entry */ public String getAuthor(); /** * Sets the author string for this feed or entry - * + * * @param author Sets the author string for this feed or entry */ public void setAuthor(String author); /** * Boolean as to whether to block this feed or entry - * + * * @return Boolean as to whether to block this feed or entry */ public boolean getBlock(); /** * Boolean as to whether to block this feed or entry - * + * * @param block Boolean as to whether to block this feed or entry */ public void setBlock(boolean block); /** * Boolean as to whether this feed or entry contains adult content - * + * * @return Boolean as to whether this feed or entry contains adult content */ public boolean getExplicit(); /** * Boolean as to whether this feed or entry contains adult content - * + * * @param explicit Boolean as to whether this feed or entry contains adult content */ public void setExplicit(boolean explicit); /** * A list of keywords for this feed or entry - * + * * Must not contain spaces - * + * * @return A list of keywords for this feed or entry */ public String[] getKeywords(); /** * A list of keywords for this feed or entry - * + * * Must not contain spaces - * + * * @param keywords A list of keywords for this feed or enty */ public void setKeywords(String[] keywords); /** * A subtitle for this feed or entry - * + * * @return A subtitle for this feed or entry */ public String getSubtitle(); /** * A subtitle for this feed or entry - * + * * @param subtitle A subtitle for this feed or entry */ public void setSubtitle(String subtitle); /** * A subtitle for this feed or entry - * + * * @return A subtitle for this feed or entry */ public String getSummary(); /** * A subtitle for this feed or entry - * + * * @param summary A subtitle for this feed or entry */ public void setSummary(String summary); diff --git a/src/main/java/org/rometools/feed/module/itunes/io/ITunesGenerator.java b/src/main/java/org/rometools/feed/module/itunes/io/ITunesGenerator.java index abf3fbc..8884889 100644 --- a/src/main/java/org/rometools/feed/module/itunes/io/ITunesGenerator.java +++ b/src/main/java/org/rometools/feed/module/itunes/io/ITunesGenerator.java @@ -162,7 +162,7 @@ public class ITunesGenerator implements ModuleGenerator { /** * Returns the list of namespaces this module uses. - * + * * @return set of Namespace objects. */ @Override @@ -172,7 +172,7 @@ public class ITunesGenerator implements ModuleGenerator { /** * Returns the namespace URI this module handles. - * + * * @return Returns the namespace URI this module handles. */ @Override diff --git a/src/main/java/org/rometools/feed/module/itunes/io/ITunesParser.java b/src/main/java/org/rometools/feed/module/itunes/io/ITunesParser.java index 1434f7f..6acdd8b 100644 --- a/src/main/java/org/rometools/feed/module/itunes/io/ITunesParser.java +++ b/src/main/java/org/rometools/feed/module/itunes/io/ITunesParser.java @@ -36,7 +36,7 @@ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. - + */ package org.rometools.feed.module.itunes.io; diff --git a/src/main/java/org/rometools/feed/module/itunes/io/ITunesParserOldNamespace.java b/src/main/java/org/rometools/feed/module/itunes/io/ITunesParserOldNamespace.java index b56e011..8dbeb01 100644 --- a/src/main/java/org/rometools/feed/module/itunes/io/ITunesParserOldNamespace.java +++ b/src/main/java/org/rometools/feed/module/itunes/io/ITunesParserOldNamespace.java @@ -24,7 +24,7 @@ package org.rometools.feed.module.itunes.io; import org.jdom2.Namespace; /** - * + * * @author Robert "kebernet" Cooper */ public class ITunesParserOldNamespace extends ITunesParser { diff --git a/src/main/java/org/rometools/feed/module/itunes/types/Category.java b/src/main/java/org/rometools/feed/module/itunes/types/Category.java index a129499..6d7029f 100644 --- a/src/main/java/org/rometools/feed/module/itunes/types/Category.java +++ b/src/main/java/org/rometools/feed/module/itunes/types/Category.java @@ -44,11 +44,15 @@ import java.io.Serializable; /** * This Category information. Basically a name and an optional Subcategory. Categories are defined by Apple. See ITMS for a view. - * + * * @version $Revision: 1.2 $ * @author Robert "kebernet" Cooper */ public class Category implements Serializable { + /** + * + */ + private static final long serialVersionUID = 1L; private String name; private Subcategory subcategory; @@ -58,7 +62,7 @@ public class Category implements Serializable { /** * Creates a new instance of Category with a given name. - * + * * @param name Name of the category. */ public Category(final String name) { @@ -67,7 +71,7 @@ public class Category implements Serializable { /** * Returns the name of the category - * + * * @return Returns the name of the category */ public String getName() { @@ -76,7 +80,7 @@ public class Category implements Serializable { /** * Sets the name of the category - * + * * @param name Sets the name of the category */ public void setName(final String name) { @@ -85,7 +89,7 @@ public class Category implements Serializable { /** * Returns the Subcategory object for this category - * + * * @return Returns the Subcategory object for this category */ public Subcategory getSubcategory() { @@ -94,7 +98,7 @@ public class Category implements Serializable { /** * Sets the Subcategory object for this category - * + * * @param subcategory Sets the Subcategory object for this category */ public void setSubcategory(final Subcategory subcategory) { @@ -103,7 +107,7 @@ public class Category implements Serializable { /** * Returns a copy of this category. - * + * * @return Returns a copy of this category. */ @Override diff --git a/src/main/java/org/rometools/feed/module/itunes/types/Duration.java b/src/main/java/org/rometools/feed/module/itunes/types/Duration.java index 38663f6..11d069a 100644 --- a/src/main/java/org/rometools/feed/module/itunes/types/Duration.java +++ b/src/main/java/org/rometools/feed/module/itunes/types/Duration.java @@ -47,11 +47,15 @@ import com.sun.syndication.io.impl.NumberParser; /** * An encapsulation of the duration of a podcast. This will serialize (via .toString()) to HH:MM:SS format, and can parse [H]*H:[M]*M:[S]*S or [M]*M:[S]*S. - * + * * @version $Revision: 1.7 $ * @author Robert "kebernet" Cooper */ public class Duration implements Serializable { + /** + * + */ + private static final long serialVersionUID = 1L; static final long SECOND = 1000; static final long MINUTE = SECOND * 60; static final long HOUR = MINUTE * 60; @@ -73,7 +77,7 @@ public class Duration implements Serializable { /** * Creates a new instance of Duration specifying a length in milliseconds - * + * * @param milliseconds Creates a new instance of Duration specifying a length in milliseconds */ public Duration(final long milliseconds) { @@ -82,7 +86,7 @@ public class Duration implements Serializable { /** * Creates a new duration object with the given hours, minutes and seconds - * + * * @param hours number of hours * @param minutes number of minutes * @param seconds number of seconds @@ -93,30 +97,30 @@ public class Duration implements Serializable { /** * Creates a new Duration parsing the String value. - * + * * @param duration A String to parse */ public Duration(final String duration) { final StringTokenizer tok = new StringTokenizer(duration, ":"); switch (tok.countTokens()) { - case 1: - setMilliseconds((long) (NumberParser.parseFloat(tok.nextToken(), 0f) * SECOND)); - break; - case 2: - setMilliseconds(NumberParser.parseLong(tok.nextToken(), 0l) * MINUTE + (long) (NumberParser.parseFloat(tok.nextToken(), 0f) * SECOND)); - break; - case 3: - setMilliseconds(NumberParser.parseLong(tok.nextToken(), 0l) * HOUR + NumberParser.parseLong(tok.nextToken(), 0l) * MINUTE - + (long) (NumberParser.parseFloat(tok.nextToken(), 0f) * SECOND)); - break; - default: - throw new RuntimeException("Illegal time value: " + duration); + case 1: + setMilliseconds((long) (NumberParser.parseFloat(tok.nextToken(), 0f) * SECOND)); + break; + case 2: + setMilliseconds(NumberParser.parseLong(tok.nextToken(), 0l) * MINUTE + (long) (NumberParser.parseFloat(tok.nextToken(), 0f) * SECOND)); + break; + case 3: + setMilliseconds(NumberParser.parseLong(tok.nextToken(), 0l) * HOUR + NumberParser.parseLong(tok.nextToken(), 0l) * MINUTE + + (long) (NumberParser.parseFloat(tok.nextToken(), 0f) * SECOND)); + break; + default: + throw new RuntimeException("Illegal time value: " + duration); } } /** * Returns a String representation in the formation HH:MM:SS - * + * * @return Returns a String representation in the formation HH:MM:SS */ @Override @@ -128,7 +132,7 @@ public class Duration implements Serializable { /** * Returns the millisecond length - * + * * @return the millisecond length */ public long getMilliseconds() { @@ -137,7 +141,7 @@ public class Duration implements Serializable { /** * Sets the millisecond length - * + * * @param milliseconds the millisecond length */ public void setMilliseconds(final long milliseconds) { diff --git a/src/main/java/org/rometools/feed/module/itunes/types/Subcategory.java b/src/main/java/org/rometools/feed/module/itunes/types/Subcategory.java index 78b7e64..092a5da 100644 --- a/src/main/java/org/rometools/feed/module/itunes/types/Subcategory.java +++ b/src/main/java/org/rometools/feed/module/itunes/types/Subcategory.java @@ -44,11 +44,15 @@ import java.io.Serializable; /** * This class represents a Subcategor of a Category. - * + * * @author Robert "kebernet" Cooper * @version $Revision: 1.2 $ */ public class Subcategory implements Serializable { + /** + * + */ + private static final long serialVersionUID = 1L; private String name; /** Creates a new instance of SubCategory */ @@ -57,7 +61,7 @@ public class Subcategory implements Serializable { /** * Creates a new instance of Category with a given name. - * + * * @param name Name of the category. */ public Subcategory(final String name) { @@ -66,7 +70,7 @@ public class Subcategory implements Serializable { /** * Returns the name of the subcategory. - * + * * @return Returns the name of the subcategory. */ public String getName() { @@ -75,7 +79,7 @@ public class Subcategory implements Serializable { /** * Set the name of the subcategory. - * + * * @param name Set the name of the subcategory. */ public void setName(final String name) { @@ -84,7 +88,7 @@ public class Subcategory implements Serializable { /** * Clones the object. - * + * * @return Clone of the object. */ @Override @@ -97,7 +101,7 @@ public class Subcategory implements Serializable { /** * String representation of the object. - * + * * @return String representation of the object. */ @Override diff --git a/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModule.java b/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModule.java index 675984e..65e1320 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModule.java +++ b/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModule.java @@ -27,20 +27,20 @@ import org.rometools.feed.module.mediarss.types.MediaGroup; /** * Represents entry/item level information. - * + * * @author cooper */ public interface MediaEntryModule extends MediaModule { /** * Returns the MediaContent items for the entry. - * + * * @return Returns the MediaContent items for the entry. */ public MediaContent[] getMediaContents(); /** * Returns the media groups for the entry. - * + * * @return Returns the media groups for the entry. */ public MediaGroup[] getMediaGroups(); diff --git a/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModuleImpl.java b/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModuleImpl.java index db9d7bb..b9cf4d3 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModuleImpl.java +++ b/src/main/java/org/rometools/feed/module/mediarss/MediaEntryModuleImpl.java @@ -33,7 +33,7 @@ import com.sun.syndication.feed.impl.ToStringBean; /** * Represents information for an Entry/Item level. - * + * * @author Nathanial X. Freitas */ public class MediaEntryModuleImpl extends MediaModuleImpl implements MediaEntryModule, Cloneable, Serializable { @@ -54,7 +54,7 @@ public class MediaEntryModuleImpl extends MediaModuleImpl implements MediaEntryM /** * MediaContent items for the entry - * + * * @param mediaContents MediaContent items for the entry */ public void setMediaContents(final MediaContent[] mediaContents) { @@ -63,7 +63,7 @@ public class MediaEntryModuleImpl extends MediaModuleImpl implements MediaEntryM /** * MediaContent items for the entry - * + * * @return MediaContent items for the entry */ @Override @@ -73,7 +73,7 @@ public class MediaEntryModuleImpl extends MediaModuleImpl implements MediaEntryM /** * MediaGroups for the entry - * + * * @param mediaGroups MediaGroups for the entry */ public void setMediaGroups(final MediaGroup[] mediaGroups) { @@ -82,7 +82,7 @@ public class MediaEntryModuleImpl extends MediaModuleImpl implements MediaEntryM /** * MediaGroups for the entry - * + * * @return MediaGroups for the entry */ @Override diff --git a/src/main/java/org/rometools/feed/module/mediarss/MediaModule.java b/src/main/java/org/rometools/feed/module/mediarss/MediaModule.java index 01e69d2..f407db8 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/MediaModule.java +++ b/src/main/java/org/rometools/feed/module/mediarss/MediaModule.java @@ -31,7 +31,7 @@ import com.sun.syndication.feed.module.Module; *
* It represents information that can be stored at the feed level, as well is a base for entry level information, as the same information can apply. *
- * + * * @author Nathanial X. Freitas */ public interface MediaModule extends Module { @@ -40,14 +40,14 @@ public interface MediaModule extends Module { /** * Returns Metadata associated with the feed. - * + * * @return Returns Metadata associated with the feed. */ public Metadata getMetadata(); /** * Returns a player reference associated with the feed. - * + * * @return Returns a player reference associated with the feed. */ public PlayerReference getPlayer(); diff --git a/src/main/java/org/rometools/feed/module/mediarss/MediaModuleImpl.java b/src/main/java/org/rometools/feed/module/mediarss/MediaModuleImpl.java index ffef8f0..5b5061f 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/MediaModuleImpl.java +++ b/src/main/java/org/rometools/feed/module/mediarss/MediaModuleImpl.java @@ -31,9 +31,9 @@ import com.sun.syndication.feed.CopyFrom; import com.sun.syndication.feed.module.ModuleImpl; /** - * + * * This class represents feed/channel level elements for MediaRSS - * + * * @author cooper */ public class MediaModuleImpl extends ModuleImpl implements MediaModule, Serializable { @@ -49,7 +49,7 @@ public class MediaModuleImpl extends ModuleImpl implements MediaModule, Serializ /** * constructor that passes values up to ModuleImpl. - * + * * @param clazz * @param uri */ @@ -64,7 +64,7 @@ public class MediaModuleImpl extends ModuleImpl implements MediaModule, Serializ /** * Metadata for a feed. - * + * * @param metadata Metadata for a feed. */ public void setMetadata(final Metadata metadata) { @@ -73,7 +73,7 @@ public class MediaModuleImpl extends ModuleImpl implements MediaModule, Serializ /** * Metadata for a feed. - * + * * @return Metadata for a feed. */ @Override @@ -83,7 +83,7 @@ public class MediaModuleImpl extends ModuleImpl implements MediaModule, Serializ /** * Player for a feed. - * + * * @param player Player for a feed. */ public void setPlayer(final PlayerReference player) { @@ -92,7 +92,7 @@ public class MediaModuleImpl extends ModuleImpl implements MediaModule, Serializ /** * Player for a feed. - * + * * @return Player for a feed. */ @Override diff --git a/src/main/java/org/rometools/feed/module/mediarss/io/AlternateMediaModuleParser.java b/src/main/java/org/rometools/feed/module/mediarss/io/AlternateMediaModuleParser.java index 5ff6145..7ab4593 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/io/AlternateMediaModuleParser.java +++ b/src/main/java/org/rometools/feed/module/mediarss/io/AlternateMediaModuleParser.java @@ -12,7 +12,7 @@ package org.rometools.feed.module.mediarss.io; import org.jdom2.Namespace; /** - * + * * @author cooper */ public class AlternateMediaModuleParser extends MediaModuleParser { diff --git a/src/main/java/org/rometools/feed/module/mediarss/io/MediaModuleParser.java b/src/main/java/org/rometools/feed/module/mediarss/io/MediaModuleParser.java index 9aa8713..34f12a5 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/io/MediaModuleParser.java +++ b/src/main/java/org/rometools/feed/module/mediarss/io/MediaModuleParser.java @@ -55,7 +55,7 @@ import com.sun.syndication.io.impl.NumberParser; /** * @author Nathanial X. Freitas - * + * */ public class MediaModuleParser implements ModuleParser { private static final Logger LOG = Logger.getLogger(MediaModuleParser.class.getName()); @@ -67,7 +67,6 @@ public class MediaModuleParser implements ModuleParser { /* * (non-Javadoc) - * * @see com.sun.syndication.io.ModuleParser#getNamespaceUri() */ @Override @@ -78,7 +77,6 @@ public class MediaModuleParser implements ModuleParser { /* * (non-Javadoc) - * * @see com.sun.syndication.io.ModuleParser#parse(org.jdom2.Element) */ @Override diff --git a/src/main/java/org/rometools/feed/module/mediarss/io/RSS20YahooParser.java b/src/main/java/org/rometools/feed/module/mediarss/io/RSS20YahooParser.java index bb83961..1a736ec 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/io/RSS20YahooParser.java +++ b/src/main/java/org/rometools/feed/module/mediarss/io/RSS20YahooParser.java @@ -33,8 +33,8 @@ import com.sun.syndication.io.impl.RSS20Parser; /** * @author Nathanial X. Freitas - * - * + * + * */ public class RSS20YahooParser extends RSS20Parser { // the Yahoo Namespace URI they sometimes use in the returns for video.search.yahoo.com RSS feed @@ -53,7 +53,7 @@ public class RSS20YahooParser extends RSS20Parser { * Indicates if a JDom document is an RSS instance that can be parsed with the parser. * * It checks for RDF ("http://www.w3.org/1999/02/22-rdf-syntax-ns#") and RSS ("http://purl.org/rss/1.0/") namespaces being defined in the root element. - * + * * @param document document to check if it can be parsed with this parser implementation. * @return true if the document is RSS1., false otherwise. */ @@ -73,7 +73,7 @@ public class RSS20YahooParser extends RSS20Parser { /** * Returns the namespace used by RSS elements in document of the RSS 1.0 *- * + * * @return returns "http://purl.org/rss/1.0/". */ @Override @@ -83,7 +83,7 @@ public class RSS20YahooParser extends RSS20Parser { /** * After we parse the feed we put "rss_2.0" in it (so converters and generators work) this parser is a phantom. - * + * */ @Override protected WireFeed parseChannel(final Element rssRoot, final Locale locale) { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/AbstractSchemeValue.java b/src/main/java/org/rometools/feed/module/mediarss/types/AbstractSchemeValue.java index 80339dd..79cd482 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/AbstractSchemeValue.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/AbstractSchemeValue.java @@ -27,7 +27,7 @@ import java.io.Serializable; /** * Simple data bean parent for scheme-value type entities. - * + * * @author cooper */ public abstract class AbstractSchemeValue implements Serializable { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Category.java b/src/main/java/org/rometools/feed/module/mediarss/types/Category.java index afec0b1..3a02de0 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Category.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Category.java @@ -28,33 +28,33 @@ import com.sun.syndication.feed.impl.EqualsBean; import com.sun.syndication.feed.impl.ToStringBean; /** - * + * * <media:category>
** Allows a taxonomy to be set that gives an indication of the type of media content, and its particular contents. It has 2 optional attributes. *
- * + * ** <media:category scheme="http://search.yahoo.com/mrss/category_ * schema">music/artist/album/song</media:category> - * + * * <media:category scheme="http://dmoz.org" label="Ace Ventura - Pet * Detective">Arts/Movies/Titles/A/Ace_Ventura_Series/Ace_Ventura_ * -_Pet_Detective</media:category> - * + * * <media:category scheme="urn:flickr:tags">ycantpark * mobile</media:category> *- * + * *
* scheme is the URI that identifies the categorization scheme. It is an optional attribute. If this attribute is not included, the default scheme is * 'http://search.yahoo.com/mrss/category_schema'. *
- * + * ** label is the human readable label that can be displayed in end user applications. It is an optional attribute. *
- * + * * @author cooper */ public class Category implements Serializable { @@ -69,7 +69,7 @@ public class Category implements Serializable { /** * Creates a new instance of Category - * + * * @param scheme scheme used * @param label label for the category * @param value value of the category item @@ -82,7 +82,7 @@ public class Category implements Serializable { /** * Creates a new Category. - * + * * @param value value of the category. */ public Category(final String value) { @@ -91,7 +91,7 @@ public class Category implements Serializable { /** * label is the human readable label that can be displayed in end user applications. It is an optional attribute. - * + * * @return label is the human readable label that can be displayed in end user applications. It is an optional attribute. */ public String getLabel() { @@ -101,7 +101,7 @@ public class Category implements Serializable { /** * scheme is the URI that identifies the categorization scheme. It is an optional attribute. If this attribute is not included, the default scheme is * 'http://search.yahoo.com/mrss/category_schema'. - * + * * @return scheme is the URI that identifies the categorization scheme. It is an optional attribute. If this attribute is not included, the default scheme * is 'http://search.yahoo.com/mrss/category_schema'. */ @@ -111,7 +111,7 @@ public class Category implements Serializable { /** * value of the category - * + * * @return value of the category */ public String getValue() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Credit.java b/src/main/java/org/rometools/feed/module/mediarss/types/Credit.java index 8378b6a..5d3f28b 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Credit.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Credit.java @@ -28,32 +28,32 @@ import com.sun.syndication.feed.impl.EqualsBean; import com.sun.syndication.feed.impl.ToStringBean; /** - * + * * <media:credit> - * + * ** Notable entity and the contribution to the creation of the media object. Current entities can include people, companies, locations, etc. Specific entities * can have multiple roles, and several entities can have the same role. These should appear as distinct <media:credit> elements. It has 2 optional * attributes. *
- * + * ** <media:credit role="producer" scheme="urn:ebu">entity name</media:credit> **
* role specifies the role the entity played. Must be lowercase. It is an optional attribute. *
- * + * ** scheme is the URI that identifies the role scheme. It is an optional attribute. If this attribute is not included, the default scheme is 'urn:ebu'. * See: European Broadcasting Union Role Codes. *
- * - * + * + * ** Example roles: *
- * + * ** actor * anchor person @@ -79,7 +79,7 @@ import com.sun.syndication.feed.impl.ToStringBean; **
* Additional roles: European Broadcasting Union Role Codes - * + * * @author cooper */ public class Credit implements Serializable { @@ -94,7 +94,7 @@ public class Credit implements Serializable { /** * Creates a new instance of Credit - * + * * @param scheme schem used * @param role role name * @param name persons name @@ -111,7 +111,7 @@ public class Credit implements Serializable { /** * Person/organizations name - * + * * @return Person/organizations name */ public String getName() { @@ -120,7 +120,7 @@ public class Credit implements Serializable { /** * Role name - * + * * @return Role name */ public String getRole() { @@ -129,7 +129,7 @@ public class Credit implements Serializable { /** * Scheme used. - * + * * @return Scheme used. */ public String getScheme() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Hash.java b/src/main/java/org/rometools/feed/module/mediarss/types/Hash.java index f718a50..849a374 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Hash.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Hash.java @@ -28,22 +28,22 @@ import com.sun.syndication.feed.impl.EqualsBean; import com.sun.syndication.feed.impl.ToStringBean; /** - * + * * <media:hash>
- * + * ** This is the hash of the binary media file. It can appear multiple times as long as each instance is a different algo. It has 1 optional attribute. *
**
- * + * ** <media:hash algo="md5">dfdec888b72151965a34b4b59031290a</media:hash> *- * + * *
* algo indicates the algorithm used to create the hash. Possible values are 'md5' and 'sha-1'. Default value is 'md5'. It is an optional attribute. - * + * * @author cooper */ public class Hash extends AbstractSchemeValue implements Serializable { @@ -51,7 +51,7 @@ public class Hash extends AbstractSchemeValue implements Serializable { /** * Creates a new instance of Hash - * + * * @param algorithm algoright used * @param value value of the hash */ @@ -61,7 +61,7 @@ public class Hash extends AbstractSchemeValue implements Serializable { /** * Creates a new instance of Hash assuming the default algorithm of MD5 - * + * * @param algorithm algoright used */ public Hash(final String value) { @@ -70,7 +70,7 @@ public class Hash extends AbstractSchemeValue implements Serializable { /** * Alsorithm used for the hash - * + * * @return Alsorithm used for the hash */ public String getAlgorithm() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/MediaContent.java b/src/main/java/org/rometools/feed/module/mediarss/types/MediaContent.java index 74686d3..3821391 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/MediaContent.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/MediaContent.java @@ -33,7 +33,7 @@ import com.sun.syndication.feed.impl.ToStringBean; * in the same <media:group> element. The sequence of these items implies the order of presentation. While many of the attributes appear to be * audio/video specific, this element can be used to publish any type of media. It contains 14 attributes, most of which are optional. *
- * + * ** <media:content * url="http://www.foo.com/movie.mov" @@ -51,7 +51,7 @@ import com.sun.syndication.feed.impl.ToStringBean; * width="300" * lang="en" /> *- * + * *
* url should specify the direct url to the media object. If not included, a <media:player> element must be specified. *
@@ -61,24 +61,24 @@ import com.sun.syndication.feed.impl.ToStringBean; ** type is the standard MIME type of the object. It is an optional attribute. *
- * + * ** medium is the type of object (image | audio | video | document | executable). While this attribute can at times seem redundant if type is * supplied, it is included because it simplifies decision making on the reader side, as well as flushes out any ambiguities between MIME type and object type. * It is an optional attribute. *
- * - * + * + * ** isDefault determines if this is the default object that should be used for the <media:group>. There should only be one default object per * <media:group>. It is an optional attribute. *
- * + * ** expression determines if the object is a sample or the full version of the object, or even if it is a continuous stream (sample | full | nonstop). * Default value is 'full'. It is an optional attribute. *
- * + * ** bitrate is the kilobits per second rate of media. It is an optional attribute. *
@@ -95,31 +95,31 @@ import com.sun.syndication.feed.impl.ToStringBean; ** duration is the number of seconds the media object plays. It is an optional attribute. *
- * - * - * - * - * + * + * + * + * + * ** height is the height of the media object. It is an optional attribute. *
** width is the width of the media object. It is an optional attribute. *
- * + * ** lang is the primary language encapsulated in the media object. Language codes possible are detailed in RFC 3066. This attribute is used similar to * the xml:lang attribute detailed in the XML 1.0 Specification (Third Edition). It is an optional attribute. *
- * - * + * + * ** These optional attributes, along with the optional elements below, contain the primary metadata entries needed to index and organize media content. * Additional supported attributes for describing images, audio, and video may be added in future revisions of this document. *
- * + * * @author Nathanial X. Freitas - * + * * MediaContent corresponds to the* <media:player url="http://www.foo.com/player?id=1111" height="200" width="400" /> **
* url is the url of the player console that plays the media. It is a required attribute. *
- * + * ** height is the height of the browser window that the url should be opened in. It is an optional attribute. *
** width is the width of the browser window that the url should be opened in. It is an optional attribute. *
- * + * *- * + * * @param player PlayerReference for the item. */ public void setPlayer(final PlayerReference player) { @@ -421,21 +421,21 @@ public class MediaContent implements Serializable { * Allows the media object to be accessed through a web browser media player console. This element is required only if a direct media url attribute * is not specified in the <media:content> element. It has 1 required attribute, and 2 optional attributes. *
- * + * ** <media:player url="http://www.foo.com/player?id=1111" height="200" width="400" /> **
* url is the url of the player console that plays the media. It is a required attribute. *
- * + * ** height is the height of the browser window that the url should be opened in. It is an optional attribute. *
** width is the width of the browser window that the url should be opened in. It is an optional attribute. *
- * + * * @return PlayerReference for the item. */ public PlayerReference getPlayer() { @@ -444,7 +444,7 @@ public class MediaContent implements Serializable { /** * The player or URL reference for the item - * + * * @param reference The player or URL reference for the item */ public void setReference(final Reference reference) { @@ -457,7 +457,7 @@ public class MediaContent implements Serializable { /** * The player or URL reference for the item - * + * * @return The player or URL reference for the item */ public Reference getReference() { @@ -467,7 +467,7 @@ public class MediaContent implements Serializable { /** * samplingrate is the number of samples per second taken to create the media object. It is expressed in thousands of samples per second (kHz). It is an * optional attribute. - * + * * @param samplingrate samplingrate is the number of samples per second taken to create the media object. It is expressed in thousands of samples per second * (kHz). It is an optional attribute. */ @@ -478,7 +478,7 @@ public class MediaContent implements Serializable { /** * samplingrate is the number of samples per second taken to create the media object. It is expressed in thousands of samples per second (kHz). It is an * optional attribute. - * + * * @return samplingrate is the number of samples per second taken to create the media object. It is expressed in thousands of samples per second (kHz). It * is an optional attribute. */ @@ -487,9 +487,9 @@ public class MediaContent implements Serializable { } /** - * + * * type is the standard MIME type of the object. It is an optional attribute. - * + * * @param type The type to set. */ public void setType(final String type) { @@ -497,9 +497,9 @@ public class MediaContent implements Serializable { } /** - * + * * type is the standard MIME type of the object. It is an optional attribute. - * + * * @return Returns the type. */ public String getType() { @@ -508,7 +508,7 @@ public class MediaContent implements Serializable { /** * width is the width of the media object. It is an optional attribute. - * + * * @param width width is the width of the media object. It is an optional attribute. */ public void setWidth(final Integer width) { @@ -517,7 +517,7 @@ public class MediaContent implements Serializable { /** * width is the width of the media object. It is an optional attribute. - * + * * @return width is the width of the media object. It is an optional attribute. */ public Integer getWidth() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/MediaGroup.java b/src/main/java/org/rometools/feed/module/mediarss/types/MediaGroup.java index 3a2631f..4ad7909 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/MediaGroup.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/MediaGroup.java @@ -35,7 +35,7 @@ import com.sun.syndication.feed.impl.ToStringBean; * different representations. For instance: the same song recorded in both the WAV and MP3 format. It's an optional element that must only be used for this * purpose. * - * + * * @author cooper */ public class MediaGroup implements Cloneable, Serializable { @@ -47,7 +47,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Creates a new instance of MediaGroup - * + * * @param contents Contents of the group. */ public MediaGroup(final MediaContent[] contents) { @@ -56,7 +56,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Creates a new instance of MediaGroup - * + * * @param contents contents of the group * @param defaultContentIndex index of the default content value. */ @@ -67,7 +67,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Creates a new instance of MediaGroup - * + * * @param contents contents of the group * @param defaultContentIndex index of the default content item. * @param metadata metadata for the group. @@ -80,7 +80,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * MediaContents for the group - * + * * @param contents MediaContents for the group */ public void setContents(final MediaContent[] contents) { @@ -89,7 +89,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * MediaContents for the group - * + * * @return MediaContents for the group */ public MediaContent[] getContents() { @@ -98,7 +98,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Default content index MediaContent. - * + * * @param defaultContentIndex Default content index MediaContent. */ public void setDefaultContentIndex(final Integer defaultContentIndex) { @@ -115,7 +115,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Default content index MediaContent. - * + * * @return Default content index MediaContent. */ public Integer getDefaultContentIndex() { @@ -124,7 +124,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Metadata for the group - * + * * @param metadata Metadata for the group */ public void setMetadata(final Metadata metadata) { @@ -133,7 +133,7 @@ public class MediaGroup implements Cloneable, Serializable { /** * Metadata for the group - * + * * @return Metadata for the group */ public Metadata getMetadata() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Metadata.java b/src/main/java/org/rometools/feed/module/mediarss/types/Metadata.java index d32c3da..ba1bac9 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Metadata.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Metadata.java @@ -30,29 +30,29 @@ import com.sun.syndication.feed.impl.EqualsBean; import com.sun.syndication.feed.impl.ToStringBean; /** - * - * - * + * + * + * * Optional Elements ** The following elements are optional and may appear as sub-elements of <channel>, <item>, <media:content> and/or <media:group>. - * - * + * + * *
*- * + * * When an element appears at a shallow level, such as <channel> or <item>, it means that the element should be applied to every media object within * its scope. *
- * - * + * + * ** Duplicated elements appearing at deeper levels of the document tree have higher priority over other levels. - * + * * For example, <media:content> level elements are favored over <item> level elements. The priority level is listed from strongest to weakest: * <media:content>, <media:group>, <item>, <channel>. *
- * + * * @author cooper */ public class Metadata implements Cloneable, Serializable { @@ -83,28 +83,28 @@ public class Metadata implements Cloneable, Serializable { ** Allows a taxonomy to be set that gives an indication of the type of media content, and its particular contents. It has 2 optional attributes. *
- * + * ** <media:category scheme="http://search.yahoo.com/mrss/category_ * schema">music/artist/album/song</media:category> - * + * * <media:category scheme="http://dmoz.org" label="Ace Ventura - Pet * Detective">Arts/Movies/Titles/A/Ace_Ventura_Series/Ace_Ventura_ * -_Pet_Detective</media:category> - * + * * <media:category scheme="urn:flickr:tags">ycantpark * mobile</media:category> *- * + * *
* scheme is the URI that identifies the categorization scheme. It is an optional attribute. If this attribute is not included, the default scheme * is 'http://search.yahoo.com/mrss/category_schema'. *
- * + * ** label is the human readable label that can be displayed in end user applications. It is an optional attribute. *
- * + * * @param categories categories for the item */ public void setCategories(final Category[] categories) { @@ -116,28 +116,28 @@ public class Metadata implements Cloneable, Serializable { ** Allows a taxonomy to be set that gives an indication of the type of media content, and its particular contents. It has 2 optional attributes. *
- * + * ** <media:category scheme="http://search.yahoo.com/mrss/category_ * schema">music/artist/album/song</media:category> - * + * * <media:category scheme="http://dmoz.org" label="Ace Ventura - Pet * Detective">Arts/Movies/Titles/A/Ace_Ventura_Series/Ace_Ventura_ * -_Pet_Detective</media:category> - * + * * <media:category scheme="urn:flickr:tags">ycantpark * mobile</media:category> *- * + * *
* scheme is the URI that identifies the categorization scheme. It is an optional attribute. If this attribute is not included, the default scheme * is 'http://search.yahoo.com/mrss/category_schema'. *
- * + * ** label is the human readable label that can be displayed in end user applications. It is an optional attribute. *
- * + * * @return categories for the item. */ public Category[] getCategories() { @@ -149,7 +149,7 @@ public class Metadata implements Cloneable, Serializable { ** Copyright information for media object. It has 1 optional attribute. *
- * + * ** <media:copyright url="http://blah.com/additional-info.html">2005 FooBar Media</media:copyright> *@@ -157,7 +157,7 @@ public class Metadata implements Cloneable, Serializable { * url is the url for a terms of use page or additional copyright information. If the media is operating under a Creative Commons license, the * Creative Commons module should be used instead. It is an optional attribute. * - * + * * @param copyright copyright text */ public void setCopyright(final String copyright) { @@ -169,7 +169,7 @@ public class Metadata implements Cloneable, Serializable { *
* Copyright information for media object. It has 1 optional attribute. *
- * + * ** <media:copyright url="http://blah.com/additional-info.html">2005 FooBar Media</media:copyright> *@@ -177,7 +177,7 @@ public class Metadata implements Cloneable, Serializable { * url is the url for a terms of use page or additional copyright information. If the media is operating under a Creative Commons license, the * Creative Commons module should be used instead. It is an optional attribute. * - * + * * @return Copyright text */ public String getCopyright() { @@ -189,7 +189,7 @@ public class Metadata implements Cloneable, Serializable { *
* Copyright information for media object. It has 1 optional attribute. *
- * + * ** <media:copyright url="http://blah.com/additional-info.html">2005 FooBar Media</media:copyright> *@@ -197,7 +197,7 @@ public class Metadata implements Cloneable, Serializable { * url is the url for a terms of use page or additional copyright information. If the media is operating under a Creative Commons license, the * Creative Commons module should be used instead. It is an optional attribute. * - * + * * @param copyrightUrl link to more copyright information. */ public void setCopyrightUrl(final URI copyrightUrl) { @@ -209,7 +209,7 @@ public class Metadata implements Cloneable, Serializable { *
* Copyright information for media object. It has 1 optional attribute. *
- * + * ** <media:copyright url="http://blah.com/additional-info.html">2005 FooBar Media</media:copyright> *@@ -217,7 +217,7 @@ public class Metadata implements Cloneable, Serializable { * url is the url for a terms of use page or additional copyright information. If the media is operating under a Creative Commons license, the * Creative Commons module should be used instead. It is an optional attribute. * - * + * * @return Link to more copyright information. */ public URI getCopyrightUrl() { @@ -226,30 +226,30 @@ public class Metadata implements Cloneable, Serializable { /** * <media:credit> - * + * *
* Notable entity and the contribution to the creation of the media object. Current entities can include people, companies, locations, etc. Specific * entities can have multiple roles, and several entities can have the same role. These should appear as distinct <media:credit> elements. It has 2 * optional attributes. *
- * + * ** <media:credit role="producer" scheme="urn:ebu">entity name</media:credit> **
* role specifies the role the entity played. Must be lowercase. It is an optional attribute. *
- * + * ** scheme is the URI that identifies the role scheme. It is an optional attribute. If this attribute is not included, the default scheme is * 'urn:ebu'. See: European Broadcasting Union Role Codes. *
- * - * + * + * ** Example roles: *
- * + * ** actor * anchor person @@ -275,7 +275,7 @@ public class Metadata implements Cloneable, Serializable { **
* Additional roles: European Broadcasting Union Role Codes - * + * * @param credits credits for the item. */ public void setCredits(final Credit[] credits) { @@ -284,30 +284,30 @@ public class Metadata implements Cloneable, Serializable { /** * <media:credit>
- * + * ** Notable entity and the contribution to the creation of the media object. Current entities can include people, companies, locations, etc. Specific * entities can have multiple roles, and several entities can have the same role. These should appear as distinct <media:credit> elements. It has 2 * optional attributes. *
- * + * ** <media:credit role="producer" scheme="urn:ebu">entity name</media:credit> **
* role specifies the role the entity played. Must be lowercase. It is an optional attribute. *
- * + * ** scheme is the URI that identifies the role scheme. It is an optional attribute. If this attribute is not included, the default scheme is * 'urn:ebu'. See: European Broadcasting Union Role Codes. *
- * - * + * + * ** Example roles: *
- * + * ** actor * anchor person @@ -333,7 +333,7 @@ public class Metadata implements Cloneable, Serializable { **
* Additional roles: European Broadcasting Union Role Codes - * + * * @return credits for the time. */ public Credit[] getCredits() { @@ -345,7 +345,7 @@ public class Metadata implements Cloneable, Serializable { *
* Short description describing the media object typically a sentence in length. It has 1 optional attribute. *
- * + * ** <media:description type="plain">This was some really bizarre band I listened to as a young lad.</media:description> *@@ -353,7 +353,7 @@ public class Metadata implements Cloneable, Serializable { * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. * - * + * * @param description value of the description */ public void setDescription(final String description) { @@ -365,7 +365,7 @@ public class Metadata implements Cloneable, Serializable { *
* Short description describing the media object typically a sentence in length. It has 1 optional attribute. *
- * + * ** <media:description type="plain">This was some really bizarre band I listened to as a young lad.</media:description> *@@ -373,7 +373,7 @@ public class Metadata implements Cloneable, Serializable { * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. * - * + * * @return value of the description */ public String getDescription() { @@ -385,7 +385,7 @@ public class Metadata implements Cloneable, Serializable { *
* Short description describing the media object typically a sentence in length. It has 1 optional attribute. *
- * + * ** <media:description type="plain">This was some really bizarre band I listened to as a young lad.</media:description> *@@ -393,7 +393,7 @@ public class Metadata implements Cloneable, Serializable { * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. * - * + * * @param descriptionType type of the description. */ public void setDescriptionType(final String descriptionType) { @@ -405,7 +405,7 @@ public class Metadata implements Cloneable, Serializable { *
* Short description describing the media object typically a sentence in length. It has 1 optional attribute. *
- * + * ** <media:description type="plain">This was some really bizarre band I listened to as a young lad.</media:description> *@@ -413,7 +413,7 @@ public class Metadata implements Cloneable, Serializable { * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. * - * + * * @return type of the description */ public String getDescriptionType() { @@ -422,22 +422,22 @@ public class Metadata implements Cloneable, Serializable { /** * <media:hash> - * + * *
* This is the hash of the binary media file. It can appear multiple times as long as each instance is a different algo. It has 1 optional * attribute. *
**
- * + * ** <media:hash algo="md5">dfdec888b72151965a34b4b59031290a</media:hash> *- * + * *
* algo indicates the algorithm used to create the hash. Possible values are 'md5' and 'sha-1'. Default value is 'md5'. It is an optional * attribute. - * + * * @param hash sets the hash for the item. */ public void setHash(final Hash hash) { @@ -446,22 +446,22 @@ public class Metadata implements Cloneable, Serializable { /** * <media:hash>
- * + * ** This is the hash of the binary media file. It can appear multiple times as long as each instance is a different algo. It has 1 optional * attribute. *
**
- * + * ** <media:hash algo="md5">dfdec888b72151965a34b4b59031290a</media:hash> *- * + * *
* algo indicates the algorithm used to create the hash. Possible values are 'md5' and 'sha-1'. Default value is 'md5'. It is an optional * attribute. - * + * * @return returns a Hash object for the item. */ public Hash getHash() { @@ -473,11 +473,11 @@ public class Metadata implements Cloneable, Serializable { *
* Highly relevant keywords describing the media object with typically a maximum of ten words. The keywords and phrases should be comma delimited. *
- * + * ** <media:keywords>kitty, cat, big dog, yarn, fluffy</media:keywords> *- * + * * @param keywords Array of keywords */ public void setKeywords(final String[] keywords) { @@ -489,11 +489,11 @@ public class Metadata implements Cloneable, Serializable { *
* Highly relevant keywords describing the media object with typically a maximum of ten words. The keywords and phrases should be comma delimited. *
- * + * ** <media:keywords>kitty, cat, big dog, yarn, fluffy</media:keywords> *- * + * * @return Array of keywords */ public String[] getKeywords() { @@ -502,29 +502,29 @@ public class Metadata implements Cloneable, Serializable { /** * <media:rating> - * - * + * + * *
* This allows the permissible audience to be declared. If this element is not included, it assumes that no restrictions are necessary. It has one optional * attribute. *
- * + * ** <media:rating scheme="urn:simple">adult</media:rating> * <media:rating scheme="urn:icra">r (cz 1 lz 1 nz 1 oz 1 vz 1)</media:rating> * <media:rating scheme="urn:mpaa">pg</media:rating> - * + * * <media:rating scheme="urn:v-chip">tv-y7-fv</media:rating> *- * - * + * + * *
* scheme is the URI that identifies the rating scheme. It is an optional attribute. If this attribute is not included, the default scheme is * urn:simple (adult | nonadult). *
- * + * *- * + * * @param ratings Ratings objects */ public void setRatings(final Rating[] ratings) { @@ -533,29 +533,29 @@ public class Metadata implements Cloneable, Serializable { /** * <media:rating>
- * - * + * + * ** This allows the permissible audience to be declared. If this element is not included, it assumes that no restrictions are necessary. It has one optional * attribute. *
- * + * ** <media:rating scheme="urn:simple">adult</media:rating> * <media:rating scheme="urn:icra">r (cz 1 lz 1 nz 1 oz 1 vz 1)</media:rating> * <media:rating scheme="urn:mpaa">pg</media:rating> - * + * * <media:rating scheme="urn:v-chip">tv-y7-fv</media:rating> *- * - * + * + * *
* scheme is the URI that identifies the rating scheme. It is an optional attribute. If this attribute is not included, the default scheme is * urn:simple (adult | nonadult). *
- * + * *- * + * * @return Ratings objects */ public Rating[] getRatings() { @@ -564,7 +564,7 @@ public class Metadata implements Cloneable, Serializable { /** * <media:restriction>
- * + * ** Allows restrictions to be placed on the aggregator rendering the media in the feed. Currently, restrictions are based on distributor (uri) and country * codes. This element is purely informational and no obligation can be assumed or implied. Only one <media:restriction> element of the same @@ -572,16 +572,16 @@ public class Metadata implements Cloneable, Serializable { * producer to explicitly declare his/her intentions, two literals are reserved: 'all', 'none'. These literals can only be used once. This element has 1 * required attribute, and 1 optional attribute (with strict requirements for its exclusion). *
- * + * ** <media:restriction relationship="allow" type="country">au us</media:restriction> *- * + * *
* relationship indicates the type of relationship that the restriction represents (allow | deny). In the example above, the media object should * only be syndicated in Australia and the United States. It is a required attribute. *
- * + * * @param restrictions restrictions for the item. */ public void setRestrictions(final Restriction[] restrictions) { @@ -590,7 +590,7 @@ public class Metadata implements Cloneable, Serializable { /** * <media:restriction> - * + * ** Allows restrictions to be placed on the aggregator rendering the media in the feed. Currently, restrictions are based on distributor (uri) and country * codes. This element is purely informational and no obligation can be assumed or implied. Only one <media:restriction> element of the same @@ -598,16 +598,16 @@ public class Metadata implements Cloneable, Serializable { * producer to explicitly declare his/her intentions, two literals are reserved: 'all', 'none'. These literals can only be used once. This element has 1 * required attribute, and 1 optional attribute (with strict requirements for its exclusion). *
- * + * ** <media:restriction relationship="allow" type="country">au us</media:restriction> *- * + * *
* relationship indicates the type of relationship that the restriction represents (allow | deny). In the example above, the media object should * only be syndicated in Australia and the United States. It is a required attribute. *
- * + * * @return restrictions for the item. */ public Restriction[] getRestrictions() { @@ -621,11 +621,11 @@ public class Metadata implements Cloneable, Serializable { * series of text. In such cases, it is encouraged, but not required, that the elements be grouped by language and appear in time sequence order based on * the start time. Elements can have overlapping start and end times. It has 4 optional attributes. * - * + * ** <media:text type="plain" lang="en" start="00:00:03.000" * end="00:00:10.000"> Oh, say, can you see</media:text> - * + * * <media:text type="plain" lang="en" start="00:00:10.000" * end="00:00:17.000">By the dawn's early light</media:text> *@@ -633,26 +633,26 @@ public class Metadata implements Cloneable, Serializable { * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. * - * - * - * - * - * - * + * + * + * + * + * + * *
* lang is the primary language encapsulated in the media object. Language codes possible are detailed in RFC 3066. This attribute is used similar * to the xml:lang attribute detailed in the XML 1.0 Specification (Third Edition). It is an optional attribute. *
- * + * ** start specifies the start time offset that the text starts being relevant to the media object. An example of this would be for closed * captioning. It uses the NTP time code format (see: the time attribute used in <media:thumbnail>). It is an optional attribute. *
- * + * ** end specifies the end time that the text is relevant. If this attribute is not provided, and a start time is used, it is expected that * the end time is either the end of the clip or the start of the next <media:text> element. - * + * * @param text text objects for the item. */ public void setText(final Text[] text) { @@ -666,11 +666,11 @@ public class Metadata implements Cloneable, Serializable { * series of text. In such cases, it is encouraged, but not required, that the elements be grouped by language and appear in time sequence order based on * the start time. Elements can have overlapping start and end times. It has 4 optional attributes. *
- * + * ** <media:text type="plain" lang="en" start="00:00:03.000" * end="00:00:10.000"> Oh, say, can you see</media:text> - * + * * <media:text type="plain" lang="en" start="00:00:10.000" * end="00:00:17.000">By the dawn's early light</media:text> *@@ -678,26 +678,26 @@ public class Metadata implements Cloneable, Serializable { * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. * - * - * - * - * - * - * + * + * + * + * + * + * *
* lang is the primary language encapsulated in the media object. Language codes possible are detailed in RFC 3066. This attribute is used similar * to the xml:lang attribute detailed in the XML 1.0 Specification (Third Edition). It is an optional attribute. *
- * + * ** start specifies the start time offset that the text starts being relevant to the media object. An example of this would be for closed * captioning. It uses the NTP time code format (see: the time attribute used in <media:thumbnail>). It is an optional attribute. *
- * + * ** end specifies the end time that the text is relevant. If this attribute is not provided, and a start time is used, it is expected that * the end time is either the end of the clip or the start of the next <media:text> element. - * + * * @return Text objects for the item. */ public Text[] getText() { @@ -706,17 +706,17 @@ public class Metadata implements Cloneable, Serializable { /** * <media:thumbnail>
- * - * + * + * ** Allows particular images to be used as representative images for the media object. If multiple thumbnails are included, and time coding is not at play, * it is assumed that the images are in order of importance. It has 1 required attribute and 3 optional attributes. *
- * - * - * - * - * + * + * + * + * + * ** <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123" /> *@@ -729,14 +729,14 @@ public class Metadata implements Cloneable, Serializable { *
* width specifies the width of the thumbnail. It is an optional attribute. *
- * - * + * + * ** time specifies the time offset in relation to the media object. Typically this is used when creating multiple keyframes within a single video. * The format for this attribute should be in the DSM-CC's Normal Play Time (NTP) as used in RTSP [RFC 2326 * 3.6 Normal Play Time]. It is an optional attribute. *
- * + * * @param thumbnail thumbnails for the image */ public void setThumbnail(final Thumbnail[] thumbnail) { @@ -745,17 +745,17 @@ public class Metadata implements Cloneable, Serializable { /** * <media:thumbnail> - * - * + * + * ** Allows particular images to be used as representative images for the media object. If multiple thumbnails are included, and time coding is not at play, * it is assumed that the images are in order of importance. It has 1 required attribute and 3 optional attributes. *
- * - * - * - * - * + * + * + * + * + * ** <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123" /> *@@ -768,14 +768,14 @@ public class Metadata implements Cloneable, Serializable { *
* width specifies the width of the thumbnail. It is an optional attribute. *
- * - * + * + * ** time specifies the time offset in relation to the media object. Typically this is used when creating multiple keyframes within a single video. * The format for this attribute should be in the DSM-CC's Normal Play Time (NTP) as used in RTSP [RFC 2326 * 3.6 Normal Play Time]. It is an optional attribute. *
- * + * * @return Thumbnails for the image */ public Thumbnail[] getThumbnail() { @@ -787,16 +787,16 @@ public class Metadata implements Cloneable, Serializable { ** The title of the particular media object. It has 1 optional attribute. *
- * + * ** <media:title type="plain">The Judy's - The Moo Song</media:title> *- * + * *
* type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. *
- * + * * @param title Value of the title */ public void setTitle(final String title) { @@ -808,16 +808,16 @@ public class Metadata implements Cloneable, Serializable { ** The title of the particular media object. It has 1 optional attribute. *
- * + * ** <media:title type="plain">The Judy's - The Moo Song</media:title> *- * + * *
* type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. *
- * + * * @return value of the title. */ public String getTitle() { @@ -829,16 +829,16 @@ public class Metadata implements Cloneable, Serializable { ** The title of the particular media object. It has 1 optional attribute. *
- * + * ** <media:title type="plain">The Judy's - The Moo Song</media:title> *- * + * *
* type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. *
- * + * * @param titleType type of the title. */ public void setTitleType(final String titleType) { @@ -850,16 +850,16 @@ public class Metadata implements Cloneable, Serializable { ** The title of the particular media object. It has 1 optional attribute. *
- * + * ** <media:title type="plain">The Judy's - The Moo Song</media:title> *- * + * *
* type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be * entity-encoded. It is an optional attribute. *
- * + * * @return type of the title */ public String getTitleType() { @@ -871,7 +871,7 @@ public class Metadata implements Cloneable, Serializable { ** Copyright information for media object. It has 1 optional attribute. *
- * + * ** <media:copyright url="http://blah.com/additional-info.html">2005 FooBar Media</media:copyright> *@@ -879,7 +879,7 @@ public class Metadata implements Cloneable, Serializable { * url is the url for a terms of use page or additional copyright information. If the media is operating under a Creative Commons license, the * Creative Commons module should be used instead. It is an optional attribute. * - * + * * @return Link to more copyright information. */ @Override diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/PlayerReference.java b/src/main/java/org/rometools/feed/module/mediarss/types/PlayerReference.java index 6dee0d3..b8893f5 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/PlayerReference.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/PlayerReference.java @@ -29,27 +29,27 @@ import com.sun.syndication.feed.impl.EqualsBean; import com.sun.syndication.feed.impl.ToStringBean; /** - * + * * <media:player> *
* Allows the media object to be accessed through a web browser media player console. This element is required only if a direct media url attribute is * not specified in the <media:content> element. It has 1 required attribute, and 2 optional attributes. *
- * + * ** <media:player url="http://www.foo.com/player?id=1111" height="200" width="400" /> **
* url is the url of the player console that plays the media. It is a required attribute. *
- * + * ** height is the height of the browser window that the url should be opened in. It is an optional attribute. *
** width is the width of the browser window that the url should be opened in. It is an optional attribute. *
- * + * * @author cooper */ public class PlayerReference implements Reference, Serializable { @@ -61,7 +61,7 @@ public class PlayerReference implements Reference, Serializable { /** * Creates a new instance of PlayerReference - * + * * @param url url of the player * @param width width of the player * @param height height of the player @@ -80,7 +80,7 @@ public class PlayerReference implements Reference, Serializable { /** * Constructs a new PlayerReference - * + * * @param url URL of the player */ public PlayerReference(final URI url) { @@ -89,7 +89,7 @@ public class PlayerReference implements Reference, Serializable { /** * Height of the player - * + * * @return Height of the player */ public Integer getHeight() { @@ -98,7 +98,7 @@ public class PlayerReference implements Reference, Serializable { /** * URL of the player - * + * * @return URL of the player */ public URI getUrl() { @@ -107,7 +107,7 @@ public class PlayerReference implements Reference, Serializable { /** * Width of the player - * + * * @return Width of the player */ public Integer getWidth() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Rating.java b/src/main/java/org/rometools/feed/module/mediarss/types/Rating.java index f2c16e5..bb25729 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Rating.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Rating.java @@ -27,29 +27,29 @@ import com.sun.syndication.feed.impl.ToStringBean; /** * <media:rating> - * - * + * + * ** This allows the permissible audience to be declared. If this element is not included, it assumes that no restrictions are necessary. It has one optional * attribute. *
- * + * ** <media:rating scheme="urn:simple">adult</media:rating> * <media:rating scheme="urn:icra">r (cz 1 lz 1 nz 1 oz 1 vz 1)</media:rating> * <media:rating scheme="urn:mpaa">pg</media:rating> - * + * * <media:rating scheme="urn:v-chip">tv-y7-fv</media:rating> *- * - * + * + * *
* scheme is the URI that identifies the rating scheme. It is an optional attribute. If this attribute is not included, the default scheme is * urn:simple (adult | nonadult). *
- * + * * For compatibility, a medai:adult tag will appear in the ratings as a urn:simple equiv. - * + * * @author cooper */ public class Rating extends AbstractSchemeValue { @@ -67,7 +67,7 @@ public class Rating extends AbstractSchemeValue { /** * Constructs a new Rating object. - * + * * @param scheme scheme used for the rating * @param value value of the rating. */ @@ -76,7 +76,7 @@ public class Rating extends AbstractSchemeValue { } /** - * + * * @param obj * @return */ @@ -88,7 +88,7 @@ public class Rating extends AbstractSchemeValue { } /** - * + * * @return */ @Override @@ -99,7 +99,7 @@ public class Rating extends AbstractSchemeValue { } /** - * + * * @return */ @Override diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Reference.java b/src/main/java/org/rometools/feed/module/mediarss/types/Reference.java index 9039863..7302822 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Reference.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Reference.java @@ -24,7 +24,7 @@ package org.rometools.feed.module.mediarss.types; /** * This class is an idenfier for UrlReference and PlayerReference and is required for constructing a MediaContent object. - * + * * @author cooper */ public interface Reference { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Restriction.java b/src/main/java/org/rometools/feed/module/mediarss/types/Restriction.java index f6cfc74..5da3149 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Restriction.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Restriction.java @@ -29,7 +29,7 @@ import com.sun.syndication.feed.impl.ToStringBean; /** * <media:restriction> - * + * ** Allows restrictions to be placed on the aggregator rendering the media in the feed. Currently, restrictions are based on distributor (uri) and country codes. * This element is purely informational and no obligation can be assumed or implied. Only one <media:restriction> element of the same type can be @@ -37,16 +37,16 @@ import com.sun.syndication.feed.impl.ToStringBean; * his/her intentions, two literals are reserved: 'all', 'none'. These literals can only be used once. This element has 1 required attribute, and 1 optional * attribute (with strict requirements for its exclusion). *
- * + * ** <media:restriction relationship="allow" type="country">au us</media:restriction> *- * + * *
* relationship indicates the type of relationship that the restriction represents (allow | deny). In the example above, the media object should only * be syndicated in Australia and the United States. It is a required attribute. *
- * + * ** Note: If the "allow" element is empty and the type is relationship is "allow", it is assumed that the empty list means "allow nobody" and * the media should not be syndicated. @@ -54,22 +54,22 @@ import com.sun.syndication.feed.impl.ToStringBean; *
* A more explicit method would be: *
- * + * ** <media:restriction relationship="allow" type="country">au us</media:restriction> *- * + * *
* type specifies the type of restriction (country | uri) that the media can be syndicated. It is an optional attribute; however can only be excluded * when using one of the literal values "all" or "none". *
- * + * ** "country" allows restrictions to be placed based on country code. [ISO 3166] *
** "uri" allows restrictions based on URI. Examples: urn:apple, http://images.google.com, urn:yahoo, etc. - * + * * @author cooper */ public class Restriction implements Serializable { @@ -81,7 +81,7 @@ public class Restriction implements Serializable { /** * Creates a new instance of Restriction - * + * * @param relationship a Restriction.Relationship object * @param type A Restriction.Type object * @param value a value for the restriction. diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Text.java b/src/main/java/org/rometools/feed/module/mediarss/types/Text.java index c557335..3e794af 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Text.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Text.java @@ -34,11 +34,11 @@ import com.sun.syndication.feed.impl.ToStringBean; * of text. In such cases, it is encouraged, but not required, that the elements be grouped by language and appear in time sequence order based on the * start time. Elements can have overlapping start and end times. It has 4 optional attributes. *
- * + * ** <media:text type="plain" lang="en" start="00:00:03.000" * end="00:00:10.000"> Oh, say, can you see</media:text> - * + * * <media:text type="plain" lang="en" start="00:00:10.000" * end="00:00:17.000">By the dawn's early light</media:text> *@@ -46,27 +46,27 @@ import com.sun.syndication.feed.impl.ToStringBean; * type specifies the type of text embedded. Possible values are either 'plain' or 'html'. Default value is 'plain'. All html must be entity-encoded. * It is an optional attribute. * - * - * - * - * - * - * + * + * + * + * + * + * *
* lang is the primary language encapsulated in the media object. Language codes possible are detailed in RFC 3066. This attribute is used similar to * the xml:lang attribute detailed in the XML 1.0 Specification (Third Edition). It is an optional attribute. *
- * + * ** start specifies the start time offset that the text starts being relevant to the media object. An example of this would be for closed captioning. It * uses the NTP time code format (see: the time attribute used in <media:thumbnail>). It is an optional attribute. *
- * + * ** end specifies the end time that the text is relevant. If this attribute is not provided, and a start time is used, it is expected that the * end time is either the end of the clip or the start of the next <media:text> element. *
- * + * * @author cooper */ public class Text implements Serializable { @@ -78,7 +78,7 @@ public class Text implements Serializable { /** * Creates a text object. - * + * * @param value value of the text */ public Text(final String value) { @@ -87,7 +87,7 @@ public class Text implements Serializable { /** * Creates a new instance of Text - * + * * @param type type of text * @param value value of text */ @@ -98,7 +98,7 @@ public class Text implements Serializable { /** * Creates a text object with start and end times - * + * * @param type type of text * @param value value of text * @param start start time @@ -112,7 +112,7 @@ public class Text implements Serializable { /** * End time of the text - * + * * @return End time of the text */ public Time getEnd() { @@ -121,7 +121,7 @@ public class Text implements Serializable { /** * Start time of the text - * + * * @return Start time of the text */ public Time getStart() { @@ -130,7 +130,7 @@ public class Text implements Serializable { /** * type of the text - * + * * @return type of the text */ public String getType() { @@ -139,7 +139,7 @@ public class Text implements Serializable { /** * Value of the text - * + * * @return type of the text */ public String getValue() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Thumbnail.java b/src/main/java/org/rometools/feed/module/mediarss/types/Thumbnail.java index 6b0393b..c4e7cb3 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Thumbnail.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Thumbnail.java @@ -29,17 +29,17 @@ import com.sun.syndication.feed.impl.ToStringBean; /** * <media:thumbnail> - * - * + * + * ** Allows particular images to be used as representative images for the media object. If multiple thumbnails are included, and time coding is not at play, it is * assumed that the images are in order of importance. It has 1 required attribute and 3 optional attributes. *
- * - * - * - * - * + * + * + * + * + * ** <media:thumbnail url="http://www.foo.com/keyframe.jpg" width="75" height="50" time="12:05:01.123" /> *@@ -52,8 +52,8 @@ import com.sun.syndication.feed.impl.ToStringBean; *
* width specifies the width of the thumbnail. It is an optional attribute. *
- * - * + * + * ** time specifies the time offset in relation to the media object. Typically this is used when creating multiple keyframes within a single video. The * format for this attribute should be in the DSM-CC's Normal Play Time (NTP) as used in RTSP [RFC 2326 3.6 Normal @@ -70,7 +70,7 @@ public class Thumbnail implements Cloneable, Serializable { /** * Creates a new thumbnail - * + * * @param url URL to thumbnail * @param width width in pixels * @param height height in pixels @@ -85,7 +85,7 @@ public class Thumbnail implements Cloneable, Serializable { /** * Creates a new thumbnail - * + * * @param url URL * @param width width * @param height height @@ -96,7 +96,7 @@ public class Thumbnail implements Cloneable, Serializable { /** * Creates a new thumbnail - * + * * @param url URL */ public Thumbnail(final URI url) { @@ -104,9 +104,9 @@ public class Thumbnail implements Cloneable, Serializable { } /** - * + * * Returns the thumbHeight. - * + * * @return Returns the thumbHeight. */ public Integer getHeight() { @@ -115,7 +115,7 @@ public class Thumbnail implements Cloneable, Serializable { /** * returns the time that the thumbnail was captured from its source - * + * * @return returns the time that the thumbnail was captured from its source */ public Time getTime() { @@ -123,9 +123,9 @@ public class Thumbnail implements Cloneable, Serializable { } /** - * + * * Retursn the URL - * + * * @return Returns the thumbUrl. */ public URI getUrl() { @@ -133,9 +133,9 @@ public class Thumbnail implements Cloneable, Serializable { } /** - * + * * Returns width. - * + * * @return Returns the thumbWidth. */ public Integer getWidth() { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/Time.java b/src/main/java/org/rometools/feed/module/mediarss/types/Time.java index 3fd26b4..55c4e00 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/Time.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/Time.java @@ -29,7 +29,7 @@ import com.sun.syndication.feed.impl.EqualsBean; /** * Represents a RFC 2326 3.6 Normal Play Time timestamp. - * + * * @author cooper */ public class Time implements Serializable { @@ -48,7 +48,7 @@ public class Time implements Serializable { /** * Creates a new instance of Time - * + * * @param milliseconds milliseconds in length or offset. */ public Time(final long milliseconds) { @@ -57,7 +57,7 @@ public class Time implements Serializable { /** * Creates a new instance of Time - * + * * @param value RFC 2326 3.6 Normal Play Time value */ public Time(final String value) { diff --git a/src/main/java/org/rometools/feed/module/mediarss/types/UrlReference.java b/src/main/java/org/rometools/feed/module/mediarss/types/UrlReference.java index 3240a85..c3aa720 100644 --- a/src/main/java/org/rometools/feed/module/mediarss/types/UrlReference.java +++ b/src/main/java/org/rometools/feed/module/mediarss/types/UrlReference.java @@ -31,7 +31,7 @@ import com.sun.syndication.feed.impl.EqualsBean; /** * Used to indicate a URL primary reference for a MediaContent object. - * + * * @author cooper */ public class UrlReference implements Reference, Serializable { @@ -41,7 +41,7 @@ public class UrlReference implements Reference, Serializable { /** * Creates a new UrlReference. - * + * * @param url URL to the media source */ public UrlReference(final URI url) { @@ -54,7 +54,7 @@ public class UrlReference implements Reference, Serializable { /** * Creates a new instance of UrlReference - * + * * @param url String value of a URL * @throws java.net.MalformedURLException thrown on bad URLs */ @@ -70,7 +70,7 @@ public class UrlReference implements Reference, Serializable { /** * Returns the URL value - * + * * @return Returns the URL value */ public URI getUrl() { diff --git a/src/main/java/org/rometools/feed/module/opensearch/OpenSearchModule.java b/src/main/java/org/rometools/feed/module/opensearch/OpenSearchModule.java index b02d925..09ec0df 100644 --- a/src/main/java/org/rometools/feed/module/opensearch/OpenSearchModule.java +++ b/src/main/java/org/rometools/feed/module/opensearch/OpenSearchModule.java @@ -19,7 +19,7 @@ import com.sun.syndication.feed.module.Module; /** * Provides access to A9 Open Search information. - * + * * @author Michael W. Nassif (enrouteinc@gmail.com) */ public interface OpenSearchModule extends Module, OpenSearchResponse { diff --git a/src/main/java/org/rometools/feed/module/opensearch/OpenSearchResponse.java b/src/main/java/org/rometools/feed/module/opensearch/OpenSearchResponse.java index fdd7812..93be7e4 100644 --- a/src/main/java/org/rometools/feed/module/opensearch/OpenSearchResponse.java +++ b/src/main/java/org/rometools/feed/module/opensearch/OpenSearchResponse.java @@ -23,85 +23,85 @@ import com.sun.syndication.feed.atom.Link; /** * Provides access to A9 Open Search information. - * + * * @author Michael W. Nassif (enrouteinc@gmail.com) */ public interface OpenSearchResponse { /** * # totalResults – the maximum number of results available for these search terms - * + * * * Restrictions: An integer greater than or equal to 0. * Default: The number of items that were returned in this set of results. * Requirements: May * appear zero or one time. - * + * * @param totalResults A positive integer value. */ public void setTotalResults(int totalResults); /** * # totalResults – the maximum number of results available for these search terms - * + * * * Restrictions: An integer greater than or equal to 0. * Default: The number of items that were returned in this set of results. * Requirements: May * appear zero or one time. - * + * * @return a positive integer value. */ public int getTotalResults(); /** * # startIndex – the index of the first item returned in the result. - * + * * * Restrictions: An integer greater than or equal to 1. * Note: The first result is 1. * Default: 1 * Requirements: May appear zero or one time. - * + * * @param startIndex int value >= 1. */ public void setStartIndex(int startIndex); /** * # startIndex – the index of the first item returned in the result. - * + * * * Restrictions: An integer greater than or equal to 1. * Note: The first result is 1. * Default: 1 * Requirements: May appear zero or one time. - * + * * @return int value >= 1. */ public int getStartIndex(); /** * # itemsPerPage – the maximum number of items that can appear in one page of results. - * + * * * Restrictions: An integer greater than or equal to 1. * Default: The number of items that were returned in this set of results. * Requirements: May * appear zero or one time. - * + * * @param itemsPerPage int value >= 1. */ public void setItemsPerPage(int itemsPerPage); /** * # itemsPerPage – the maximum number of items that can appear in one page of results. - * + * * * Restrictions: An integer greater than or equal to 1. * Default: The number of items that were returned in this set of results. * Requirements: May * appear zero or one time. - * + * * @return int value >= 1 */ public int getItemsPerPage(); /** * # link – a reference back to the OpenSearch Description file - * + * * * Attributes: This is a clone of the link element in Atom, including href, hreflang, rel, and type attributes. * Restrictions: The rel attribute must * equal search. * Note: New in version 1.1. * Requirements: May appear zero or one time. - * + * * @param link link to the open search spec. */ public void setLink(Link link); /** * # link – a reference back to the OpenSearch Description file - * + * * * Attributes: This is a clone of the link element in Atom, including href, hreflang, rel, and type attributes. * Restrictions: The rel attribute must * equal search. * Note: New in version 1.1. * Requirements: May appear zero or one time. - * + * * @return link to the opensearch spec. */ public Link getLink(); @@ -113,7 +113,7 @@ public interface OpenSearchResponse { *
- * + * * @return a clone of the object. * @throws CloneNotSupportedException thrown if an element of the object cannot be cloned. - * + * */ @Override public Object clone() throws CloneNotSupportedException { @@ -59,10 +59,10 @@ public class OSQuery implements Cloneable, Serializable { /** * Indicates whether some other object is "equal to" this one as defined by the Object equals() method. *
- * + * * @param other he reference object with which to compare. * @return true if 'this' object is equal to the 'other' object. - * + * */ @Override public boolean equals(final Object other) { @@ -74,9 +74,9 @@ public class OSQuery implements Cloneable, Serializable { *
* It follows the contract defined by the Object hashCode() method. *
- * + * * @return the hashcode of the bean object. - * + * */ @Override public int hashCode() { @@ -86,9 +86,9 @@ public class OSQuery implements Cloneable, Serializable { /** * Returns the String representation for the object. *
- * + * * @return String representation for the object. - * + * */ @Override public String toString() { @@ -104,7 +104,7 @@ public class OSQuery implements Cloneable, Serializable { /** * Typically represents a url link to the os description file - * + * * @param osd The osd to set. */ public void setOsd(final String osd) { diff --git a/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleGenerator.java b/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleGenerator.java index 8662e79..cabc7e5 100644 --- a/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleGenerator.java +++ b/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleGenerator.java @@ -57,7 +57,7 @@ public class OpenSearchModuleGenerator implements ModuleGenerator { * It is used by the the feed generators to add their namespace definition in the root element of the generated document (forward-missing of Java 5.0 * Generics). *
- * + * * @return a set with all the URIs (JDOM Namespace elements) this module generator uses. */ @Override diff --git a/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleImpl.java b/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleImpl.java index 57daf7a..b6b4996 100644 --- a/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleImpl.java +++ b/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleImpl.java @@ -131,7 +131,6 @@ public class OpenSearchModuleImpl extends ModuleImpl implements OpenSearchModule /* * (non-Javadoc) - * * @see com.sun.syndication.feed.CopyFrom#copyFrom(java.lang.Object) */ @Override @@ -152,7 +151,6 @@ public class OpenSearchModuleImpl extends ModuleImpl implements OpenSearchModule /* * (non-Javadoc) - * * @see com.sun.syndication.feed.CopyFrom#getInterface() */ @Override diff --git a/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleParser.java b/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleParser.java index 29fc33a..fd04873 100644 --- a/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleParser.java +++ b/src/main/java/org/rometools/feed/module/opensearch/impl/OpenSearchModuleParser.java @@ -154,21 +154,21 @@ public class OpenSearchModuleParser implements ModuleParser { final Link link = new Link(); String att = e.getAttributeValue("rel");// getAtomNamespace()); DONT - // KNOW WHY DOESN'T WORK + // KNOW WHY DOESN'T WORK if (att != null) { link.setRel(att); } att = e.getAttributeValue("type");// getAtomNamespace()); DONT KNOW WHY - // DOESN'T WORK + // DOESN'T WORK if (att != null) { link.setType(att); } att = e.getAttributeValue("href");// getAtomNamespace()); DONT KNOW WHY - // DOESN'T WORK + // DOESN'T WORK if (att != null) { @@ -180,14 +180,14 @@ public class OpenSearchModuleParser implements ModuleParser { } att = e.getAttributeValue("hreflang");// getAtomNamespace()); DONT KNOW - // WHY DOESN'T WORK + // WHY DOESN'T WORK if (att != null) { link.setHreflang(att); } att = e.getAttributeValue("length");// getAtomNamespace()); DONT KNOW - // WHY DOESN'T WORK + // WHY DOESN'T WORK return link; } diff --git a/src/main/java/org/rometools/feed/module/photocast/PhotocastModule.java b/src/main/java/org/rometools/feed/module/photocast/PhotocastModule.java index 6e7fc80..a62dbae 100644 --- a/src/main/java/org/rometools/feed/module/photocast/PhotocastModule.java +++ b/src/main/java/org/rometools/feed/module/photocast/PhotocastModule.java @@ -48,9 +48,9 @@ import com.sun.syndication.feed.module.Module; /** * This is a ROME module that provides support for the "http://www.apple.com/ilife/wallpapers" namespace. - * + * * See the package information for example usage. - * + * * @author Robert "kebernet" Cooper */ public interface PhotocastModule extends Module { @@ -61,70 +61,70 @@ public interface PhotocastModule extends Module { /** * Returns the Item level photoDate value. - * + * * @return Returns the Item level photoDate value. */ public Date getPhotoDate(); /** * Set the Item level photoDate value. - * + * * @param photoDate Item level photoDate value */ public void setPhotoDate(Date photoDate); /** * Returns the cropDate value from the item level. - * + * * @return Item level cropDate value */ public Date getCropDate(); /** * Sets the cropDate value for the item level. - * + * * @param cropDate cropDate value for the item level */ public void setCropDate(Date cropDate); /** * The URL of the image. - * + * * @return The URL of the image. */ public URL getImageUrl(); /** * The URL of the image. - * + * * @param imageUrl The URL of the image. */ public void setImageUrl(URL imageUrl); /** * The URL of the image thumbnail. - * + * * @return The URL of the image thumbnail. */ public URL getThumbnailUrl(); /** * The URL of the image thumbnail. - * + * * @param thumbnailUrl The URL of the image thumbnail. */ public void setThumbnailUrl(URL thumbnailUrl); /** * The iPhoto metadata for the image. - * + * * @return The iPhoto metadata for the image. */ public Metadata getMetadata(); /** * The iPhoto metadata for the image. - * + * * @param metadata The iPhoto metadata for the image. */ public void setMetadata(Metadata metadata); diff --git a/src/main/java/org/rometools/feed/module/photocast/PhotocastModuleImpl.java b/src/main/java/org/rometools/feed/module/photocast/PhotocastModuleImpl.java index a0db0b7..c319c0b 100644 --- a/src/main/java/org/rometools/feed/module/photocast/PhotocastModuleImpl.java +++ b/src/main/java/org/rometools/feed/module/photocast/PhotocastModuleImpl.java @@ -51,10 +51,14 @@ import com.sun.syndication.feed.impl.EqualsBean; import com.sun.syndication.feed.impl.ToStringBean; /** - * + * * @author Robert "kebernet" Cooper */ public class PhotocastModuleImpl implements PhotocastModule { + /** + * + */ + private static final long serialVersionUID = 1L; private Date photoDate; private Date cropDate; private URL imageUrl; diff --git a/src/main/java/org/rometools/feed/module/photocast/io/Generator.java b/src/main/java/org/rometools/feed/module/photocast/io/Generator.java index 8135177..cc33e4f 100644 --- a/src/main/java/org/rometools/feed/module/photocast/io/Generator.java +++ b/src/main/java/org/rometools/feed/module/photocast/io/Generator.java @@ -52,7 +52,7 @@ import com.sun.syndication.feed.module.Module; import com.sun.syndication.io.ModuleGenerator; /** - * + * * @author Robert "kebernet" Cooper */ public class Generator implements ModuleGenerator { diff --git a/src/main/java/org/rometools/feed/module/photocast/io/Parser.java b/src/main/java/org/rometools/feed/module/photocast/io/Parser.java index 57b97b5..0a3514f 100644 --- a/src/main/java/org/rometools/feed/module/photocast/io/Parser.java +++ b/src/main/java/org/rometools/feed/module/photocast/io/Parser.java @@ -60,7 +60,7 @@ import com.sun.syndication.feed.module.Module; import com.sun.syndication.io.ModuleParser; /** - * + * * @author Robert "kebernet" Cooper */ public class Parser implements ModuleParser { diff --git a/src/main/java/org/rometools/feed/module/photocast/types/Metadata.java b/src/main/java/org/rometools/feed/module/photocast/types/Metadata.java index 81bef28..de93459 100644 --- a/src/main/java/org/rometools/feed/module/photocast/types/Metadata.java +++ b/src/main/java/org/rometools/feed/module/photocast/types/Metadata.java @@ -46,7 +46,7 @@ import com.sun.syndication.feed.impl.ToStringBean; /** * This is an immutable class representing the apple-wallpapers:metadata tag in the photocast module. - * + * * @author Robert "kebernet" Cooper */ public class Metadata { @@ -56,7 +56,7 @@ public class Metadata { /** * Creates a new instance of Metadata with a set photoDate and comments value. - * + * * @param photoDate PhotoDate value to use * @param comments comments about this photo. */ @@ -67,7 +67,7 @@ public class Metadata { /** * Returns the PhotoDate value. - * + * * @return Returns the PhotoDate value. */ public PhotoDate getPhotoDate() { @@ -76,7 +76,7 @@ public class Metadata { /** * Returns comments about the photo. - * + * * @return Returns comments about the photo. */ public String getComments() { @@ -85,7 +85,7 @@ public class Metadata { /** * Returns a String representation of the metadata object. - * + * * @return Returns a String representation of the metadata object. */ @Override diff --git a/src/main/java/org/rometools/feed/module/photocast/types/PhotoDate.java b/src/main/java/org/rometools/feed/module/photocast/types/PhotoDate.java index 0aef960..ebebb70 100644 --- a/src/main/java/org/rometools/feed/module/photocast/types/PhotoDate.java +++ b/src/main/java/org/rometools/feed/module/photocast/types/PhotoDate.java @@ -47,11 +47,15 @@ import java.util.Date; /** * This is a specialized Date class for working with the apple PhotoDate format. It provides a constructor taking a dobule value representing the fractional * number of days since 00:00:00 01/01/00. - * + * * @author Robert "kebernet" Cooper */ public class PhotoDate extends Date { + /** + * + */ + private static final long serialVersionUID = 1L; private static final long Y2K = 946616400531l; private static final double DAY = 24 * 60 * 60 * 1000; @@ -62,7 +66,7 @@ public class PhotoDate extends Date { /** * Creates a new instance of PhotoDate with the timestamp provided. - * + * * @param time milliseconds time */ public PhotoDate(final long time) { @@ -71,7 +75,7 @@ public class PhotoDate extends Date { /** * Creates a new instance of PhotoDate with the fractional number of days since 00:00:00 01/01/00. - * + * * @param photoDateValue fractional number of days since 00:00:00 01/01/00 */ public PhotoDate(final double photoDateValue) { @@ -83,7 +87,7 @@ public class PhotoDate extends Date { /** * Returns a string representing the fractional number of days since 00:00:00 01/01/00. - * + * * @return Returns a string representing the fractional number of days since 00:00:00 01/01/00. */ @Override diff --git a/src/main/java/org/rometools/feed/module/portablecontacts/ContactModule.java b/src/main/java/org/rometools/feed/module/portablecontacts/ContactModule.java index b768510..adb80c1 100644 --- a/src/main/java/org/rometools/feed/module/portablecontacts/ContactModule.java +++ b/src/main/java/org/rometools/feed/module/portablecontacts/ContactModule.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -18,7 +18,7 @@ package org.rometools.feed.module.portablecontacts; /** - * + * * @author robert.cooper */ public interface ContactModule { diff --git a/src/main/java/org/rometools/feed/module/portablecontacts/types/Address.java b/src/main/java/org/rometools/feed/module/portablecontacts/types/Address.java index 8c331c5..e3a7736 100644 --- a/src/main/java/org/rometools/feed/module/portablecontacts/types/Address.java +++ b/src/main/java/org/rometools/feed/module/portablecontacts/types/Address.java @@ -1,12 +1,12 @@ /* * Copyright 2011 robert.cooper. - * + * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at - * + * * http://www.apache.org/licenses/LICENSE-2.0 - * + * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -18,7 +18,7 @@ package org.rometools.feed.module.portablecontacts.types; /** - * + * * @author robert.cooper */ public class Address { diff --git a/src/main/java/org/rometools/feed/module/slash/Slash.java b/src/main/java/org/rometools/feed/module/slash/Slash.java index bbd5019..e189d35 100644 --- a/src/main/java/org/rometools/feed/module/slash/Slash.java +++ b/src/main/java/org/rometools/feed/module/slash/Slash.java @@ -46,7 +46,7 @@ import com.sun.syndication.feed.module.Module; /** * This interface represents the Slash RSS extension. - * + * * @version $Revision: 1.2 $ * @author Robert "kebernet" Cooper */ diff --git a/src/main/java/org/rometools/feed/module/slash/SlashImpl.java b/src/main/java/org/rometools/feed/module/slash/SlashImpl.java index eee5d5d..94a263f 100644 --- a/src/main/java/org/rometools/feed/module/slash/SlashImpl.java +++ b/src/main/java/org/rometools/feed/module/slash/SlashImpl.java @@ -3,7 +3,7 @@ * * Created on November 19, 2005, 8:53 PM * - * + * * This library is provided under dual licenses. * You may choose the terms of the Lesser General Public License or the Apache * License at your discretion. @@ -50,6 +50,11 @@ import com.sun.syndication.feed.impl.EqualsBean; */ public class SlashImpl implements Slash { + /** + * + */ + private static final long serialVersionUID = 1L; + private String section; private String department; diff --git a/src/main/java/org/rometools/feed/module/slash/io/SlashModuleGenerator.java b/src/main/java/org/rometools/feed/module/slash/io/SlashModuleGenerator.java index c9bec76..3be208c 100644 --- a/src/main/java/org/rometools/feed/module/slash/io/SlashModuleGenerator.java +++ b/src/main/java/org/rometools/feed/module/slash/io/SlashModuleGenerator.java @@ -51,7 +51,7 @@ import com.sun.syndication.io.ModuleGenerator; /** * The ModuleGenerator implementation for the Slash plug in. - * + * * @version $Revision: 1.1 $ * @author Robert "kebernet" Cooper */ diff --git a/src/main/java/org/rometools/feed/module/slash/io/SlashModuleParser.java b/src/main/java/org/rometools/feed/module/slash/io/SlashModuleParser.java index 9803478..8e3f380 100644 --- a/src/main/java/org/rometools/feed/module/slash/io/SlashModuleParser.java +++ b/src/main/java/org/rometools/feed/module/slash/io/SlashModuleParser.java @@ -53,7 +53,7 @@ import com.sun.syndication.io.ModuleParser; /** * ModuleParser implementation for Slash RSS. - * + * * @version $Revision: 1.3 $ * @author Robert "kebernet" Cooper */ diff --git a/src/main/java/org/rometools/feed/module/sle/SimpleListExtension.java b/src/main/java/org/rometools/feed/module/sle/SimpleListExtension.java index dad5822..259ec1b 100644 --- a/src/main/java/org/rometools/feed/module/sle/SimpleListExtension.java +++ b/src/main/java/org/rometools/feed/module/sle/SimpleListExtension.java @@ -24,7 +24,7 @@ import com.sun.syndication.feed.module.Module; /** * This is the primary module interface for the MS Simple List Extensions. - * + * * @author Robert "kebernet" Cooper */ public interface SimpleListExtension extends Module { @@ -37,7 +37,7 @@ public interface SimpleListExtension extends Module { * The cf:group element is intended to inform the client that the property to which it refers is one that is “groupable” – that is, that the client should * provide a user interface that allows the user to group or filter on the values of that property. Groupable properties should contain a small set of * discrete values (e.g. book genres are perfect for groups). - * + * * @param groupFields Array of types.Group objects. */ public void setGroupFields(Group[] groupFields); @@ -46,7 +46,7 @@ public interface SimpleListExtension extends Module { * The cf:group element is intended to inform the client that the property to which it refers is one that is “groupable” – that is, that the client should * provide a user interface that allows the user to group or filter on the values of that property. Groupable properties should contain a small set of * discrete values (e.g. book genres are perfect for groups). - * + * * @return Array of types.Group objects. */ public Group[] getGroupFields(); @@ -54,7 +54,7 @@ public interface SimpleListExtension extends Module { /** * The cf:sort element is intended to inform the client that the property to which it refers is one that is “sortable” – that is, that the client should * provide a user interface that allows the user to sort on that property. - * + * * @param sortFields Array of types.Sort objects */ public void setSortFields(Sort[] sortFields); @@ -62,7 +62,7 @@ public interface SimpleListExtension extends Module { /** * The cf:sort element is intended to inform the client that the property to which it refers is one that is “sortable” – that is, that the client should * provide a user interface that allows the user to sort on that property. - * + * * @return Array of types.Sort objects */ public Sort[] getSortFields(); @@ -70,14 +70,14 @@ public interface SimpleListExtension extends Module { /** * This XML element allows the publisher of a feed document to indicate to the consumers of the feed that the feed is intended to be consumed as a list. * (defaults to "list" ) - * + * * @param value treatAs value */ public void setTreatAs(String value); /** * This XML element allows the publisher of a feed document to indicate to the consumers of the feed that the feed is intended to be consumed as a list. - * + * * @return treatAs value. */ public String getTreatAs(); diff --git a/src/main/java/org/rometools/feed/module/sle/SimpleListExtensionImpl.java b/src/main/java/org/rometools/feed/module/sle/SimpleListExtensionImpl.java index daa0397..1c2dd61 100644 --- a/src/main/java/org/rometools/feed/module/sle/SimpleListExtensionImpl.java +++ b/src/main/java/org/rometools/feed/module/sle/SimpleListExtensionImpl.java @@ -24,10 +24,14 @@ import com.sun.syndication.feed.CopyFrom; import com.sun.syndication.feed.module.ModuleImpl; /** - * + * * @author Robert "kebernet" Cooper */ public class SimpleListExtensionImpl extends ModuleImpl implements SimpleListExtension { + /** + * + */ + private static final long serialVersionUID = 1L; private String treatAs = "list"; private Group[] groupFields; private Sort[] sortFields; @@ -52,7 +56,7 @@ public class SimpleListExtensionImpl extends ModuleImpl implements SimpleListExt ** This is useful when dealing with properties that may have multiple implementations. For example, Module. *
- * + * * @return the interface the copyFrom works on. */ @Override @@ -83,7 +87,7 @@ public class SimpleListExtensionImpl extends ModuleImpl implements SimpleListExt /** * Returns the URI of the module. *
- * + * * @return URI of the module. */ @Override @@ -99,7 +103,7 @@ public class SimpleListExtensionImpl extends ModuleImpl implements SimpleListExt * This method is useful for moving from one implementation of a bean interface to another. For example from the default SyndFeed bean implementation to a * Hibernate ready implementation. *
- *
+ *
* @param obj the instance to copy properties from.
*/
@Override
diff --git a/src/main/java/org/rometools/feed/module/sle/SleEntry.java b/src/main/java/org/rometools/feed/module/sle/SleEntry.java
index 0e630c0..beed519 100644
--- a/src/main/java/org/rometools/feed/module/sle/SleEntry.java
+++ b/src/main/java/org/rometools/feed/module/sle/SleEntry.java
@@ -27,7 +27,7 @@ import com.sun.syndication.feed.module.Module;
/**
* This is a parse only module that holds the values of enternal fields declared in the SLE module. These will not be persisted on an output()
* call, nor will changing a value here change a value in another module or a foreign markup tag.
- *
+ *
* @author Robert "kebernet" Cooper
*/
public interface SleEntry extends Module {
@@ -38,7 +38,7 @@ public interface SleEntry extends Module {
/**
* Returns an EntryValue for the given element name.
- *
+ *
* @param element element name to look for
* @return Returns an EntryValue for the given element name.
*/
@@ -46,14 +46,14 @@ public interface SleEntry extends Module {
/**
* An array of EntryValue objects that correspond to the grouping for the feed.
- *
+ *
* @return An array of EntryValue objects that correspond to the grouping for the feed.
*/
public EntryValue[] getGroupValues();
/**
* Returns an EntryValue for the given element name.
- *
+ *
* @param element element name
* @return Returns an EntryValue for the given element name.
*/
@@ -61,11 +61,11 @@ public interface SleEntry extends Module {
/**
* Returns an array of EntryValues for the fields declared in the heading.
- *
+ *
* NB:
* Right now the parser will take any default=true field and change it to an integer value representing the default order in the field. You should not rely
* on these values data display to a user!
- *
+ *
* @return Array of EntryValue implementations from this entry.
*/
public EntryValue[] getSortValues();
diff --git a/src/main/java/org/rometools/feed/module/sle/SleEntryImpl.java b/src/main/java/org/rometools/feed/module/sle/SleEntryImpl.java
index 1f8024b..002d5fe 100644
--- a/src/main/java/org/rometools/feed/module/sle/SleEntryImpl.java
+++ b/src/main/java/org/rometools/feed/module/sle/SleEntryImpl.java
@@ -29,10 +29,14 @@ import com.sun.syndication.feed.impl.ObjectBean;
/**
* This is a parse only module that holds the values of enternal fields declared in the SLE module. These will not be persisted on an output()
* call, nor will changing a value here change a value in another module or a foreign markup tag.
- *
+ *
* @author Robert "kebernet" Cooper
*/
public class SleEntryImpl implements SleEntry {
+ /**
+ *
+ */
+ private static final long serialVersionUID = 1L;
private static final EntryValue[] EMPTY_VALUES = new EntryValue[0];
private final ObjectBean obj = new ObjectBean(SleEntryImpl.class, this);
private EntryValue[] groupValues = EMPTY_VALUES;
@@ -70,7 +74,7 @@ public class SleEntryImpl implements SleEntry {
*
* This is useful when dealing with properties that may have multiple implementations. For example, Module. *
- * + * * @return the interface the copyFrom works on. */ @Override @@ -106,7 +110,7 @@ public class SleEntryImpl implements SleEntry { /** * Returns the URI of the module. *
- * + * * @return URI of the module. */ @Override @@ -127,7 +131,7 @@ public class SleEntryImpl implements SleEntry { * This method is useful for moving from one implementation of a bean interface to another. For example from the default SyndFeed bean implementation to a * Hibernate ready implementation. *
- * + * * @param obj the instance to copy properties from. */ @Override diff --git a/src/main/java/org/rometools/feed/module/sle/SleUtility.java b/src/main/java/org/rometools/feed/module/sle/SleUtility.java index 4692286..e574a00 100644 --- a/src/main/java/org/rometools/feed/module/sle/SleUtility.java +++ b/src/main/java/org/rometools/feed/module/sle/SleUtility.java @@ -35,11 +35,11 @@ import com.sun.syndication.io.impl.ModuleGenerators; /** * This is a utiltiy class for grouping and sorting lists of entries based on the SLE. - * + * *
* Note, this class can ONLY be used on parsed feeds, unless you manually add the appropriate SleEntry objects on the items. *
- * + * * @author Robert "kebernet" Cooper * @see SleEntry */ @@ -53,7 +53,7 @@ public class SleUtility { /** * Groups values by the groups from the SLE. - * + * * @param values List of Extendable implementations to group. * @param groups Group fields (from the SimpleListExtension module) * @return Grouped list of entries. @@ -71,7 +71,7 @@ public class SleUtility { /** * Sorts a list of values based on a given sort field using a selection sort. - * + * * @param values List of values (implements Extendable) to sort. * @param sort The sort field to sort on. * @param ascending Sort ascending/descending. @@ -86,7 +86,7 @@ public class SleUtility { /** * Sorts and groups a set of entries. - * + * * @param values List of Extendable implementations. * @param groups Group items to group by. * @param sort Field to sort on. @@ -150,6 +150,11 @@ public class SleUtility { } private static class SortableList extends ArrayList { + /** + * + */ + private static final long serialVersionUID = 1L; + public SortableList(final Collection c) { super(c); } diff --git a/src/main/java/org/rometools/feed/module/sle/io/ItemParser.java b/src/main/java/org/rometools/feed/module/sle/io/ItemParser.java index 0572b95..5559534 100644 --- a/src/main/java/org/rometools/feed/module/sle/io/ItemParser.java +++ b/src/main/java/org/rometools/feed/module/sle/io/ItemParser.java @@ -36,7 +36,7 @@ import com.sun.syndication.feed.module.Module; import com.sun.syndication.io.impl.DateParser; /** - * + * * @author Robert "kebernet" Cooper */ public class ItemParser implements com.sun.syndication.io.ModuleParser { @@ -48,7 +48,7 @@ public class ItemParser implements com.sun.syndication.io.ModuleParser { /** * Returns the namespace URI this parser handles. *- * + * * @return the namespace URI. */ @Override @@ -59,7 +59,7 @@ public class ItemParser implements com.sun.syndication.io.ModuleParser { /** * Parses the XML node (JDOM element) extracting module information. *
- *
+ *
* @param element the XML node (JDOM element) to extract module information from.
* @return a module instance, null if the element did not have module information.
*/
@@ -83,7 +83,7 @@ public class ItemParser implements com.sun.syndication.io.ModuleParser {
element.removeContent(group);
}
- sle.setGroupValues((EntryValue[]) values.toArray(new EntryValue[values.size()]));
+ sle.setGroupValues(values.toArray(new EntryValue[values.size()]));
values = values.size() == 0 ? values : new ArrayList
- *
+ *
* @return the namespace URI.
*/
@Override
@@ -52,7 +52,7 @@ public class ModuleGenerator implements com.sun.syndication.io.ModuleGenerator {
* It is used by the the feed generators to add their namespace definition in the root element of the generated document (forward-missing of Java 5.0
* Generics).
*
- *
+ *
* @param module the module to inject into the XML node (JDOM element).
* @param element the XML node to inject the module metadata to.
*/
diff --git a/src/main/java/org/rometools/feed/module/sle/io/ModuleParser.java b/src/main/java/org/rometools/feed/module/sle/io/ModuleParser.java
index 98fd6c6..982e2bf 100644
--- a/src/main/java/org/rometools/feed/module/sle/io/ModuleParser.java
+++ b/src/main/java/org/rometools/feed/module/sle/io/ModuleParser.java
@@ -31,7 +31,7 @@ import org.rometools.feed.module.sle.types.Sort;
import com.sun.syndication.feed.module.Module;
/**
- *
+ *
* @author Robert "kebernet" Cooper
*/
public class ModuleParser implements com.sun.syndication.io.ModuleParser {
@@ -46,7 +46,7 @@ public class ModuleParser implements com.sun.syndication.io.ModuleParser {
/**
* Returns the namespace URI this parser handles.
*
- *
+ *
* @return the namespace URI.
*/
@Override
@@ -57,7 +57,7 @@ public class ModuleParser implements com.sun.syndication.io.ModuleParser {
/**
* Parses the XML node (JDOM element) extracting module information.
*
- *
+ *
* @param element the XML node (JDOM element) to extract module information from.
* @return a module instance, null if the element did not have module information.
*/
@@ -79,7 +79,7 @@ public class ModuleParser implements com.sun.syndication.io.ModuleParser {
values.add(new Group(ns, elementName, label));
}
- sle.setGroupFields((Group[]) values.toArray(new Group[values.size()]));
+ sle.setGroupFields(values.toArray(new Group[values.size()]));
values = values.size() == 0 ? values : new ArrayList
* The
* The
* The
* The
- *
+ *
* @author Laird Dornin
*/
public class SSE091Generator implements DelegatingModuleGenerator {
@@ -52,7 +51,7 @@ public class SSE091Generator implements DelegatingModuleGenerator {
* It is used by the the feed generators to add their namespace definition in the root element of the generated document (forward-missing of Java 5.0
* Generics).
*
* "aggregated" if the link points to a feed whose contents are being incorporated into this feed by the publisher.
- *
+ *
* @return the type of the releated feed.
*/
public Integer getType() {
@@ -112,7 +112,7 @@ public class Related extends SSEModule {
/**
* Set the type of relationship, complete or aggregated.
- *
+ *
* @param type the type of relationship, complete or aggregated.
*/
public void setType(final Integer type) {
@@ -122,7 +122,7 @@ public class Related extends SSEModule {
/**
* An optional, date-time attribute. This is the starting point of the related feed. If this attribute is omitted or blank, it is assumed that this is a
* complete feed.
- *
+ *
* @return the starting point of the related feed.
*/
public Date getSince() {
@@ -131,7 +131,7 @@ public class Related extends SSEModule {
/**
* Set the starting point of the related feed.
- *
+ *
* @param since the starting point of the related feed.
*/
public void setSince(final Date since) {
@@ -140,7 +140,7 @@ public class Related extends SSEModule {
/**
* An optional, date-time attribute. This is the ending point of a feed.
- *
+ *
* @return the ending point of the feed, until.
*/
public Date getUntil() {
@@ -149,7 +149,7 @@ public class Related extends SSEModule {
/**
* Set the ending point of the feed, until. An optional, date-time attribute.
- *
+ *
* @param until the ending point of the feed.
*/
public void setUntil(final Date until) {
diff --git a/src/main/java/org/rometools/feed/module/sse/modules/Sharing.java b/src/main/java/org/rometools/feed/module/sse/modules/Sharing.java
index 265e79c..8e26d4c 100644
--- a/src/main/java/org/rometools/feed/module/sse/modules/Sharing.java
+++ b/src/main/java/org/rometools/feed/module/sse/modules/Sharing.java
@@ -9,19 +9,19 @@ import com.sun.syndication.feed.module.Module;
* cf:group
element contains the following attributes:
*
*
- *
+ *
* @author Robert "kebernet" Cooper
*/
public class Group implements Serializable, Cloneable {
@@ -60,7 +60,7 @@ public class Group implements Serializable, Cloneable {
/**
* Creates a new instance of Group
- *
+ *
* @param namespace Namespace of the element
* @param element Name of the element
* @param label Label for the grouping.
@@ -73,7 +73,7 @@ public class Group implements Serializable, Cloneable {
/**
* Returns the name of the element.
- *
+ *
* @return Returns the name of the element.
*/
public String getElement() {
@@ -82,7 +82,7 @@ public class Group implements Serializable, Cloneable {
/**
* Returns the label of the element.
- *
+ *
* @return Returns the label of the element.
*/
public String getLabel() {
@@ -91,7 +91,7 @@ public class Group implements Serializable, Cloneable {
/**
* Returns the namespace of the element.
- *
+ *
* @return Returns the namespace of the element.
*/
public Namespace getNamespace() {
diff --git a/src/main/java/org/rometools/feed/module/sle/types/NumberValue.java b/src/main/java/org/rometools/feed/module/sle/types/NumberValue.java
index 51316b4..e905036 100644
--- a/src/main/java/org/rometools/feed/module/sle/types/NumberValue.java
+++ b/src/main/java/org/rometools/feed/module/sle/types/NumberValue.java
@@ -25,7 +25,7 @@ import com.sun.syndication.feed.impl.ObjectBean;
/**
* An EntryValue implementation for "number" data-type values.
- *
+ *
* @author Robert "kebernet" Cooper
*/
public class NumberValue implements EntryValue {
diff --git a/src/main/java/org/rometools/feed/module/sle/types/Sort.java b/src/main/java/org/rometools/feed/module/sle/types/Sort.java
index a405ff6..3384147 100644
--- a/src/main/java/org/rometools/feed/module/sle/types/Sort.java
+++ b/src/main/java/org/rometools/feed/module/sle/types/Sort.java
@@ -26,22 +26,22 @@ import com.sun.syndication.feed.impl.ObjectBean;
/**
* cf:group
element refers to the
* default sort order.cf:group
element refers. If it is omitted, the
* client should use the value of the "element" attribute as the human-readable name. The "label" attribute is required if the "element" attribute is
* omitted. cf:sort
element is intended to inform the client that the property to which it refers
- *
+ *
* is one that is “sortable” – that is, that the client should provide a user interface that allows the
- *
+ *
* user to sort on that property.
* cf:sort
element can also be used to provide a label for the default sort that appears
- *
+ *
* in the list (in this case, only the label attribute should be included).
* cf:sort
element contains the following attributes:
*
*
- *
+ *
* @author Robert "kebernet" Cooper
*/
public class Sort implements Serializable, Cloneable {
@@ -86,7 +86,7 @@ public class Sort implements Serializable, Cloneable {
/**
* Creates a new instance of Sort
- *
+ *
* @param namespace Namespace of the element
* @param element Name of the element
* @param dataType data-type of the element
@@ -104,7 +104,7 @@ public class Sort implements Serializable, Cloneable {
/**
* Returns the dataType of the sort
- *
+ *
* @return Returns the dataType of the sort
*/
public String getDataType() {
@@ -113,7 +113,7 @@ public class Sort implements Serializable, Cloneable {
/**
* Indicates this is the natural order of the feed.
- *
+ *
* @return Indicates this is the natural order of the feed.
*/
public boolean getDefaultOrder() {
@@ -122,7 +122,7 @@ public class Sort implements Serializable, Cloneable {
/**
* Name of the element.
- *
+ *
* @return Name of the element.
*/
public String getElement() {
@@ -131,7 +131,7 @@ public class Sort implements Serializable, Cloneable {
/**
* User label for sorting.
- *
+ *
* @return User label for sorting.
*/
public String getLabel() {
@@ -140,7 +140,7 @@ public class Sort implements Serializable, Cloneable {
/**
* Namespace of the element
- *
+ *
* @return Namespace of the element
*/
public Namespace getNamespace() {
diff --git a/src/main/java/org/rometools/feed/module/sle/types/StringValue.java b/src/main/java/org/rometools/feed/module/sle/types/StringValue.java
index 500f9b4..7666222 100644
--- a/src/main/java/org/rometools/feed/module/sle/types/StringValue.java
+++ b/src/main/java/org/rometools/feed/module/sle/types/StringValue.java
@@ -23,7 +23,7 @@ import com.sun.syndication.feed.impl.ObjectBean;
/**
* An EntryValue implementation for "text" data-types.
- *
+ *
* @author Robert "kebernet" Cooper
*/
public class StringValue implements EntryValue {
diff --git a/src/main/java/org/rometools/feed/module/sse/SSE091Generator.java b/src/main/java/org/rometools/feed/module/sse/SSE091Generator.java
index 4e31192..ac81ba4 100644
--- a/src/main/java/org/rometools/feed/module/sse/SSE091Generator.java
+++ b/src/main/java/org/rometools/feed/module/sse/SSE091Generator.java
@@ -1,7 +1,6 @@
package org.rometools.feed.module.sse;
import java.util.Date;
-import java.util.Iterator;
import java.util.List;
import java.util.Locale;
import java.util.Set;
@@ -27,7 +26,7 @@ import com.sun.syndication.io.impl.RSS20Generator;
/**
* Generator for the SSE Module.
* cf:sort
element refers to the
* default sort order.cf:sort
element refers. If it is omitted, the
* client should use the value of the "element" attribute as the human-readable name. The "label" attribute is required if the "element" attribute is omitted.cf:sort
element refers.. It contains
@@ -58,9 +58,9 @@ import com.sun.syndication.feed.impl.ObjectBean;
* The allowed values are "true" and "false". If omitted, the default value is "false". The items in the list must be already be sorted by the element –
* this is, the client should not expect to have to resort by this field if it displaying content directly from the list. The client should respect only the
* first instance of default="true" that it encounters.
*
- *
+ *
* Element within
- *
+ *
*
*
- *
+ *
* .
*/
public class History extends SSEModule {
@@ -57,7 +57,7 @@ public class History extends SSEModule {
*
* This is the date-time when the most recent modification took place. If this attribute is omitted the value defaults to the earliest time representable in
* RFC 822.
- *
+ *
* @return the date-time when the most recent modification took place.
*/
public Date getWhen() {
@@ -69,7 +69,7 @@ public class History extends SSEModule {
* Set the date-time when the most recent modification took place.
*
* Either or both of the when or by attributes MUST be present; it is invalid to have neither.
- *
+ *
* @param when the date-time when the most recent modification took place.
*/
public void setWhen(final Date when) {
@@ -84,7 +84,7 @@ public class History extends SSEModule {
* Either or both of the when or by must be present; it is invalid to have neither.
*
* If this attribute is omitted the value defaults to the empty string (which must be less than all other values for purposes of collation).
- *
+ *
* @return A text attribute identifying the unique endpoint that made the most recent modification.
*/
public String getBy() {
@@ -95,7 +95,7 @@ public class History extends SSEModule {
* Sets the endpoint that made the most recent modification.
*
* Either or both of the when or by attributes MUST be present; it is invalid to have neither.
- *
+ *
* @param by the endpoint that made the most recent modification.
*/
public void setBy(final String by) {
@@ -104,7 +104,7 @@ public class History extends SSEModule {
/**
* Add an update to this history
- *
+ *
* @param update an update to add to the list of updates for this history.
*/
public void addUpdate(final Update update) {
@@ -116,7 +116,7 @@ public class History extends SSEModule {
/**
* Return the list of updates for this history.
- *
+ *
* @return the list of updates for this history.
*/
public List
*
- *
+ *
* Element within
- *
+ *
*
*
- *
+ *
* .
*/
public class Related extends SSEModule {
@@ -62,7 +62,7 @@ public class Related extends SSEModule {
/**
* link A required, URL attribute. The URL for related feeds.
- *
+ *
* @return the URL for related feeds
*/
// TODO: use a java.net.URL?
@@ -72,7 +72,7 @@ public class Related extends SSEModule {
/**
* Set the URL for related feeds.
- *
+ *
* @param link the URL for related feeds.
*/
public void setLink(final String link) {
@@ -81,7 +81,7 @@ public class Related extends SSEModule {
/**
* title An optional, string attribute. The name or description of the related feed.
- *
+ *
* @return The name or description of the related feed.
*/
public String getTitle() {
@@ -90,7 +90,7 @@ public class Related extends SSEModule {
/**
* Set the name or description of the related feed.
- *
+ *
* @param title the name or description of the related feed.
*/
public void setTitle(final String title) {
@@ -103,7 +103,7 @@ public class Related extends SSEModule {
* "complete" if the link points to file containing the complete collection of items for this feed.
*
*
- *
+ *
* Element within RSS
- *
+ *
*
*
- *
+ *
* or OPML
- *
+ *
*
*
*
- *
+ *
* .
*/
public class Sharing extends SSEModule {
@@ -64,7 +64,7 @@ public class Sharing extends SSEModule {
/**
* ordered An optional, Boolean attribute. If present and its value is "true" (lower-case), subscribers MUST treat the item list as an ordered set (see
* section 3.2). If this attribute is omitted or blank, it is assumed that this is an unordered feed.
- *
+ *
* @return a Boolean indicating if subscribers must treat the item list as an ordered set.
*/
public Boolean getOrdered() {
@@ -73,7 +73,7 @@ public class Sharing extends SSEModule {
/**
* Set whether subscribers MUST tread the item list as an ordered set.
- *
+ *
* @param ordered whether subscribers MUST tread the item list as an ordered set.
*/
public void setOrdered(final Boolean ordered) {
@@ -83,7 +83,7 @@ public class Sharing extends SSEModule {
/**
* Provides an Integer that expresses the size of the window of change history kept by the publisher. Subscribers MAY use this value to determine the
* frequency with which they must read a feed.
- *
+ *
* @return an Integer that expresses the size of the window of change history kept by the publisher.
*/
public Integer getWindow() {
@@ -92,7 +92,7 @@ public class Sharing extends SSEModule {
/**
* Set an Integer that expresses the size of the window of change history kept by the publisher.
- *
+ *
* @param window an Integer that expresses the size of the window of change history kept by the publisher.
*/
public void setWindow(final Integer window) {
@@ -102,7 +102,7 @@ public class Sharing extends SSEModule {
/**
* since An optional date-time attribute. All items updated on or after this date-time are included in the feed. If not present or null, the
* "beginning of time" is assumed and the feed contains the node's complete item set as of the until date-time.
- *
+ *
* @return An optional date-time attribute.
*/
public Date getSince() {
@@ -111,7 +111,7 @@ public class Sharing extends SSEModule {
/**
* Sets the optional date-time attribute where all items updated on or after this date-time are included in the feed.
- *
+ *
* @param since An optional date-time attribute.
*/
public void setSince(final Date since) {
@@ -122,7 +122,7 @@ public class Sharing extends SSEModule {
* until An optional date-time attribute. Items updated after this date are not included in the feed. The publisher must guarantee that the value of until
* will increase if any items in the feed are updated. If this attribute is omitted or blank, the subscriber cannot make assumptions about when the feed was
* updated.
- *
+ *
* @return the date where items updated after this date are not included in the feed.
*/
public Date getUntil() {
@@ -131,7 +131,7 @@ public class Sharing extends SSEModule {
/**
* Set the date where items updated after this date are not included in the feed.
- *
+ *
* @param until the date where items updated after this date are not included in the feed.
*/
public void setUntil(final Date until) {
diff --git a/src/main/java/org/rometools/feed/module/sse/modules/Sync.java b/src/main/java/org/rometools/feed/module/sse/modules/Sync.java
index 7a65894..b0ee980 100644
--- a/src/main/java/org/rometools/feed/module/sse/modules/Sync.java
+++ b/src/main/java/org/rometools/feed/module/sse/modules/Sync.java
@@ -10,19 +10,19 @@ import com.sun.syndication.feed.module.Module;
*
*
- *
+ *
* Element within RSS
- *
+ *
*
*
- *
+ *
* or OPML
- *
+ *
*
*
- *
+ *
* .
*/
public class Sync extends SSEModule {
@@ -74,7 +74,7 @@ public class Sync extends SSEModule {
/**
* Set the identifier for the item. The ID MUST be globally unique within the feed and it MUST be identical across feeds if an item is being shared or
* replicated as part of multiple distinct independent feeds.
- *
+ *
* @param id the identifier for the item.
*/
public void setId(final String id) {
@@ -91,7 +91,7 @@ public class Sync extends SSEModule {
/**
* Set the modification sequence number of the item.
- *
+ *
* @param version the modification sequence number of the item.
*/
public void setVersion(final Integer version) {
@@ -108,7 +108,7 @@ public class Sync extends SSEModule {
/**
* Set an indication of whether this item has been deleted and is a tombstone.
- *
+ *
* @param deleted an indication of whether this item has been deleted and is a tombstone.
*/
public void setDeleted(final Boolean deleted) {
@@ -119,7 +119,7 @@ public class Sync extends SSEModule {
* Provides access to an optional, Boolean conflict attribute. If present and its value is "true" (lower-case), it indicates there was an update conflict
* detected when processing an update of this item, and it should potentially be examined by the user. If not present, or present with value of "false" or
* "", Then no conflict has been detected. All other values are invalid.
- *
+ *
* @return indicates there was an update conflict detected when processing an update of this item.
*/
public Boolean isConflict() {
@@ -128,7 +128,7 @@ public class Sync extends SSEModule {
/**
* Set an indication of whether there was an update conflict detected when processing an update of this item.
- *
+ *
* @param conflict an indication of whether there was an update conflict detected when processing an update of this item.
*/
public void setConflict(final Boolean conflict) {
@@ -140,7 +140,7 @@ public class Sync extends SSEModule {
/**
* The history history for this sync object
- *
+ *
* @param history the history for this sync object.
*/
public void setHistory(final History history) {
@@ -149,7 +149,7 @@ public class Sync extends SSEModule {
/**
* Get the history for this sync object
- *
+ *
* @return get the history for this sync object.
*/
public History getHistory() {
diff --git a/src/main/java/org/rometools/feed/module/sse/modules/Update.java b/src/main/java/org/rometools/feed/module/sse/modules/Update.java
index 0f05239..c6b9d8d 100644
--- a/src/main/java/org/rometools/feed/module/sse/modules/Update.java
+++ b/src/main/java/org/rometools/feed/module/sse/modules/Update.java
@@ -9,13 +9,13 @@ import com.sun.syndication.feed.module.Module;
*
*
- *
+ *
* Element within
- *
+ *
*
*
- *
+ *
* .
*/
public class Update extends SSEModule {
@@ -45,7 +45,7 @@ public class Update extends SSEModule {
/**
* Set the date-time when the modification took place.
- *
+ *
* @param when the date-time when the modification took place.
*/
public void setWhen(final Date when) {
@@ -56,7 +56,7 @@ public class Update extends SSEModule {
* Provides access to a text attribute identifying the unique endpoint that made a modification. This SHOULD be some combination of user and device (so that
* a given user can edit a feed on multiple devices). This attribute is used programmatically to break ties in case two changes happened at the same time
* (within the same second). Either or both of the when or by must be present; it is invalid to have neither.
- *
+ *
* @return access to a text attribute identifying the unique endpoint that made a modification.
*/
public String getBy() {
@@ -65,7 +65,7 @@ public class Update extends SSEModule {
/**
* Sets a text attribute identifying the unique endpoint that made a modification.
- *
+ *
* @param by a text attribute identifying the unique endpoint that made a modification.
*/
public void setBy(final String by) {
diff --git a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherEntryModule.java b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherEntryModule.java
index cf5f13c..96f796d 100644
--- a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherEntryModule.java
+++ b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherEntryModule.java
@@ -41,35 +41,35 @@ import org.rometools.feed.module.yahooweather.types.Forecast;
/**
* An interface describing the entry/item level data for Yahoo Weather.
- *
+ *
* @version $Id: YWeatherEntryModule.java,v 1.2 2008/01/22 14:50:06 kebernet Exp $
* @author Robert "kebernet" Cooper
*/
public interface YWeatherEntryModule extends YWeatherModule {
/**
* The current conditions.
- *
+ *
* @return The current conditions.
*/
public Condition getCondition();
/**
* The current conditions.
- *
+ *
* @param condition The current conditions.
*/
public void setCondition(Condition condition);
/**
* Forecasts for this location.
- *
+ *
* @return Forecasts for this location.
*/
public Forecast[] getForecasts();
/**
* Forecasts for this location.
- *
+ *
* @param forecasts Forecasts for this location.
*/
public void setForecasts(Forecast[] forecasts);
diff --git a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherFeedModule.java b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherFeedModule.java
index a5b1a01..c630dfe 100644
--- a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherFeedModule.java
+++ b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherFeedModule.java
@@ -43,77 +43,77 @@ import org.rometools.feed.module.yahooweather.types.Wind;
/**
* An interface describing feed/channel level data for Yahoo Weather.
- *
+ *
* @version $Id: YWeatherFeedModule.java,v 1.3 2008/03/29 16:19:12 kebernet Exp $
* @author Robert "kebernet" Cooper
*/
public interface YWeatherFeedModule extends YWeatherModule {
/**
* The location the feed is for.
- *
+ *
* @return The location the feed is for.
*/
public Location getLocation();
/**
* The location the feed is for.
- *
+ *
* @param location The location the feed is for.
*/
public void setLocation(Location location);
/**
* Astronomical information for the location.
- *
+ *
* @return Astronomical information for the location.
*/
public Astronomy getAstronomy();
/**
* Astronomical information for the location.
- *
+ *
* @param astronomy Astronomical information for the location.
*/
public void setAstronomy(Astronomy astronomy);
/**
* Units that data in the feed is provided in.
- *
+ *
* @return Units that data in the feed is provided in.
*/
public Units getUnits();
/**
* Units that data in the feed is provided in.
- *
+ *
* @param units Units that data in the feed is provided in.
*/
public void setUnits(Units units);
/**
* Current wind conditions at the location.
- *
+ *
* @return Current wind conditions at the location.
*/
public Wind getWind();
/**
* Current wind conditions at the location.
- *
+ *
* @param wind Current wind conditions at the location.
*/
public void setWind(Wind wind);
/**
* The current atmospheric conditions.
- *
+ *
* @return Atmosphere object.
*/
public Atmosphere getAtmosphere();
/**
* Sets the current atmopheric condictions
- *
+ *
* @param value Atmosphere object.
*/
public void setAtmosphere(Atmosphere value);
diff --git a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModule.java b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModule.java
index 530345b..b885dd5 100644
--- a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModule.java
+++ b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModule.java
@@ -39,7 +39,7 @@ import com.sun.syndication.feed.module.Module;
/**
* A simple parent interface that defines the feed URI
- *
+ *
* @version $Id: YWeatherModule.java,v 1.2 2008/01/22 14:50:06 kebernet Exp $
* @author Robert "kebernet" Cooper
*/
diff --git a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModuleImpl.java b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModuleImpl.java
index 893c043..d6e7eb4 100644
--- a/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModuleImpl.java
+++ b/src/main/java/org/rometools/feed/module/yahooweather/YWeatherModuleImpl.java
@@ -49,7 +49,7 @@ import com.sun.syndication.feed.module.ModuleImpl;
/**
* A Module implementation for entry or feed level information.
- *
+ *
* @version $Id: YWeatherModuleImpl.java,v 1.2 2008/01/22 14:50:06 kebernet Exp $
* @author Robert "kebernet" Cooper
*/
diff --git a/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleGenerator.java b/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleGenerator.java
index c8a5d30..6d7201d 100644
--- a/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleGenerator.java
+++ b/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleGenerator.java
@@ -52,7 +52,7 @@ import com.sun.syndication.io.ModuleGenerator;
/**
* The ModuleGenerator implementation for the Yahoo Weather plug in.
- *
+ *
* @version $Revision: 1.3 $
* @author Robert "kebernet" Cooper
*/
diff --git a/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleParser.java b/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleParser.java
index cef27c6..0bd4c21 100644
--- a/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleParser.java
+++ b/src/main/java/org/rometools/feed/module/yahooweather/io/WeatherModuleParser.java
@@ -63,7 +63,7 @@ import com.sun.syndication.io.ModuleParser;
/**
* ModuleParser implementation for Slash RSS.
- *
+ *
* @version $Revision: 1.2 $
* @author Robert "kebernet" Cooper
*/
@@ -144,7 +144,7 @@ public class WeatherModuleParser implements ModuleParser {
try {
final Condition c = new Condition(condition.getAttributeValue("text"), ConditionCode.fromCode(Integer.parseInt(condition
.getAttributeValue("code"))), Integer.parseInt(condition.getAttributeValue("temp")), LONG_DATE.parse(condition
- .getAttributeValue("date").replaceAll("pm", "PM").replaceAll("am", "AM")));
+ .getAttributeValue("date").replaceAll("pm", "PM").replaceAll("am", "AM")));
module.setCondition(c);
} catch (final NumberFormatException nfe) {
Logger.getAnonymousLogger().warning("NumberFormatException processing
* Condition codes are used in the yweather:forecast element to describe the current conditions. *
@@ -56,7 +56,7 @@ import com.sun.syndication.feed.impl.EqualsBean; *