org.blojsom.plugin.comment
Class CommentPlugin

java.lang.Object
  org.blojsom.plugin.velocity.StandaloneVelocityPlugin
      org.blojsom.plugin.comment.CommentPlugin

All Implemented Interfaces:

Listener, Plugin

public class CommentPlugin

extends StandaloneVelocityPlugin

implements Listener

CommentPlugin

Since:

blojsom 3.0

Version:

$Id: CommentPlugin.java,v 1.14 2007/01/21 15:42:47 czarneckid Exp $

Author:

David Czarnecki

Field Summary

protected EventBroadcaster	_eventBroadcaster
static java.lang.String	AUTHOR_EMAIL_PARAM Request parameter for the "authorEmail"
static java.lang.String	AUTHOR_PARAM Request parameter for the "author"
static java.lang.String	AUTHOR_URL_PARAM Request parameter for the "authorURL"
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_AUTHOR Key under which the author from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_AUTHOR_EMAIL Key under which the author's e-mail from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_AUTHOR_URL Key under which the author's URL from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_BLOG_COMMENT Key under which the blog comment will be placed for merging the comment e-mail
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_BLOG_ENTRY Key under which the blog entry will be placed for merging the comment e-mail
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_ENABLED Key under which the indicator this plugin is "live" will be placed (example: on the request for the JSPDispatcher)
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_METADATA_IP IP address meta-data
static java.lang.String	BLOJSOM_COMMENT_PLUGIN_REMEMBER_ME Key under which the "remember me" checkbox from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)
static java.lang.String	BLOJSOM_PLUGIN_COMMENT_METADATA
static java.lang.String	BLOJSOM_PLUGIN_COMMENT_METADATA_DESTROY
static java.lang.String	COMMENT_AUTOFORMAT_IP Initialization parameter to do plugin autoformatting
static java.lang.String	COMMENT_COOKIE_EXPIRATION_DURATION_IP Initialization parameter for the duration of the "remember me" cookies
static java.lang.String	COMMENT_DAYS_EXPIRATION_IP Initialization parameter for disabling comments on entries after a certain number of days
static java.lang.String	COMMENT_PARAM Request parameter for the "comment"
static java.lang.String	COMMENT_PLUGIN_EMAIL_TEMPLATE_HTML
static java.lang.String	COMMENT_PLUGIN_EMAIL_TEMPLATE_TEXT Template for comment e-mails
static java.lang.String	COMMENT_PREFIX_IP Initialization parameter for e-mail prefix
static java.lang.String	COMMENT_TEXT_PARAM Request parameter for the "commentText"
static java.lang.String	COMMENT_THROTTLE_MINUTES_IP Initialization parameter for the throttling of comments from IP addresses
static java.lang.String	DEFAULT_COMMENT_PREFIX Default prefix for comment e-mail notification

Fields inherited from class org.blojsom.plugin.velocity.StandaloneVelocityPlugin

_servletConfig, _velocityProperties

Constructor Summary

CommentPlugin()

Method Summary

void	cleanup() Perform any cleanup for the plugin.
void	destroy() Called when BlojsomServlet is taken out of service
void	handleEvent(Event event) Handle an event broadcast from another component
void	init() Initialize this plugin.
Entry[]	process(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse, Blog blog, java.util.Map context, Entry[] entries) Process the blog entries
void	processEvent(Event event) Process an event from another component
void	setEventBroadcaster(EventBroadcaster eventBroadcaster) Set the EventBroadcaster event broadcaster
void	setFetcher(Fetcher fetcher) Set the Fetcher
protected void	setupEmail(Blog blog, Entry entry, org.apache.commons.mail.Email email) Setup the comment e-mail

Methods inherited from class org.blojsom.plugin.velocity.StandaloneVelocityPlugin

mergeTemplate, setServletConfig, setVelocityProperties

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COMMENT_PLUGIN_EMAIL_TEMPLATE_TEXT

public static final java.lang.String COMMENT_PLUGIN_EMAIL_TEMPLATE_TEXT

Template for comment e-mails

See Also:

Constant Field Values

COMMENT_PLUGIN_EMAIL_TEMPLATE_HTML

public static final java.lang.String COMMENT_PLUGIN_EMAIL_TEMPLATE_HTML

See Also:

Constant Field Values

DEFAULT_COMMENT_PREFIX

public static final java.lang.String DEFAULT_COMMENT_PREFIX

Default prefix for comment e-mail notification

See Also:

Constant Field Values

COMMENT_PREFIX_IP

public static final java.lang.String COMMENT_PREFIX_IP

Initialization parameter for e-mail prefix

See Also:

Constant Field Values

COMMENT_AUTOFORMAT_IP

public static final java.lang.String COMMENT_AUTOFORMAT_IP

Initialization parameter to do plugin autoformatting

See Also:

Constant Field Values

COMMENT_COOKIE_EXPIRATION_DURATION_IP

public static final java.lang.String COMMENT_COOKIE_EXPIRATION_DURATION_IP

Initialization parameter for the duration of the "remember me" cookies

See Also:

Constant Field Values

COMMENT_THROTTLE_MINUTES_IP

public static final java.lang.String COMMENT_THROTTLE_MINUTES_IP

Initialization parameter for the throttling of comments from IP addresses

See Also:

Constant Field Values

COMMENT_DAYS_EXPIRATION_IP

public static final java.lang.String COMMENT_DAYS_EXPIRATION_IP

Initialization parameter for disabling comments on entries after a certain number of days

See Also:

Constant Field Values

COMMENT_PARAM

public static final java.lang.String COMMENT_PARAM

Request parameter for the "comment"

See Also:

Constant Field Values

AUTHOR_PARAM

public static final java.lang.String AUTHOR_PARAM

Request parameter for the "author"

See Also:

Constant Field Values

AUTHOR_EMAIL_PARAM

public static final java.lang.String AUTHOR_EMAIL_PARAM

Request parameter for the "authorEmail"

See Also:

Constant Field Values

AUTHOR_URL_PARAM

public static final java.lang.String AUTHOR_URL_PARAM

Request parameter for the "authorURL"

See Also:

Constant Field Values

COMMENT_TEXT_PARAM

public static final java.lang.String COMMENT_TEXT_PARAM

Request parameter for the "commentText"

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_ENABLED

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_ENABLED

Key under which the indicator this plugin is "live" will be placed (example: on the request for the JSPDispatcher)

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_AUTHOR

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_AUTHOR

Key under which the author from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_AUTHOR_EMAIL

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_AUTHOR_EMAIL

Key under which the author's e-mail from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_AUTHOR_URL

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_AUTHOR_URL

Key under which the author's URL from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_REMEMBER_ME

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_REMEMBER_ME

Key under which the "remember me" checkbox from the "remember me" cookie will be placed (example: on the request for the JSPDispatcher)

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_METADATA_IP

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_METADATA_IP

IP address meta-data

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_BLOG_ENTRY

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_BLOG_ENTRY

Key under which the blog entry will be placed for merging the comment e-mail

See Also:

Constant Field Values

BLOJSOM_COMMENT_PLUGIN_BLOG_COMMENT

public static final java.lang.String BLOJSOM_COMMENT_PLUGIN_BLOG_COMMENT

Key under which the blog comment will be placed for merging the comment e-mail

See Also:

Constant Field Values

BLOJSOM_PLUGIN_COMMENT_METADATA

public static final java.lang.String BLOJSOM_PLUGIN_COMMENT_METADATA

See Also:

Constant Field Values

BLOJSOM_PLUGIN_COMMENT_METADATA_DESTROY

public static final java.lang.String BLOJSOM_PLUGIN_COMMENT_METADATA_DESTROY

See Also:

Constant Field Values

_eventBroadcaster

protected EventBroadcaster _eventBroadcaster

Constructor Detail

CommentPlugin

public CommentPlugin()

Method Detail

setEventBroadcaster

public void setEventBroadcaster(EventBroadcaster eventBroadcaster)

Set the EventBroadcaster event broadcaster

Parameters:

eventBroadcaster - EventBroadcaster

setFetcher

public void setFetcher(Fetcher fetcher)

Set the Fetcher

Parameters:

fetcher - Fetcher

init

public void init()
          throws PluginException

Initialize this plugin. This method only called when the plugin is instantiated.

Specified by:

init in interface Plugin

Overrides:

init in class StandaloneVelocityPlugin

Throws:

PluginException - If there is an error initializing the plugin

process

public Entry[] process(javax.servlet.http.HttpServletRequest httpServletRequest,
                       javax.servlet.http.HttpServletResponse httpServletResponse,
                       Blog blog,
                       java.util.Map context,
                       Entry[] entries)
                throws PluginException

Process the blog entries

Specified by:

process in interface Plugin

Parameters:

httpServletRequest - Request

httpServletResponse - Response

blog - Blog instance

context - Context

entries - Blog entries retrieved for the particular request

Returns:

Modified set of blog entries

Throws:

PluginException - If there is an error processing the blog entries

cleanup

public void cleanup()
             throws PluginException

Perform any cleanup for the plugin. Called after process(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, org.blojsom.blog.Blog, java.util.Map, org.blojsom.blog.Entry[]).

Specified by:

cleanup in interface Plugin

Throws:

PluginException - If there is an error performing cleanup for this plugin

destroy

public void destroy()
             throws PluginException

Called when BlojsomServlet is taken out of service

Specified by:

destroy in interface Plugin

Throws:

PluginException - If there is an error in finalizing this plugin

setupEmail

protected void setupEmail(Blog blog,
                          Entry entry,
                          org.apache.commons.mail.Email email)
                   throws org.apache.commons.mail.EmailException

Setup the comment e-mail

Parameters:

blog - Blog information

entry - Entry

email - Email message

Throws:

org.apache.commons.mail.EmailException - If there is an error preparing the e-mail message

handleEvent

public void handleEvent(Event event)

Handle an event broadcast from another component

Specified by:

handleEvent in interface Listener

Parameters:

event - Event to be handled

processEvent

public void processEvent(Event event)

Process an event from another component

Specified by:

processEvent in interface Listener

Parameters:

event - Event to be handled