Servlet Support
Das jadice web toolkit benötigt serverseitig diverse Servlet
- und
Filter
-Instanzen, die durch standardisierte
Java-Annotationen (@WebServlet
, @WebFilter
, etc.) automatisch registriert werden.
Die nachfolgende Tabelle zeigt, welche URL-Patterns in den @WebServlet
bzw. @WebFilter
Annotationen hinterlegt sind.
Klasse | Servlet-/Filtername | URL-Pattern |
---|---|---|
com.levigo.jadice.web.server.FontDownloadServlet | jwtFontDownloadServlet | /jwt/font/* |
com.levigo.jadice.web.server.FontResourceServlet | jwtFontResourceServlet | /jwt/fontresources/* |
com.levigo.jadice.web.conn.server.TileServlet | jwtTileDownloadServlet | /jwt/tile/* |
com.levigo.jadice.web.conn.server.AnnotationImageServlet | jwtAnnotationImageDownloadServlet | /jwt/resource/* |
com.levigo.jadice.web.transport.server.TransportWebtoolkitFilter | jwtTransportFilter | /jwt/transport/* |
com.levigo.jadice.web.server.filter.CacheFilter | jwtCacheFilter | /* |
com.levigo.jadice.web.server.filter.NoCacheFilter | jwtNoCacheFilter | /* |
com.levigo.jadice.web.server.filter.MDCFilter | jwtMDCFilter | /* |
com.levigo.jadice.web.server.filter.TileCacheFilter | jwtTileCacheFilter | /* |
Einige der Servlets arbeiten asynchron (z.B. das TileServlet sowie die Servlets für Longpoll- und Server-Sent-Event-Kommunikation). Dies hat zur Folge, dass alle Filter, die eine Anfrage an diese Servlets durchläuft, ebenfalls asynchron arbeiten müssen. Für die im jadice web toolkit enthaltenen Filter ist dies bereits gesetzt; die integrationsspezifischen Filter hingegen müssen entsprechend konfiguriert werden. Die Konfiguration kann gemäß Servlet 3 Standard über Annotationen (asyncSupported = true), über die web.xml oder programmatisch erfolgen. Falls eine web.xml die im jadice web toolkit enthaltenen annotationsbasierten Servlet- und Filterkonfigurationen überschreibt, ist auch dort an den entsprechenden Stellen asynchroner Support zu konfigurieren.
Wird einer der Filter nicht benötigt, kann er mit der ServerConfiguration deaktiviert werden.