网建短信通 使用java调用API发送短信时总是返回-41，关键的关键，仅在于一个问号:(

今天突发奇想做一个定时给女朋友发送表白短信的功能，发送短信的接口很多，不过基本都是收费的，情有可原。在网建短信通平台(http://sms.webchinese.cn/default.shtml)可以非常找到各语言的示例代码。我自己没有采用默认版本的jar包，直接在maven里面加载了对应包的最新版本，那么，问题就来了，特别是org.apache.httpcomponents在4.0后应该有了较大的更新，很多方法就不能直接使用，测试了很久返回值都是-41，按照平台API可以知道，显示的是：手机号为空，下面是部分代码：

import java.io.IOException;
import java.util.LinkedList;
import java.util.List;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.apache.http.HttpResponse;
import org.apache.http.HttpStatus;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.config.CookieSpecs;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;

public class SendMessageService {
	// 接口地址
	private Log logger = LogFactory.getLog(this.getClass());
	private HttpClient httpClient = null;
	private HttpPost httpPost = null;
	private long startTime = 0L;
	private long endTime = 0L;
	private int status = 0;
//测试方法
public static void main(String[] args) {
	SendMessageService ac = new SendMessageService("http://utf8.api.smschinese.cn/");
	List<NameValuePair> list = new LinkedList<NameValuePair>();
	//设置用户名
	NameValuePair param1 = new BasicNameValuePair("Uid", "xxx");
	//设置秘钥，这个秘钥不是你用户名密码，要去网站上查看
	NameValuePair param2 = new BasicNameValuePair("Key", "xxx");
	//设置收信人号码
	NameValuePair param3 = new BasicNameValuePair("smsMob", "xxx");
	//设置短信内容，内容中不宜出现空格等特殊符号
	NameValuePair param4 = new BasicNameValuePair("smsText", "xxx");
	list.add(param1);
	list.add(param2);
	list.add(param3);
	list.add(param4);
	System.out.println(ac.post(list));
	System.out.println(ac.getStatus());
	}
	//构造方法
	public SendMessageService(String url) {
		if (url != null) {
			this.apiURL = url;
		}
		if (apiURL != null) {		
			RequestConfig config = RequestConfig.custom().setCookieSpec(CookieSpecs.STANDARD_STRICT).build();
			this.httpClient = HttpClients.custom().setDefaultRequestConfig(config).build();
			this.httpPost = new HttpPost(apiURL);
		}
	}
	//调用接口API
	public String post(List<NameValuePair> list) {
		String body = null;
		if (this.httpPost != null & list != null ) {
			try {
				UrlEncodedFormEntity entityParam = new UrlEncodedFormEntity(list, "UTF-8");
		        httpPost.setEntity(entityParam);
				this.startTime = System.currentTimeMillis();
				HttpResponse response = httpClient.execute(this.httpPost);
				this.endTime = System.currentTimeMillis();
				int statusCode = response.getStatusLine().getStatusCode();
				logger.info("statusCode:" + statusCode);
				logger.info("调用API 花费时间(单位：毫秒)：" + (this.endTime - this.startTime));
				if (statusCode != HttpStatus.SC_OK) {
					logger.error("Method failed:" + response.getStatusLine());
					this.status = 1;
				}
				// Read the response body
				body = EntityUtils.toString(response.getEntity());
			} catch (IOException e) {
				// 网络错误
				this.status = 3;
			} finally {
				logger.info("调用接口状态：" + this.status);
			}
		}
		return body;
	}
	/**
	 * 0.成功 1.执行方法失败 2.协议错误 3.网络错误
	 * @return the status
	 */
	public int getStatus() {
		return this.status;
	}
	public long getStartTime() {
		return this.startTime;
	}
	public long getEndTime() {
		return this.endTime;
	}
}	

既然不能识别请求信息中的电话号码，即请求参数，那么肯定是在配置参数时有问题。所以得查看httpClient源码一探究竟，根据一骨碌的继承关系，最终找到了org.apache.http.client.utils.URLEncodedUtils这个工具类中。

    public static String format(
            final List <? extends NameValuePair> parameters,
            final String charset) {
        return format(parameters, QP_SEP_A, charset);
    }
    public static String format(
            final List <? extends NameValuePair> parameters,
            final char parameterSeparator,
            final String charset) {
        final StringBuilder result = new StringBuilder();
        for (final NameValuePair parameter : parameters) {
            final String encodedName = encodeFormFields(parameter.getName(), charset);
            final String encodedValue = encodeFormFields(parameter.getValue(), charset);
            if (result.length() > 0) {
                result.append(parameterSeparator);
            }
            result.append(encodedName);
            if (encodedValue != null) {
                result.append(NAME_VALUE_SEPARATOR);
                result.append(encodedValue);
            }
        }
        return result.toString();
    }

从第二个format方法可以看到，就是把参数名和参数值取出来，中间连接一个“&”，等等，是不是差点什么，第一个参数与前面URL之间的“？”呢？？果然，在声明URL的时候加上一个问号直接解决问题：http://utf8.api.smschinese.cn/?,这样在后续的拼接过程后，才能正确的读取参数。
另外，更加简单粗暴的方法是直接在声明URL的时候，加上对应的参数信息，就可以一步到位了，但是这样不是特别利于代码的维护及扩展。