springboot整合axis1.4搭建服务端

前言

最近公司要开发个接口,要用webservices接口实现,而且使用的是axis1.4框架,webservices和axis这两个东西我之前都没接触过,而且axis1.4这个框架06年就不再维护了,没办法,客户就是上帝。上网查了一圈,基本都是spring整合axis的,而公司用的是springboot,比较头疼,在此记录下搭建过程。

一、引入依赖

 1 <dependency>
 2 <groupId>org.apache.axis</groupId>
 3 <artifactId>axis</artifactId>
 4 <version>1.4</version>
 5 </dependency>
 6 
 7 <dependency>
 8 <groupId>axis</groupId>
 9 <artifactId>axis-jaxrpc</artifactId>
10 <version>1.4</version>
11 </dependency>
12 
13 <dependency>
14 <groupId>commons-discovery</groupId>
15 <artifactId>commons-discovery</artifactId>
16 <version>0.2</version>
17 </dependency>
18 <dependency>
19 <groupId>wsdl4j</groupId>
20 <artifactId>wsdl4j</artifactId>
21 <version>1.6.3</version>
22 </dependency>

二、写个接口以及实现类

接口:

1 public interface HelloService {
2     public String sayHello(String info);
3  
4 }

实现类:

1 public class HelloServiceImpl implements HelloService {
2     public String sayHello(String info) {
3         return "sayHello:"+info;
4     }
5 }

三、创建资源文件server-config.wsdd

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <deployment xmlns="http://xml.apache.org/axis/wsdd/"
 3     xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
 4     <handler type="java:org.apache.axis.handlers.http.URLMapper"
 5         name="URLMapper" />
 6     
 7     <!--要告诉别人的接口名-->
 8     <service name="HelloServiceImpl" provider="java:RPC">
 9         <!--这个是 实现类-->
10         <parameter name="className" value="com.codefish.javalab.ws.server.HelloServiceImpl" />
11         <!--这是是暴露的方法名   比如可以值暴露一个-->
12         <parameter name="allowedMethods" value="sayHello" />
13         <!--这是是暴露的方法名   也可以用* 表示暴露全部的public方法-->
14         <!--<parameter name="allowedMethods" value="*" />-->
15     </service>
16 
17     <transport name="http">
18         <requestFlow>
19             <handler type="URLMapper" />
20         </requestFlow>
21     </transport>
22 
23 </deployment>

四、添加servlet过滤规则

新建com.example.servlet.WebServlet,继承AxisServlet。

 1     package com.example.servlet;
 2     import org.apache.axis.transport.http.AxisServlet;
 3     @javax.servlet.annotation.WebServlet(
 4             urlPatterns =  "/services/*",
 5             loadOnStartup = 1,
 6             name = "AxisServlet"
 7     )
 8     public class WebServlet extends AxisServlet {
 9            
10     }

五、重写Axis的配置工厂信息

因为我想要以jar包形式发布,所以需要重写EngineConfigurationFactory类,否则会访问不到。新建org.apache.axis.configuration.EngineConfigurationFactoryServlet,继承EngineConfigurationFactoryDefault。更改的是getServerEngineConfig(ServletConfig cfg)方法。(注意:该类需要放在org.apache.axis.configuration包下,我尝试放在其他路径下无效,如有大神知道,还望告知

  1 /*
  2  * Copyright 2002-2004 The Apache Software Foundation.
  3  * 
  4  * Licensed under the Apache License, Version 2.0 (the "License");
  5  * you may not use this file except in compliance with the License.
  6  * You may obtain a copy of the License at
  7  * 
  8  *      http://www.apache.org/licenses/LICENSE-2.0
  9  * 
 10  * Unless required by applicable law or agreed to in writing, software
 11  * distributed under the License is distributed on an "AS IS" BASIS,
 12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 13  * See the License for the specific language governing permissions and
 14  * limitations under the License.
 15  */
 16 
 17 package org.apache.axis.configuration;
 18 
 19 import org.apache.axis.AxisProperties;
 20 import org.apache.axis.ConfigurationException;
 21 import org.apache.axis.EngineConfiguration;
 22 import org.apache.axis.EngineConfigurationFactory;
 23 import org.apache.axis.components.logger.LogFactory;
 24 import org.apache.axis.server.AxisServer;
 25 import org.apache.axis.utils.ClassUtils;
 26 import org.apache.axis.utils.Messages;
 27 import org.apache.commons.logging.Log;
 28 
 29 import javax.servlet.ServletConfig;
 30 import java.io.InputStream;
 31 
 32 /**
 33  * This is a default implementation of ServletEngineConfigurationFactory.
 34  * It is user-overrideable by a system property without affecting
 35  * the caller. If you decide to override it, use delegation if
 36  * you want to inherit the behaviour of this class as using
 37  * class extension will result in tight loops. That is, your
 38  * class should implement EngineConfigurationFactory and keep
 39  * an instance of this class in a member field and delegate
 40  * methods to that instance when the default behaviour is
 41  * required.
 42  *
 43  * @author Richard A. Sitze
 44  * @author Davanum Srinivas (dims@apache.org)
 45  */
 46 public class EngineConfigurationFactoryServlet
 47         extends EngineConfigurationFactoryDefault {
 48     protected static Log log =
 49             LogFactory.getLog(EngineConfigurationFactoryServlet.class.getName());
 50 
 51     private ServletConfig cfg;
 52 
 53     /**
 54      * Creates and returns a new EngineConfigurationFactory.
 55      * If a factory cannot be created, return 'null'.
 56      * <p>
 57      * The factory may return non-NULL only if:
 58      * - it knows what to do with the param (param instanceof ServletContext)
 59      * - it can find it's configuration information
 60      *
 61      * @see EngineConfigurationFactoryFinder
 62      */
 63     public static EngineConfigurationFactory newFactory(Object param) {
 64         /**
 65          * Default, let this one go through if we find a ServletContext.
 66          *
 67          * The REAL reason we are not trying to make any
 68          * decision here is because it's impossible
 69          * (without refactoring FileProvider) to determine
 70          * if a *.wsdd file is present or not until the configuration
 71          * is bound to an engine.
 72          *
 73          * FileProvider/EngineConfiguration pretend to be independent,
 74          * but they are tightly bound to an engine instance...
 75          */
 76         return (param instanceof ServletConfig)
 77                 ? new EngineConfigurationFactoryServlet((ServletConfig) param)
 78                 : null;
 79     }
 80 
 81     /**
 82      * Create the default engine configuration and detect whether the user
 83      * has overridden this with their own.
 84      */
 85     protected EngineConfigurationFactoryServlet(ServletConfig conf) {
 86         super();
 87         this.cfg = conf;
 88     }
 89 
 90     /**
 91      * Get a default server engine configuration.
 92      *
 93      * @return a server EngineConfiguration
 94      */
 95     public EngineConfiguration getServerEngineConfig() {
 96         return getServerEngineConfig(cfg);
 97     }
 98 
 99     /**
100      * Get a default server engine configuration in a servlet environment.
101      *
102      * @param cfg a ServletContext
103      * @return a server EngineConfiguration
104      */
105     private static EngineConfiguration getServerEngineConfig(ServletConfig cfg) {
106 
107         // Respect the system property setting for a different config file
108         String configFile = cfg.getInitParameter(OPTION_SERVER_CONFIG_FILE);
109         if (configFile == null)
110             configFile =
111                     AxisProperties.getProperty(OPTION_SERVER_CONFIG_FILE);
112         if (configFile == null) {
113             configFile = SERVER_CONFIG_FILE;
114         }
115 
116         /**
117          * Flow can be confusing.  Here is the logic:
118          * 1) Make all attempts to open resource IF it exists
119          *    - If it exists as a file, open as file (r/w)
120          *    - If not a file, it may still be accessable as a stream (r)
121          *    (env will handle security checks).
122          * 2) If it doesn't exist, allow it to be opened/created
123          *
124          * Now, the way this is done below is:
125          * a) If the file does NOT exist, attempt to open as a stream (r)
126          * b) Open named file (opens existing file, creates if not avail).
127          */
128 
129         /*
130          * Use the WEB-INF directory
131          * (so the config files can't get snooped by a browser)
132          */
133         String appWebInfPath = "/WEB-INF";
134         //由于部署方式变更为jar部署,此处不可以使用改方式获取路径
135 //        ServletContext ctx = cfg.getServletContext();
136 //        String realWebInfPath = ctx.getRealPath(appWebInfPath);
137 
138         FileProvider config = null;
139         String realWebInfPath = EngineConfigurationFactoryServlet.class.getResource(appWebInfPath).getPath();
140 
141         /**
142          * If path/file doesn't exist, it may still be accessible
143          * as a resource-stream (i.e. it may be packaged in a JAR
144          * or WAR file).
145          */
146         InputStream iss = ClassUtils.getResourceAsStream(EngineConfigurationFactoryServlet.class, appWebInfPath+"/" + SERVER_CONFIG_FILE);
147         if (iss != null) {
148             // FileProvider assumes responsibility for 'is':
149             // do NOT call is.close().
150             config = new FileProvider(iss);
151         }
152 
153         if (config == null) {
154             log.error(Messages.getMessage("servletEngineWebInfError03", ""));
155         }
156 
157         /**
158          * Couldn't get data  OR  file does exist.
159          * If we have a path, then attempt to either open
160          * the existing file, or create an (empty) file.
161          */
162         if (config == null && realWebInfPath != null) {
163             try {
164                 config = new FileProvider(realWebInfPath, configFile);
165             } catch (ConfigurationException e) {
166                 log.error(Messages.getMessage("servletEngineWebInfError00"), e);
167             }
168         }
169 
170         /**
171          * Fall back to config file packaged with AxisEngine
172          */
173         if (config == null) {
174             log.warn(Messages.getMessage("servletEngineWebInfWarn00"));
175             try {
176                 InputStream is =
177                         ClassUtils.getResourceAsStream(AxisServer.class,
178                                 SERVER_CONFIG_FILE);
179                 config = new FileProvider(is);
180 
181             } catch (Exception e) {
182                 log.error(Messages.getMessage("servletEngineWebInfError02"), e);
183             }
184         }
185 
186         return config;
187     }
188 }

六、配置Application

添加注解 @ServletComponentScan

@SpringBootApplication
@ServletComponentScan //扫描自定义的WebFilter和WebListener,否则无法扫描到
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

启动程序,访问http://localhost:8080/services,会将server-config.wsdd里面的接口发布出来,此时客户端可以调用接口。

点赞