HttpServletRequest介绍

HttpServletRequest对象表明客户端的请求,当客户端经过HTTP协议访问服务器时,HTTP请求头中的全部信息都封装在这个对象中,经过这个对象提供的方法,能够得到客户端请求的全部信息。html

2、Request经常使用方法

2.一、得到客户机信息

  getRequestURL方法返回客户端发出请求时的完整URL。
  getRequestURI方法返回请求行中的资源名部分。
  getQueryString 方法返回请求行中的参数部分。
  getPathInfo方法返回请求URL中的额外路径信息。额外路径信息是请求URL中的位于Servlet的路径以后和查询参数以前的内容,它以“/”开头。
  getRemoteAddr方法返回发出请求的客户机的IP地址。
  getRemoteHost方法返回发出请求的客户机的完整主机名。
  getRemotePort方法返回客户机所使用的网络端口号。
  getLocalAddr方法返回WEB服务器的IP地址。
  getLocalName方法返回WEB服务器的主机名。
java

范例:经过request对象获取客户端请求信息web

复制代码
 1 package gacl.request.study;  2 import java.io.IOException;  3 import java.io.PrintWriter;  4 import javax.servlet.ServletException;  5 import javax.servlet.http.HttpServlet;  6 import javax.servlet.http.HttpServletRequest;  7 import javax.servlet.http.HttpServletResponse;  8 /**  9  * @author gacl 10  * 经过request对象获取客户端请求信息 11 */ 12 public class RequestDemo01 extends HttpServlet { 13 14 public void doGet(HttpServletRequest request, HttpServletResponse response) 15 throws ServletException, IOException { 16 /** 17  * 1.得到客户机信息 18 */ 19 String requestUrl = request.getRequestURL().toString();//获得请求的URL地址 20 String requestUri = request.getRequestURI();//获得请求的资源 21 String queryString = request.getQueryString();//获得请求的URL地址中附带的参数 22 String remoteAddr = request.getRemoteAddr();//获得来访者的IP地址 23 String remoteHost = request.getRemoteHost(); 24 int remotePort = request.getRemotePort(); 25 String remoteUser = request.getRemoteUser(); 26 String method = request.getMethod();//获得请求URL地址时使用的方法 27 String pathInfo = request.getPathInfo(); 28 String localAddr = request.getLocalAddr();//获取WEB服务器的IP地址 29 String localName = request.getLocalName();//获取WEB服务器的主机名 30 response.setCharacterEncoding("UTF-8");//设置将字符以"UTF-8"编码输出到客户端浏览器 31 //经过设置响应头控制浏览器以UTF-8的编码显示数据,若是不加这句话,那么浏览器显示的将是乱码 32 response.setHeader("content-type", "text/html;charset=UTF-8"); 33 PrintWriter out = response.getWriter(); 34 out.write("获取到的客户机信息以下:"); 35 out.write("<hr/>"); 36 out.write("请求的URL地址:"+requestUrl); 37 out.write("<br/>"); 38 out.write("请求的资源:"+requestUri); 39 out.write("<br/>"); 40 out.write("请求的URL地址中附带的参数:"+queryString); 41 out.write("<br/>"); 42 out.write("来访者的IP地址:"+remoteAddr); 43 out.write("<br/>"); 44 out.write("来访者的主机名:"+remoteHost); 45 out.write("<br/>"); 46 out.write("使用的端口号:"+remotePort); 47 out.write("<br/>"); 48 out.write("remoteUser:"+remoteUser); 49 out.write("<br/>"); 50 out.write("请求使用的方法:"+method); 51 out.write("<br/>"); 52 out.write("pathInfo:"+pathInfo); 53 out.write("<br/>"); 54 out.write("localAddr:"+localAddr); 55 out.write("<br/>"); 56 out.write("localName:"+localName); 57  } 58 59 public void doPost(HttpServletRequest request, HttpServletResponse response) 60 throws ServletException, IOException { 61  doGet(request, response); 62  } 63 64 }
复制代码

运行结果:编程

  

2.二、得到客户机请求头

  getHeader(string name)方法:String
  getHeaders(String name)方法:Enumeration
  getHeaderNames()方法 设计模式

范例:经过request对象获取客户端请求头信息数组

复制代码
 1 package gacl.request.study;  2 import java.io.IOException;  3 import java.io.PrintWriter;  4 import java.util.Enumeration;  5 import javax.servlet.ServletException;  6 import javax.servlet.http.HttpServlet;  7 import javax.servlet.http.HttpServletRequest;  8 import javax.servlet.http.HttpServletResponse;  9 /** 10  * @author gacl 11  * 获取客户端请求头信息 12  * 客户端请求头: 13  * 14 */ 15 public class RequestDemo02 extends HttpServlet { 16 17 public void doGet(HttpServletRequest request, HttpServletResponse response) 18 throws ServletException, IOException { 19 response.setCharacterEncoding("UTF-8");//设置将字符以"UTF-8"编码输出到客户端浏览器 20 //经过设置响应头控制浏览器以UTF-8的编码显示数据 21 response.setHeader("content-type", "text/html;charset=UTF-8"); 22 PrintWriter out = response.getWriter(); 23 Enumeration<String> reqHeadInfos = request.getHeaderNames();//获取全部的请求头 24 out.write("获取到的客户端全部的请求头信息以下:"); 25 out.write("<hr/>"); 26 while (reqHeadInfos.hasMoreElements()) { 27 String headName = (String) reqHeadInfos.nextElement(); 28 String headValue = request.getHeader(headName);//根据请求头的名字获取对应的请求头的值 29 out.write(headName+":"+headValue); 30 out.write("<br/>"); 31  } 32 out.write("<br/>"); 33 out.write("获取到的客户端Accept-Encoding请求头的值:"); 34 out.write("<hr/>"); 35 String value = request.getHeader("Accept-Encoding");//获取Accept-Encoding请求头对应的值 36  out.write(value); 37 38 Enumeration<String> e = request.getHeaders("Accept-Encoding"); 39 while (e.hasMoreElements()) { 40 String string = (String) e.nextElement(); 41  System.out.println(string); 42  } 43  } 44 45 public void doPost(HttpServletRequest request, HttpServletResponse response) 46 throws ServletException, IOException { 47  doGet(request, response); 48  } 49 50 }
复制代码

运行结果以下:浏览器

  

2.三、得到客户机请求参数(客户端提交的数据)

  • getParameter(String)方法(经常使用)
  • getParameterValues(String name)方法(经常使用)
  • getParameterNames()方法(不经常使用)
  • getParameterMap()方法(编写框架时经常使用)

好比如今有以下的form表单服务器

复制代码
 1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  2 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  3 <html>  4 <head>  5 <title>Html的Form表单元素</title>  6 </head>  7 <fieldset style="width:500px;">  8 <legend>Html的Form表单元素</legend>  9 <!--form表单的action属性规定当提交表单时,向何处发送表单数据,method属性指明表单的提交方式,分为get和post,默认为get--> 10 <form action="${pageContext.request.contextPath}/servlet/RequestDemo03" method="post"> 11 <!--输入文本框,SIZE表示显示长度,maxlength表示最多输入长度--> 12 编&nbsp;&nbsp;号(文本框): 13 <input type="text" name="userid" value="NO." size="2" maxlength="2"><br> 14 <!--输入文本框,经过value指定其显示的默认值--> 15 用户名(文本框):<input type="text" name="username" value="请输入用户名"><br> 16 <!--密码框,其中全部输入的内容都以密文的形式显示--> 17 密&nbsp;&nbsp;码(密码框): 18 <!--&nbsp;表示的是一个空格--> 19 <input type="password" name="userpass" value="请输入密码"><br> 20 <!--单选按钮,经过checked指定默认选中,名称必须同样,其中value为真正须要的内容--> 21 性&nbsp;&nbsp;别(单选框): 22 <input type="radio" name="sex" value="男" checked>23 <input type="radio" name="sex" value="女">女<br> 24 <!--下拉列表框,经过<option>元素指定下拉的选项--> 25 部&nbsp;&nbsp;门(下拉框): 26 <select name="dept"> 27 <option value="技术部">技术部</option> 28 <option value="销售部" SELECTED>销售部</option> 29 <option value="财务部">财务部</option> 30 </select><br> 31 <!--复选框,能够同时选择多个选项,名称必须同样,其中value为真正须要的内容--> 32 兴&nbsp;&nbsp;趣(复选框): 33 <input type="checkbox" name="inst" value="唱歌">唱歌 34 <input type="checkbox" name="inst" value="游泳">游泳 35 <input type="checkbox" name="inst" value="跳舞">跳舞 36 <input type="checkbox" name="inst" value="编程" checked>编程 37 <input type="checkbox" name="inst" value="上网">上网 38 <br> 39 <!--大文本输入框,宽度为34列,高度为5行--> 40 说&nbsp;&nbsp;明(文本域): 41 <textarea name="note" cols="34" rows="5"> 42 </textarea> 43 <br> 44 <!--隐藏域,在页面上没法看到,专门用来传递参数或者保存参数--> 45 <input type="hidden" name="hiddenField" value="hiddenvalue"/> 46 <!--提交表单按钮,当点击提交后,全部填写的表单内容都会被传输到服务器端--> 47 <input type="submit" value="提交(提交按钮)"> 48 <!--重置表单按钮,当点击重置后,全部表单恢复原始显示内容--> 49 <input type="reset" value="重置(重置按钮)"> 50 </form> 51 <!--表单结束--> 52 </fieldset> 53 </body> 54 <!--完结标记--> 55 </html> 56 <!--完结标记-->
复制代码

  在Form表单中填写数据,而后提交到RequestDemo03这个Servlet进行处理,填写的表单数据以下:网络

  

在服务器端使用getParameter方法和getParameterValues方法接收表单参数,代码以下:框架

复制代码
 1 package gacl.request.study;  2 import java.io.IOException;  3 import java.text.MessageFormat;  4 import javax.servlet.ServletException;  5 import javax.servlet.http.HttpServlet;  6 import javax.servlet.http.HttpServletRequest;  7 import javax.servlet.http.HttpServletResponse;  8 /**  9  * @author gacl 10  * 获取客户端经过Form表单提交上来的参数 11 */ 12 public class RequestDemo03 extends HttpServlet { 13 14 public void doGet(HttpServletRequest request, HttpServletResponse response) 15 throws ServletException, IOException { 16 //客户端是以UTF-8编码提交表单数据的,因此须要设置服务器端以UTF-8的编码进行接收,不然对于中文数据就会产生乱码 17 request.setCharacterEncoding("UTF-8"); 18 /** 19  * 编&nbsp;&nbsp;号(文本框): 20  <input type="text" name="userid" value="NO." size="2" maxlength="2"> 21 */ 22 String userid = request.getParameter("userid");//获取填写的编号,userid是文本框的名字,<input type="text" name="userid"> 23 /** 24  * 用户名(文本框):<input type="text" name="username" value="请输入用户名"> 25 */ 26 String username = request.getParameter("username");//获取填写的用户名 27 /** 28  * 密&nbsp;&nbsp;码(密码框):<input type="password" name="userpass" value="请输入密码"> 29 */ 30 String userpass = request.getParameter("userpass");//获取填写的密码 31 String sex = request.getParameter("sex");//获取选中的性别 32 String dept = request.getParameter("dept");//获取选中的部门 33 //获取选中的兴趣,由于能够选中多个值,因此获取到的值是一个字符串数组,所以须要使用getParameterValues方法来获取 34 String[] insts = request.getParameterValues("inst"); 35 String note = request.getParameter("note");//获取填写的说明信息 36 String hiddenField = request.getParameter("hiddenField");//获取隐藏域的内容 37 38 String instStr=""; 39 /** 40  * 获取数组数据的技巧,能够避免insts数组为null时引起的空指针异常错误! 41 */ 42 for (int i = 0; insts!=null && i < insts.length; i++) { 43 if (i == insts.length-1) { 44 instStr+=insts[i]; 45 }else { 46 instStr+=insts[i]+","; 47  } 48  } 49 50 String htmlStr = "<table>" + 51 "<tr><td>填写的编号:</td><td>{0}</td></tr>" + 52 "<tr><td>填写的用户名:</td><td>{1}</td></tr>" + 53 "<tr><td>填写的密码:</td><td>{2}</td></tr>" + 54 "<tr><td>选中的性别:</td><td>{3}</td></tr>" + 55 "<tr><td>选中的部门:</td><td>{4}</td></tr>" + 56 "<tr><td>选中的兴趣:</td><td>{5}</td></tr>" + 57 "<tr><td>填写的说明:</td><td>{6}</td></tr>" + 58 "<tr><td>隐藏域的内容:</td><td>{7}</td></tr>" + 59 "</table>"; 60 htmlStr = MessageFormat.format(htmlStr, userid,username,userpass,sex,dept,instStr,note,hiddenField); 61 62 response.setCharacterEncoding("UTF-8");//设置服务器端以UTF-8编码输出数据到客户端 63 response.setContentType("text/html;charset=UTF-8");//设置客户端浏览器以UTF-8编码解析数据 64 response.getWriter().write(htmlStr);//输出htmlStr里面的内容到客户端浏览器显示 65  } 66 67 public void doPost(HttpServletRequest request, HttpServletResponse response) 68 throws ServletException, IOException { 69  doGet(request, response); 70  } 71 }
复制代码

运行结果以下:

  

在服务器端使用getParameterNames方法接收表单参数,代码以下:

复制代码
1 Enumeration<String> paramNames = request.getParameterNames();//获取全部的参数名 2 while (paramNames.hasMoreElements()) { 3 String name = paramNames.nextElement();//获得参数名 4 String value = request.getParameter(name);//经过参数名获取对应的值 5 System.out.println(MessageFormat.format("{0}={1}", name,value)); 6 }
复制代码

运行结果以下:

  

在服务器端使用getParameterMap方法接收表单参数,代码以下:

复制代码
 1 //request对象封装的参数是以Map的形式存储的  2 Map<String, String[]> paramMap = request.getParameterMap();  3 for(Map.Entry<String, String[]> entry :paramMap.entrySet()){  4 String paramName = entry.getKey();  5 String paramValue = "";  6 String[] paramValueArr = entry.getValue();  7 for (int i = 0; paramValueArr!=null && i < paramValueArr.length; i++) {  8 if (i == paramValueArr.length-1) {  9 paramValue+=paramValueArr[i]; 10 }else { 11 paramValue+=paramValueArr[i]+","; 12  } 13  } 14 System.out.println(MessageFormat.format("{0}={1}", paramName,paramValue)); 15 }
复制代码

运行结果以下:

  

3、request接收表单提交中文参数乱码问题

3.一、以POST方式提交表单中文参数的乱码问题

例若有以下的form表单页面:

复制代码
 1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  2  3 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  4 <html>  5 <head>  6 <title>request接收中文参数乱码问题</title>  7 </head>  8  9 <body> 10 <form action="<%=request.getContextPath()%>/servlet/RequestDemo04" method="post"> 11 用户名:<input type="text" name="userName"/> 12 <input type="submit" value="post方式提交表单"> 13 </form> 14 </body> 15 </html>
复制代码

  

  此时在服务器端接收中文参数时就会出现中文乱码,以下所示:

  

3.二、post方式提交中文数据乱码产生的缘由和解决办法

  

  能够看到,之因此会产生乱码,就是由于服务器和客户端沟通的编码不一致形成的,所以解决的办法是:在客户端和服务器之间设置一个统一的编码,以后就按照此编码进行数据的传输和接收。

  因为客户端是以UTF-8字符编码将表单数据传输到服务器端的,所以服务器也须要设置以UTF-8字符编码进行接收,要想完成此操做,服务器能够直接使用从ServletRequest接口继承而来的"setCharacterEncoding(charset)"方法进行统一的编码设置。修改后的代码以下:

复制代码
1 public void doPost(HttpServletRequest request, HttpServletResponse response) 2 throws ServletException, IOException { 3 /** 4  * 客户端是以UTF-8编码传输数据到服务器端的,因此须要设置服务器端以UTF-8的编码进行接收,不然对于中文数据就会产生乱码 5 */ 6 request.setCharacterEncoding("UTF-8"); 7 String userName = request.getParameter("userName"); 8 System.out.println("userName:"+userName); 9 }
复制代码

  使用request.setCharacterEncoding("UTF-8");设置服务器以UTF-8的编码接收数据后,此时就不会产生中文乱码问题了,以下所示:

  

3.三、以GET方式提交表单中文参数的乱码问题

例若有以下的form表单页面:

复制代码
 1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  2  3 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  4 <html>  5 <head>  6 <title>request接收中文参数乱码问题</title>  7 </head>  8  9 <body> 10 <form action="${pageContext.request.contextPath}/servlet/RequestDemo04" method="get"> 11 姓名:<input type="text" name="name"/> 12 <input type="submit" value="get方式提交表单"> 13 </form> 14 </body> 15 </html>
复制代码

  

  此时在服务器端接收中文参数时就会出现中文乱码,以下所示:

  

  那么这个中文乱码问题又该如何解决呢,是否能够经过request.setCharacterEncoding("UTF-8");设置服务器 以UTF-8的编码进行接收这种方式来解决中文乱码问题呢,注意,对于以get方式传输的中文数据,经过 request.setCharacterEncoding("UTF-8");这种方式是解决不了中文乱码问题,以下所示:

  

3.四、get方式提交中文数据乱码产生的缘由和解决办法

  对于以get方式传输的数据,request即便设置了以指定的编码接收数据也是无效的(至于为何无效我也没有弄明白),默认的仍是使用 ISO8859-1这个字符编码来接收数据,客户端以UTF-8的编码传输数据到服务器端,而服务器端的request对象使用的是ISO8859-1这 个字符编码来接收数据,服务器和客户端沟通的编码不一致所以才会产生中文乱码的。解决办法:在接收到数据后,先获取request对象以ISO8859-1字符编码接收到的原始数据的字节数组,而后经过字节数组以指定的编码构建字符串,解决乱码问题。代码以下:

复制代码
 1 public void doGet(HttpServletRequest request, HttpServletResponse response)  2 throws ServletException, IOException {  3 /**  4  *  5  * 对于以get方式传输的数据,request即便设置了以指定的编码接收数据也是无效的,默认的仍是使用ISO8859-1这个字符编码来接收数据  6 */  7 String name = request.getParameter("name");//接收数据  8 name =new String(name.getBytes("ISO8859-1"), "UTF-8") ;//获取request对象以ISO8859-1字符编码接收到的原始数据的字节数组,而后经过字节数组以指定的编码构建字符串,解决乱码问题  9 System.out.println("name:"+name); 10 }
复制代码

运行结果以下:

3.五、以超连接形式传递中文参数的乱码问题

  客户端想传输数据到服务器,能够经过表单提交的形式,也能够经过超连接后面加参数的形式,例如:

1 <a href="${pageContext.request.contextPath}/servlet/RequestDemo05?userName=gacl&name=徐达沛">点击</a>

  点击超连接,数据是以get的方式传输到服务器的,因此接收中文数据时也会产生中文乱码问题,而解决中文乱码问题的方式与上述的以get方式提交表单中文数据乱码处理问题的方式一致,以下所示:

1 String name = request.getParameter("name"); 2 name =new String(name.getBytes("ISO8859-1"), "UTF-8");

  另外,须要提的一点就是URL地址后面若是跟了中文数据,那么中文参数最好使用URL编码进行处理,以下所示:

1 <a href="${pageContext.request.contextPath}/servlet/RequestDemo05?userName=gacl&name=<%=URLEncoder.encode("徐达沛", "UTF-8")%>">点击</a>

3.六、提交中文数据乱码问题总结

  一、若是提交方式为post,想不乱码,只须要在服务器端设置request对象的编码便可,客户端以哪一种编码提交的,服务器端的request对象就以对应的编码接收,好比客户端是以UTF-8编码提交的,那么服务器端request对象就以UTF-8编码接收(request.setCharacterEncoding("UTF-8"))

  二、若是提交方式为get,设置request对象的编码是无效的,request对象仍是以默认的ISO8859-1编码接收数据,所以要想不乱码,只能在接收到数据后再手工转换,步骤以下:

  1).获取获取客户端提交上来的数据,获得的是乱码字符串,data="???è?????"

   String data = request.getParameter("paramName"); 

  2).查找ISO8859-1码表,获得客户机提交的原始数据的字节数组

   byte[] source = data.getBytes("ISO8859-1"); 

  3).经过字节数组以指定的编码构建字符串,解决乱码

   data = new String(source, "UTF-8"); 

  经过字节数组以指定的编码构建字符串,这里指定的编码是根据客户端那边提交数据时使用的字符编码来定的,若是是GB2312,那么就设置成data = new String(source, "GB2312"),若是是UTF-8,那么就设置成data = new String(source, "UTF-8")

4、Request对象实现请求转发

4.一、请求转发的基本概念

  请求转发:指一个web资源收到客户端请求后,通知服务器去调用另一个web资源进行处理。
  请求转发的应用场景:MVC设计模式

  在Servlet中实现请求转发的两种方式:

  一、经过ServletContext的getRequestDispatcher(String path)方法,该方法返回一个RequestDispatcher对象,调用这个对象的forward方法能够实现请求转发。

例如:将请求转发的test.jsp页面

1 RequestDispatcher reqDispatcher =this.getServletContext().getRequestDispatcher("/test.jsp"); 2 reqDispatcher.forward(request, response);

  二、经过request对象提供的getRequestDispatche(String path)方法,该方法返回一个RequestDispatcher对象,调用这个对象的forward方法能够实现请求转发。

例如:将请求转发的test.jsp页面

1 request.getRequestDispatcher("/test.jsp").forward(request, response);

  request对象同时也是一个域对象(Map容器),开发人员经过request对象在实现转发时,把数据经过request对象带给其它web资源处理。

例如:请求RequestDemo06 Servlet,RequestDemo06将请求转发到test.jsp页面

复制代码
 1 package gacl.request.study;  2  3 import java.io.IOException;  4 import javax.servlet.ServletException;  5 import javax.servlet.http.HttpServlet;  6 import javax.servlet.http.HttpServletRequest;  7 import javax.servlet.http.HttpServletResponse;  8  9 public class RequestDemo06 extends HttpServlet { 10 11 public void doGet(HttpServletRequest request, HttpServletResponse response) 12 throws ServletException, IOException { 13 14 String data="你们好,我是孤傲苍狼,我正在总结JavaWeb"; 15 /** 16  * 将数据存放到request对象中,此时把request对象看成一个Map容器来使用 17 */ 18 request.setAttribute("data", data); 19 //客户端访问RequestDemo06这个Servlet后,RequestDemo06通知服务器将请求转发(forward)到test.jsp页面进行处理 20 request.getRequestDispatcher("/test.jsp").forward(request, response); 21  } 22 23 public void doPost(HttpServletRequest request, HttpServletResponse response) 24 throws ServletException, IOException { 25  doGet(request, response); 26  } 27 }
复制代码

test.jsp页面代码以下:

复制代码
 1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  2  3 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  4 <html>  5 <head>  6 <title>Request对象实现请求转发</title>  7 </head>  8  9 <body> 10  使用普通方式取出存储在request对象中的数据: 11 <h3 style="color:red;"><%=(String)request.getAttribute("data")%></h3> 12  使用EL表达式取出存储在request对象中的数据: 13 <h3 style="color:red;">${data}</h3> 14 </body> 15 </html>
复制代码

运行结果以下:

  

  request对象做为一个域对象(Map容器)使用时,主要是经过如下的四个方法来操做

  • setAttribute(String name,Object o)方法,将数据做为request对象的一个属性存放到request对象中,例如:request.setAttribute("data", data);
  • getAttribute(String name)方法,获取request对象的name属性的属性值,例如:request.getAttribute("data")
  • removeAttribute(String name)方法,移除request对象的name属性,例如:request.removeAttribute("data")
  • getAttributeNames方法,获取request对象的全部属性名,返回的是一个,例如:Enumeration<String> attrNames = request.getAttributeNames();

4.二、请求重定向和请求转发的区别

  一个web资源收到客户端请求后,通知服务器去调用另一个web资源进行处理,称之为请求转发/307。
  一个web资源收到客户端请求后,通知浏览器去访问另一个web资源进行处理,称之为请求重定向/302。

相关文章
相关标签/搜索