JDK11环境安装metro-jax-ws及运行wsimport问题咨询

前置检查 #

• 本地提前装好JDK11及以上版本，确认JAVA_HOME环境变量配置正确，命令行执行java -version可正常返回版本信息即可。

metro-jax-ws 安装步骤 #

• 下载官方发布的JAX-WS RI二进制压缩包（即metro-jax-ws正式发行包，不要下载源码包），包名一般为jaxws-ri-<版本号>.zip格式，选最新稳定版即可。
• 将压缩包解压到本地无中文、无空格的固定路径下，Windows可参考路径C:\devtools\jaxws-ri，macOS/Linux可参考路径/usr/local/jaxws-ri，解压后根目录下能看到bin、lib等子文件夹即解压正确。

wsimport 环境配置 #

Windows 系统 #

• 打开系统环境变量设置面板，新建系统变量JAXWS_HOME，变量值填写刚才解压的metro-jax-ws根目录完整路径。
• 编辑系统变量Path，新增条目%JAXWS_HOME%\bin，所有设置窗口点击确定保存。
• 新开一个命令提示符窗口（旧窗口不会加载新的环境变量配置），执行wsimport -version，正常输出版本号即配置生效。

macOS / Linux 系统 #

• 打开终端，编辑当前使用的shell配置文件：如果用zsh就编辑~/.zshrc，如果用bash就编辑~/.bash_profile，在文件末尾追加两行配置：

export JAXWS_HOME=/usr/local/jaxws-ri
export PATH=$JAXWS_HOME/bin:$PATH

• 保存文件后执行source <你编辑的配置文件路径>，让配置即时生效。
• 终端执行wsimport -version，正常返回版本信息即配置完成。

使用注意事项 #

• 不要直接拷贝JDK8内置的wsimport工具到高版本JDK目录使用，会出现类缺失、版本不兼容的问题，直接使用metro发行版自带的工具即可。
• 如果执行命令时提示依赖缺失，优先检查解压后的lib目录文件是否完整，有没有被安全软件误删。
• 生成WebService客户端代码时，如果运行环境是高版本JDK，可以追加-target 2.3参数（对应你下载的JAX-WS版本），避免生成的代码出现运行时兼容问题。

内容的提问来源于stack exchange，提问作者Jack