I recently wrote some fairly, um, extreme code for the Guice Mutibindings extension. That code makes use of several tricks that you might find useful in your own Guice extensions. In this series I'm going to show-and-tell the various clever code tricks from Multibinder.java. Initialize an extension Guice doesn't…
As previously alluded to, I've started work on the Multibindings API. I've checked in the initial implementation, and I'm pretty excited about it. You can grab it from svn. This feature is ideal for lightweight plugin-type architectures, where you've got multiple modules each contributing Servlets, Actions, Filters, Components or even…
As previously mentioned, I'm cataloging Guice's changes since 1.0. Suppose you have a provider that throws an unchecked exception: class PhaseOfTheMoonProvider implements Provider<PhaseOfTheMoon> { @Inject Observatory observatory; public PhaseOfTheMoon get() { if (observatory.isNighttime()) { return observatory.getCurrentPhase(); } throw new IllegalStateException("Can't see the moon unless…
Details on this year's Glazed Lists tech session: Simply Sweet Applications with Glazed Lists Ken Orr, The MathWorks Session TS-6047 Friday May 9 at 14:50, Hall E 135 From Ken's Abstract, Glazed Lists fosters data-centric design, which promotes decoupling of components and increases the testability of your code. This…
Multibindings is an idea to allow multiple independent modules to contribute elements to a collection. There's lots of proposed APIs to add multibindings to Guice. Unlike almost all of the existing proposals, this strategy can be used to add multibindings as an extension to Guice. Therefore we don't increase the…
As previously mentioned, I'm cataloging the differences in Guice since 1.0. This test passes in Guice 1.0, but how it does so is surprising: public class InjectTest extends TestCase { public void testFoo() { Foo foo = Guice.createInjector().getInstance(InnerFoo.class) } class InnerFoo implements Foo { @Inject InnerFoo() {} } } The problem is…
For the past month, I've been cataloging the various changes since Bob & Kevin released version 1.0 back in March 2007. For a 1.0, it's held up remarkably well. We've been using it on my team without many problems and we've quite enjoyed it. Good News! Guice has…
Michael Kölling blogged about Quines - programs that print themselves. Here's my best effort in Java (prettyprinted for readability): class A { static { String a="class A{static{String a=%s%s%1$s;System.out.printf(a,'%1$s',a);}}"; System.out.printf(a,'"',…
I just bought the new Panic At The Disco album on Amazon MP3. It was easy! And I don't have the DRM-guilt that I usually get whenever I buy stuff from iTunes. The price is right, the quality is high, and I don't have to do the Deregister Computer bullshit…
The following program is valid Java, even though the Runnable on line 1 is a completely different symbol than Runnable on line 3: public class Refrigerator implements Runnable { public void run() { new Runnable().freeze(); } public class Runnable { void freeze() { System.out.println("cold and refreshing"); } } public static void…
What's the simplest way to get CPU speed, amount of RAM, OS version, and other hardware details from the running JVM? I'm putting together a yet-to-be-announced tool that will include hardware specs in its reporting. So far, I've been able to get the hardware profile on Mac OS X using…
Part 15 in a Series. The Google Collections project has released an impressive new collection of features. The new release has prompted me to continue this series. My favourite feature of the new release is ImmutableSet. It's a top-level implementation of Set that's full of features - this class alone…
As previously mentioned, my current 20% project involves some RMI hackery. Today I ran into an unfortunate error message: java.lang.ClassNotFoundException: com.publicobject.m2x.Measurer (no security manager: RMI class loader disabled) at sun.rmi.server.LoaderHandler.loadClass(LoaderHandler.java:371) at sun.rmi.server.LoaderHandler.loadClass(LoaderHandler.java:…
One of the four steps to setup Java RMI is "Making classes network accessible." Since I'm new to Java RMI, I found this requirement surprising. We have a client and a server. Of the two of them, surely one of the two has a full set of classes.…
For part of an project which I'll be announcing shortly, I needed an extremely lightweight HTTP server. Fortunately, HTTP is quite easy-to-implement. Tonight I hacked together MiniHttpServer.java, a simple server with zero third-party dependencies. I was able to support the core of HTTP in with just 168 lines by…
Pop quiz - without reflection, access to private members, or changing the source, create an instance of Inner. public final class Outer { public static final Outer INSTANCE = new Outer(); private Outer() { } public class Inner { } } Note that Inner is non-static, so each Inner has a reference to its containing Outer. Show…
Suppose you'd like to remove an entry from a Map, and perform some action only if the remove actually removed. Since Map.remove() returns the value associated with the removed key, we can do this: if (map.remove(key) != null) { deleteAssociatedFiles(key); }`</pre> Unfortunately, if the map tolerates…
I love the ? : ternary operator. It makes my code feel tighter. Plus, I get to save code - fewer assignments, fewer return statements, and variable declarations are inline. In the code I was writing yesterday, a duplicated call to 'add()' made me itch for the ternary: for (String key…
From the Guice User's group, Congratulations Bob, Kevin and the rest of the Guice team! Guice beat out rival Spring and several other worthy projects to win the 2008 Jolt Award for libraries and tools. It was great to see the guys win - they deserve to be recognized for…
Often I see Javadoc with only an @return tag: /** * @return the current user assigned to make the delivery, or {@code null} * if no such assignment has been made. */ public User getDeliveryPerson();`</pre> Unfortunately, the `javadoc` command line tool doesn't handle this format particularly well. Since the method has…
I recently checked in a new Guice extension called commands. The goal is simple - make it possible to modify your modules at runtime. But modules aren't naturally data, they're more like code: Module module = new AbstractModule() { protected void configure() { bind(Soda.class).to(Coke.class); bind(Snack.class).to(…
Class.toString() doesn't return what you'd expect: assertEquals("java.lang.Integer", Integer.class.toString());`</pre> Instead, it prefixes the fully-qualified classname with "class " for classes, "interface " for interfaces and probably "enum " and "annotation " elsewhere. You need to call…
Java.net is having a poll on which version of closures is preferred for Java 7. I think this is a great opportunity for First-Class Methods (FCM) to get some attention as a worthy contender. Closures offer us the opportunity to make our Java code simpler by making the Java…
Guice loves class literals: bind(Foo.class) .toProvider(FooProvider.class);`</pre> Today I found out that there's a simple syntax for declaring a literal array. Just add an extra pair of square brackets: <pre class="prettyprint">` bind(Foo[].class) .toProvider(FooArrayProvider.class);…
I'm working on a simple API that deals with raw arrays - yuck! Did ya know that Arrays.hashCode(a) is the same as Arrays.asList(a).hashCode()? Somebody smart made it easy to migrate from arrays to Lists.…
A shared codebase means a shared styleguide. An issue that's come up a lot recently is where to put the damn @Override tag, and similar marker annotations. Above: @Override public String toString() { return "Delivery " + id; }`</pre> ### Inline <pre class="prettyprint">` @Override public…
Part 2 in a series. Suppose we have a simple interface that can initiate a delivery: interface DeliveryService { /** * Schedules {@link order} for immediate delivery to {@link destination}. * * @return a snapshot of the delivery in progress. */ Delivery scheduleDelivery(Order order, Address destination); ... }`</pre> Naturally there are several possible implementations…
In this series I document patterns, techniques and styles for designing fantastic APIs in Java. My target audience is software developers working with big teams on big projects. Many of the suggestions should be overkill for a weekend project. Topics in this series will range from simple style issues to…
Want sexy charts, but without the grief of Excel? In your blogs, emails, and projects? Use the recently released Google Chart API for fast and easy charts. Google Chart API Let's suppose we want to make the above pie chart. We simply build a URL that describes the image, and…
I have a DVR built into the receiver for my Canadian satellite dish. It's fantastic. I love being able to record Canadian football games and to do my own instant-replays when I see something great. Tonight I'm home alone - Jodie's out shopping in San Francisco. When I got home,…
I've got two classes, Base and Sub. I can freely make changes to Base. But Sub is written by a third party and I don't have privileges to make changes to it. Here's what they look like: public class Base { public void prepareForMission() { loadUpInfantry(); loadUpWeapons(); } } public class Sub extends Base…
Long before I was writing code, I liked to play with the CorelDRAW graphics suite. Unfortunately, Corel abandoned the Mac market five years ago! I've blogged some tips and tricks on getting CorelDRAW to run on new Macs. And a lot of people searched for them on Google and commented…
Stephan Schmidt writes, Beside the fact that my IDE does the typing with auto completion - of course the compiler knows - DUH. But the developer does not know.I couldn't agree more with his recent post on programming languages.…
I'm using Guice throughout my code, and I've found a pattern that works rather nicely. Suppose I've got a service interface method for scheduling a delivery: public interface DeliveryService { /** * Schedules {@link order} for delivery and returns a snapshot with * the details of the scheduled delivery. * * @param loggedInUser the customer service…
I'm fairly confident that Apple will be posting a download of Java 6 shortly. One of the MRJ developers gave a talk at Desktop Matters, and Java 6 is definitely being worked on. But I feel compelled to dispute a recent post on John Gruber's blog: Apple’s decision to…
When modeling an entity that may or may-not have an id assigned, writing the equals method is surprisingly hard. What to do when there's no id? Falling back on equals-by-value is tempting: public class Product { private final Id id; private final String description; private final Money price; ... public boolean equals(…
Imagine you've got some method that sometimes returns a legitimate value, and other times returns the special value null to indicate that no legitimate value exists: public interface StoreLocator { /** * Returns a store nearest to {@code address}, or {@code null} * if there are no stores within delivery range of the address.…
A bookmarklet is a tiny JavaScript program that lives inside a link. Drag each of these to your browser's bookmark bar - they add simple features to every page you visit: ← go to the "previous" page. This works for pages with numbers in the URLs, like Engadget or…
In my project we're having a great discussion about whether to use checked or unchecked exceptions for a particular problem. I've discovered an interesting problem with unchecked exceptions - they're not as robust with respect to refactoring and maintenance. Here's some code that gracefully handles the unchecked exception called MappingServiceUnreachableException:…
I'm a big fan of blog feeds. As a blog author, they give me an audience to whom I can blast my ideas. And as a blog reader, I can grab the latest content from 159 blogs in just a few seconds. If you're still surfing the web by hand,…
Consistency in API design is great. It makes the API more predictable, easier to learn, and more maintainable. But I believe there's a difference between being consistent when writing code, and writing code to be consistent. Consider this API: public enum Status { PENDING, PREPARATION_IN_PROGRESS, PREPARED, DELIVERY_IN_PROGRESS,…
AirTran sold my seat out from under me today for my trip from Buffalo to San Francisco... I made my annual trip back to southwestern Ontario this weekend to attend Oktoberfest in Kitchener, and to see the 'Riders. Jodie and I flew through Buffalo airport to save some bucks -…
This morning while waiting for a connection at the Atlanta airport, I signed up for $7.95/day WiFi. It's a lot of cash for Internet, but I'm a news junkie and I wanted to sync up on work email, etc. As usual, when I got online I refreshed all…
Compare these two code snippets, they both do the same thing. Minimalist public static <T> Comparator<T> reverse(final Comparator<T> forward) { Preconditions.checkNotNull(forward, "forward"); return new Comparator<T>() { public int compare(T a, T b) { return forward.compare(…
I love Guice. So much so that lately I've been trying to push it on my friends for their projects. But my friends are reluctant. They've become accustomed to manually solving the problems that Guice could solve for them. They enjoy wiring up their apps and implementing singletons, factories and…
It's tempting to write overly-friendly APIs: public void setDeliveries(List<Delivery> deliveries) { if (deliveries == null) { deliveries = Collections.emptyList(); } this.deliveries = Collections.unmodifiableList( new ArrayList<Delivery>(deliveries)); } Please don't do this: It masks bugs. The caller might be passing the wrong deliveries object, such as orderDeliveries when…
I just posted the first draft of a proposal for Bean-independent Properties for the Java language. This started when I was CC'd on email from Mikael Grev who prefers bean-attached properties. I prefer the opposite, so I figured I'd make my preference concrete. This is quite similar to an implementation…
In addition to more platformey changes and language changes, the JCP develops standard classlibraries for the JDK. Let's contrast this process to open source development of classlibraries. In particular I'm thinking about libraries like binding, app frameworks, units/measures, date/time, module systems, and object-relational mapping. Code Quality JCP: consistently…
Robert Konigsberg, Jerome Mourits and myself have written several snippets that highlight the carefully designed Google Collections Library: Preconditions Preconditions.checkNotNull(order.getAddress(), "order address");`</pre> [Iterables.getOnlyElement](/2007/09/coding-in-small-with-google-collections_9985.html)<pre class="prettyprint">`assertEquals(jesse, Iterables.getOnlyElement(usersOnDuty));`<…
Part 14 in a Series. ClassToInstanceMap is a specialized Map whose keys are class literals like PizzaPromotion.class or RestockingInformation.class and whose values are instances of those types. It provides a convenient balance between type safety and model flexibility. In some code I wrote recently, I needed to attach…