// 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;
}