@header@

<table width="100%" cellspacing="0" cellpadding="8" class="item">
  <tr class="itemHeader">
    <td>
      Blog Listeners
    </td>
  </tr>
  <tr class="itemBody">
    <td>
      <p>
      Blog listeners are a type of Pebble plugin that allow you to write code that is called
      whenever your blog is started and stopped. Example uses include:
      <ul>
        <li>Initialising/flushing a cache when the blog is started/stopped.</li>
        <li>Opening/closing a connection to an external data source that is used by another type of Pebble plugin.</li>
        <li>Starting/stopping a thread that subscribes to an RSS feed and automatically posts new content to your blog.</li>
      </ul>
      </p>

      <p>
      To write your own listener, you need to write a Java class that implements the <a href="../javadoc/pebble/event/BlogListener.html">pebble.event.blog.BlogListener</a> interface
      as shown below. To gain access to the associated <a href="../javadoc/pebble/blog/Blog.html">blog</a>, simply use the <code>getBlog()</code> method on the <a href="../javadoc/pebble/event/BlogEvent.html">pebble.event.blog.BlogEvent</a> object
      that is passed to the callback methods.
<pre>  package pebble.event;

  /**
   * Implemented by classes wanting to be notified of blog events.
   *
   * @author Simon Brown
   */
  public interface BlogListener {

    /**
     * Called when a blog has been started.
     *
     * @param event   a BlogEvent instance
     */
    public void blogStarted(BlogEvent event);

    /**
     * Called when a blog has been stopped.
     *
     * @param event   a BlogEvent instance
     */
    public void blogStopped(BlogEvent event);

  }</pre>
      </p>
    </td>
  </tr>
</table>

@footer@