You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@roller.apache.org by ag...@apache.org on 2006/04/19 21:25:10 UTC
svn commit: r395363 -
/incubator/roller/branches/roller-newbackend/src/org/roller/model/AutoPingManager.java
Author: agilliland
Date: Wed Apr 19 12:25:08 2006
New Revision: 395363
URL: http://svn.apache.org/viewcvs?rev=395363&view=rev
Log:
code reformatting.
Modified:
incubator/roller/branches/roller-newbackend/src/org/roller/model/AutoPingManager.java
Modified: incubator/roller/branches/roller-newbackend/src/org/roller/model/AutoPingManager.java
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller-newbackend/src/org/roller/model/AutoPingManager.java?rev=395363&r1=395362&r2=395363&view=diff
==============================================================================
--- incubator/roller/branches/roller-newbackend/src/org/roller/model/AutoPingManager.java (original)
+++ incubator/roller/branches/roller-newbackend/src/org/roller/model/AutoPingManager.java Wed Apr 19 12:25:08 2006
@@ -8,63 +8,34 @@
package org.roller.model;
+import java.io.Serializable;
+import java.util.Collection;
+import java.util.List;
+import org.roller.RollerException;
import org.roller.pojos.AutoPingData;
import org.roller.pojos.PingTargetData;
-import org.roller.pojos.WebsiteData;
import org.roller.pojos.WeblogEntryData;
-import org.roller.RollerException;
+import org.roller.pojos.WebsiteData;
-import java.io.Serializable;
-import java.util.Collection;
-import java.util.List;
/**
* Manages autoping storage/retrieval, queries and queue.
*/
-public interface AutoPingManager extends Serializable
-{
- /**
- * Release all resources associated with Roller session.
- */
- public void release();
-
+public interface AutoPingManager extends Serializable {
+
+
/**
* Create an auto ping configuration specifying that the given ping target is to be pinged when the given website
* changes.
* @param pingTarget target to ping
* @param website website whose changes should trigger the ping
* @return new auto ping configuration
- * @throws RollerException
- */
- public AutoPingData createAutoPing(PingTargetData pingTarget, WebsiteData website)
- throws RollerException;
-
- /*
- * Create an auto ping configuration specifying that the given pingTarget is to be pinged when the
- * given website changes, but only for changes on one of the specified categories of that website.
- * If the collection of categories is empty, this has the same effect as creating an unrestricted
- * auto ping configuration.
- *
- * @param pingTarget
- * @param website website whose changes should trigger the ping (subject to category restrictions)
- * @param categories categories in which changes should trigger the ping
- * @return new auto ping configuration
- * @throws RollerException
-
- public AutoPingData createAutoPing(PingTargetData pingTarget,
- WebsiteData website,
- Collection categories) throws RollerException;
- */
-
- /**
- * Retrieve an auto ping configuration by id.
- *
- * @param id the id of the auto ping configuration to retrieve.
- * @return the auto ping configuration with specified id or null if not found
* @throws RollerException
*/
- public AutoPingData retrieveAutoPing(String id) throws RollerException;
-
+ public AutoPingData createAutoPing(PingTargetData pingTarget, WebsiteData website)
+ throws RollerException;
+
+
/**
* Store an auto ping configuration.
*
@@ -72,7 +43,7 @@
* @throws RollerException
*/
public void storeAutoPing(AutoPingData autoPing) throws RollerException;
-
+
/**
* Remove the auto ping configuration with given id.
*
@@ -80,7 +51,8 @@
* @throws RollerException
*/
public void removeAutoPing(AutoPingData autoPing) throws RollerException;
-
+
+
/**
* Remove the auto ping configuration for the given ping target and website, if one exists. Returns silently if it
* doesn't exist.
@@ -90,7 +62,8 @@
* @throws RollerException
*/
public void removeAutoPing(PingTargetData pingTarget, WebsiteData website) throws RollerException;
-
+
+
/**
* Remove a collection of auto ping configurations.
*
@@ -98,14 +71,26 @@
* @throws RollerException
*/
public void removeAutoPings(Collection autopings) throws RollerException;
-
+
+
/**
* Remove all auto ping configurations for all websites.
*
* @throws RollerException
*/
public void removeAllAutoPings() throws RollerException;
-
+
+
+ /**
+ * Retrieve an auto ping configuration by id.
+ *
+ * @param id the id of the auto ping configuration to retrieve.
+ * @return the auto ping configuration with specified id or null if not found
+ * @throws RollerException
+ */
+ public AutoPingData retrieveAutoPing(String id) throws RollerException;
+
+
/**
* Get all of the auto ping configurations for the given website.
*
@@ -113,7 +98,8 @@
* @return a list of auto ping configurations for the given website as <code>AutoPingData</code> objects.
*/
public List getAutoPingsByWebsite(WebsiteData website) throws RollerException;
-
+
+
/**
* Get all of the auto ping configurations for a given target (across all websites).
*
@@ -121,7 +107,27 @@
* @return a list of auto ping configurations for the given target as <code>AutoPingData</code> objects.
*/
public List getAutoPingsByTarget(PingTargetData pingTarget) throws RollerException;
-
+
+
+ /**
+ * Get the auto ping configurations that should be pinged upon creation/change of the given weblog entry.
+ *
+ * @param changedWeblogEntry the entry that has been created or changed
+ * @return a list of the ping configurations that should be applied due to this change
+ */
+ public List getApplicableAutoPings(WeblogEntryData changedWeblogEntry) throws RollerException;
+
+
+ /**
+ * Queue the auto ping configurations that should be pinged upon change to the given weblog entry. This calls the
+ * {@link PingQueueManager} to queue ping requests for each ping configuration that should be applied on change to
+ * the given weblog entry. If ping processing is suspended, this returns without doing anything.
+ *
+ * @param changedWeblogEntry the entry that has been created or changed
+ */
+ public void queueApplicableAutoPings(WeblogEntryData changedWeblogEntry) throws RollerException;
+
+
/**
* Get the category restrictions on the given auto ping configuration.
*
@@ -131,7 +137,8 @@
* in any category of the website).
*/
public List getCategoryRestrictions(AutoPingData autoPing) throws RollerException;
-
+
+
/**
* Set the category restrictions on the given ping configuration to the specified ones. If the new collection is
* empty, all category restrictions are removed.
@@ -140,22 +147,12 @@
* @param newCategories a collection of <code>WeblogCategoryData</code> objects for the new category restrictions
*/
public void setCategoryRestrictions(AutoPingData autoPing,
- Collection newCategories);
-
+ Collection newCategories);
+
+
/**
- * Get the auto ping configurations that should be pinged upon creation/change of the given weblog entry.
- *
- * @param changedWeblogEntry the entry that has been created or changed
- * @return a list of the ping configurations that should be applied due to this change
- */
- public List getApplicableAutoPings(WeblogEntryData changedWeblogEntry) throws RollerException;
-
- /**
- * Queue the auto ping configurations that should be pinged upon change to the given weblog entry. This calls the
- * {@link PingQueueManager} to queue ping requests for each ping configuration that should be applied on change to
- * the given weblog entry. If ping processing is suspended, this returns without doing anything.
- *
- * @param changedWeblogEntry the entry that has been created or changed
+ * Release all resources associated with Roller session.
*/
- public void queueApplicableAutoPings(WeblogEntryData changedWeblogEntry) throws RollerException;
+ public void release();
+
}