Red Hat SummitCe contenu n'est pas disponible dans la langue sélectionnée.
Chapter 25. web
The web application is a bundle, so we can use normal bundle:start and bundle:stop commands.
The recommended method is to use WAB bundles, that have the Web-ContextPath: /path manifest header.
WAB bundles can be installed as the type war:
Example
mvn:io.hawt/hawtio-osgi/2.0.0.fuse-7_12_0-00009/war.
25.1. web:context-list
25.1.1. Description
Lists all available web contexts. These may originate from HttpService, Whiteboard or WAB Extender.
25.1.2. Syntax
web:context-list
25.1.3. Options
| Name | Description |
|---|---|
| --help | Display this help message |
25.1.4. Additional information
This command is mostly useful for OSGi web application developers.
| Bundle ID | Symbolic Name | Context Path | Context Name | Rank | Service ID | Type | Scope | Registration Properties |
|---|---|---|---|---|---|---|---|---|
| 122 | org.apache.cxf.cxf-rt-transports-http | / | default | MAX | 0 | HttpService | static* | httpContext.id=default httpContext.path=/ osgi.http.whiteboard.context.httpservice=default osgi.http.whiteboard.context.path=/ |
| 230 | org.ops4j.pax.web.pax-web-extender-whiteboard | / | default | 0 | 0 | Whiteboard | static* | osgi.http.whiteboard.context.name=default osgi.http.whiteboard.context.path=/ |
| 43 | io.hawt.hawtio-osgi | /hawtio | /hawtio | MAX | 0 | WAB | static* | osgi.http.whiteboard.context.path=/hawtio |
25.2. web:launch
25.2.1. Description
Start the web application in a browser of the given bundle ID.
25.2.2. Syntax
web:launch [options] id
25.2.3. Arguments
| Name | Description |
|---|---|
| id | The bundle ID to start the browser with |
25.2.4. Options
| Name | Description |
|---|---|
| --base | The base URL to browse to, otherwise default localhost:8181 will be used. |
| --help | Display this help message |
25.3. web:wab-list
25.3.1. Description
Lists all available, deployed Web Application Bundles.
25.3.2. Syntax
web:wab-list
25.3.3. Options
| Name | Description |
|---|---|
| --help | Display this help message |
25.4. web:servlet-list
25.4.1. Description
Lists details for available servlets.
25.4.2. Syntax
web:servlet-list [options]
25.4.3. Options
| Name | Description |
|---|---|
| --help | Display this help message |
| --no-format | Disable table rendered output |
25.4.4. Additional information
The web:servlet-list command lists installed servlets, showing additional information, for example the method of servlet registration.
| Bundle ID | Name | Class | Context Path(s) | URLs | Type |
|---|---|---|---|---|---|
| 43 | default | org.ops4j.pax.web.service.undertow.internal.web.UndertowResourceServlet | /hawtio | / | WAB |
| 43 | jolokia-agent | io.hawt.web.servlets.JolokiaConfiguredAgentServlet | /hawtio | /jolokia/* | WAB |
| 43 | jolokia-proxy | io.hawt.web.proxy.ProxyServlet | /hawtio | /proxy/* | WAB |
| 43 | jsp | org.ops4j.pax.web.jsp.JspServlet | /hawtio | *.jspx, *.jsp | WAB |
| 43 | keycloak | io.hawt.web.auth.keycloak.KeycloakServlet | /hawtio | /keycloak/* | WAB |
| 43 | login | io.hawt.web.auth.LoginServlet | /hawtio | /auth/login | WAB |
| 43 | logout | io.hawt.web.auth.LogoutServlet | /hawtio | /auth/logout | WAB |
| 43 | plugin | io.hawt.web.plugin.PluginServlet | /hawtio | /plugin/* | WAB |
| 43 | user | io.hawt.web.auth.keycloak.KeycloakUserServlet | /hawtio | /user/* | WAB |
| 122 | cxf-osgi-transport-servlet | org.apache.cxf.transport.servlet.CXFNonSpringServlet | / | /cxf/* | HttpService |
25.5. web:start
- Deprecated
-
Use
bundle:startwith WAB bundles instead.
25.5.1. Description
Start the web context of given bundles.
25.5.2. Syntax
web:start [options] ids
25.5.3. Arguments
| Name | Description |
|---|---|
| ids | The list of bundle IDs separated by whitespaces |
25.5.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
25.6. web:stop
- Deprecated
-
Use
bundle:stopwith WAB bundles instead.
25.6.1. Description
Stop the web context of given bundles.
25.6.2. Syntax
web:stop [options] ids
25.6.3. Arguments
| Name | Description |
|---|---|
| ids | The list of bundle IDs separated by whitespaces |
25.6.4. Options
| Name | Description |
|---|---|
| --help | Display this help message |
25.7. web:wab-info
25.7.1. Description
Shows information about Web Application Bundle.
25.7.2. Syntax
web:wab-info [options]
25.7.3. Options
| Name | Description |
|---|---|
| --wab | WAB specified by context path or bundle ID |
| --help | Display this help message |
25.7.4. Additional information
The web:wab-info command shows information about the structure of a web application. It displays reachable bundles, WAB classpath and registered ServletContainerInitializers.
Sample output for hawtio web application
hawtio :: OSGi Web Console (43)
-------------------------------
Context Path: /hawtio
Deployment State: Deployed
WAB ClassPath:
- bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/classes/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/hawtio-core-2.0.0.fuse-7_12_0-00009.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/hawtio-system-2.0.0.fuse-7_12_0-00009.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/jolokia-core-1.7.1.redhat-00001.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/json-simple-1.1.1.redhat-1.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/httpclient-4.5.13.redhat-00002.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/httpcore-4.4.13.redhat-00001.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/commons-logging-1.2.0.redhat-3.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/commons-io-2.11.0.redhat-00001.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/commons-codec-1.15.0.redhat-00001.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/guava-27.1-jre.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/failureaccess-1.0.1.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/listenablefuture-9999.0-empty-to-avoid-conflict-with-guava.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/jsr305-3.0.2.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/checker-qual-2.5.2.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/error_prone_annotations-2.2.0.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/j2objc-annotations-1.1.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/animal-sniffer-annotations-1.17.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/json-20171018.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/hawtio-util-2.0.0.fuse-7_12_0-00009.jar!/
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/org.apache.aries.blueprint.web-1.1.0.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/org.apache.aries.blueprint.noosgi-1.1.0.jar!/ (scanning skipped)
- jar:bundle://2469cbea-ac0f-4f79-9760-2186c2e80b94_43.0:0/WEB-INF/lib/slf4j-api-1.7.36.redhat-00002.jar!/ (scanning skipped)
ServletContainerInitializers:
- org.ops4j.pax.web.jsp.JasperInitializer
- org.ops4j.pax.web.service.undertow.websocket.internal.WebSocketsInitializer
- io.undertow.servlet.sse.ServerSentEventSCI
Container web fragments (reachable bundles without /META-INF/web-fragment.xml):
- (231) org.ops4j.pax.web.pax-web-jsp/8.0.17
- (237) org.ops4j.pax.web.pax-web-undertow-websocket/8.0.17
- (193) org.apache.servicemix.specs.javax-el-api-3.0.0/3.0.0.1
- (50) io.undertow.servlet/2.2.23.SP1-redhat-00001
- (51) io.undertow.websockets-jsr/2.2.23.SP1-redhat-00001
- (49) io.undertow.core/2.2.23.SP1-redhat-00001
- (212) org.jboss.xnio.api/3.8.7.SP1-redhat-0000125.8. web:wab-list
25.8.1. Description
Lists all available, deployed Web Application Bundles.
25.8.2. Syntax
web:wab-list
25.8.3. Options
| Name | Description |
|---|---|
| --help | Display this help message |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}