// ================================================================================
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
// You can delete these comments if you wish manually maintain this interface file.
// ================================================================================

package service

import (
	"context"
	"easygoadmin/api/v1"
)

// 按模块独立拆分（源：gf gen service 产物手工重组）。
// logic 方法签名变更时需同步维护本文件（手维护，勿整体运行 gf gen service）。

// ICity 城市服务接口
type ICity interface {
	// Page 城市分页
	Page(ctx context.Context, req *v1.CityPageReq) (res *v1.CityPageRes, err error)
	// List 城市列表
	// 按父级编码查询，供级联选择器使用
	List(ctx context.Context, req *v1.CityListReq) (res v1.CityListRes, err error)
	// Detail 城市详情
	Detail(ctx context.Context, req *v1.CityDetailReq) (res *v1.CityDetailRes, err error)
	// Add 新增城市
	Add(ctx context.Context, req *v1.CityAddReq) (res *v1.IdRes, err error)
	// Update 修改城市
	Update(ctx context.Context, req *v1.CityUpdateReq) (res *v1.CityUpdateRes, err error)
	// Delete 删除城市
	Delete(ctx context.Context, req *v1.CityDeleteReq) (res *v1.CityDeleteRes, err error)
	// BatchDelete 批量删除城市
	BatchDelete(ctx context.Context, req *v1.CityBatchDeleteReq) (res *v1.CityBatchDeleteRes, err error)
	// ByParent 按父编码查询下级城市
	// 登录用户即可访问
	ByParent(ctx context.Context, req *v1.CityByParentReq) (res *v1.CityByParentRes, err error)
	// AreaProvince 查询省份列表
	// 登录用户即可访问
	AreaProvince(ctx context.Context, req *v1.AreaParentReq) (res *v1.AreaParentRes, err error)
	// GetCityList 按父编码获取下级城市
	// 登录用户即可访问，供级联选择器懒加载
	GetCityList(ctx context.Context, req *v1.CityGetListReq) (res v1.CityGetListRes, err error)
}

// localCity 城市服务实现实例
var localCity ICity

// City 获取城市服务实例
func City() ICity {
	if localCity == nil {
		panic("implement not found for interface ICity, forgot register?")
	}
	return localCity
}

// RegisterCity 注册城市服务实现
func RegisterCity(i ICity) {
	localCity = i
}