java 省市区接口

原创

mob649e815b5994 2024-08-02 08:52:09 ©著作权

©著作权归作者所有：来自51CTO博客作者mob649e815b5994的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java 省市区接口的构建以及使用

在开发与地理位置相关的应用时，省市区的管理和显示是经常需要实现的功能。为了更好地组织这些信息，我们可以通过构建一个 Java 的接口来处理省、市、区（县）的数据。本文将介绍如何设计这样一个接口，并提供代码示例。

1. 省市区数据模型

我们通常需要定义三个主要的类：Province（省）、City（市）和District（区）。每个类都包括其相关属性及方法。以下是这些类的基本结构定义：

public class District {
    private String name; // 区名
    private String code; // 区代码

    public District(String name, String code) {
        this.name = name;
        this.code = code;
    }

    // Getter 和 Setter 略
}

public class City {
    private String name; // 市名
    private String code; // 市代码
    private List<District> districts; // 城市下的区列表

    public City(String name, String code) {
        this.name = name;
        this.code = code;
        this.districts = new ArrayList<>();
    }

    public void addDistrict(District district) {
        this.districts.add(district);
    }

    // Getter 和 Setter 略
}

public class Province {
    private String name; // 省名
    private String code; // 省代码
    private List<City> cities; // 省下的市列表

    public Province(String name, String code) {
        this.name = name;
        this.code = code;
        this.cities = new ArrayList<>();
    }

    public void addCity(City city) {
        this.cities.add(city);
    }

    // Getter 和 Setter 略
}

2. 省市区接口的定义

为了统一操作，我们可以定义一个接口 LocationService，提供基本的 CRUD 操作。以下是接口的示例：

public interface LocationService {
    void addProvince(Province province);
    void addCity(String provinceCode, City city);
    void addDistrict(String provinceCode, String cityCode, District district);
    
    List<Province> getAllProvinces();
    List<City> getCitiesByProvince(String provinceCode);
    List<District> getDistrictsByCity(String provinceCode, String cityCode);
}

3. 接口的实现

通过实现 LocationService 接口，我们可以创建一个存储省市区信息的类 LocationServiceImpl。该类使用 Map 来存储和管理数据。

import java.util.*;

public class LocationServiceImpl implements LocationService {
    private Map<String, Province> provinceMap = new HashMap<>();

    @Override
    public void addProvince(Province province) {
        provinceMap.put(province.getCode(), province);
    }

    @Override
    public void addCity(String provinceCode, City city) {
        Province province = provinceMap.get(provinceCode);
        if (province != null) {
            province.addCity(city);
        }
    }

    @Override
    public void addDistrict(String provinceCode, String cityCode, District district) {
        City city = getCitiesByProvince(provinceCode).stream()
                    .filter(c -> c.getCode().equals(cityCode))
                    .findFirst().orElse(null);
        if (city != null) {
            city.addDistrict(district);
        }
    }

    @Override
    public List<Province> getAllProvinces() {
        return new ArrayList<>(provinceMap.values());
    }

    @Override
    public List<City> getCitiesByProvince(String provinceCode) {
        Province province = provinceMap.get(provinceCode);
        return province != null ? province.getCities() : Collections.emptyList();
    }

    @Override
    public List<District> getDistrictsByCity(String provinceCode, String cityCode) {
        City city = getCitiesByProvince(provinceCode).stream()
                    .filter(c -> c.getCode().equals(cityCode))
                    .findFirst().orElse(null);
        return city != null ? city.getDistricts() : Collections.emptyList();
    }
}

4. 状态图

为了更直观地展示系统的状态和流程，我们可以使用状态图表示各个操作之间的关系。以下是一个状态图示例，展示了省市区操作的状态。

stateDiagram
    [*] --> AddProvince
    AddProvince --> AddCity
    AddCity --> AddDistrict
    AddDistrict --> [*]
    AddProvince --> GetAllProvinces
    GetAllProvinces --> [*]
    AddCity --> GetCitiesByProvince
    GetCitiesByProvince --> [*]
    AddDistrict --> GetDistrictsByCity
    GetDistrictsByCity --> [*]