David Chandler's Journal of Java Web and Mobile Development

  • David M. Chandler

    Web app developer since 1994 and Google Cloud Platform Instructor now residing in Colorado. Besides tech, I enjoy landscape photography and share my work at ColoradoPhoto.gallery.

  • Subscribe

  • Enter your email address to subscribe to this blog and receive notifications of new posts by email.

    Join 224 other followers
  • Sleepless Nights…

    July 2011
    S M T W T F S
  • Blog Stats

    • 1,035,335 hits

Archive for July, 2011

Custom search shortcuts in Chrome

Posted by David Chandler on July 25, 2011

One of my favorite Chrome features is the “one box” which serves as both address bar and search box. Press Ctrl+L and away you go. It’s also the handiest way to access bookmarks. Press Ctrl+L and start typing the name of one of your bookmarks, and you’ll see it appear as one of the starred items. Just arrow down and press Enter to go to the bookmark. Some Chrome extensions contribute shortcuts to the one box, and you can also create your own.

For example, let’s create a shortcut to search dictionary.com. Right-click in the Chrome onebox and click Edit search providers. You’ll see many defined already. Scroll to the bottom and click in the box that says Add a new search engine. Type “Dictionary.com”, then tab to the next box, where you’ll enter a shortcut. Type the letter “d”, then tab to the next box and enter this URL: “http://dictionary.reference.com/browse/%s”. To save the shortcut, click anywhere on the page.

Now try it out: press Ctrl+L and type “d blogger” then press Enter. As soon as you type the space after “d”, you’ll see that you’re searching Dictionary.com, and when you press Enter, your results appear.

Here are some other useful shortcuts:

In most cases, you can determine the correct URL by doing a search at the target Web site (like weatherbug.com) and observing the URL in the address bar after the search. Simply replace your search words in the URL with “%s” as in the examples above.

Happy shortcutting!

Posted in PC Tech | 3 Comments »

GWT performance tip: watch out for String.split()

Posted by David Chandler on July 12, 2011

GWT benchmarking inside Google shows that due to intentional emulation of the differences between Java and JS regex, GWT’s emulated implementation of String.split() is about an order of magnitude slower than the native split on all browsers. On Chrome, it can be up to 1000x slower (6000 ms vs. 6 ms) if the strings are large enough (>1 MB in benchmark testing). This isn’t likely to be noticeable in many real-world applications, but if you happen to be doing a lot of String manipulation in GWT, you should consider using JS native methods instead.

Posted in Google Web Toolkit | 1 Comment »

Sending HTML emails with App Engine and Velocity in a Maven project

Posted by David Chandler on July 6, 2011

I’ve been using the App Engine Mail API for a while now to send emails in plain text format, but recently decided to beef it up to allow HTML formatting. In addition, I wanted a template-based approach so I could more easily modify the email contents. To achieve both purposes, I chose Apache Velocity, an easy-to-use, general purpose framework that lets you easily create anything textual from a template (text, email, XML, even Java code once on a previous project).

The main subtlety to observe when using Velocity with App Engine is that by default, Velocity uses the filesystem resource loader to load templates. This works fine in the App Engine development server and should also work in production as long as you put your templates in the WAR. Since my project is using Maven, however, the standard way to do this is to put templates in src/main/resources and let Maven automatically copy them to WEB-INF/classes during the build. In order for Velocity to see them on the classpath, you need Velocity’s ClasspathResourceLoader, so I created a helper class that lazily initializes the Velocity engine with the required resource loader:

 * Singleton that initializes Velocity engine instance with the classpath resource loader
 * @author David Chandler
public class VelocityHelper {
  private static VelocityEngine velocityEngine;

  static VelocityEngine getVelocityEngine() {
    if (velocityEngine == null)
    return velocityEngine;

  private static void init() {
    velocityEngine = new VelocityEngine();
    Properties velocityProperties = new Properties();
    velocityProperties.put("resource.loader", "class");
    velocityProperties.put("class.resource.loader.description", "Velocity Classpath Resource Loader");

To use the template, first populate the VelocityContext with variables to be replaced, then merge the template:

VelocityContext context = new VelocityContext();
context.put("date", today);
context.put("username", "johndoe");
VelocityEngine ve = VelocityHelper.getVelocityEngine();
// Finds template in WEB-INF/classes
template = ve.getTemplate("emailTemplate.vm");
StringWriter writer = new StringWriter();
template.merge(context, writer);

Since we’re sending an HTML email, the template is just an HTML file named emailTemplate.vm (by convention–.vm stands for Velocity macro). The template merge substitutes variables like ${date} with their values from the VelocityContext populated above. You can also loop over Collections with #foreach ($item in $list) … #end.

Now let’s send the email. There are a couple things to observe here.

First, webmail readers like Gmail write the HEAD and BODY tags to the page, so the browser will likely ignore these tags in your HTML template. This means you can’t link a stylesheet in the HEAD section of your HTML and expect it to work across email clients. The most compatible approach is to use inline styles, that is, the style=”” attribute on various HTML tags right in your template.

Second, in order to send HTML email, you must set the MIME type correctly. Here is the code that takes the template output, sets the MIME type, and sends the email:

import java.util.Properties;
import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.AddressException;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import javax.servlet.ServletException;


Properties props = new Properties();
Session session = Session.getDefaultInstance(props, null);
	Message msg = new MimeMessage(session);
	msg.addRecipient(Message.RecipientType.TO, to);
	if (msgBody.startsWith("<!DOCTYPE html"))
		msg.setContent(msgBody, "text/html");
catch (AddressException e)
	throw new ServletException(e);
catch (MessagingException e)
	throw new ServletException(e);

That’s it in a nutshell. Spam away…


Posted in AppEngine | 9 Comments »

%d bloggers like this: