/*
  neon - Embeddable HTTP Server based on jdk.httpserver
  Copyright (C) 2024  Ulrich Hilger

  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as
  published by the Free Software Foundation, either version 3 of the
  License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
package de.uhilger.neon;

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

/**
 * Die Annotation Action kennzeichnet eine Methode, die 
 * ausgefuehrt wird, wenn die in der Annotation 
 * angegebene Route via HTTP angefragt wird.
 * 
 * Beispiel
 * 
 * @Action(route="/hallo", type=Type.GET)
 * public String sayHello(String nameToGreet) {
 *   return "Hallo, " + nameToGreet;
 * }
 * 
 * @author Ulrich Hilger
 */
@Target( { ElementType.METHOD } ) 
@Retention( RetentionPolicy.RUNTIME ) 
public @interface Action {
  enum Type{GET, PUT, POST, DELETE}
	/** type of method */
	Type type() default Type.GET;  
  String[] handler();
  String route();
  boolean handlesResponse();  
}