import org.noear.solon.annotation.Controller;
import org.noear.solon.annotation.Mapping;
@Mapping("/user") //或 "user"，開頭自動會補"/"
@Controller
public void DemoController{
    @Mapping("") //=/user
    public void home(){ }
    @Mapping("/") //=/user/，與上面是有區(qū)別的，注意下。
    public void home2(){ }
    @Mapping("/?") //=/user/ 或者 /user，與上面是有區(qū)別的，注意下。
    public void home3(){ }
    @Mapping("list") //=/user/list ，間隔自動會補"/"
    public void getList(){ }
    @Mapping("/{id}") //=/user/{id}
    public void getOne(long id){ }
    @Mapping("/ajax/**") //=/user/ajax/**
    public void ajax(){ }
}

import org.noear.solon.core.handle.Context;
import org.noear.solon.core.handle.ModelAndView;
import org.noear.solon.core.handle.UploadedFile;
import java.util.Locale;
@Mapping("/user") 
@Controller
public void DemoController{
    //非請求參數(shù)的可注入對象
    @Mapping("case1")
    public void case1(Context ctx, Locale locale , ModelAndView mv){ }
    //請求參數(shù)（可以是散裝的；支持 queryString, form；json，或支持的其它序列化格式）
    @Mapping("case2")
    public void case2(String userName, String nickName, long[] ids, List<String> names){ }
    //請求參數(shù)（可以是整裝的結構體；支持 queryString, form；json，或支持的其它序列化格式Mapping
    @Mapping("case3")
    public void case3(UserModel user){ }
    //也可以是混搭的
    @Mapping("case4")
    public void case4(Context ctx, UserModel user, String userName){  }
    //文件上傳    //注意與 <input type='file' name="file1" /> 名字對上
    @Mapping("case5")
    public void case5(UploadedFile file1, UploadedFile file2){ } 
    //同名多文件上傳
    @Mapping("case6")
    public void case6(UploadedFile[] file){ }  
}

import org.noear.solon.annotation.Controller;
import org.noear.solon.annotation.Mapping;
import org.noear.solon.annotation.Header;
import org.noear.solon.annotation.Body;
import org.noear.solon.annotation.Path;
@Mapping("/user") 
@Controller
public void DemoController{
    @Mapping("case1")
    public void case1(@Body String bodyStr){   }
    @Mapping("case2")
    public void case2(@Body Map<String,String> paramMap, @Header("Token") String token){ }
    @Mapping("case3")
    public void case3(@Body InputStream stream, @Cookie("Token") token){  }
    //這個用例加不加 @Body 效果一樣
    @Mapping("case4")
    public void case4(@Body UserModel user){  } 
    @Mapping("case5/{id}")
    public void case5(String id){  }
    //如果名字不同，才有必要用 @Path //否則是自動處理（如上）
    @Mapping("case5_2/{id}")
    public void case5_2(@Path("id") String name){  } 
    @Mapping("case6")
    public void case6(String name){ }
    //如果名字不同，才有必要用 @Param //否則是自動處理（如上）
    @Mapping("case6_2")
    public void case6_2(@Param("id") String name){ } 
    //如果要默認值，才有必要用 @Param
    @Mapping("case6_3")
    public void case6_3(@Param(defaultValue="world") String name){ }
    @Mapping("case7")
    public void case7(@Header String token){ }
    @Mapping("case7_2")
    public void case7_2(@Header String[] user){ } //v2.4.0 后支持
}

import org.noear.solon.boot.web.MimeType;
@Mapping("/user") 
@Controller
public void DemoController{
    @Get
    @Mapping("case1")
    public void case1(Context ctx, Locale locale , ModelAndView mv){ }
    //也可以直接使用 Mapping 的屬性進行限定。。。但是沒使用注解的好看
    @Mapping(path = "case1_2", method = MethodType.GET)
    public void case1_2(Context ctx, Locale locale , ModelAndView mv){ }
    @Put
    @Message
    @Mapping("case2")
    public void case2(String userName, String nickName){ }
    //如果沒有輸出申明，側 string 輸出默認為 "text/plain"
    @Produces(MimeType.APPLICATION_JSON_VALUE)
    @Mapping("case3")
    public String case3(){
        return "{code:1}";
    }
    ////也可以直接使用 Mapping 的屬性進行限定。。。但是沒使用注解的好看
    @Mapping(path= "case3_2", produces=MimeType.APPLICATION_JSON_VALUE))
    public String case3_2(){
        return "{code:1}";
    }
    //如果沒有輸出申明，側 object 輸出默認為 "application/json"
    @Mapping("case3_3")
    public User case3_3(){
        return new User();
    }
}

@Mapping("/user") 
@Controller
public void DemoController{
    //輸出視圖與模型，經后端渲染后輸出最終格式
    @Maping("case1")
    public ModelAndView case1(){
        ModelAndView mv = new ModelAndView();
        mv.put("name", "world");
        mv.view("hello.ftl");
        return mv;
    }
    //輸出結構體，默認會采用josn格式渲染后輸出
    @Maping("case2")
    public UserModel case2(){
        return new UserModel();
    }
    //輸出下載文件
    @Maping("case3")
    public Object case3(){
        return new File(...); //或者 return new DownloadedFile(...);
    }
}

@Mapping("user")
public void UserController extends CrudControllerBase<User>{
}
public class CrudControllerBase<T>{
    @Post
    @Mapping("add")
    public void add(T t){
        ...
    }
    @Delete
    @Mapping("remove")
    public void remove(T t){
        ...
    }
}