Define a basic key type for keys using 'short' as their value

Signed-off-by: Shawn O. Pearce <sop@google.com>
diff --git a/src/main/java/com/google/gwtorm/client/ShortKey.java b/src/main/java/com/google/gwtorm/client/ShortKey.java
new file mode 100644
index 0000000..8919715
--- /dev/null
+++ b/src/main/java/com/google/gwtorm/client/ShortKey.java
@@ -0,0 +1,86 @@
+// Copyright 2008 Google Inc.
+//
+// Licensed 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 com.google.gwtorm.client;
+
+import java.io.Serializable;
+
+/**
+ * Abstract key type using a single short value.
+ * <p>
+ * Applications should subclass this type to create their own entity-specific
+ * key classes.
+ * 
+ * @param <P> the parent key type. Use {@link Key} if no parent key is needed.
+ */
+public abstract class ShortKey<P extends Key<?>> implements Key<P>,
+    Serializable {
+  /**
+   * @return id of the entity instance.
+   */
+  public abstract short get();
+
+  /**
+   * @return the parent key instance; null if this is a root level key.
+   */
+  public P getParentKey() {
+    return null;
+  }
+
+  @Override
+  public int hashCode() {
+    int hc = get();
+    if (getParentKey() != null) {
+      hc *= 31;
+      hc += getParentKey().hashCode();
+    }
+    return hc;
+  }
+
+  @Override
+  public boolean equals(final Object b) {
+    if (b == null || b.getClass() != getClass()) {
+      return false;
+    }
+
+    final ShortKey<P> q = cast(b);
+    if (get() == q.get()) {
+      if (getParentKey() != null) {
+        return getParentKey().equals(q.getParentKey());
+      }
+      return true;
+    }
+
+    return false;
+  }
+
+  @Override
+  public String toString() {
+    final StringBuffer r = new StringBuffer();
+    r.append(getClass().getName());
+    r.append('[');
+    if (getParentKey() != null) {
+      r.append(getParentKey().toString());
+      r.append(", ");
+    }
+    r.append(get());
+    r.append(']');
+    return r.toString();
+  }
+
+  @SuppressWarnings("unchecked")
+  private static <A extends Key<?>> ShortKey<A> cast(final Object b) {
+    return (ShortKey<A>) b;
+  }
+}