TT_单点登录系统SSO最小实现的接口文档及Cookie工具类

1.1. 注册接口

1.1.1. 检查数据是否可用

请求方法	GET
URL	http://sso.taotao.com/user/check/{param}/{type}
参数说明	格式如：zhangsan/ 1，其中zhangsan是校验的数据，type为类型，可选参数1、2、3分别代表username、phone、email   可选参数callback：如果有此参数表示此方法为jsonp请求，需要支持jsonp。
示例	http://sso.taotao.com/user/check/zhangsan/1
返回值	{ status: 200//200 成功 msg: "OK" //返回信息消息 data: false// 返回数据，true：数据可用，false：数据不可用 }

1.1.2. 用户注册

请求方法	POST
URL	http://sso.taotao.com/user/register
参数	username //用户名 password //密码 phone //手机号 email //邮箱
参数说明
示例	http://sso.taotao.com/user/register
返回值	{ status: 400 msg: "注册失败.请校验数据后请再提交数据." data: null }

1.2. 用户登录

请求方法	POST
URL	http://sso.taotao.com/user/login
参数	username //用户名 password //密码
参数说明
示例	http://sso.taotao.com/user/login username=zhangsan&password=123
返回值	{ status: 200 msg: "OK" data: "fe5cb546aeb3ce1bf37abcb08a40493e" //登录成功，返回token }

1.3. 通过token查询用户信息

请求方法	GET
URL	http://sso.taotao.com/user/token/{token}
参数	token //用户登录凭证 callback//jsonp回调方法
参数说明	可选参数callback：如果有此参数表示此方法为jsonp请求，需要支持jsonp。
示例	http://sso.taotao.com/user/token/fe5cb546aeb3ce1bf37abcb08a40493e
返回值	{ status: 200 msg: "OK" data: "{"id":1,"username":"zhangzhijun","phone":"15800807944", "email":"420840806@qq.com","created":1414119176000,"updated":1414119179000}" }

 

1.4. 安全退出

请求方法	GET
URL	http://sso.taotao.com/user/logout/{token}
参数	token //用户登录凭证 callback//jsonp回调方法
参数说明	可选参数callback：如果有此参数表示此方法为jsonp请求，需要支持jsonp。
示例	http://sso.taotao.com/user/logout/fe5cb546aeb3ce1bf37abcb08a40493e
返回值	{ status: 200 msg: "OK" data: "" }

Cookie工具类

[java]  view plain  copy

1. import java.io.UnsupportedEncodingException;  
2. import java.net.URLDecoder;  
3. import java.net.URLEncoder;  
4.   
5. import javax.servlet.http.Cookie;  
6. import javax.servlet.http.HttpServletRequest;  
7. import javax.servlet.http.HttpServletResponse;  
8.   
9.   
10. /** 
11.  *  
12.  * Cookie 工具类 
13.  * 
14.  */  
15. public final class CookieUtils {  
16.   
17.     /** 
18.      * 得到Cookie的值, 不编码 
19.      *  
20.      * @param request 
21.      * @param cookieName 
22.      * @return 
23.      */  
24.     public static String getCookieValue(HttpServletRequest request, String cookieName) {  
25.         return getCookieValue(request, cookieName, false);  
26.     }  
27.   
28.     /** 
29.      * 得到Cookie的值, 
30.      *  
31.      * @param request 
32.      * @param cookieName 
33.      * @return 
34.      */  
35.     public static String getCookieValue(HttpServletRequest request, String cookieName, boolean isDecoder) {  
36.         Cookie[] cookieList = request.getCookies();  
37.         if (cookieList == null || cookieName == null) {  
38.             return null;  
39.         }  
40.         String retValue = null;  
41.         try {  
42.             for (int i = 0; i < cookieList.length; i++) {  
43.                 if (cookieList[i].getName().equals(cookieName)) {  
44.                     if (isDecoder) {  
45.                         retValue = URLDecoder.decode(cookieList[i].getValue(), "UTF-8");  
46.                     } else {  
47.                         retValue = cookieList[i].getValue();  
48.                     }  
49.                     break;  
50.                 }  
51.             }  
52.         } catch (UnsupportedEncodingException e) {  
53.             e.printStackTrace();  
54.         }  
55.         return retValue;  
56.     }  
57.   
58.     /** 
59.      * 得到Cookie的值, 
60.      *  
61.      * @param request 
62.      * @param cookieName 
63.      * @return 
64.      */  
65.     public static String getCookieValue(HttpServletRequest request, String cookieName, String encodeString) {  
66.         Cookie[] cookieList = request.getCookies();  
67.         if (cookieList == null || cookieName == null) {  
68.             return null;  
69.         }  
70.         String retValue = null;  
71.         try {  
72.             for (int i = 0; i < cookieList.length; i++) {  
73.                 if (cookieList[i].getName().equals(cookieName)) {  
74.                     retValue = URLDecoder.decode(cookieList[i].getValue(), encodeString);  
75.                     break;  
76.                 }  
77.             }  
78.         } catch (UnsupportedEncodingException e) {  
79.              e.printStackTrace();  
80.         }  
81.         return retValue;  
82.     }  
83.   
84.     /** 
85.      * 设置Cookie的值 不设置生效时间默认浏览器关闭即失效,也不编码 
86.      */  
87.     public static void setCookie(HttpServletRequest request, HttpServletResponse response, String cookieName,  
88.             String cookieValue) {  
89.         setCookie(request, response, cookieName, cookieValue, -1);  
90.     }  
91.   
92.     /** 
93.      * 设置Cookie的值 在指定时间内生效,但不编码 
94.      */  
95.     public static void setCookie(HttpServletRequest request, HttpServletResponse response, String cookieName,  
96.             String cookieValue, int cookieMaxage) {  
97.         setCookie(request, response, cookieName, cookieValue, cookieMaxage, false);  
98.     }  
99.   
100.     /** 
101.      * 设置Cookie的值 不设置生效时间,但编码 
102.      */  
103.     public static void setCookie(HttpServletRequest request, HttpServletResponse response, String cookieName,  
104.             String cookieValue, boolean isEncode) {  
105.         setCookie(request, response, cookieName, cookieValue, -1, isEncode);  
106.     }  
107.   
108.     /** 
109.      * 设置Cookie的值 在指定时间内生效, 编码参数 
110.      */  
111.     public static void setCookie(HttpServletRequest request, HttpServletResponse response, String cookieName,  
112.             String cookieValue, int cookieMaxage, boolean isEncode) {  
113.         doSetCookie(request, response, cookieName, cookieValue, cookieMaxage, isEncode);  
114.     }  
115.   
116.     /** 
117.      * 设置Cookie的值 在指定时间内生效, 编码参数(指定编码) 
118.      */  
119.     public static void setCookie(HttpServletRequest request, HttpServletResponse response, String cookieName,  
120.             String cookieValue, int cookieMaxage, String encodeString) {  
121.         doSetCookie(request, response, cookieName, cookieValue, cookieMaxage, encodeString);  
122.     }  
123.   
124.     /** 
125.      * 删除Cookie带cookie域名 
126.      */  
127.     public static void deleteCookie(HttpServletRequest request, HttpServletResponse response,  
128.             String cookieName) {  
129.         doSetCookie(request, response, cookieName, "", -1, false);  
130.     }  
131.   
132.     /** 
133.      * 设置Cookie的值，并使其在指定时间内生效 
134.      *  
135.      * @param cookieMaxage cookie生效的最大秒数 
136.      */  
137.     private static final void doSetCookie(HttpServletRequest request, HttpServletResponse response,  
138.             String cookieName, String cookieValue, int cookieMaxage, boolean isEncode) {  
139.         try {  
140.             if (cookieValue == null) {  
141.                 cookieValue = "";  
142.             } else if (isEncode) {  
143.                 cookieValue = URLEncoder.encode(cookieValue, "utf-8");  
144.             }  
145.             Cookie cookie = new Cookie(cookieName, cookieValue);  
146.             if (cookieMaxage > 0)  
147.                 cookie.setMaxAge(cookieMaxage);  
148.             if (null != request) {// 设置域名的cookie  
149.                 String domainName = getDomainName(request);  
150.                 System.out.println(domainName);  
151.                 if (!"localhost".equals(domainName)) {  
152.                     cookie.setDomain(domainName);  
153.                 }  
154.             }  
155.             cookie.setPath("/");  
156.             response.addCookie(cookie);  
157.         } catch (Exception e) {  
158.              e.printStackTrace();  
159.         }  
160.     }  
161.   
162.     /** 
163.      * 设置Cookie的值，并使其在指定时间内生效 
164.      *  
165.      * @param cookieMaxage cookie生效的最大秒数 
166.      */  
167.     private static final void doSetCookie(HttpServletRequest request, HttpServletResponse response,  
168.             String cookieName, String cookieValue, int cookieMaxage, String encodeString) {  
169.         try {  
170.             if (cookieValue == null) {  
171.                 cookieValue = "";  
172.             } else {  
173.                 cookieValue = URLEncoder.encode(cookieValue, encodeString);  
174.             }  
175.             Cookie cookie = new Cookie(cookieName, cookieValue);  
176.             if (cookieMaxage > 0)  
177.                 cookie.setMaxAge(cookieMaxage);  
178.             if (null != request) {// 设置域名的cookie  
179.                 String domainName = getDomainName(request);  
180.                 System.out.println(domainName);  
181.                 if (!"localhost".equals(domainName)) {  
182.                     cookie.setDomain(domainName);  
183.                 }  
184.             }  
185.             cookie.setPath("/");  
186.             response.addCookie(cookie);  
187.         } catch (Exception e) {  
188.              e.printStackTrace();  
189.         }  
190.     }  
191.   
192.     /** 
193.      * 得到cookie的域名 
194.      */  
195.     private static final String getDomainName(HttpServletRequest request) {  
196.         String domainName = null;  
197.   
198.         String serverName = request.getRequestURL().toString();  
199.         if (serverName == null || serverName.equals("")) {  
200.             domainName = "";  
201.         } else {  
202.             serverName = serverName.toLowerCase();  
203.             serverName = serverName.substring(7);  
204.             final int end = serverName.indexOf("/");  
205.             serverName = serverName.substring(0, end);  
206.             final String[] domains = serverName.split("\\.");  
207.             int len = domains.length;  
208.             if (len > 3) {  
209.                 // www.xxx.com.cn  
210.                 domainName = "." + domains[len - 3] + "." + domains[len - 2] + "." + domains[len - 1];  
211.             } else if (len <= 3 && len > 1) {  
212.                 // xxx.com or xxx.cn  
213.                 domainName = "." + domains[len - 2] + "." + domains[len - 1];  
214.             } else {  
215.                 domainName = serverName;  
216.             }  
217.         }  
218.   
219.         if (domainName != null && domainName.indexOf(":") > 0) {  
220.             String[] ary = domainName.split("\\:");  
221.             domainName = ary[0];  
222.         }  
223.         return domainName;  
224.     }  
225.   
226. }