org.jboss.resteasy.spi.touri.MappedBy Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of resteasy-jaxrs

There is a newer version: 4.0.0.Beta5

package org.jboss.resteasy.spi.touri;

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

/**
 * 
 * This annotation can be added to any object to perform a Resource/method based
 * lookup to create a URI template. From there, perform Java beans-based
 * transformation between URI template and bean properties. For example, take
 * the following bean:
 * 
 *  * MappedBy(Resource=FooResource.class, method="getFoo")
 * public class Foo
 * {
 *    private int id;
 *    // getters and setters
 * }
 *
 * {@literal @}Path("/foo")public class FooResource {
 * {@literal @}GET
 * {@literal @}Path("{id}")
 * {@literal @}Produces(...) public Foo getFoo(@PathParam("id") Integer id){
 * ...
 * }
 * }
 * 
 * 
 * for a Foo f with id = 123, ObjectToURI.getInstance(f) = "/foo/123"
 * 
 * @author Solomon Duskis
 * @version $Revision: 1 $
 */

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface MappedBy
{
   Class resource();

   String method() default "";
}