打印顺丰电子面单SDK调用总结-java

一、获得顺丰电子面单SDK

    https://qiao.sf-express.com/index.html 丰桥系统中，文档中心->SDK使用说明->运单自助打印SDK

    顺丰电子面单SDK-1.0.3

    支持的开发环境： Java sdk 支持1.8及以上

二、启动SDK本地服务：

    1.windows环境：

       ①将csim_waybill_print_service_V1.0.3.jar和RUN-SF-PRINTER.bat置于同一目录下，双击RUN-SF-PRINTER.bat文件即可开启本地运单打印服务。（这种情况也有可能开启不成功，建议使用下面命令的方式）

        ②java -jar path [port]

例：（不填写端口，则默认为4040）

    

    2.linux环境：

        ①linux下安装jdk1.8，执行命令：yum -y install java

        ②创建文件夹sf-service将csim_waybill_print_service_V1.0.3.jar放在文件夹顺丰电子面单SDK-1.0.3中

        ③执行命令：chmod 777 csim_waybill_print_service_V1.0.3.jar 进行授权

        ④linux下进入sf-service文件，执行命令：nohup java -jar csim_waybill_print_service_V1.0.3.jar &

（注：nohup <程序名> &：命令在Unix/Linux中，普通进程用“&”符号放到后台运行，则控制台logout后，进程仍然继续运行，起到守护进程的作用，使用nohup命令后，原程序的的标准输出被自动改向到当前目录下的nohup.out文件，起到了log的作用）。

    3.验证服务器运行情况：

    浏览器：http://localhost:4040/servertest.html（4040为启动端口），显示“OK!”则表示启动成功

    4.Linux系统下需安装黑体字体！！！

        ①查看安装了哪些中文字体，命令：fc-list :lang=zh（如果命令不存在，则yum安装fontconfig，命令：fontconfig）

        ②cd /usr/share/fonts（没有目录则创建，命令：mkdir /usr/share/fonts）

        ③将顺丰sdk里带的黑体字体放到该文件夹下

        ④chmod 755 *.ttf（linux命令chmod 755的含义）

        ⑤建立字体缓存

                mkfontscal （如果命令不存在，则yum安装mkfontscale，命令：yum install mkfontscale）

                mkfontdir  （如果命令不存在，则yum安装mkfontscale，命令：yum install mkfontdir）

                fc-cache -fv

        ⑥让字体生效

                source /etc/profile  

                fc-match  （查看设置是否生效）

三、项目中引用顺丰jar包

    方法一：将sf-csim-printer-api-1.0.3.jar包放在项目lib目录下，并add as library（使用maven的不建议这样做）

    方法二：将sf-csim-printer-api-1.0.3.jar包放到maven私服上，并在项目中引用依赖