{"id":265,"date":"2010-07-19T01:06:00","date_gmt":"2010-07-18T23:06:00","guid":{"rendered":""},"modified":"2023-03-20T13:07:39","modified_gmt":"2023-03-20T12:07:39","slug":"jetty-webapp-osgi-way","status":"publish","type":"post","link":"https:\/\/touk.pl\/blog\/2010\/07\/19\/jetty-webapp-osgi-way\/","title":{"rendered":"Jetty webapp osgi way"},"content":{"rendered":"

I will show how to expose simple Jetty OSGi service and use it to register hello world webapp. This app will serve static content from OSGi bundle and implement sample request handler under ServiceMix 4.Code is available here: http:\/\/github.com\/rafalrusin\/jetty-service<\/a>
\nAlternative solutions are: using standard OSGi HTTP service http:\/\/www.osgi.org\/javadoc\/r4v42\/org\/osgi\/service\/http\/HttpService.html<\/a>to register servlet; and wrap existing WAR application using PAX WEB http:\/\/wiki.ops4j.org\/display\/paxweb\/Pax+Web<\/a>.I won’t consider those two, since Jetty itself provides flexible way to handle webapps (including registering servlets). So those two are unnecessary overhead and are less flexible. Anyway those two are usually implemented on top of Jetty.
\nSo the first thing to do is to create Jetty OSGi service. Basicly it will be a Spring Bean exposed to OSGi. Following snippet does the job:<\/p>\n

<bean<\/span> id<\/span>=\"jetty-service\"<\/span> class<\/span>=\"org.apache.jetty.service.JettyServiceImpl\"<\/span> init-method<\/span>=\"init\"<\/span> destroy-method<\/span>=\"destroy\"<\/span>\/><\/span>\r\n<osgi:service<\/span> id<\/span>=\"jetty-service-osgi\"<\/span> ref<\/span>=\"jetty-service\"<\/span> interface<\/span>=\"org.apache.jetty.service.api.JettyService\"<\/span> \/><\/span><\/pre>\n
This will expose jetty-service to OSGi. All other components, which connect to it will wait automaticly until it’s registered.Exposed interface has following methods:<\/p>\n
public<\/span> Handler<\/span> registerApp<\/span>(<\/span>String<\/span> name,<\/span> Handler<\/span> handler)<\/span> throws<\/span> Exception<\/span>;<\/span>\r\npublic<\/span> void<\/span> unregisterApp<\/span>(<\/span>Handler<\/span> handler)<\/span> throws<\/span> Exception<\/span>;<\/span><\/pre>\n
Those will be invoked to register Hello World application. JettyServiceImpl on the other hand, starts embedded Jetty Server and handles apps registration.
\npackage org.apache.jetty.service;<\/p>\n
\r\nimport org.apache.jetty.service.api.JettyService;\r\nimport org.mortbay.jetty.Handler;\r\nimport org.mortbay.jetty.Server;\r\nimport org.mortbay.jetty.handler.ContextHandler;\r\nimport org.mortbay.jetty.handler.ContextHandlerCollection;\r\n\r\npublic class JettyServiceImpl implements JettyService {\r\n    private Server server;\r\n    private ContextHandlerCollection rootContext;\r\n\r\n    public void init() throws Exception {\r\n        server = new Server(8080);\r\n        rootContext = new ContextHandlerCollection();\r\n        server.setHandler(rootContext);\r\n        server.start();\r\n    }\r\n\r\n    public void destroy() throws Exception {\r\n        server.stop();\r\n    }\r\n\r\n    public Handler registerApp(String name, Handler handler) throws Exception {\r\n        server.stop();\r\n        ContextHandler h = rootContext.addContext(\"\/\" + name, name);\r\n        h.setHandler(handler);\r\n        server.start();\r\n        return h;\r\n    }\r\n\r\n    public void unregisterApp(Handler handler) throws Exception {\r\n        server.stop();\r\n        rootContext.removeHandler(handler);\r\n        server.start();\r\n    }\r\n}\r\n<\/pre>\n
Next step is to implement sample web app. First, we need to connect jetty-service bean to make it visible in our app.<\/p>\n
  <osgi:reference<\/span> id<\/span>=\"jetty-service\"<\/span> interface<\/span>=\"org.apache.jetty.service.api.JettyService\"<\/span> bean-name<\/span>=\"jetty-service\"<\/span>\/><\/span><\/pre>\n
<bean<\/span> class<\/span>=“org.apache.jetty.service.example.HelloWorld”<\/span> init-method<\/span>=“init”<\/span> destroy-method<\/span>=“destroy”<\/span>><\/span>
\n<property<\/span> name<\/span>=“jettyService”<\/span> ref<\/span>=“jetty-service”<\/span>\/><\/span>
\nThen, we need to implement sample app.<\/p>\n
\r\npackage org.apache.jetty.service.example;\r\n\r\nimport java.io.IOException;\r\nimport javax.servlet.ServletException;\r\nimport javax.servlet.http.HttpServletRequest;\r\nimport javax.servlet.http.HttpServletResponse;\r\n\r\nimport org.apache.jetty.service.api.JettyService;\r\nimport org.apache.jetty.service.util.BundleResource;\r\nimport org.mortbay.jetty.Handler;\r\nimport org.mortbay.jetty.HttpConnection;\r\nimport org.mortbay.jetty.Request;\r\nimport org.mortbay.jetty.handler.AbstractHandler;\r\nimport org.mortbay.jetty.handler.ContextHandler;\r\nimport org.mortbay.jetty.handler.ContextHandlerCollection;\r\nimport org.mortbay.jetty.handler.ResourceHandler;\r\n\r\npublic class HelloWorld {\r\n    private JettyService jettyService;\r\n    private Handler registered;\r\n\r\n    public void setJettyService(JettyService jettyService) {\r\n        this.jettyService = jettyService;\r\n    }\r\n\r\n    public void init() throws Exception {\r\n        ContextHandlerCollection handler = new ContextHandlerCollection();\r\n\r\n        handler.addContext(\"\/app\", \"app\").setHandler(new AbstractHandler() {\r\n            public void handle(String target, HttpServletRequest request,\r\n                               HttpServletResponse response, int arg3) throws IOException,\r\n                    ServletException {\r\n                response.setContentType(\"text\/html\");\r\n                response.setStatus(HttpServletResponse.SC_OK);\r\n                response.getWriter().println(\r\n                    \"Hello World from Java\"\r\n                    + request.getParameterMap()\r\n                );\r\n\r\n                Request base_request = (request instanceof Request) ? (Request) request : HttpConnection.getCurrentConnection().getRequest();\r\n                base_request.setHandled(true);\r\n            }\r\n        });\r\n\r\n        ResourceHandler resourceHandler = new ResourceHandler();\r\n        resourceHandler.setBaseResource(new BundleResource(getClass().getResource(\"\/static\")));\r\n        ContextHandler contextHandler = handler.addContext(\"\", \"\");\r\n        contextHandler.setHandler(resourceHandler);\r\n\r\n        registered = jettyService.registerApp(\"helloWorld\", handler);\r\n    }\r\n\r\n    public void destroy() throws Exception {\r\n        jettyService.unregisterApp(registered);\r\n    }\r\n}\r\n<\/pre>\n
Here, we register sample request handler at ‘app’ sub path and serve static content from jar using BundleResource. Last thing is registering app using jettyService under ‘helloWorld’ context. So our application will be exposed under http:\/\/localhost:8080\/helloWorld\/<\/a> address.
\nServiceMix has also so called features. This is the way to collect multiple dependencies under a single name. So we have to create features.xml file, like this:<\/p>\n
<<\/span>features><\/span>\r\n    <<\/span>feature name=<\/span>\"jetty-service\"<\/span> version=<\/span>\"${project.version}\"<\/span>><\/span>\r\n        <<\/span>bundle><\/span>mvn:<\/span>org.<\/span>apache.<\/span>jetty.<\/span>service\/<\/span>service\/<\/span>${<\/span>project.<\/span>version}bundle><\/span> feature><\/span><\/span><\/span><\/pre>\n
<<\/span>feature name=<\/span>“example-jetty-service-helloworld”<\/span> version=<\/span>“${project.version}”<\/span>><\/span>
\n<<\/span>feature version=<\/span>“${project.version}”<\/span>><\/span>jetty–<\/span>servicefeature><\/span>
\n<<\/span>bundle><\/span>mvn:<\/span>org.<\/span>apache.<\/span>jetty.<\/span>service\/<\/span>example–<\/span>helloworld\/<\/span>${<\/span>project.<\/span>version}bundle><\/span>
\nfeature><\/span>
\nfeatures><\/span><\/span><\/span><\/span><\/span>
\nBasicly, we can provide particular dependencies for our project.
\nNext, we do ‘mvn install’ on our project and run apache-servicemix-4.2.0-fuse-01-00\/bin\/servicemix karaf console. On the console, we need to type following commands:<\/p>\n
features:addUrl mvn:org.apache.jetty.service\/service-karaf\/0.1.0-SNAPSHOT\/xml\/features\r\nfeatures:install example-jetty-service-helloworld\r\nosgi:list<\/pre>\n[ 230] [Active ] [ ] [Started] [ 60] Unnamed – org.apache.jetty.service:service:bundle:0.1.0-SNAPSHOT (0.1.0.SNAPSHOT)
\n[ 231] [Active ] [ ] [Started] [ 60] Unnamed – org.apache.jetty.service:example-helloworld:bundle:0.1.0-SNAPSHOT (0.1.0.SNAPSHOT)
\nNow, we can enter http:\/\/localhost:8080\/helloWorld\/<\/a> to test our app.
\nAnd that’s it. OSGi and ServiceMix 4 features enable easy way to use dynamic modules in web apps. For example, it’s veryeasy to build simple web framework with loadable components on page (something like mini implementation of Portlets).<\/p>\n
\"\"<\/div>\n","protected":false},"excerpt":{"rendered":"I will show how to expose simple Jetty OSGi service and use it to register hello world webapp.…\n","protected":false},"author":35,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[44],"_links":{"self":[{"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/posts\/265"}],"collection":[{"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/users\/35"}],"replies":[{"embeddable":true,"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/comments?post=265"}],"version-history":[{"count":30,"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/posts\/265\/revisions"}],"predecessor-version":[{"id":15360,"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/posts\/265\/revisions\/15360"}],"wp:attachment":[{"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/media?parent=265"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/categories?post=265"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/touk.pl\/blog\/wp-json\/wp\/v2\/tags?post=265"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}