KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > blojsom > plugin > footnote > FootnotePlugin


1 /**
2  * Copyright (c) 2003-2006, David A. Czarnecki
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * Redistributions of source code must retain the above copyright notice, this list of conditions and the
9  * following disclaimer.
10  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
11  * following disclaimer in the documentation and/or other materials provided with the distribution.
12  * Neither the name of "David A. Czarnecki" and "blojsom" nor the names of its contributors may be used to
13  * endorse or promote products derived from this software without specific prior written permission.
14  * Products derived from this software may not be called "blojsom", nor may "blojsom" appear in their name,
15  * without prior written permission of David A. Czarnecki.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
18  * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
19  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
20  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
21  * EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
27  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
29  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30  */

31 package org.blojsom.plugin.footnote;
32
33 import org.apache.commons.logging.Log;
34 import org.apache.commons.logging.LogFactory;
35 import org.blojsom.blog.Blog;
36 import org.blojsom.blog.Entry;
37 import org.blojsom.plugin.Plugin;
38 import org.blojsom.plugin.PluginException;
39 import org.blojsom.util.BlojsomUtils;
40
41 import javax.servlet.http.HttpServletRequest JavaDoc;
42 import javax.servlet.http.HttpServletResponse JavaDoc;
43 import java.text.MessageFormat JavaDoc;
44 import java.util.Iterator JavaDoc;
45 import java.util.Map JavaDoc;
46 import java.util.TreeMap JavaDoc;
47 import java.util.regex.Matcher JavaDoc;
48 import java.util.regex.Pattern JavaDoc;
49
50 /**
51  * Footnote Expansion Plugin
52  *
53  * @author Mark Lussier
54  * @author David Czarnecki
55  * @since blojsom 3.0
56  * @version $Id: FootnotePlugin.java,v 1.2 2006/03/20 22:50:39 czarneckid Exp $
57  */

58 public class FootnotePlugin implements Plugin {
59
60     private static final String JavaDoc FOOTNOTE_METADATA = "footnote";
61     private static final String JavaDoc REGEX_FOOTNOTE = "\\[(\\d+)\\]";
62     private static final String JavaDoc FOOTNOTE_LINKAGE_FORMAT = "[{0}] {1}";
63     private static final String JavaDoc FOOTNOTES_PROCESSED_METADATA = "footnotes-processed";
64
65     private Log _logger = LogFactory.getLog(FootnotePlugin.class);
66
67     /**
68      * Initialize this plugin. This method only called when the plugin is instantiated.
69      *
70      * @throws org.blojsom.plugin.PluginException
71      * If there is an error initializing the plugin
72      */

73     public void init() throws PluginException {
74     }
75
76     /**
77      * Process the blog entries
78      *
79      * @param httpServletRequest Request
80      * @param httpServletResponse Response
81      * @param blog {@link Blog} instance
82      * @param context Context
83      * @param entries Blog entries retrieved for the particular request
84      * @return Modified set of blog entries
85      * @throws PluginException If there is an error processing the blog entries
86      */

87     public Entry[] process(HttpServletRequest JavaDoc httpServletRequest, HttpServletResponse JavaDoc httpServletResponse, Blog blog, Map JavaDoc context, Entry[] entries) throws PluginException {
88         Pattern JavaDoc footnotePattern = Pattern.compile(REGEX_FOOTNOTE);
89
90         for (int i = 0; i < entries.length; i++) {
91             Entry entry = entries[i];
92             String JavaDoc content = entry.getDescription();
93             Matcher JavaDoc matcher = footnotePattern.matcher(content);
94             StringBuffer JavaDoc modifiedContent = new StringBuffer JavaDoc();
95             Map JavaDoc footnotes = new TreeMap JavaDoc();
96
97             while (matcher.find()) {
98                 int footnoteIndex;
99
100                 try {
101                     footnoteIndex = Integer.parseInt(matcher.group(1));
102                     if (BlojsomUtils.checkMapForKey(entry.getMetaData(), FOOTNOTE_METADATA + "-" + footnoteIndex)) {
103                         footnotes.put(Integer.toString(footnoteIndex), entry.getMetaData().get(FOOTNOTE_METADATA + "-" + footnoteIndex));
104                     }
105
106                     matcher.appendReplacement(modifiedContent, "<sup id=\"footnoteref-" + footnoteIndex + "\"><a HREF=\"#footnote-" + footnoteIndex + "\">" + footnoteIndex + "</a></sup>");
107                 } catch (NumberFormatException JavaDoc e) {
108                     if (_logger.isErrorEnabled()) {
109                         _logger.error("Footnote index in post is not a valid integer [" + matcher.group(1) + "]");
110                     }
111                 }
112             }
113
114             matcher.appendTail(modifiedContent);
115
116             if (!footnotes.isEmpty() && !BlojsomUtils.checkMapForKey(entry.getMetaData(), FOOTNOTES_PROCESSED_METADATA)) {
117                 modifiedContent.append("<br/><br/>");
118                 modifiedContent.append("<div class=\"footnote\">");
119                 modifiedContent.append("<hr/>");
120                 modifiedContent.append("<ol>");
121                 Iterator JavaDoc footnotesIterator = footnotes.keySet().iterator();
122                 
123                 while (footnotesIterator.hasNext()) {
124                     String JavaDoc footnoteIndex = (String JavaDoc) footnotesIterator.next();
125                     modifiedContent.append("<li id=\"footnote-").append(footnoteIndex).append("\"><p>");
126                     modifiedContent.append(MessageFormat.format(FOOTNOTE_LINKAGE_FORMAT, new Object JavaDoc[] {footnoteIndex, entry.getMetaData().get(FOOTNOTE_METADATA + "-" + footnoteIndex)}));
127                     modifiedContent.append("<a HREF=\"#footnoteref-").append(footnoteIndex).append("\" class=\"footnoteBackLink\" title=\"Jump back to footnote ").append(footnoteIndex).append(" in the text.\">");
128                     modifiedContent.append("&#8617;</a></p></li>");
129                 }
130
131                 modifiedContent.append("</ol>");
132                 modifiedContent.append("</div>");
133
134                 entry.getMetaData().put(FOOTNOTES_PROCESSED_METADATA, "true");
135             }
136
137             entry.setDescription(modifiedContent.toString());
138         }
139
140         return entries;
141     }
142
143     /**
144      * Perform any cleanup for the plugin. Called after {@link #process}.
145      *
146      * @throws org.blojsom.plugin.PluginException
147      * If there is an error performing cleanup for this plugin
148      */

149     public void cleanup() throws PluginException {
150     }
151
152     /**
153      * Called when BlojsomServlet is taken out of service
154      *
155      * @throws org.blojsom.plugin.PluginException
156      * If there is an error in finalizing this plugin
157      */

158     public void destroy() throws PluginException {
159     }
160
161 }
162
Popular Tags