In the previous post we looked at creating a web service, exposing SOAP and running in a CXF created instance of Jetty, but what if you already have an application with an existing instance of Jetty running. All you want to do is drop a SOAP capable service into this instance.<\/p>\n
Like most of the things I’ve discovered working with CXF (and Spring), it’s not that difficult, once you know how. It’s the finding out “how” that seems more difficult :)<\/p>\n
First off, much credit goes to this post Embedded Jetty and Apache CXF: Secure REST Services With Spring Security<\/a> or more specifically the source code for this post, here<\/a>.<\/p>\n I’m not interested (at this time) in security, so we’ll ignore that and just concern ourselves with injecting a service into an instance of Jetty created by the application itself (not by CXF).<\/p>\n First up, let’s create our pom.xml<\/p>\n As usual, run mavn install<\/em> to grab the dependencies.<\/p>\n Now create the usual folder structure for our source, \/src\/main\/java and within this your package folders, i.e. com\/putridparrot\/core.<\/p>\n We’re going to create four files, two of which we’ve used in previous posts, HelloWorld and HelloWorldImpl, I’ll include those here first just for completeness<\/p>\n HelloWorld.java<\/p>\n HelloWorldImpl.java<\/p>\n As per the example from the referenced post Embedded Jetty and Apache CXF: Secure REST Services With Spring Security<\/a> we’re going to create the configuration in code, so create AppConfig.java and place the following in this file<\/p>\n Finally create App.java and place the following inside it<\/p>\n Once this is built, run App.main and you should be able to use your web browser to navigate to http:\/\/localhost:9000\/HelloWorld?wsdl and see the wsdl definitions for this service.<\/p>\n Great, but what’s it all doing?<\/strong><\/p>\n Let’s start with the App.main method. The server<\/em> variable is our Jetty instance. So really the only thing we’re interested here is which port have we assigned the instance to and the server.setHandler<\/em> method call. This is where we embed our servlet context into the Jetty engine. From what I can understand, this basically allows us a way to intercept calls and pass to our specific servlet, in this case (ultimately) our CXFServlet.<\/p>\n The ServletHolder, as the name suggests, holds the servlet object that we want to use and will be added to the ServletContextHandler. As you can see this is where the bulk of the code is. The setContextPath<\/em> call sets up the root level path of our context, i.e. changing to context.setContextPath( “\/ws” )<\/em> means our webservice will now be located off of the ws path, thus http:\/\/localhost:9000\/ws\/HelloWorld?wsdl.<\/p>\n When we call addServlet<\/em> we can, in essence, extend the root path further, so for example context.addServlet( servletHolder, “\/services\/*” )<\/em> will simply moved the servlet to your root path\/services.<\/p>\n We add the spring ContextLoaderListener<\/a> to the ServletContext and this is where we can setup the parameters required for spring to bring in our webservices etc.<\/p>\n The ContextLoaderListener “Create a new ContextLoaderListener that will create a web application context based on the “contextClass” and “contextConfigLocation” servlet context-params.”<\/em> we’ll need to supplied the contextClass and contextConfigLocation parameters and that’s exactly what we do in the two setInitParameter<\/em> lines of code.<\/p>\n The contextClass is going to use the web annotations (hence our webservices are annotated) and the contextConfigLocation will use our AppConfig class (instead of a config. file).<\/p>\n Configuration class<\/strong><\/p>\n The AppConfig class supplies the configuration for the ContextLoaderListener<\/em> and is first annotated with the Configuration<\/a><\/em>, although removing this seemed to have no effect. What does have a big effect is the requirement for a bean named cxf – if this is missing you’ll get the following exception<\/p>\n\r\n<project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0" xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"\r\n xsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/maven-v4_0_0.xsd">\r\n <modelVersion>4.0.0<\/modelVersion>\r\n <groupId>com.putridparrot.core<\/groupId>\r\n <artifactId>cxfws<\/artifactId>\r\n <packaging>jar<\/packaging>\r\n <version>1.0-SNAPSHOT<\/version>\r\n <name>cxfws<\/name>\r\n <url>http:\/\/maven.apache.org<\/url>\r\n\r\n <properties>\r\n <cxf.version>3.0.1<\/cxf.version>\r\n <spring.version>4.1.0.RELEASE<\/spring.version>\r\n <jetty.version>9.4.2.v20170220<\/jetty.version>\r\n <\/properties>\r\n\r\n <dependencies>\r\n\r\n <dependency>\r\n <groupId>org.apache.cxf<\/groupId>\r\n <artifactId>cxf-rt-frontend-jaxws<\/artifactId>\r\n <version>${cxf.version}<\/version>\r\n <\/dependency>\r\n\r\n <dependency>\r\n <groupId>org.springframework<\/groupId>\r\n <artifactId>spring-core<\/artifactId>\r\n <version>${spring.version}<\/version>\r\n <\/dependency>\r\n\r\n <dependency>\r\n <groupId>org.springframework<\/groupId>\r\n <artifactId>spring-context<\/artifactId>\r\n <version>${spring.version}<\/version>\r\n <\/dependency>\r\n\r\n <dependency>\r\n <groupId>org.springframework<\/groupId>\r\n <artifactId>spring-web<\/artifactId>\r\n <version>${spring.version}<\/version>\r\n <\/dependency>\r\n\r\n <dependency>\r\n <groupId>org.eclipse.jetty<\/groupId>\r\n <artifactId>jetty-server<\/artifactId>\r\n <version>${jetty.version}<\/version>\r\n <\/dependency>\r\n\r\n <dependency>\r\n <groupId>org.eclipse.jetty<\/groupId>\r\n <artifactId>jetty-servlet<\/artifactId>\r\n <version>${jetty.version}<\/version>\r\n <\/dependency>\r\n <\/dependencies>\r\n<\/project>\r\n<\/pre>\n\r\npackage com.putridparrot.core;\r\n\r\nimport javax.jws.WebParam;\r\nimport javax.jws.WebService;\r\n\r\n@WebService\r\npublic interface HelloWorld {\r\n String reply(@WebParam(name="text") String text);\r\n}\r\n<\/pre>\n\r\npackage com.putridparrot.core;\r\n\r\nimport javax.jws.WebParam;\r\nimport javax.jws.WebService;\r\n\r\n@WebService(endpointInterface = "com.putridparrot.core.HelloWorld", serviceName="HelloWorld")\r\npublic class HelloWorldImpl implements HelloWorld {\r\n public String reply(@WebParam(name = "text") String text) {\r\n return "Hello " + text;\r\n }\r\n}\r\n<\/pre>\n\r\npackage com.putridparrot.core;\r\n\r\nimport org.apache.cxf.bus.spring.SpringBus;\r\nimport org.apache.cxf.endpoint.Server;\r\nimport org.apache.cxf.jaxws.JaxWsServerFactoryBean;\r\nimport org.springframework.context.annotation.Bean;\r\nimport org.springframework.context.annotation.Configuration;\r\nimport org.springframework.context.annotation.DependsOn;\r\n\r\n@Configuration\r\npublic class AppConfig {\r\n @Bean( destroyMethod = "shutdown" )\r\n public SpringBus cxf() {\r\n return new SpringBus();\r\n }\r\n\r\n @Bean @DependsOn( "cxf" )\r\n public Server getServer() {\r\n JaxWsServerFactoryBean factory = new JaxWsServerFactoryBean();\r\n factory.setServiceBean(getService());\r\n return factory.create();\r\n }\r\n\r\n @Bean\r\n public HelloWorldImpl getService() {\r\n return new HelloWorldImpl();\r\n }\r\n}\r\n<\/pre>\n\r\npackage com.putridparrot.core;\r\n\r\nimport org.apache.cxf.transport.servlet.CXFServlet;\r\nimport org.eclipse.jetty.server.Server;\r\nimport org.eclipse.jetty.servlet.ServletContextHandler;\r\nimport org.eclipse.jetty.servlet.ServletHolder;\r\nimport org.springframework.web.context.ContextLoaderListener;\r\nimport org.springframework.web.context.support.AnnotationConfigWebApplicationContext;\r\n\r\npublic class App {\r\n public static void main( String[] args ) throws Exception {\r\n\r\n Server server = new Server( 9000 );\r\n\r\n ServletHolder servletHolder = new ServletHolder( new CXFServlet() );\r\n ServletContextHandler context = new ServletContextHandler();\r\n context.setContextPath( "\/" );\r\n context.addServlet( servletHolder, "\/*" );\r\n context.addEventListener( new ContextLoaderListener() );\r\n\r\n context.setInitParameter( "contextClass", AnnotationConfigWebApplicationContext.class.getName() );\r\n context.setInitParameter( "contextConfigLocation", AppConfig.class.getName() );\r\n\r\n server.setHandler( context );\r\n server.start();\r\n server.join();\r\n\r\n System.in.read();\r\n\r\n System.exit(0);\r\n }\r\n}\r\n<\/pre>\n