省市區 - 三級聯動通用化模塊組件

都說我們要做模塊化設計，而不要做功能化設計

什么是模塊化設計，就是可插拔性高，組件化，想要就用，不要用拉倒，直接刪除就行

什么是功能化設計，就是一個簡單的功能，實現想要的效果，但是不夠通用化，別人要用的話需要讀懂你的代碼，還需要復制黏貼很多代碼這樣效率不高

 

今天寫了一個省市區三級聯動的模塊，寫完后使用會非常方便，也很靈活

主要使用到的技術：jquery，redis，springMVC，MyBatis（springMVC和MyBatis無所謂，你用struts或者hibernate或者spring data都行）

首先頁面引入js

<script src="/js/jquery-2.2.4.min.js"></script>
<script src="/cityselect/js/jquery.cityselect.js"></script>

HTML中寫入3個div塊，這是互斥的，div#id不同就可以做到模塊化可插拔

<div id="city"> 
        <select class="prov"></select>  
        <select class="city" disabled="disabled"></select> 
        <select class="dist" disabled="disabled"></select> 
    </div> 
    
    <div id="city2"> 
        <select class="prov"></select>  
        <select class="city" disabled="disabled"></select> 
        <select class="dist" disabled="disabled"></select> 
    </div> 
    
    <div id="city3"> 
        <select class="prov"></select>  
        <select class="city" disabled="disabled"></select> 
        <select class="dist" disabled="disabled"></select> 
    </div> 

初始化JS：

    <script type="text/javascript">
        /**
         * 
         * @Description: 省市區三級聯動api
         * Copyright: Copyright (c) 2016
         * 
         * ==============================
         * 參數說明
         * url:省市數據josn文件路徑
         * prov:默認省份
         * city:默認城市
         * dist:默認地區（縣）
         * nodata:無數據狀態
         * required:必選項
         * ==============================
         * 
         * @author leechenxiang
         * @date 2016年6月16日 下午3:46:58
         * @version V1.0
         */
        $(function(){
            $("#city").citySelect({
                prov:"江蘇省",
                city:"無錫市",
                dist:"南長區",
                required:false
            }); 
            
            $("#city2").citySelect({
                nodata:"none",
                required:false
            }); 
            
            $("#city3").citySelect({
                nodata:"none",
                required:false
            }); 
            
        });
    </script>

后台controller：

/**
     * 
     * @Description: 獲取所有的省市區列表
     * @return
     * @throws Exception
     * 
     * @author leechenxiang
     * @date 2016年6月16日 上午11:22:10
     */
    @RequestMapping("/getCities")
    @ResponseBody
    public CitiesDataResult getCities() throws Exception {
        CitiesDataResult areas = commonService.getAllCities();
        return areas;
    }

service：

@Override
    public CitiesDataResult getAllCities() {
        // 取出緩存
        try {
            String citiesDataResult = jedisClient.get(REDIS_CITIES_KEY);
            if (!StringUtils.isBlank(citiesDataResult)) {
                CitiesDataResult redisResult = JsonUtils.jsonToPojo(citiesDataResult, CitiesDataResult.class);
                return redisResult;
            }
        } catch (Exception e1) {
            e1.printStackTrace();
        }
        
        List<AreaProvince> provinceList = areaProvinceMapper.getProvinceList();
        List<Province> pList = new ArrayList<Province>();
        for (AreaProvince province : provinceList) {
            int provinceId = province.getProvinceId();
            String provinceName = province.getProvinceName();
            
            List<AreaCity> cityList = areaProvinceMapper.getCityListBypId(provinceId);
            List<City> cList = new ArrayList<City>();
            for (AreaCity city : cityList) {
                int cityId = city.getCityId();
                String cityName = city.getCityName();
                
                List<District> districtList = areaProvinceMapper.getDistrictListBycId(cityId);
                
                City c = new City();
                c.setN(cityName);
                c.setA(districtList);
                cList.add(c);
            }
            
            Province p = new Province(provinceName, cList);
            pList.add(p);
        }
        
        CitiesDataResult result = new CitiesDataResult();
        result.setCitylist(pList);
        
        // 放入緩存
        try {
            jedisClient.set(REDIS_CITIES_KEY, JsonUtils.objectToJson(result));
        } catch (Exception e) {
            e.printStackTrace();
        }
        
        return result;
    }

如果需要默認選中那么只需要對這3個參數賦值即可：

prov:"江蘇省",
city:"無錫市",
dist:"南長區",

對於省市區的數據源，可以存放在數據庫表中，也可以直接存入js，作為一個json來調用即可

如果沒有省市區可以淘一下萬能的X寶，可以參考如下鏈接，真的是太強大了，把省市區直接細化到了極致:

省市區 數據庫 腳本 excel