001 /*
002 * ===========================================================================================
003 * = COPYRIGHT
004 *          PAX Computer Technology (Shenzhen) Co., Ltd. PROPRIETARY INFORMATION
005 *   This software is supplied under the terms of a license agreement or nondisclosure
006 *   agreement with PAX Computer Technology (Shenzhen) Co., Ltd. and may not be copied or
007 *   disclosed except in accordance with the terms in that agreement.
008 *     Copyright (C) 2017-2023 PAX Computer Technology (Shenzhen) Co., Ltd. All rights reserved.
009 * Description: // Detail description about the function of this module,
010 *             // interfaces with the other modules, and dependencies.
011 * Revision History:
012 * Date                         Author                        Action
013 * 2017/04/01                   PAX                     Create/Add/Modify/Delete
014 * ===========================================================================================
015 */
016 
017package com.pax.dal;
018
019import com.pax.dal.entity.IDReadResult;
020
021public interface IIDReaderEx {
022
023    interface IDReaderExListener {
024        /**
025         * <div class="zh"> 读取内容成功时回调 </div> <div class="en"> the underlying called when read successful </div>
026         * 
027         * @param result
028         *            {@link IDReadResult}
029         */
030        void onSuccess(IDReadResult result);
031
032        /**
033         * <div class="zh"> 读取内容失败时回调 </div> <div class="en"> the underlying called when read failed </div>
034         * 
035         * @param errCode
036         *            <div class="zh">
037         *            <ul>
038         *            <li>1 没有找到阅读器</li>
039         *            <li>2 阅读器忙</li>
040         *            <li>3 网络错误</li>
041         *            <li>4 没有身份证</li>
042         *            <li>5 与后台传输超时,请更换较好的网络环境再试</li>
043         *            <li>6 读取身份证出错,请不要移动身份证</li>
044         *            <li>7 出现错误需要重试</li>
045         *            <li>8 打开身份证错误</li>
046         *            <li>9 无法连接服务器</li>
047         *            <li>10 没有可用的服务器</li>
048         *            <li>11 服务器连接失败</li>
049         *            <li>12 服务器繁处理繁忙</li>
050         *            <li>13 设备未授权</li>
051         *            <li>14 设备序列号不在系统中</li>
052         *            <li>15 未知错误</li>
053         *            </ul>
054         *            </div> <div class="en">
055         *            <ul>
056         *            <li>1 No reader can be found</li>
057         *            <li>2 The reader is busy</li>
058         *            <li>3 network error</li>
059         *            <li>4 No ID card</li>
060         *            <li>5 Time out with the background transmission. Please retry the better network environment and
061         *            try again.</li>
062         *            <li>6 Error reading ID card, please do not move ID card</li>
063         *            <li>7 Mistakes need to be retried</li>
064         *            <li>8 Open the ID card error</li>
065         *            <li>9 Unable to connect to the server</li>
066         *            <li>10 No server available</li>
067         *            <li>11 Server connection failure</li>
068         *            <li>12 Server busy handling complex</li>
069         *            <li>13 Unauthorized equipment</li>
070         *            <li>14 The serial number of the device is not in the system</li>
071         *            <li>15 unknown error</li>
072         *            </ul>
073         *            </div>
074         */
075        void onError(int errCode);
076    }
077
078    /**
079     * <div class="zh"> 打开身份证读取模块服务 </div> <div class="en"> Start the ID card reader service </div>
080     * 
081     * @param exListener
082     *            {@link IDReaderExListener}
083     */
084    void start(IDReaderExListener exListener);
085
086    /**
087     * <div class="zh"> 停止身份证读取模块服务 </div> <div class="en"> Stop the ID card reader service </div>
088     */
089    void stop();
090}