基于 Swift 多地图源业务向地图控件实现(三):交互事件处理
有的时候地图控件上还会有交互需求。比如在我的业务场景里,需要编辑无人机巡航的区域。要编辑区域,区域的多边形顶点就需要可以拖动。
image简化一下需求,我们现在来实现一下点拖动编辑的功能。
首先我们定义一下可以移动的顶点 View:
class MapMoveableAnnotation: UIImageView {
init(type: MoveableAnnotationType) {
self.type = type
super.init(frame: CGRect.zero)
isUserInteractionEnabled = true
setupUI()
}
private func setupUI() {
bounds = CGRect(x: 0, y: 0, width: 44, height: 44)
contentMode = .center
image = Asset.Map.iconAreaEditPoint.image
highlightedImage = Asset.Map.iconAreaEditPointSelected.image
}
}
上面要注意的细节是需要设置 isUserInteractionEnabled 为 true。
接着我们定义一个 view 专门响应用户的交互事件,因为要首先响应交互,这个 view 要在地图控件的最顶层。
class MapInteractionView: UIView {
override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
for subview in subviews {
let subPoint = subview.convert(point, from: self)
if let result = subview.hitTest(subPoint, with: event) {
return result
}
}
return nil
}
}
因为 MapInteractionView 里所有元素都会响应交互事件,因此直接重新实现了 hitTest 方法。如果交互的点在内部元素上响应事件,如果不在的话不响应,让交互事件可以传到下层的地图源响应。
接下来我们在 MapInteractionView 中定义添加可拖动控制点的方法:
class MapInteractionView: UIView {
private var areaControlAnnotations: [MapMoveableAnnotation] = []
func renderAreaEdit(vertexs: [CGPoint]) {
if areaControlAnnotations.count != vertexs.count {
areaControlAnnotations.forEach { $0.removeFromSuperview() }
areaControlAnnotations.removeAll()
areaControlAnnotations = vertexs.map { _ in MapMoveableAnnotation() }
areaControlAnnotations.forEach {
addSubview($0)
}
}
for (index, point) in vertexs.enumerated() {
areaControlAnnotations[index].center = point
areaControlAnnotations[index].tag = index
}
}
}
接着我们给 MapInteractionView 添加手势响应:
protocol MapInteractionDelegate: class {
func areaVertexMoved(index: Int, point: CGPoint, isFinish: Bool)
func areaFinishChanging()
}
class MapInteractionView: UIView {
weak var delegate: MapInteractionDelegate?
private var panGesture: UIPanGestureRecognizer?
override init(frame: CGRect) {
super.init(frame: frame)
panGesture = UIPanGestureRecognizer(target: self, action: #selector(handlePanGesture))
addGestureRecognizer(panGesture!)
}
private var panSelectedView: UIView?
@objc private func handlePanGesture(_ gesture: UIPanGestureRecognizer) {
switch gesture.state {
case .began:
guard let selectedView = hitTest(gesture.location(in: self), with: nil) else { return }
panSelectedView = selectedView
if let movableAnnotation = selectedView as? MapMoveableAnnotation {
movableAnnotation.isHighlighted = true
}
case .changed:
guard let panSelectedView = panSelectedView else { return }
let touchPoint = gesture.location(in: self)
panSelectedView.center = touchPoint
delegate?.areaVertexMoved(index: panSelectedView.tag, point: touchPoint, isFinish: false)
case .ended:
if let movableAnnotation = panSelectedView as? MapMoveableAnnotation {
movableAnnotation.isHighlighted = false
if movableAnnotation.type == .areaControlPoint {
delegate?.areaVertexMoved(index: movableAnnotation.tag, point: movableAnnotation.center, isFinish: true)
}
delegate?.areaFinishChanging()
}
panSelectedView = nil
default:
break
}
}
}
这里要强调的还是每个类职责的划分。在架构中我们常说单一职责,单一职责对于维护性的影响至关重要。我们对 MapInteractionView 的定义就是接受用户的交互事件。因此它在上面的场景中,处理移动手势,通知外界哪个顶点开始移动,移动结束。
如何检验单一职责执行的好不好呢?我的一个建议是思考这个模块是否可以抽离出来独立验证,也就是可测试性。以 MapInteractionView 为例,现在这样设计如果想要单独测试这个类,可以做到吗?相对而言是比较容易的,可以在单元测试项目中初始化添加到 VC 中,输入特定的坐标点,接着在模拟控制坐标点位置模拟拖动手势。在 MapInteractionDelegate 中断言返回的结果和模拟的手势值是否一致。
最后一环就是把 MapInteractionView 添加到地图控件的最顶层,这块代码比较简单代码我就不列举了。
总结
复杂的业务必然会有“复杂”的实现。架构设计要解决的是:面对复杂的需求,复杂的实现应该让开发者容易理解,容易维护。怎样做到呢?我们在规划时就划分好各个模块,让各个模块通过合理的组合实现复杂的功能。这样开发者在维护的时候只需要关注两件事:1.模块是如何划分的 2.我要维护的部分在模块中是如何实现的。每个模块因为职责清晰,所以即便不清楚全局,也可以维护这个模块的实现细节。这样的设计就达到了易理解、已维护的目标。