Параметры пути

Java Platform, Enterprise Edition (Java EE) 8
Учебник по Java EE

Параметры пути

Аннотация @ServerEndpoint позволяет использовать шаблоны URI для указания частей URI развёртывания конечной точки в качестве параметров приложения. Например, рассмотрим эту конечную точку:

@ServerEndpoint("/chatrooms/{room-name}")
public class ChatEndpoint {
   ...
}

Если конечная точка развёрнута внутри веб-приложения с именем chatapp на локальном сервере Java EE на порту 8080, клиенты могут подключаться к конечной точке с помощью любого из следующих URI:

http://localhost:8080/chatapp/chatrooms/currentnews
http://localhost:8080/chatapp/chatrooms/music
http://localhost:8080/chatapp/chatrooms/cars
http://localhost:8080/chatapp/chatrooms/technology

Аннотированные конечные точки могут получать параметры пути в качестве аргументов в методах, аннотированных с помощью @OnOpen, @OnMessage и @OnClose. В этом примере конечная точка использует параметр в методе @OnOpen, чтобы определить, к какой комнате чата клиент хочет присоединиться:

@ServerEndpoint("/chatrooms/{room-name}")
public class ChatEndpoint {
   @OnOpen
   public void open(Session session,
                    EndpointConfig c,
                    @PathParam("room-name") String roomName) {
      // Добавление клиента в чат по его выбору...
   }
}

Параметры пути, используемые в качестве аргументов в этих методах, могут быть строками, примитивными типами или соответствующими им типами-обёртками (wrapper).

Вперёд

Содержание