在HC免费开源物业系统中开发接口，很详细

最近在捣鼓HC免费开源物业系统，他们的开发文档比较简单，有些细节也没说清楚，因此踩了不少坑，这里做个记录。

这是他们的开发文档

http://www.homecommunity.cn/devDoc/

我是按照网友贡献的开发接口博客进行接口开发，地址如下：

http://bbs.homecommunity.cn/document.html?docId=102022061989930248

一、创建对应的数据表已经对应的DAO

这里我只是想摸索接口是怎么调用的，就没有建表和DAO，网友的博客有说明怎么操作。

二、创建Service，也就是SMO

1、创建测试接口

2、创建对应接口的实现类

我看了一下，SMO和对应的实现类并不放在同一模块，想放那个模块自行决定，我就放在“service-common ”模块

这是模块的项目模块的介绍

地址如下：

http://bbs.homecommunity.cn/document.html?docId=102022061989930248

3、接着是创建Cmd，也就相当于Controller

想要看到返回值就使用context调用一下setResponseEntity方法设置一下值，否则就只能看到接口调用成功的信息。

我这里只是想看看接口调用的结果，就简单返回个字符串，更多详情可以看其他xxxCmd类。

注意：

Java110Cmd注解中的 serviceCode 的值后面要使用dev账号注册服务。

三、使用Java110Cmd注解的值注册服务

1、先使用dev账号登录

2、在“服务–服务注册–服务绑定”进行服务绑定

（1）、选择应用

真正开发接口的时候选择对应应用就行了，我这里选择的是小区管理系统 web 端

（2）、选择/添加服务

一般都是先添加服务后再选择

注意！！！

这个服务编码就是@Java110Cmd对应的值，千万不要写错了，写错了后面调用接口会报错。

我这里添加过了，就不再做添加，点击选择服务进行选择就行了

添加成功之后可能在选择服务时看不到，选择“缓存–刷新缓存”，清一下对应缓存

没有意外的话就可以在选择服务那看到了。

================================================================================================

如果看不到的话可以去“tt”数据库中的“c_service”，使用Java110Cmd注解的值（服务编码）查一下有没有对应的记录，没有的话应该就是添加时服务编码写错了

四、调用接口

1、在postman中调用

2、在项目中调用

我这里是测试，就随便找地方加个按钮进行接口调用，先看看效果

源码如下：

_testGet: function() {
    var param = {
        params: {
            page: 1,
            row: 100,
            shType: '2806',
            communityId: vc.getCurrentCommunity().communityId
        }
    };
    //发送get请求
    vc.http.apiGet('test.testMethod',
        param,
        function (json, res) {
            let _storehouseManageInfo = JSON.parse(json);
            vc.component.addResourceStoreInfo.storehouses = _storehouseManageInfo.data;

        }, function (errInfo, error) {
            console.log('请求失败处理');
        }
    );
},

从其他地方拿到vc.http.apiGet方法，将第一个参数值改为我的@Java110Cmd注解（服务编码）的值，其他都没有改，会自动生成当前时间以及TRANSACTION-ID

五、踩坑记录

1、可以在服务注册哪里看到绑定的服务信息，但调用接口的时候进不去方法里，打断点也不会停下

检查一下自己新建的服务接口、Cmd接口的所处包位置，如果是建在已经存在的包里，那应该没有问题，如果是放在自己新建的包里，那么可能是没有扫描到包，在对应的ApplicationStart添加扫描包

添加之后重启对应的ApplicationStart服务。