Added convenience methods for grabbing references to Config and TemplateRenderer.

Author: codedance

.gitignore

@@ -1,4 +1,5 @@
 *.swp
+.DS_Store
 /.settings
 /.classpath
 /.project

README.md

@@ -602,16 +602,17 @@ import com.papercut.silken.Config;
 Config config = (Config) getServletContext().getAttribute("silken.config");
 config.setLocaleResolver(new MyLocaleResolver());
 ```
-
 A logical place to perform this initalization would be in a startup servlet's
-init method.
+init method. It is also possible to access the ``Config`` class using the
+convenience method: ``SilkenServlet.getConfig()``. 
 
 ##Accessing the Template Renderer (Advanced)
 
 It's possible for non-servlet request code to access Silken's template
 rendering service. For example you may have a service that generates template
-emails. By using Silken's ``TemplateRenderer`` server, this email generation
-code can benefit from the same template structure, caching layer, etc.
+emails. By using Silken's ``TemplateRenderer`` service, your template email
+generation code can benefit from the same template structure, caching layer,
+etc. Example usage:
 
 ```java
 Map<String, String> model = ImmutableMap.of("username", username
@@ -620,10 +621,12 @@ Map<String, String> model = ImmutableMap.of("username", username
 TemplateRenderer renderer = (TemplateRenderer) context.getAttribute("silken.templateRenderer");
 
 String emailText = renderer.render("email.lostPassword", model);
-
 myEmailService.sendEmail(emailAddress, emailText);
 ```
 
+It is also possible to access the ``TemplateRenderer`` using the convenience
+method: ``SilkenServlet.getTemplateRenderer()``. 
+
 ##Supported Environments
 
 Silken will run in any standard Servlet hosting environment, including [Google

src/main/java/com/papercut/silken/SilkenServlet.java

@@ -85,6 +85,8 @@
  * @author chris
  */
 public class SilkenServlet extends HttpServlet {
+    
+    private static volatile SilkenServlet s_instance;
 
     private static final long serialVersionUID = 1L;
 
@@ -99,10 +101,6 @@ public class SilkenServlet extends HttpServlet {
 
     private final TemplateRenderer templateRenderer = new TemplateRenderer(config);
 
-    public Config getConfig() {
-        return config;
-    }
-
     @Override
     public void init(ServletConfig servletConfig) throws ServletException {
         super.init(servletConfig);
@@ -205,6 +203,8 @@ public void init(ServletConfig servletConfig) throws ServletException {
         		}	
         	}
         }
+        
+        s_instance = this;
     }
 
     @Override
@@ -344,4 +344,35 @@ private boolean isValueFalse(String value) {
         return (value.startsWith("f") || value.equals("0") || value.startsWith("n"));
     }
 
+    /**
+     * Advanced: A convenience method to get a reference to the currently loaded SilkenServlet. Use this method with
+     * care.  It assumes only one instance if the SilkenServlet is loaded in your server's context.
+     * 
+     * @return A reference to the currently loaded SilkenServlet.
+     */
+    public static SilkenServlet getInstance() {
+	if (s_instance == null) throw new IllegalStateException("The Silken Servlet is not yet initialized/loaded!");
+	return s_instance;
+    }
+    
+    /**
+     * Advanced: A convenience method to get a reference to the currently loaded SilkenServlet's Config class. Use this
+     * method with care.  Where possible obtain this reference from the "silken.config" servlet context attribute.
+     * 
+     * @return A reference to the currently loaded SilkenServet's Config class.
+     */
+    public static Config getConfig() {
+	return getInstance().config;
+    }
+    
+    /**
+     * Advanced: A convenience method to get a reference to the currently loaded TemplateRender. Use this method with 
+     * care.  Where possible obtain this reference from the "silken.templateRenderer" servlet context attribute.
+     * 
+     * @return A reference to the currently loaded TemplateRenderer hosted by Silken.
+     */
+    public static TemplateRenderer getTemplateRenderer() {
+	return getInstance().templateRenderer;
+    }
+
 }