工程搭建

• 工程目錄。
  
  
• pom.xml中tomcat埠配置為8084。
• web.xml中配置工程的url字尾為 / 。
• RedisDao與rest工程中的相同。

介面開發

• 在taotao-sso中開發，提供介面實現單點登入服務。
• redis.properties中配置redis相關引數，包括資料的key。

redis.host=127.0.0.1
redis.prot=6379

#使用者session的key
REDIS_USER_SESSION_KEY=REDIS_USER_SESSION_KEY
#使用者token過期時間
SSO_SESSION_EXPIRE = 1800

• log4j.properties中配置日誌輸出，輸出到控制檯和檔案。

### set log levels ###
log4j.rootLogger=DEBUG , console , debug 
### console ###
log4j.appender.console=org.apache.log4j.ConsoleAppender  
log4j.appender.console.layout=org.apache.log4j.PatternLayout  
log4j.appender.console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
#org.apache包下輸出INFO
#log4j.logger.org.apache=INFO
### log file ###
log4j.appender.debug=org.apache.log4j.DailyRollingFileAppender  
log4j.appender.debug.File=./logs/sso.log  
log4j.appender.debug.Append=true
 
  
log4j.appender.debug.Threshold=INFO  
log4j.appender.debug.layout=org.apache.log4j.PatternLayout  
log4j.appender.debug.layout.ConversionPattern=%-d{yyyy-MM-dd HH\:mm\:ss} [%p]-[%c] %m%n  

檢查資料可用

需求

• 請求方法：GET
• 請求url：/user/check/{param}/{type}
• 請求引數：
  
  • param，校驗引數。
  • type，校驗引數型別，1、2、3分別代表使用者名稱、手機、郵箱。
  • callback，查詢字串中，可選，如果有此引數表示此方法為jsonp請求，需要支援jsonp。
• 響應引數：TaoTaoResult，資料為true、false，表示資料是否可用。

{
    status: 200, //200 成功
    msg: "OK", // 返回資訊訊息
    data: false // 返回資料，true：資料可用，false：資料不可用
}

Service層

• 建立UserService和實現類，根據資料內容和型別查詢資料庫，若存在相同資料則資料不可用，否則可用，返回TaoTaoResult包裝結果。

@Service
public class UserServiceImpl implements UserService {

    @Value("${REDIS_USER_SESSION_KEY}")
    private String REDIS_USER_SESSION_KEY;
    @Value("${SSO_SESSION_EXPIRE}")
    private Integer SSO_SESSION_EXPIRE;

    private static final Logger LOGGER = LoggerFactory.getLogger(UserServiceImpl.class);

    @Autowired
    private TbUserMapper userMapper;
    @Autowired
    private RedisDao redisDao;

    @Override
    public TaotaoResult checkData(String content, Integer type) {
        //建立查詢條件
        TbUserExample example = new TbUserExample();
        Criteria criteria = example.createCriteria();
        if (type == 1) {
            criteria.andUsernameEqualTo(content);
        } else if (type == 2) {
            criteria.andPhoneEqualTo(content);
        } else {
            criteria.andEmailEqualTo(content);
        }

        //執行查詢
        Boolean canBeUse = null;
        List<TbUser> userList = userMapper.selectByExample(example);
        if (userList == null || userList.size() == 0) {
            canBeUse = true;
        } else {
            canBeUse = false;
        }

        LOGGER.debug("userList: {}", JsonUtils.objectToJson(userList));

        return TaotaoResult.ok(canBeUse);
    }

Controller層

• 建立UserController，根據內容和型別呼叫service方法，並注意對jsonp的支援，返回TaoTaoResult，包含是否可用。

@Controller
@RequestMapping("/user")
public class UserController {

    private static final Logger LOGGER = LoggerFactory.getLogger(UserController.class);

    @Autowired
    private UserService userService;

    @RequestMapping("/check/{param}/{type}")
    @ResponseBody
    public Object checkData(@PathVariable String param, @PathVariable Integer type, String callback) {
        LOGGER.debug("param: {}, type: {}, callback: {}", param, type, callback);

        TaotaoResult result = null;

        //引數有效性校驗
        if (StringUtils.isBlank(param)) {
            result = TaotaoResult.build(400, "內容不能為空");
        }
        if (type == null) {
            result = TaotaoResult.build(400, "型別不能為空");
        } else if (type != 1 && type != 2 && type != 3) {
            result = TaotaoResult.build(400, "型別錯誤");
        }
        //校驗出錯
        if (result != null) {
            return getResult(callback, result);

        }

        //呼叫服務
        try {
            result = userService.checkData(param, type);
        } catch (Exception e) {
            result = TaotaoResult.build(500, ExceptionUtil.getStackTrace(e));
        }

        return getResult(callback, result);
    }
    /**
     * jsonp呼叫則返回包含TaoTaoResult的js片段，否則返回TaoTaoResult
     */
    private Object getResult(String callback, TaotaoResult result) {
        if (callback != null) {
            //jsonp呼叫
            MappingJacksonValue mappingJacksonValue = new MappingJacksonValue(result);
            mappingJacksonValue.setJsonpFunction(callback);
            LOGGER.debug("jacksonVaule: {}", JsonUtils.objectToJson(mappingJacksonValue));
            return mappingJacksonValue;
        } else {
            return result;
        }
    }

使用者註冊

需求

• 請求方法：POST
• 請求url：/user/register
• 請求引數：4項表單資料，username、password、phone、email
• 響應引數：TaoTaoResult，包含註冊情況。

{
    status: 200,
    msg: "OK",
    data: null,
}

Service層

• 補全user屬性，插入資料庫，返回TaoTaoResult。
  
  • 使用者密碼需要md5化之後存入資料庫。

    @Override
    public TaotaoResult addUser(TbUser user) {
        user.setCreated(new Date());
        user.setUpdated(new Date());
        //密碼md5化之後儲存在資料庫
        user.setPassword(DigestUtils.md5DigestAsHex(user.getPassword().getBytes()));

        userMapper.insert(user);

        return TaotaoResult.ok();
    }

Controller層

• 接收表單中的使用者資訊，呼叫service層服務，返回TaoTaoResult。

    @RequestMapping(value = "/register", method = RequestMethod.POST)
    @ResponseBody
    public TaotaoResult addUser(TbUser user) {
        LOGGER.debug("user: {}", ReflectionToStringBuilder.toString(user));
        try {
            TaotaoResult result = userService.addUser(user);
            return result;
        } catch (Exception e) {
            return TaotaoResult.build(500, ExceptionUtil.getStackTrace(e));
        }
    }

使用者登入

• 請求方法：POST
• 請求url：/user/login
• 請求引數：username、password
• 響應引數：TaoTaoResult，包含token或者錯誤資訊。

{
    status: 200,
    msg: "OK",
    data: "fe5cb546aeb3ce1bf37abcb08a40493e" //登入成功，返回token
}

Service層

• 根據使用者名稱和密碼，從mysql中查詢使用者，密碼進行md5加密後進行比對。比對成功後說明登入成功，生成一個token（可以使用UUID），並把使用者資訊寫入redis，key為token，value為使用者資訊（不包含密碼）。返回token字串。

    @Override
    public TaotaoResult userLogin(String username, String password) {
        //查詢該使用者
        TbUserExample example = new TbUserExample();
        Criteria criteria = example.createCriteria();
        criteria.andUsernameEqualTo(username);
        List<TbUser> userList = userMapper.selectByExample(example);

        //使用者不存在
        if (userList == null || userList.isEmpty()) {
            return TaotaoResult.build(400, "使用者名稱或密碼錯誤");
        }

        TbUser user = userList.get(0);
        String md5 = DigestUtils.md5DigestAsHex(password.getBytes());
        //密碼不匹配
        if (!user.getPassword().equals(md5)) {
            return TaotaoResult.build(400, "使用者名稱或密碼錯誤");
        }

        //生成使用者token
        String token = UUID.randomUUID().toString();
        //redis中需要清空使用者的密碼
        user.setPassword(null);
        //使用者資訊寫入redis
        String key = REDIS_USER_SESSION_KEY + ":" + token;
        redisDao.set(key, JsonUtils.objectToJson(user));
        redisDao.expire(key, SSO_SESSION_EXPIRE);

        return TaotaoResult.ok(token);
    }

Controller層

• 根據使用者名稱和密碼，呼叫service層，返回TaoTaoResult，包含使用者token。

    @RequestMapping(value = "/login", method = RequestMethod.POST)
    @ResponseBody
    public TaotaoResult userLogin(String username, String password) {
        try {
            TaotaoResult result = userService.userLogin(username, password);
            return result;
        } catch (Exception e) {
            e.printStackTrace();
            return TaotaoResult.build(500, ExceptionUtil.getStackTrace(e));
        }
    }

查詢使用者資訊

需求

• 請求方法：GET
• 請求ulr：/user/token/{token}
• 請求引數：
  
  • token，使用者登入憑證。
  • callback，jsonp回撥方法，查詢字串中，可選，用來支援jsonp。
• 響應引數：TaoTaoResult，包含使用者資訊。

{
    status: 200,
    msg: "OK",
    data: "{"id":1,"username":"zhangzhijun","phone":"15800807944","email":"[email protected]","created":1414119176000,"updated":1414119179000}"
}

Service層

• 接收token，根據token到redis中取使用者資訊。判斷token是否存在，如果不存在說明token非法或者session已過期；存在說明使用者就是正常的登入狀態，返回使用者資訊，同時重置使用者的過期時間。返回值用TaoTaoResult包裝。

    @Override
    public TaotaoResult getUser(String token) {
        //從redis中查詢使用者資訊
        String json = redisDao.get(REDIS_USER_SESSION_KEY + ":" + token);

        if (StringUtils.isBlank(json)) {
            return TaotaoResult.build(400, "此session已經過期，請重新登入");
        }

        //更新過期時間
        redisDao.expire(REDIS_USER_SESSION_KEY + ":" + token, SSO_SESSION_EXPIRE);

        return TaotaoResult.ok(JsonUtils.jsonToPojo(json, TbUser.class));

    }

Controller層

• 根據token調動service方法，返回包含使用者資訊的TaoTaoResult。並且支援jsonp呼叫。

    @RequestMapping("/token/{token}")
    @ResponseBody
    public Object getUser(@PathVariable String token, String callback) {
        TaotaoResult result = null;
        try {
            result = userService.getUser(token);
        } catch (Exception e) {
            e.printStackTrace();
            result = TaotaoResult.build(500, ExceptionUtil.getStackTrace(e));
        }

        return getResult(callback, result);
    }

使用者退出

需求

• 請求方法：GET
• 請求url：/user/logout/{token}
• 請求引數：token，callback（可選）
• 響應引數：TaoTaoResult

{
    status: 200,
    msg: "OK",
    data: ""
}

Service層

• 接收使用者的token，刪除redis中對應的key，返回TaoTaoResult。

    @Override
    public TaotaoResult userLogout(String token) {
        //刪除redis中的key
        String key = REDIS_USER_SESSION_KEY + ":" + token;
        redisDao.del(key);

        return TaotaoResult.ok();
    }

Controller層

• 接收使用者的token，呼叫使用者退出的service層方法，返回操作結果的json，需要支援jsonp呼叫。

    @RequestMapping("/logout/{token}")
    @ResponseBody
    public Object userLogout(@PathVariable String token, String callback) {
        LOGGER.debug("token: {}, callback: {}", token, callback);
        TaotaoResult result = null;
        try {
            result = userService.userLogout(token);
        } catch (Exception e) {
            e.printStackTrace();
            result = TaotaoResult.build(500, ExceptionUtil.getStackTrace(e));
        }

        return getResult(callback, result);
    }

介面測試

• 使用postman測試介面，參考:postman批量測試。
• 本專案中post提交表單，編碼方式為application/x-www-form-urlencoded。
  
• 注意：jsonp的響應實體，以 /**/ 開頭。