用函数计算搭建微服务——云客服访客名片-阿里云开发者社区

开发者社区> 阿里云Serverless Compute> 正文
登录阅读全文

用函数计算搭建微服务——云客服访客名片

简介:

云客服可以方便快捷集成到用户的官网、APP、公众号等任意位置;依托阿里云智能算法,机器人能准确的理解用户的意图,并准确的回答用户的问题;提供完整的热线、在线服务功能,并能轻松连接企业的其他系统,如 CRM 等;动态管理客户和坐席使用的统一知识库、知识文章;实时汇总、实时分析服务中心的数据,帮助业务决策者从全局视角了解热门问题和当前的服务瓶颈;云客服是一套完整的智能服务体系。

访客名片是云客服上一个功能,用于关联云客服和客户 CRM 系统之间的用户,方便客服人员了解提问用户的基本信息,更好的支持用户。

目前云客服提供的访客名片集成指南是一个基于 Spring MVC 实现的 Web 项目,nodejs 语言背景的用户提出希望将 java 实现移植到函数计算服务,以服务的形式提供给 nodejs 实现的核心业务调用。

困难点

用户自己尝试过移植,如下几个技术点让其受挫:

  1. 云客服提供的 jar 是 maven 私有仓库,外网无法访问,所以需要以拷贝 jar 的方式集成进 maven
  2. 如何正确的配置 maven 插件打包成函数计算支持的 jar 包。

依赖本地 Jar 包

fccsplatform-common-crypto-1.0.0.20161108.jar 是一个阿里内网 maven 仓库的包,外网客户需要问云客服索要。下面 xml片段是 maven 依赖本地 jar 包的通用方法,但是由于 maven 依赖本地 jar 并不常见,需要查些资料。

<dependency>
    <groupId>com.alipay.fc.csplatform</groupId>
    <artifactId>fccsplatform-common-crypto</artifactId>
    <version>1.0.0.20161108</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/fccsplatform-common-crypto-1.0.0.20161108.jar</systemPath>
</dependency>

<scope>system</scope>表示从系统路径查找 jar 包,而不是仓库,要配合 <systemPath/> 一起使用。<systemPath/> 指定 jar 的真实路径,一般需要配合${project.basedir}一起使用,表示相对于项目目录。

封装 Handler 函数

Spring MVC 以 Controller 的形式对外暴露服务,而对应于函数计算实现 Handler 接口即可。

/**
 * This is the interface for any none event based function handler
 */
public interface StreamRequestHandler {

    /**
     * The interface to handle a function compute invoke request
     *
     * @param input The function compute input data wrapped in a stream
     * @param output The function compute output data wrapped in a stream
     * @param context The function compute execution environment context object.
     * @throws IOException IOException during I/O handling
     */
    void handleRequest(InputStream input, OutputStream output, Context context) throws IOException;
}

访客名片的业务较为简单只要实现加密和解码两个接口,不涉及到第三方服务调用

public class Encryptor implements StreamRequestHandler {

    private CustomerInfo customerInfo = new CustomerInfo();

    public void handleRequest(InputStream input, OutputStream output, Context context) throws IOException {
        String cInfo = CharStreams.toString(new InputStreamReader(
                input, Charset.defaultCharset()));
        try {
            output.write(customerInfo.encrypt(cInfo).getBytes(Charset.defaultCharset()));
        } catch (GeneralSecurityException e) {
            e.printStackTrace();
        }
    }
}
public class Decryptor implements StreamRequestHandler {

    private CustomerInfo customerInfo = new CustomerInfo();

    @Override
    public void handleRequest(InputStream input, OutputStream output, Context context) throws IOException {
        String jsonString = CharStreams.toString(new InputStreamReader(
                input, Charset.defaultCharset()));

        JSONObject jsonObject = JSON.parseObject(jsonString);
        try {
            String cInfo = customerInfo.decrypt(jsonObject.getString("params"), jsonObject.getString("key"));
            output.write(cInfo.getBytes(Charset.defaultCharset()));

        } catch (GeneralSecurityException e) {
            e.printStackTrace();
        }

    }
}

上面 Encryptor.java 和 Decryptor.java 负责实现 StreamRequestHandler 接口,而 CustomerInfo.java 类封装了真正的业务逻辑。

public class CustomerInfo {

    # 问云客服要 PUB_KEY
    private static String PUB_KEY = "your PUB_KEY";


    public String encrypt(String cInfo) throws GeneralSecurityException, UnsupportedEncodingException {
        PublicKey publicKey = getPubKey(PUB_KEY);
        Map<String, String> res = CustomerInfoCryptoUtil.encryptByPublicKey(cInfo, publicKey);

        JSONObject jsonObject = new JSONObject();
        jsonObject.put("cinfo", res.get("text"));
        jsonObject.put("key", res.get("key"));

        return jsonObject.toJSONString();
    }

    public String decrypt(String params, String key) throws UnsupportedEncodingException, GeneralSecurityException {
        PublicKey publicKey = getPubKey(PUB_KEY);
        return CustomerInfoCryptoUtil.decryptByPublicKey(params, key, publicKey);
    }

    private PublicKey getPubKey(String pubKey) throws NoSuchAlgorithmException, InvalidKeySpecException {
        X509EncodedKeySpec keySpec = new X509EncodedKeySpec(Base64Util.decode(pubKey));
        KeyFactory keyFactory;
        keyFactory = KeyFactory.getInstance("RSA");
        PublicKey key = keyFactory.generatePublic(keySpec);
        return key;
    }

打包

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <id>copy-dependencies</id>
            <phase>prepare-package</phase>
            <goals>
                <goal>copy-dependencies</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/classes/lib</outputDirectory>
                <includeScope>compile</includeScope>
            </configuration>
        </execution>
    </executions>
</plugin>

函数计算官方文档推荐了两种打包方式 maven-assembly-plugin 和 maven-dependency-plugin。

  • maven-assembly-plugin 会提取所有被依赖的 class 文件,重新打包成一个 jar 包,体积更小,但可能会产生一些额外的问题
  • maven-dependency-plugin 将所有依赖 jar 包都打包那一个内部的 lib/ 目录下,然后打包成嵌套 jar 包,函数计算运行时会解压顶层 jar 包。

关于 java 打包更多的细节可以参考个人的另外一篇文章《Java 打包 FatJar 方法小结》 。本例中实测使用 maven-assembly-plugin 插件打包是不行的,因为 systemPath 指定依赖的传递依赖没法被打包进去,导致运行时缺少类,所以选用了 maven-dependency-plugin 的方式。

fun 部署

最后通过一个 fun 的 template.yml 文件进行描述, 然后执行 mvn package && fun deploy

ROSTemplateFormatVersion: '2015-09-01'
Transform: 'Aliyun::Serverless-2018-04-03'
Resources:
  YunkefuSign:
    Type: 'Aliyun::Serverless::Service'
    Properties:
      Description: 'yun ke fu Sign'
    Encryptor:
      Type: 'Aliyun::Serverless::Function'
      Properties:
        Handler: com.aliyun.fc.Encryptor::handleRequest
        Runtime: java8
        CodeUri: './target/yunkefu-sign-1.0-SNAPSHOT.jar'
        Timeout: 60
    Decryptor:
      Type: 'Aliyun::Serverless::Function'
      Properties:
        Handler: com.aliyun.fc.Decryptor::handleRequest
        Runtime: java8
        CodeUri: './target/yunkefu-sign-1.0-SNAPSHOT.jar'
        Timeout: 60

小结

将语言作为服务的边界是服务架构常见的划分边界方式之一。函数计算支持多语言环境,具备可扩展和高可用特性,使其适于以服务的形式支持多语言的架构。通常情况下,开发商在熟悉语言领域有足够的积累,构建了一整套完备的架构和部署运维体系,而为了扩大业务的边界,有时候会面临被迫选择熟悉语言领域之外的编程语言和架构,对于这一挑战,函数计算只需要用语言简单地写业务,无需关注架构和运维,可以减轻开发商的压力。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
阿里云Serverless Compute
使用钉钉扫一扫加入圈子
+ 订阅

Serverless微服务应用实践分享

官方博客
函数计算官网