jnote.java

JSP方面的实例程序

package com.cargo.send;

/**
 * <p>Title: </p>
 * <p>Description: </p>
 * <p>Copyright: Copyright (c) 2004</p>
 * <p>Company: </p>
 * @author not attributable
 * @version 1.0
 */

public class JNote {
    protected final String IP="129.9.123.8  7000  5000";
    public JNote() {
    }

    static {
        System.loadLibrary("RxSendMessage");
    }

    /*
     函数名称：Initface
     功能：初始化接口，和短讯中心建立连接，应用程序必须首先调用本函数。
     参数说明：
          CodeProtocol 	说明：和短讯中心连接的协议类型
                                          取值	意义
                                          1	内部协议（保留）
                                          2	网关协议（保留）
                                          3	SMEI协议
          DriverProtocol 	说明：和短讯中心连接的网络协议
                                          取值	意义
                                          1	TCP/IP协议
                                          2	COM协议（保留）
                                          3	X25协议（保留）
          DriverParam		说明：网络协议参数。字符串，参数之间以空格隔开。
                                  例如：TCP/IP协议的参数为“IP地址    端口号    超时时间”
                                          （如“129.9.123.8    5016    5000”）
     应用举例：
     Initface(1, 1, "129.9.123.8  7000  5000 ");
     返回值:true表示成功，false表示失败
     */
    public native boolean Initface(int CodeProtocol, int DriverProtocol,
                                   String DriverParam);

    /*
     函数名称：Exitface
     功能：退出接口，应用程序在退出程序时必须调用此函数。
       返回值:true表示成功，false表示失败
     应用举例：
     Exitface();
     */
    public native boolean Exitface();

    /*
     函数名称：LoginNT
     功能：用户向短讯中心注册登录。短讯中心对用户数据进行校验，如果合法，则登记该用户为合法用户，此后用户即可使用其他短讯业务函数。如果此函数调用不成功，则短讯中心不会处理用户其他有关短讯业务的命令。
     参数说明：
      SystemID		最大长度为15个字符
                              意义：在短讯中心注册的接口名。
      Password		最大长度为8个字符
                              意义:接口密码。
     返回值:true表示成功，false表示失败
     应用举例：
      If  (Initface(1, 1, "129.9.123.8  7000  5000"))
                  LoginNT("newid", "password");
     */
    public native boolean LoginNT(String SystemID, String Password);

    /*
     函数名称：Logout
     功能：用户向短讯中心注销接口。
     返回值:true表示成功，false表示失败
     应用举例：
     Logout();
     */
    public native boolean Logout();

    /*
     函数名称：SendMessage
     功能：向指定的地址发送短讯。
     参数说明：
     输入参数：
     OrgTON
                          说明：源地址号码类型
                                  取值		意义
                                  0		未知，当用户或网络不含关于编码方案的较早信息
                                  1		国际号码，
                                  2		国内号码，不能包含地区和退出数字
                                  3		网络特殊号码
                                  4		用户号码
                                  5		字符数字
                                  6		缩写号码
                                  7		保留
     OrgNPI
                          意义：源地址编码方案
                                  取值		意义
                                  0		未知，当TON=5时，NPI=0
         1		ISDN或电话号码编码方案（E164/E163），							对于任意实体SC，MSC或MS，都有效
                                  2		保留
                                  3		数据编码方案（X121）
                                  4		电报编码方案
                                  5-7		保留
                                  8		国内编码方案
                                  9		私有编码方案
                                  10		ERMES编码方案（ETSI DE/PS 3 01-3）
                                  11-15	保留
     OrgAddr
                          意义：源地址
     DestTON
                          意义：目标地址号码类型。取值同OrgTON。
     DestNPI
                          意义：目标地址编码方案。取值同OrgNPI。
     DestAddr
                          意义：目标地址
     PRI
                          意义：SM优先级
                                  取值		意义
                                  1		优先级别
                                  0		缺省级别
     RD
                          意义：保留，设置为0。
     RP
                          意义：回应路径，保留，设置为0。
     SRR
                          意义：状态报告，保留，设置为0。
     MR
                          意义：消息索引，保留，设置为0。
     DCS
                          意义：数据编码方案
                                  取值		意义
                                  0		缺省编码方案(7位)
                                  4		英文编码方案(不被手机支持)
                                  8		UCS2编码方案
                                  其他		保留
     PID
                          意义：协议类型，缺省为0。
     Schedule
                          意义：定时时间
                          注意：时间格式必须为“yyyy/mm/dd hh:mm:ss”。
     Expire		类型：LPCTSTR  长度为19个ASC字符的字符串
                          意义：超时时间
                          注意：时间格式必须为“yyyy/mm/dd hh:mm:ss”。
     Default_ID
                          意义：缺省短消息的信息码
                          注意：国标定义的缺省短消息的个数为100条。
     UDHI
                          意义：用于长短消息，表示UserData是否是结构
                                  取值		意义
                                  0		UD是正常字符串
                                  1		UD是结构
     UDLen
     意义：表示UserData的长度，UDLen要注意的事项如下，如果对于UDHI设置为1的短消息，则此项表示UserData的字符个数（字符个数和字节个数不同，对于7比特编码格式，字符是7比特的，字节是8比特的。其他编码方式则字符的大小和字节的大小相同）
     UserData
     意义：用户信息，短消息正文。对于正常短消息，该字段的最大长度和编码方式有关，对于7比特编码方式（缺省的编码方式）为160个字符的ASC字符串，如果为8比特编码方式则为140个8比特字节流，如果为UCS2编码方式，则为70个字符的16比特字符串。
     此外对于UDHI设置为1的短消息，表示此字段已经经过编码，所以不论是什么编码方式，此字段的最大长度为140字节。
     输出参数：
     SM_ID
                          意义：返回短消息ID
     FCS
                          意义：返回SC端失败原因
     返回值:特定编码
     调用举例:
     char PRI = 0, DCS = 8, RD = 0, RP = 0, SRR = 0, MR = 0, PID = 0;
      long default_id = 0;
              char UDHI = 0;
             String UserData = "短信内容";
      long UDLen =  UserData.length();
             unsigned long SM_ID;
             unsigned char FCS;
     int iRet = SendMessage(2,  1,  "13596070001",  2,  1,  "13596070002",  PRI, RD, RP, SRR, MR, DCS, PID,  "2005/02/24 08:00:00",  "2005/02/24 20:30:00",  default_id,  0,  UDLen,  (LPCTSTR)UserData,  &SM_ID, &FCS);
     if (iRet != 0)
         //短讯发送失败
     */
    public native int SendMessage(char OrgTON, char OrgNPI,
                                  String OrgAddr, char DestTON,
                                  char DestNPI, String DestAddr,
                                  char PRI, char RD,
                                  char RP, char SRR,
                                  char MR, char DCS,
                                  char PID, String Schedule,
                                  String Expire, long Default_ID,
                                  char UDHI, long UDLen,
                                  String UserData, long SM_ID,
                                  String FCS);

    /*
     函数名称：GetMessage
     功能：读取短信。
     参数说明：
     Sm_ID    意义：返回短消息的ID
     DestTON 意义：返回目标地址号码类型
     DestNPI 意义:返回目标地址编码方案
     DestAddr 意义：目标地址
     OrgTON 说明：返回源地址号码类型
     OrgNPI 说明：返回源地址编码方案
     OrgAddr 说明：源地址
     PRI	说明：返回优先级
     RP	说明：返回回应路径
     UDHI	说明：返回头结构指示
     PID	说明：返回协议标志
     DCS	说明：返回编码方案
     TimeStamp  说明：提交时间
     UDLen  意义：返回短消息的UDL
     UserData  说明：正文
     StatusReport  返回：状态报告标志，0表示不是状态报告，1：表示为状态报告
     返回值:特定编码
     应用举例：
     Logout();
     */
    public native int GetMessage(long sm_ID, char DestTON,
                                 char DestNPI, String DestAddr,
                                 char OrgTON, char OrgNPI,
                                 String OrgAddr, char PRI,
                                 char RP, char UDHI,
                                 char PID, char DCS,
                                 String TimeStamp, long UDLen,
                                 String UserData, char StatusReport);

    /*
     函数名：IsHaveMessage
     参数说明
     dwTimeOut 意义：等待时间，单位毫秒。
     功能：
     该函数用于查询有无下发到接口的短消息。在等待时间内如果有消息，则返回0。如果没有，则返回非0。
     */
    public native int IsHaveMessage(int nTime);
}