Handling cookies

Vert.x-Web使用CookieHandler来支持cookies.

你必须确保当请求需要cookies支持的时候,你已经设置上了cookie handler。

  1. router.route().handler(CookieHandler.create());

Manipulating cookies

你可以向getCookie()方法, 或者通过cookies()方法检索出cookie集合.

  • getCookie(), 传递一个cookie name的参数来检索出一个cookie
  • cookies(), 检索出cookie集合
  • removeCookie, 删除一个cookie
  • addCookie, 添加一个cookie

当response headers被写回的时候, cookies集合会自动的被写入到response中.

Cookies是通过Cookie实例进行描述的. 你可以通过该实例检索出cookie中的name, value, domain, path 或者其他的cookie属性.

下面的例子演示了如何检索和添加cookie

  1. router.route().handler(CookieHandler.create());
  3. router.route("some/path/").handler(routingContext -> {
  5.   Cookie someCookie = routingContext.getCookie("mycookie");
  6.   String cookieValue = someCookie.getValue();
  8.   // Do something with cookie...
  10.   // Add a cookie - this will get written back in the response automatically
  11.   routingContext.addCookie(Cookie.cookie("othercookie", "somevalue"));
  12. });