Java tutorial
/* Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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. See the License for the specific language governing permissions and limitations under the License. */ package org.apache.wiki.ui; import java.io.ByteArrayOutputStream; import java.io.IOException; import java.io.OutputStream; import java.io.OutputStreamWriter; import java.io.PrintWriter; import java.io.UnsupportedEncodingException; import javax.servlet.FilterChain; import javax.servlet.FilterConfig; import javax.servlet.ServletContext; import javax.servlet.ServletException; import javax.servlet.ServletOutputStream; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpServletResponseWrapper; import org.apache.commons.lang.StringUtils; import org.apache.log4j.NDC; import org.apache.wiki.WatchDog; import org.apache.wiki.WikiContext; import org.apache.wiki.WikiEngine; import org.apache.wiki.event.WikiEventManager; import org.apache.wiki.event.WikiPageEvent; import org.apache.wiki.url.DefaultURLConstructor; import org.apache.wiki.util.TextUtil; import org.apache.wiki.util.UtilJ2eeCompat; /** * This filter goes through the generated page response prior and * places requested resources at the appropriate inclusion markers. * This is done to let dynamic content (e.g. plugins, editors) * include custom resources, even after the HTML head section is * in fact built. This filter is typically the last filter to execute, * and it <em>must</em> run after servlet or JSP code that performs * redirections or sends error codes (such as access control methods). * <p> * Inclusion markers are placed by the IncludeResourcesTag; the * defult content templates (see .../templates/default/commonheader.jsp) * are configured to do this. As an example, a JavaScript resource marker * is added like this: * <pre> * <wiki:IncludeResources type="script"/> * </pre> * Any code that requires special resources must register a resource * request with the TemplateManager. For example: * <pre> * <wiki:RequestResource type="script" path="scripts/custom.js" /> * </pre> * or programmatically, * <pre> * TemplateManager.addResourceRequest( context, TemplateManager.RESOURCE_SCRIPT, "scripts/customresource.js" ); * </pre> * * @see TemplateManager * @see org.apache.wiki.tags.RequestResourceTag */ public class WikiJSPFilter extends WikiServletFilter { private Boolean m_useOutputStream; private String m_wiki_encoding; /** {@inheritDoc} */ public void init(FilterConfig config) throws ServletException { super.init(config); m_wiki_encoding = m_engine.getWikiProperties().getProperty(WikiEngine.PROP_ENCODING); ServletContext context = config.getServletContext(); m_useOutputStream = UtilJ2eeCompat.useOutputStream(context.getServerInfo()); } public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws ServletException, IOException { WatchDog w = m_engine.getCurrentWatchDog(); try { NDC.push(m_engine.getApplicationName() + ":" + ((HttpServletRequest) request).getRequestURI()); w.enterState("Filtering for URL " + ((HttpServletRequest) request).getRequestURI(), 90); HttpServletResponseWrapper responseWrapper; if (m_useOutputStream) { log.debug("Using ByteArrayResponseWrapper"); responseWrapper = new ByteArrayResponseWrapper((HttpServletResponse) response, m_wiki_encoding); } else { log.debug("Using MyServletResponseWrapper"); responseWrapper = new MyServletResponseWrapper((HttpServletResponse) response, m_wiki_encoding); } // fire PAGE_REQUESTED event String pagename = DefaultURLConstructor.parsePageFromURL((HttpServletRequest) request, response.getCharacterEncoding()); fireEvent(WikiPageEvent.PAGE_REQUESTED, pagename); super.doFilter(request, responseWrapper, chain); // The response is now complete. Lets replace the markers now. // WikiContext is only available after doFilter! (That is after // interpreting the jsp) try { w.enterState("Delivering response", 30); WikiContext wikiContext = getWikiContext(request); String r = filter(wikiContext, responseWrapper); if (m_useOutputStream) { OutputStreamWriter out = new OutputStreamWriter(response.getOutputStream(), response.getCharacterEncoding()); out.write(r); out.flush(); out.close(); } else { response.getWriter().write(r); } // Clean up the UI messages and loggers if (wikiContext != null) { wikiContext.getWikiSession().clearMessages(); } // fire PAGE_DELIVERED event fireEvent(WikiPageEvent.PAGE_DELIVERED, pagename); } finally { w.exitState(); } } finally { w.exitState(); NDC.pop(); NDC.remove(); } } /** * Goes through all types and writes the appropriate response. * * @param wikiContext The usual processing context * @param response The source string * @return The modified string with all the insertions in place. */ private String filter(WikiContext wikiContext, HttpServletResponse response) { String string = response.toString(); if (wikiContext != null) { String[] resourceTypes = TemplateManager.getResourceTypes(wikiContext); for (int i = 0; i < resourceTypes.length; i++) { string = insertResources(wikiContext, string, resourceTypes[i]); } // // Add HTTP header Resource Requests // String[] headers = TemplateManager.getResourceRequests(wikiContext, TemplateManager.RESOURCE_HTTPHEADER); for (int i = 0; i < headers.length; i++) { String key = headers[i]; String value = ""; int split = headers[i].indexOf(':'); if (split > 0 && split < headers[i].length() - 1) { key = headers[i].substring(0, split); value = headers[i].substring(split + 1); } response.addHeader(key.trim(), value.trim()); } } return string; } /** * Inserts whatever resources * were requested by any plugins or other components for this particular * type. * * @param wikiContext The usual processing context * @param string The source string * @param type Type identifier for insertion * @return The filtered string. */ private String insertResources(WikiContext wikiContext, String string, String type) { if (wikiContext == null) { return string; } String marker = TemplateManager.getMarker(wikiContext, type); int idx = string.indexOf(marker); if (idx == -1) { return string; } log.debug("...Inserting..."); String[] resources = TemplateManager.getResourceRequests(wikiContext, type); StringBuilder concat = new StringBuilder(resources.length * 40); for (int i = 0; i < resources.length; i++) { log.debug("...:::" + resources[i]); concat.append(resources[i]); } string = TextUtil.replaceString(string, idx, idx + marker.length(), concat.toString()); return string; } /** * Simple response wrapper that just allows us to gobble through the entire * response before it's output. */ private static class MyServletResponseWrapper extends HttpServletResponseWrapper { ByteArrayOutputStream m_output; private MyServletOutputStream m_servletOut; private PrintWriter m_writer; public MyServletResponseWrapper(HttpServletResponse r, final String wiki_encoding) throws UnsupportedEncodingException { super(r); m_output = new ByteArrayOutputStream(); m_servletOut = new MyServletOutputStream(m_output); m_writer = new PrintWriter(new OutputStreamWriter(m_servletOut, wiki_encoding), true); } /** * Returns a writer for output; this wraps the internal buffer * into a PrintWriter. */ public PrintWriter getWriter() { return m_writer; } public ServletOutputStream getOutputStream() { return m_servletOut; } public void flushBuffer() throws IOException { m_writer.flush(); super.flushBuffer(); } class MyServletOutputStream extends ServletOutputStream { ByteArrayOutputStream m_buffer; public MyServletOutputStream(ByteArrayOutputStream byteArrayOutputStream) { super(); m_buffer = byteArrayOutputStream; } @Override public void write(int aInt) throws IOException { m_buffer.write(aInt); } } /** * Returns whatever was written so far into the Writer. */ public String toString() { try { flushBuffer(); } catch (IOException e) { log.error(MyServletResponseWrapper.class + " toString() flushBuffer() Failed", e); return StringUtils.EMPTY; } return m_output.toString(); } } /** * Response wrapper for application servers which do not work with CharArrayWriter * Currently only OC4J */ private static class ByteArrayResponseWrapper extends HttpServletResponseWrapper { private HttpServletResponse m_response; private ByteArrayOutputStream m_output; private MyServletOutputStream m_servletOut; private PrintWriter m_writer; /** * How large the initial buffer should be. This should be tuned to achieve * a balance in speed and memory consumption. */ private static final int INIT_BUFFER_SIZE = 4096; public ByteArrayResponseWrapper(HttpServletResponse r, final String wiki_encoding) throws UnsupportedEncodingException { super(r); m_output = new ByteArrayOutputStream(INIT_BUFFER_SIZE); m_servletOut = new MyServletOutputStream(m_output); m_writer = new PrintWriter(new OutputStreamWriter(m_servletOut, wiki_encoding), true); m_response = r; } /** * Returns a writer for output; this wraps the internal buffer * into a PrintWriter. */ public PrintWriter getWriter() { return m_writer; } public ServletOutputStream getOutputStream() { return m_servletOut; } public void flushBuffer() throws IOException { m_writer.flush(); super.flushBuffer(); } class MyServletOutputStream extends ServletOutputStream { private OutputStream m_stream; public MyServletOutputStream(OutputStream aOutput) { super(); m_stream = aOutput; } @Override public void write(int aInt) throws IOException { m_stream.write(aInt); } } /** * Returns whatever was written so far into the Writer. */ public String toString() { try { flushBuffer(); return m_output.toString(m_response.getCharacterEncoding()); } catch (UnsupportedEncodingException e) { log.error(ByteArrayResponseWrapper.class + " Unsupported Encoding", e); return StringUtils.EMPTY; } catch (IOException e) { log.error(ByteArrayResponseWrapper.class + " toString() Flush Failed", e); return StringUtils.EMPTY; } } } // events processing ....................................................... /** * Fires a WikiPageEvent of the provided type and page name * to all registered listeners of the current WikiEngine. * * @see org.apache.wiki.event.WikiPageEvent * @param type the event type to be fired * @param pagename the wiki page name as a String */ protected final void fireEvent(int type, String pagename) { if (WikiEventManager.isListening(m_engine)) { WikiEventManager.fireEvent(m_engine, new WikiPageEvent(m_engine, type, pagename)); } } }