webService接口对接医院lis系统接口

本文涉及的产品
全局流量管理 GTM,标准版 1个月
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
云解析 DNS,旗舰版 1个月
简介: webService接口对接医院lis系统接口

@[toc]

1、应用场景

       由于本软件使用sprongboot前后端分离框架开发,前后端接口都是通过http协议交互的。如果搭建webService服务,太麻烦了,不想弄。因此,如何在原有的基础上,可以发送和接收webService请求呢?这要从webService接口的本质出发,解决问题。
       作为javaweb开发者,http协议是最熟悉的协议了。但是,在开发医院系统的时候,业务往往需要和lis、his系统或者医疗设备对接,因此,就会接触一些http以外的协议,比如hl7协议、soup协议等。了解每个协议的本质,开发业务才能得心应手。

2、http协议简述

       http协议是最熟悉的了,超文本传输协议(Hyper Text Transfer Protocol,HTTP)是一个简单的请求-响应协议,它通常运行在TCP之上。通常包含请求头、请求体,我们一般发送get请求或者post请求,在前后端分离模式中,数据通过json的格式发送。分别使用HttpServletRequest和HttpServletResponse来解析数据并做出响应,这是Servlet相关的内容,在接收webService请求的时候需要用到。

3、webService协议/soup简述

       http 和 webservice 都是基于TCP/IP协议的应用层协议,soup是webService的基础通信协议。
       对于新手来说只要记住这些就行了:
       webservice=soap=http+xml,webservice协议就是有http+xml组成的,其中xml中会用到wsdl,wsdl是描述语言xml中的一种格式。Soap建立在http上,说白了就是用http传送xml。
       之所以使用webService协议是为了实现跨编程语言和跨操作系统平台,webService就是现在微服务最初模样,相当于微服务间的远程调用,除了WebService外,常见的远程调用技术还有RMI(Remote method invoke)和CORBA,由于WebService的跨平台和跨编程语言特点,因此比其他两种技术应用更为广泛,但性能略低。有兴趣的可以了解一下,下面开始上代码!

4、发送webService请求

       读完上面我们知道了webService接口就是通过http协议发送xml内容,换句话说,发送一个webService请求,就是http+xml+post。将xml内容放到请求体中,以post的方式发送,这就是一个webService请求了。

4.1建立HttpUtils工具类,来发送post请求

HttpUtils工具类,注意,这里的Content-Type设置为text/xml; charset=utf-8,或者设置为application/xml也可以。

public class HttpUtils
{
   
   
    private static final Logger log = LoggerFactory.getLogger(HttpUtils.class);

    /**
     * 向指定 URL 发送POST方法的请求
     *
     * @param url 发送请求的 URL
     * @param param 请求参数,请求参数应该是 xml 的形式。
     * @return 所代表远程资源的响应结果
     */
    public static String sendPost(String url, String param)
    {
   
   
        PrintWriter out = null;
        BufferedReader in = null;
        StringBuilder result = new StringBuilder();
        try
        {
   
   
            log.info("sendPost - {}", url);
            URL realUrl = new URL(url);
            URLConnection conn = realUrl.openConnection();
            conn.setRequestProperty("accept", "*/*");
            conn.setRequestProperty("connection", "Keep-Alive");
            conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
            conn.setRequestProperty("Accept-Charset", "utf-8");
            conn.setRequestProperty("Content-Type", "text/xml; charset=utf-8");
            conn.setDoOutput(true);
            conn.setDoInput(true);
            out = new PrintWriter(conn.getOutputStream());
            out.print(param);
            out.flush();
            in = new BufferedReader(new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8));
            String line;
            while ((line = in.readLine()) != null)
            {
   
   
                result.append(line);
            }
            log.info("recv - {}", result);
        }
        catch (ConnectException e)
        {
   
   
            log.error("调用HttpUtils.sendPost ConnectException, url=" + url + ",param=" + param, e);
        }
        catch (SocketTimeoutException e)
        {
   
   
            log.error("调用HttpUtils.sendPost SocketTimeoutException, url=" + url + ",param=" + param, e);
        }
        catch (IOException e)
        {
   
   
            log.error("调用HttpUtils.sendPost IOException, url=" + url + ",param=" + param, e);
        }
        catch (Exception e)
        {
   
   
            log.error("调用HttpsUtil.sendPost Exception, url=" + url + ",param=" + param, e);
        }
        finally
        {
   
   
            try
            {
   
   
                if (out != null)
                {
   
   
                    out.close();
                }
                if (in != null)
                {
   
   
                    in.close();
                }
            }
            catch (IOException ex)
            {
   
   
                log.error("调用in.close Exception, url=" + url + ",param=" + param, ex);
            }
        }
        return result.toString();
    }
}

4.2 调用医院给的url和xml内容

比如要获取病人id为11111111的信息,前端输入病人id/或者住院号之类的,后端拿到id后直接向lis发送webService请求:
请求地址:

url=http://127.0.0.1:8080/webService/soup.aspx?s=patientService

xml内容:

<?xml version="1.0" encoding="gbk"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getPatient xmlns="http://tempuri.org/">
      <patient><![CDATA[{"patiend_id":"11111111"}]]></patient>
    </getPatient>
  </soap:Body>
</soap:Envelope>

响应示例(仅供参考):

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <LisServiceResponse xmlns="http://tempuri.org/">
         <LisServiceResult>
            {
            "code": "200",
            "data":{
                       "住院号": "11111111",
                       "姓名": "胡思源",
                       "手术费": "1000",
                       "年龄": "18"
                      }
            }
        </LisServiceResult>
      </LisServiceResponse>
   </soap:Body>
</soap:Envelope>

我们就可以在Controller中写如下代码:

     @GetMapping("/{patientId}")
    @ApiOperation("根据患者id新增患者信息")
    public AjaxResult add(@PathVariable(value = "patientId") Long patientId)
    {
   
   
    //从前端拿到患者id后,直接发送webService请求
    String url = "http://127.0.0.1:8080/webService/soup.aspx?s=patientService";
    String xml = "<?xml version=\"1.0\" encoding=\"gbk\"?>\n" +
                "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
                "  <soap:Body>\n" +
                "    <getPatient xmlns=\"http://tempuri.org/\">\n" +
                "      <patient><![CDATA[{\"patiend_id\":\"" + patientId+ "\"}]]></patient>\n" +
                "    </getPatient>\n" +
                "  </soap:Body>\n" +
                "</soap:Envelope>";
    //使用工具类发送webService请求
    String responseBody = HttpUtils.sendPost(url, xml);
    //拿到响应后,是一个xml内容的字符串,患者的信息都在xml内容中,对xml解析就行了
    //我这里和医院商量好,将患者内容以json的方式包到了xml中,所以,我直接使用截取json字符串后,采用阿里的fastjson解析成患者对象的。
    //这里按照上面提供的响应示例,供大家参考。
    responseBody = "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
            "   <soap:Body>\n" +
            "      <LisServiceResponse xmlns=\"http://tempuri.org/\">\n" +
            "         <LisServiceResult>\n" +
            "\t\t\t{\n" +
            "\t\t\t\"code\": \"200\",\n" +
            "\t\t\t\"data\":{\n" +
            "\t\t\t\t\t   \"住院号\": \"11111111\",\n" +
            "\t\t\t           \"姓名\": \"胡思源\",\n" +
            "\t\t\t           \"手术费\": \"1000\",\n" +
            "\t\t\t           \"年龄\": \"18\"\n" +
            "\t\t\t          }\n" +
            "\t\t\t}\n" +
            "</LisServiceResult>\n" +
            "      </LisServiceResponse>\n" +
            "   </soap:Body>\n" +
            "</soap:Envelope>";
            //将xml解析成json
        int startIndex = responseBody .indexOf("{");
        int endIndex = responseBody .lastIndexOf("}");
        //获取json字符串
        String substring = responseBody .substring(startIndex, endIndex + 1);
        //去除所有空白
        String whitespace = StringUtils.deleteWhitespace(substring);
        //去除字符串中的"\n", "\r", or "\r\n"
        org.apache.commons.lang3.StringUtils.chomp(whitespace);

        //在使用阿里的fastjson解析成java对象
        JSONObject jsonObject = (JSONObject) JSON.parse(jsonString);
        //获取code
        String code = jsonObject.get("code").toString();
        if ("200".equals(code)){
   
   
            //获取data信息
            String data = jsonObject.get("data").toString();
            //这里就剩解析成java对象,进行业务逻辑的编写了,就不再赘述了!
            ..............
        }else {
   
   
            //这里处理响应不为200的情况
            ...............
        }
}

5、接收webService请求

       想要接收lis系统以webService接口发送的请求,需要有webService服务,但是在Springboot+http协议外,再搭建webService服务,多少有点冗余,主要的是和lis系统对接的接口并不多,主要还是自身的业务逻辑多,这时候怎么处理呢?
       根据上面我们了解到的,webService接口的本质就是http+xml+post。从这上面出发,我们本身已经是http协议的了,post请求也可以发送和接收,唯一不同的点就是xml内容了。
       这里我们以servlet解决这个问题,servlet下有ServletRequest和ServletResponse,ServletRequest又可以直接获取请求体,而xml内容又在请求体中,这样我们就可以拿到lis系统请求中所带的内容了,问题也就解决了,不需要重新搭建webService服务。下面上代码。

5.1 创建HttpHelper工具类

这里需要注意的一点是编码问题,一定要和对方的编码方式一致,例如:StandardCharsets.UTF_8

/**
 * 通用http工具封装
 *
 * @author ruoyi
 */
public class HttpHelper
{
   
   
    private static final Logger LOGGER = LoggerFactory.getLogger(HttpHelper.class);

    public static String getBodyString(ServletRequest request)
    {
   
   
        StringBuilder sb = new StringBuilder();
        BufferedReader reader = null;
        try (InputStream inputStream = request.getInputStream())
        {
   
   
            reader = new BufferedReader(new InputStreamReader(inputStream, StandardCharsets.UTF_8));
            String line = "";
            while ((line = reader.readLine()) != null)
            {
   
   
                sb.append(line);
            }
        }
        catch (IOException e)
        {
   
   
            LOGGER.warn("getBodyString出现问题!");
            e.printStackTrace();
        }
        finally
        {
   
   
            if (reader != null)
            {
   
   
                try
                {
   
   
                    reader.close();
                }
                catch (IOException e)
                {
   
   
                    LOGGER.error(ExceptionUtils.getMessage(e));
                    e.printStackTrace();
                }
            }
        }
        return sb.toString();
    }
}

5.2 在Controller中写业务逻辑

/**
     * 添加病人化验结果(对方发出webService请求)
     * @param request
     * @param response
     */
    @PostMapping("/put")
    @ApiOperation("添加病人化验结果")
    public void putBloodStorage(ServletRequest request, ServletResponse response){
   
   
        //获取bodyString
        String bodyString = HttpHelper.getBodyString(request);

        //解析soap的请求体
        //这里的做法和上面一样都是借用fastjson解析成java对象的,就不详细写了
        .................
        //如果解析成功,则执行你的插入逻辑
        .................
        //webService接口响应
        try {
   
   
            //返回soap的xml响应
            response.setStatus(200);
            response.setContentType("text/xml; charset=utf-8");
            response.setCharacterEncoding("utf-8");
            String resp = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n" +
                    "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
                    "  <soap:Body>\n" +
                    "    <getAddResponse xmlns=\"http://tempuri.org/\">\n" +
                    "      <getAddResult>\n" +
                    "                    {\"code\": \"200\",\n" +
                    "                    \"message\": \"ok\"}\n" +
                    "      </getAddResult>\n" +
                    "    </getAddResponse>\n" +
                    "  </soap:Body>\n" +
                    "</soap:Envelope>";
            response.getWriter().print(resp);
        } catch (IOException e) {
   
   
            e.printStackTrace();
        }
    }

5.3 用soupUI测试自己的webService接口是否可以成功调用

这里就不赘述了,直接放个我测试成功的图片了!
在这里插入图片描述

目录
相关文章
phpstorm插件应用:Test RESTful WEB Service 控制台接口调试工具
phpstorm插件应用:Test RESTful WEB Service 控制台接口调试工具
200 0
|
2月前
|
XML 前端开发 Java
JAVA调试webservice接口
JAVA调试webservice接口
29 0
|
5月前
|
XML Java API
使用WebService接口进行数据通信
使用WebService接口进行数据通信
|
5月前
|
XML Java API
使用WebService接口进行数据通信
使用WebService接口进行数据通信
|
7月前
|
存储 监控 BI
HIS系统是什么?一套前后端分离云HIS系统源码 接口技术RESTful API + WebSocket + WebService
医院管理信息系统(全称为Hospital Information System)即HIS系统。 常规模版包括门诊管理、住院管理、药房管理、药库管理、院长查询、电子处方、物资管理、媒体管理等,为医院管理提供更有力的保障。 HIS系统以财务信息、病人信息和物资信息为主线,通过对信息的收集、存储、传递、统计、分析、综合查询、报表输出和信息共享,及时为医院领导及各部门管理人员提供全面、准确的各种数据。 门诊医生工作站采用下拉式汉化菜单,界面友好,实用性强,设有与门诊挂号收费系统、医技科室信息系统、住院结算信息系统的软件接口。
168 1
使用队列解决高并发下使用Client对象调用webService接口
使用队列解决高并发下使用Client对象调用webService接口
|
网络安全 网络架构
https请求SOAP webService接口
https请求SOAP webService接口
149 0
|
XML 测试技术 数据安全/隐私保护
【SoapUI、Postman、WebServiceStudio、Jmeter】接口测试工具结合测试webservice接口(发送XML格式参数)
【SoapUI、Postman、WebServiceStudio、Jmeter】接口测试工具结合测试webservice接口(发送XML格式参数)
313 0
|
XML Android开发 数据格式
WebService接口调试如此简单
WebService接口调试如此简单
|
XML API 数据格式
十九、.net core使用SoapCore开发webservice接口,以及使用HttpClientFactory动态访问webservice接口
使用SoapCore实现在.net core平台下开发webservice;以及使用HttpClientFactory动态访问webservice。首先,需要在包项目下面引用SoapCore:
1077 0
十九、.net core使用SoapCore开发webservice接口,以及使用HttpClientFactory动态访问webservice接口