org.chromium.sdk/src/org/chromium/sdk/internal/protocolparser/JsonSubtypeCasting.java
changeset 2 e4420d2515f1
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/org.chromium.sdk/src/org/chromium/sdk/internal/protocolparser/JsonSubtypeCasting.java	Wed Dec 23 17:13:18 2009 -0800
@@ -0,0 +1,25 @@
+// Copyright (c) 2009 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+package org.chromium.sdk.internal.protocolparser;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Marks method as method casting to a subtype. Normally the method return type should be
+ * some other json type, which serves as subtype; the subtype interface must extend
+ * {@link JsonSubtype} (with correct generic parameter).
+ * <p>However for types, annotated as <code>{@link JsonType#subtypesChosenManually()} = true</code>,
+ * the method may return something other than json type; it also may return any json type (free of
+ * mandatory {@link JsonSubtype} inheritance), provided that
+ * <code>{@link #reinterpret()} = true</code>.
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target({ ElementType.METHOD })
+public @interface JsonSubtypeCasting {
+  boolean reinterpret() default false;
+}