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.PukInfo;
020import com.pax.dal.exceptions.PukDevException;
021
022public interface IPuk {
023
024    /**
025     * <div class="zh"> 读 PUK </div> <div class="en"> read PUK </div>
026     * 
027     * @param pukId
028     *            <div class="zh"> 有效值:
029     *            <ul>
030     *            <li>ID_US_PUK: 1</li>
031     *            <li>ID_UA_PUK: 2</li>
032     *            </ul>
033     *            </div> <div class="en"> only support two values below:
034     *            <ul>
035     *            <li>ID_US_PUK: 1</li>
036     *            <li>ID_UA_PUK: 2</li>
037     *            </ul>
038     *            </div>
039     * @return
040     * @throws PukDevException
041     */
042    PukInfo readPuk(byte pukId) throws PukDevException;
043
044    /**
045     * <div class="zh"> 写 PUK </div> <div class="en"> write PUK </div>
046     * 
047     * @param pukId
048     *            <div class="zh"> 有效值
049     *            <ul>
050     *            <li>ID_US_PUK: 1</li>
051     *            <li>ID_UA_PUK: 2</li>
052     *            </ul>
053     *            </div> <div class="en"> only support two values below:
054     *            <ul>
055     *            <li>ID_US_PUK: 1</li>
056     *            <li>ID_UA_PUK: 2</li>
057     *            </ul>
058     *            </div>
059     * 
060     * @param data
061     *            <div class="zh"> puk 数据 </div> <div class="en"> puk data </div>
062     * 
063     * @throws PukDevException
064     */
065    void writePuk(byte pukId, byte[] data) throws PukDevException;
066}