Question

我想为我的XPage应用程序设置一些基本的REST服务。所以我在xpage上添加了xe：restService控件并选择了xe：customRestService，其中我引用了Java类：

<xe:restService id="restService1" pathInfo="json" state="false">
        <xe:this.service>
            <xe:customRestService contentType="application/json"
                serviceBean="se.banking.desk.CustomSearchHelper">
            </xe:customRestService>
        </xe:this.service>
    </xe:restService>

它自己的CustomSearchHelper类仍然很空，但我想知道我是否在正确的轨道上？

以下是该类的代码：

package se.banking.desk;

import java.io.IOException;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.ibm.domino.services.ServiceException;
import com.ibm.domino.services.rest.RestServiceEngine;
import com.ibm.xsp.extlib.component.rest.CustomService;
import com.ibm.xsp.extlib.component.rest.CustomServiceBean;

public class CustomSearchHelper extends CustomServiceBean {

    @Override
    public void renderService(CustomService service, RestServiceEngine engine) throws ServiceException {

        HttpServletRequest request = engine.getHttpRequest();           
        String method = request.getMethod();

        HttpServletResponse response = engine.getHttpResponse();        
        response.setHeader("Content-Type", "text/javascript; charset=UTF-8");        

        if(method.equals("GET")){
            this.get(engine);
        }
        else if(method.equals("POST")){
            this.post(engine,request);
        }
        else{
            this.other(engine);
        }

    }

    public void get(RestServiceEngine engine){
        HttpServletResponse response = engine.getHttpResponse();
        try {
            response.getWriter().write("get()");
            response.getWriter().close();
            return;
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

    public void post(RestServiceEngine engine,HttpServletRequest request){
      HttpServletResponse response = engine.getHttpResponse();
      Map parameters = request.getParameterMap();
      try {
          response.getWriter().write("post()");
          response.getWriter().write( request.getParameter("form"));
          String[] form = (String[])parameters.get("form");
          String val = form[0];
          response.getWriter().write(val);
        response.getWriter().close();
    } catch (Exception e) {
        // TODO: handle exception
    }     

  }

    public void other(RestServiceEngine engine){
       HttpServletResponse response = engine.getHttpResponse();
        try {
            response.getWriter().write("other()");
            response.getWriter().close();
            return;
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}

我遇到的问题：这是编写自定义REST服务的好方法吗？还有替代品吗？我在哪里可以找到更多从入门级开始的示例/信息？

Answer 1

你问了一个相当复杂的问题，这个问题在过去几年一直在我的脑海中浮现。我的评估是找到“好方法”归结为应用程序中使用的开发人员和约定。我已经包含了我所看到的备选方案的来源链接，其中包括我的一些，其中一些试图从头开始解决一些概念，例如我的series on http servlets。

[更新]我编辑了这个答案以包含一些代码示例，因为链接最终可能无法正常工作;这应该保留答案的意图。[/ Update]

您的实现是如何将 xe：restService 控件轻松绑定到XPage的一个很好的示例，可以在XPage运行时和Domino服务器中使用各种选项。

据我所知，在XPage上下文中有大约5种实现RESTful API /端点的独特（-ish）方式。按照易于实施的一般顺序（取决于人）：

XAgent（这可以与下一个交换;易于入手的好处，可用的大量示例，以及那些没有Java经验的人可以在SSJS或Java中完成更少的工作）< / LI>
```
<?xml version="1.0" encoding="UTF-8"?>
<xp:view
    xmlns:xp="http://www.ibm.com/xsp/core"
    rendered="false"
    viewState="nostate">
    <xp:this.afterRenderResponse>
        <![CDATA[#{javascript:com.demo.DataProvider.myCustomDataServiceAsJson();}]]>
    </xp:this.afterRenderResponse>

    XAgent. This will not render as a page, but as application/json data.
</xp:view>
```
1. 关于 xe：restService 的最佳部分是 xe：viewJsonService 之类的开箱即用选项（Domino开发人员已经根据视图考虑了这些选项）正如马克在评论中所指出的那样，和文档有点类似于RESTful API的集合和记录机制。这些很容易进入和方便（很多人都在博客上写这些，Brad has covered some of these rather extensively in his data grids series）
2. xe：restService ，或者作为上面显示的 CustomServiceBean ，或者作为 xe：customRestService 的另一种风格，带有 xe：this.doGet 等方法（可以通过调用类的方法或SSJS来完成;我推荐前者）

Answer 2

Eric指出了如何在XPage中实现REST服务的不同方法。以下是我在IBM Connect 2016上关于REST服务的演示文稿的链接。http://www.assono.de/blog/d6plinks/ibmconnect2016-ad1238

该演示文稿涵盖了除OSGi插件之外的所有不同方式，因为这种技术在1小时的会话中有点重。

在示例数据库中，使用了所有其他方法。只需下载示例并在Notes客户端中打开它即可。有一个欢迎页面可以指导您访问代码和示例。

你已经走得很好了。

我的xpage应用程序的基本REST服务

2 个答案: