io.quarkus.resteasy.reactive.links.RestLink Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of quarkus-resteasy-reactive-links Show documentation

Quarkus RESTEast Reactive resource linking support

There is a newer version: 3.15.2

Show newest version

package io.quarkus.resteasy.reactive.links;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Represents a Web link to be incorporated into the HTTP response.
 * Only the response of methods or classes annotated with {@link InjectRestLinks} will include the "Link" headers.
 * 
 * The RestLink annotation can be used at method level.
 * 
 *
 * @see RFC 5988 Web Linking Standard
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface RestLink {

    /**
     * If not set, it will default to the method name.
     *
     * @return the link relation.
     */
    String rel() default "";

    /**
     * Declares a link for the given type of resources.
     * If not set, it will default to the returning type of the annotated method.
     *
     * @return the type of returning method.
     */
    Class entityType() default Object.class;
}