工作之RF功能开发入门

公司现阶段使用的各个系统中有很多都是使用RF扫码枪进行业务操作，因此学会利用现有系统框架开发能在RF扫码枪上使用的业务功能非常有必要。

1 打开Telnet服务

使用Win+R快捷键打开命令窗口，输入以下内容（这里以jac_parts_wms系统中的RF为例，不同的系统输入的网址和端口号是不一样的）。

其中，telnet是协议名 “192.168.10.92”是IP地址，6666是服务端口（配置端口的文件是standardListener.properties）。点击“确定”按钮，进入到telnet登录界面：

输入用户名和密码，按键盘上的“↑”键或者“↓”键切换仓库，
就进入到了模拟RF扫码枪操作的主界面。

主界面上的各种功能就是我们要开发的功能。接着我们来讲解公司现有系统的RF功能的开发步骤：

2 RF功能开发步骤

2.1配置功能菜单

首先要在kangarooMenu.xml中的Menu标签中配置在telnet主界面上显示的功能菜单。
举例说明：

<Item name="signScanPickContainerShell" title="器具签收" location="signScanPickContainerShell" />

上述配置了一个器具签收的功能菜单，配置好之后，就会在telnet主界面上显示如下内容：

配置bean

我们编写的每一个shell文件都是java文件，由于使用了Spring框架对所有的java对象进行管理，因此要配置bean。公司现有系统都是在shellContext.xml中对RF操作的java类进行配置。
这里还是以器具签收为例：

<bean id="wmsPutAsnScanShell" parent="abstractShell" class="com.vtradex.wms.server.telnet.shell.putaway.WmsPutAsnScanShell" singleton="false"><constructor-arg index="0"><ref bean="wmsPutawayRFManager"/></constructor-arg><constructor-arg index="1"><ref bean="wmsReceivingRFManager"/></constructor-arg></bean>

上述代码中还使用构造函数的方式进行了bean的依赖注入操作，这里不再详述，需要依赖注入可以按上述代码的注入方式进行注入即可。

2.3 编写shell

要在对应的项目文件夹下编写一个名为XXXShell类的java文件。按照继承的父类的不同，目前遇到的shell文件有这么三种：

shell父类	作用
YzBaseShell	一般用于用户输入的code或者ID等
JacPageableBaseShell	用于批量展示业务数据，可以选择某条数据
Thorn4BaseShell	展示每一条业务数据，并可以输入数量等字段

2.3.1 XXXshell继承YzBaseShell

这里以jac_parts_wms系统中RF操作的器具签收功能为例：
签收界面：

代码如下：

package com.vtradex.wms.server.telnet.shell.view;import java.io.IOException;
import java.util.Map;import net.wimpi.telnetd.net.Connection;import org.apache.commons.lang.StringUtils;import com.vtradex.kangaroo.shell.BreakException;
import com.vtradex.kangaroo.shell.ContinueException;
import com.vtradex.kangaroo.shell.ShellFactory;
import com.vtradex.wms.server.model.base.BaseStatus;
import com.vtradex.wms.server.telnet.pick.WmsPickRFManager;
import com.vtradex.wms.server.telnet.shell.ShellExceptions;
import com.vtradex.wms.server.telnet.shell.YzBaseShell;
import com.yc.utils.common.MyUtils;
/**器具签收*/
public class SignScanPickContainerShell extends YzBaseShell{public static final String PAGE_ID = "signScanPickContainerShell";public static final String BOX_TAG = "BOX_TAG";public static final String ERROR = "";private final WmsPickRFManager pickRFManager;public SignScanPickContainerShell(WmsPickRFManager pickRFManager) {this.pickRFManager = pickRFManager;}@Overrideprotected void mainProcess(Connection connection) throws BreakException,ContinueException, IOException, Exception {String messge = "成功";String boxTag = (String) this.getParentValue(BOX_TAG);if(boxTag==null){boxTag = this.getTextField("scan.boxTag");if (StringUtils.isEmpty (boxTag) || BaseStatus.NULLVALUE.equals(boxTag)) {this.setStatusMessage(ShellExceptions.ERROR_OVER);}boxTag = boxTag.trim();if(MyUtils.OVER.equals(boxTag)){forward(ShellFactory.getMainShell());}Map<String,String> result = pickRFManager.checkBoxTag(boxTag);if(!result.get(ERROR).isEmpty()){messge = result.get(ERROR);this.forward(SignScanPickContainerShell.PAGE_ID, messge);}else{messge = "选择序号";this.put(BOX_TAG, boxTag);this.forward(ViewScanPickContainerDetailShell.PAGE_ID, messge);}}}}

代码讲解如下图：

对上图补充一点：boxTag = this.getTextField("scan.boxTag");代码中那个的scan.boxTag是自定义的，并且要对其国际化。国际化如下：
新建一个和XXXShell_zh.properties的文件，在该文件中编写需要国际化的字段。

2.3.2 XXXshell继承JacPageableBaseShell

该界面主要用于展示，有点类似于表格的概念。话不多说，直接上图：

代码如下：

package com.vtradex.wms.server.telnet.shell.view;import java.util.HashMap;
import java.util.Map;import com.vtradex.wms.server.telnet.shell.JacPageableBaseShell;public class ViewScanPickContainerDetailShell extends JacPageableBaseShell{public static final String PAGE_ID = "viewScanPickContainerDetailShell";public static final String TASK_ID = "TASK_ID";public static final String ITEM_CODE = "ITEM_CODE";public static final String ITEM_NAME = "ITEM_NAME";public static final String MOVED_QUANTITY = "MOVED_QUANTITY";public static final String PRODUCT_LINE = "PRODUCT_LINE";@Overridepublic String[] getTableHeader() {return new String[]{"序号","物料编码","物料名称","数量","产线"};}@Overridepublic String getHql() {String hql = " SELECT task.id" +",task.moveDocDetail.item.code" +",task.moveDocDetail.item.name" +",task.movedQuantityBU" +",task.moveDocDetail.productionLine" +" FROM WmsTask task" +" WHERE task.signTime is null" +" /~BOXTAG: AND task.boxTag = {BOXTAG}~/";  return hql;}@Overridepublic String getNextShell() {Object[] rowData = (Object[])get(ROW_DATA_KEY);String boxTag = (String) this.getParentValue(SignScanPickContainerShell.BOX_TAG);this.put(TASK_ID, rowData[0]);this.put(ITEM_CODE, rowData[1]);this.put(ITEM_NAME, rowData[2]);this.put(MOVED_QUANTITY, rowData[3]);this.put(PRODUCT_LINE, rowData[4]);this.put(SignScanPickContainerShell.BOX_TAG, boxTag);return SignScanPickContainerDetailShell.PAGE_ID;}@Overridepublic String getUpShell() {return SignScanPickContainerShell.PAGE_ID;}@Overridepublic Map<String, Object> getParams() {Map<String, Object> params = new HashMap<String, Object>();String boxTag = (String) this.getParentValue(SignScanPickContainerShell.BOX_TAG);params.put("BOXTAG", boxTag);return params;}}

代码讲解如下：

2.3.3 XXXshell继承Thorn4BaseShell

代码如下：

package com.vtradex.wms.server.telnet.shell.view;import java.io.IOException;
import java.util.Map;import org.apache.commons.lang.StringUtils;import net.wimpi.telnetd.net.Connection;import com.vtradex.kangaroo.shell.BreakException;
import com.vtradex.kangaroo.shell.ContinueException;
import com.vtradex.kangaroo.shell.Thorn4BaseShell;
import com.vtradex.wms.server.telnet.pick.WmsPickRFManager;
import com.vtradex.wms.server.telnet.shell.ShellExceptions;
import com.yc.utils.common.JavaTools;
import com.yc.utils.common.MyUtils;public class SignScanPickContainerDetailShell extends Thorn4BaseShell{public static final String PAGE_ID = "signScanPickContainerDetailShell";private final WmsPickRFManager pickRFManager;public static final String ERROR = "ERROR";public SignScanPickContainerDetailShell(WmsPickRFManager pickRFManager) {this.pickRFManager = pickRFManager;}@Overrideprotected void mainProcess(Connection connection) throws BreakException,ContinueException, IOException, Exception {String messge = "";Long taskId = (Long)this.getParentValue(ViewScanPickContainerDetailShell.TASK_ID);String boxTag = (String) this.getParentValue(SignScanPickContainerShell.BOX_TAG);String itemCode = (String) this.getParentValue(ViewScanPickContainerDetailShell.ITEM_CODE);String itemName = (String) this.getParentValue(ViewScanPickContainerDetailShell.ITEM_NAME);String productLine = (String) this.getParentValue(ViewScanPickContainerDetailShell.PRODUCT_LINE);double quantity = (Double) this.getParentValue(ViewScanPickContainerDetailShell.MOVED_QUANTITY);output("物料编码",itemCode);output("物料名称",itemName);output("产线",productLine);output("数量",String.valueOf(quantity));String value = this.getTextField("task.signQty");Double signQuantityBU = 0D;if(StringUtils.isEmpty(value)){signQuantityBU = quantity;}else{if(MyUtils.OVER.equals(value)){messge = "选择序号";this.put(SignScanPickContainerShell.BOX_TAG, messge);this.forward(ViewScanPickContainerDetailShell.PAGE_ID,messge);}if(!JavaTools.isNumber(value)){messge = "失败！签收数量不合法！00返回上一级";this.setStatusMessage(messge);}signQuantityBU = JavaTools.stringToDouble(value);if(signQuantityBU<0 || signQuantityBU>quantity){messge = "失败！签收数量不合法！00返回上一级";this.setStatusMessage(messge);}}try {Map<String,String> results = pickRFManager.signScanPickContainerDetail(taskId,signQuantityBU);if(!StringUtils.isEmpty(results.get(ERROR))){messge = results.get(ERROR);this.put(SignScanPickContainerShell.BOX_TAG, messge);this.forward(ViewScanPickContainerDetailShell.PAGE_ID,messge);}} catch (Exception e) {e.printStackTrace();this.reset(e.getMessage());}//验证器具单明细是否全部签收 Map<String,String> results = pickRFManager.checkBoxTag(boxTag);if(!StringUtils.isEmpty(results.get(ERROR))){messge = "签收完成，继续扫码";this.forward(SignScanPickContainerShell.PAGE_ID,messge);}messge = "选择序号";this.put(SignScanPickContainerShell.BOX_TAG, boxTag);this.forward(ViewScanPickContainerDetailShell.PAGE_ID,messge);}}

代码讲解如下：

RF功能开发的大致流程就是以上这些，关于RF开发的内容还有很多没有讲到，可自行查看源码分析学习。如有不正确的地方，请各位批评指正，不胜感激！！！