认识请求上下文（Context）

Handler + Context 架构，是Solon Web 的基础。在 Context （org.noear.solon.core.handle.Context）里可以获取：

• 请求相关的对象与接口
• 会话状态相关的对象与接口
• 响应相关的对象与接口

或者理解所有请求与响应相关的，都在它身上。关于架构方面，可以再看看《想法与架构笔记》

1、几种获取（或控制） Context 的方式

a) 通过 Controller 获取

@Controller
public class HelloController{
    @Mapping("/hello")
    public String hello(Context ctx){
        //可以注入 ctx:Context
        return "Hello " + ctx.paramOrDefault("name", "world");
    }
}

b) 通过 Handler 或 Filter 或 RouterInterceptor 接口方式获取

Solon.start(DemoApp.class, args, app->{
   app.get("/hello", ctx-> ctx.output("Hello " + ctx.paramOrDefault("name", "world"))); 
});

//或者，用以组件方式编写
@Mapping("/hello")
@Component
public class HelloHandler implements Handler{
    public void handle(Context ctx) throws Throwable{
        ctx.output("Hello " + ctx.paramOrDefault("name", "world"));
    }
}

c) 直接获取当前上下文（基于 ThreadLocal 实现）

Context ctx = Context.current();

d) 获取当前线程的上下文，进行跨线程传递（一般在异步场景才用到）

public class Demo {
    public void asyncDemo() {
        //获取当前线程的请求上下文
        Context ctx = Context.current();

        //跨线程传递当前请求上下文
        RunUtil.async(()->{
            ContextHolder.currentSet(ctx);
             
            try {
                //... Context.current() 有值...
            } finally {
                //用完要移掉（很重要）
                ContextHolder.currentRemove();
            }
        });
    }
}

e) 设置空的当前上下文，并模拟数据（一般用在非 web 请求环境）

Context ctx = ContextEmpty.create();

//模拟请求的数据（如果有需要）
ctx.headerMap().put("Header1", "1"); 
ctx.paramMap().put("Param1", "1"); 
ctx.pathNew("/path1")

ContextHolder.currentSet(ctx);

try {
    //... Context.current() 有值...
} finally {
    //用完要移掉（很重要）
    ContextHolder.currentRemove();
}

2、几个特殊属性

提示：控制器里的 @Mapping 函数，即为 Action。

3、请求相关的接口

关于 MultiMap 接口的使用示例：

//for（遍历）
for(KeyValues<String> kv: ctx.paramMap()){ //headerMap(), cookieMap()
    String       val  = kv.getValue();  //单值
    List<String> val2 = ky.getValues(); //多值
}

//add（添加）
ctx.paramMap().add("list", "a1")
ctx.paramMap().add("list", "a2")

ctx.paramValues("list") -> String[] //获取多值

//put（替换）
ctx.paramMap().put("item", "a1")

ctx.param("item") -> String //获取单值

4、响应相关的接口

5、会话相关的接口

6、其它查询