四、认识请求上下文（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(()->{
            try {
                ContextUtil.currentSet(ctx);

                //... Context.current() 有值...
            } finally {
                ContextUtil.currentRemove();
            }
        });
    }
}

2、关于 context-path 的配置（基于 pathNew 实现）

添加配置即可：（v1.11.2 后支持）

server.contextPath: "/test-service/" #原路径仍能访问

或者：（'!' 开头。v2.6.3 后支持）

server.contextPath: "!/test-service/" #原路径不能访问

3、几个特殊属性

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

4、请求相关的接口

关于 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 //获取单值

5、响应相关的接口

6、会话相关的接口

7、其它查询