如何通过NWDS 7.5为SAP AS Java NetWeaver开发部署Web服务？

一、NWDS 7.5对JAX-WS开发的支持说明 #

NWDS 7.5完全支持JAX-WS开发，但和旧版本（如7.3及更早）的操作逻辑差异明显——旧版本右键Java类生成Web服务的向导已被整合到项目级的创建流程中，不再单独提供类右键的“Web Service”选项。

二、JAX-WS服务开发与部署的修正步骤 #

1. 正确生成Web服务配置 #

• 必须创建Dynamic Web Project（或Enterprise Application Project，用于多模块场景），而非普通Java项目。
• 编写好服务端点接口（SEI）和实现类后，通过Project > New > Other > Web Services > Web Service向导生成部署描述符与服务配置，向导中需选择SAP NetWeaver作为运行时环境，确保生成的配置适配AS Java。

2. WAR vs EAR包选择 #

• 仅包含Web服务的简单场景，WAR包足够；若需整合EJB、其他业务模块，才使用EAR包。AS Java原生支持WAR部署，但需保证WAR的WEB-INF目录结构符合SAP规范。
• 部署后需在NetWeaver Administrator（NWA）中检查应用状态，确认已处于“Started”状态。

3. 访问路径与目录列表问题 #

• 错误路径：https://host:port/web-service-name，正确路径应为https://host:port/[context-root]/[service-path]：
  • context-root由web.xml的<context-root>标签或项目创建时的配置指定；
  • service-path对应JAX-WS服务@WebService注解的端点路径，或生成的WSDL文件中的地址。
• 若访问仅显示目录列表，说明未正确映射服务端点：检查web.xml中是否配置了com.sun.xml.ws.transport.http.servlet.WSServlet的servlet映射，且url-pattern设置正确（通常为/*或/services/*）。

4. web.xml报错处理 #

AS Java对web.xml的规范比Tomcat更严格，需注意：

• 必须遵循Servlet 3.1规范（AS Java 7.5支持的版本）；
• 移除Tomcat特有的配置节点（如<Resource>）；
• 确保JAX-WS的servlet配置正确，示例：

  <servlet>
      <servlet-name>RoleImportService</servlet-name>
      <servlet-class>com.sun.xml.ws.transport.http.servlet.WSServlet</servlet-class>
      <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
      <servlet-name>RoleImportService</servlet-name>
      <url-pattern>/services/*</url-pattern>
  </servlet-mapping>
  

• 验证所有类路径引用无缺失，依赖库需包含SAP提供的JAX-WS相关jar包。

三、UME访问实现要点 #

• 引入SAP官方库：在NWDS中添加com.sap.security.api等相关依赖（可从SAP NetWeaver库中选择）；
• 代码示例（角色创建）：

  import com.sap.security.api.UMFactory;
  import com.sap.security.api.IRoleFactory;
  import com.sap.security.api.IRole;
  
  public class RoleImportServiceImpl {
      public void importRolesFromFile() throws Exception {
          IRoleFactory roleFactory = UMFactory.getRoleFactory();
          // 从文件读取角色数据，此处省略文件解析逻辑
          IRole newRole = roleFactory.createRole("PORTAL_ROLE_001", "EN", "门户管理员角色");
          roleFactory.saveRole(newRole);
      }
  }
  

• 权限配置：在NWA的Configuration > Security > Application Security中，为部署的应用分配UME操作权限（如UME.SuperAdmin或自定义权限）。

四、RESTful Web服务替代方案建议 #

若JAX-WS配置繁琐，推荐使用JAX-RS 2.0开发RESTful服务，AS Java 7.5原生支持基于Apache CXF的JAX-RS实现：

1. 项目创建 #

创建Dynamic Web Project，勾选“JAX-RS” facet，选择SAP提供的JAX-RS运行时。

2. 开发示例 #

import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Consumes;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;

@Path("/role-import")
public class RoleImportRestResource {
    @POST
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    public Response importRoles() {
        // 实现文件上传与角色导入逻辑
        try {
            // 此处添加UME操作代码
            return Response.ok("角色导入完成").build();
        } catch (Exception e) {
            return Response.status(Response.Status.INTERNAL_SERVER_ERROR).entity(e.getMessage()).build();
        }
    }
}

3. 部署与访问 #

• 打包为WAR部署，访问路径为https://host:port/[context-root]/role-import；
• 优势：轻量易集成，支持JSON/XML等多种数据格式，配置比JAX-WS更简洁，适合跨系统文件上传场景。

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