一次解析URL参数的实践

应用场景

“千人千面”一般是参考URL定义,进行协议传输,各部分进行解析执行,从而达到可配置的目的

  1. 客户端从CMS服务器读取配置。这里涉及到网络传输,一般是一个字段,字符串比较多。格式一般是
    “app://com.company.department.module.class.function?key1=value1&key2=value2”
  • "://"前面的一般是标识符,判断该由哪部分处理。这部分相当于URL的scheme
  • "://"和“?”之间的一般是模块名,判断应该调起哪个模块,哪个类,哪个函数。当然粒度可以根据具体需求而定。这部分相当于URL的host
  • "?"后面的一般是参数,以“&”分隔各参数,以“=”分隔key与value。这部分相当于URL的query
  1. 客户端收到字符串之后,进行解析
  • 字符串来自网络,格式参考url,所以第一步要去掉%表示的各种非ASCII字符stringByRemovingPercentEncoding
  • 根据分隔标识符,将url串提取成三部分,scheme、host、parameter(这是一个字典,而且可能没有)componentsSeparatedByString
  1. 根据类名、函数名、参数(字典)调用相关函数
  • 根据字符串生成类NSClassFromString
  • 根据字符串执行方法NSSelectorFromString
  • 这两个涉及动态特性,加@obc应该可以用,以后不知道能否在Swift中用
  • 一个笨一点的方法是用if或者switch穷举。这种分发函数在以前的C代码里面是比较常见的。灵活性比较好,每个分支可以有不一样的处理。

手动实现

根据字符串处理方法,手动分割参数。这里只是简单地进行字符串提取,其中的host包括URL中的host, path, parameter等各部分的统称。这里只是借用概念,简单处理,并不严格遵循。

extension String {
    /**
     
     "zaapp://com.zhongan.zaf.card?key1=value1&key2=value2" -> (zaapp, com.zhongan.zaf.card, [key1:value1, key2:value2])
     
     - returns: 各参数分离的元组
     */
    func parseUrl() -> (scheme:String, host: String, query: [String : String]?)? {
        // 去掉%
        guard let rawString = self.stringByRemovingPercentEncoding else {
            return nil
        }
        
        // 取协议名称
        let schemeArray = rawString.componentsSeparatedByString("://")
        guard schemeArray.count == 2 else {
            return nil
        }
        let scheme = schemeArray[0];
        let hostString = schemeArray[1];
        
        // 取path
        let hostArray = hostString.componentsSeparatedByString("?")
        switch hostArray.count {
        case 0: // 不带?没有参数
            return (scheme, hostString, nil)
            
        case 1: // 最后面带?,但是后面没有参数
            let host = hostArray[0]
            return (scheme, host, nil)
            
        case 2:
            
            // 内部函数,"key=value" -> (key, value)
            func parseKeyValue(keyValueString: String) -> (key: String, value: String)? {
                let keyValueArray = keyValueString.componentsSeparatedByString("=")
                guard keyValueArray.count == 2 else {
                    return nil
                }
                let key = keyValueArray[0]
                let value = keyValueArray[1]
                return (key, value)
            }
            
            let host = hostArray[0];
            let queryString = hostArray[1];
            
            // 取query参数
            let queryArray = queryString.componentsSeparatedByString("&")
            var query: [String : String] = [ : ]
            for keyValueString in queryArray {
                if let (key, value) = parseKeyValue(keyValueString) {
                    query[key] = value
                }
            }
            return (scheme, host, query)
            
        default:
            return nil
        }
    }
}

系统函数NSURL

思路是将收到的urlString转换为NSURL对象,然后用系统提供的方法取sheme, host, query等成员。这种方式遵循URL规范,利用系统的方法,更合适一些。

  • 要注意URL编码,如果含有中文,那么NSURL对象是生成不了的。需要转为百分比格式

  • 在query部分,除了url参数,还有其他参数,这里要求转换为中文等。但是其中的url字段,是给其他地方用的url字符,这里又要重新编码一下。

  • URL编码时,参数要选择NSCharacterSet.URLQueryAllowedCharacterSet()

extension String {
    /**
     
     "zaapp://com.zhongan.zaf.card?key1=value1&key2=value2" -> (zaapp, com.zhongan.zaf.card, [key1:value1, key2:value2])
     
     - returns: 各参数分离的元组
     */
    func parseUrlString() -> (scheme:String, host: String?, parameters: [String : String]?)? {     
        guard let url = NSURL(string: self) else {
            return nil
        }
        
        // 内部函数,"key=value" -> (key, value)
        func parseKeyValue(keyValueString: String) -> (key: String, value: String)? {
            let keyValueArray = keyValueString.componentsSeparatedByString("=")
            guard keyValueArray.count == 2 else {
                return nil
            }
            let key = keyValueArray[0]
            let value = keyValueArray[1]
            return (key, value)
        }
        
        let scheme = url.scheme
        let host = url.host
        
        if let query = url.query {
            let queryArray = query.componentsSeparatedByString("&")
            var parameters: [String : String] = [ : ]
            for keyValueString in queryArray {
                if let (key, value) = parseKeyValue(keyValueString) {
                    parameters[key] = value
                }
            }
            return (scheme, host, parameters)
        }

        return (scheme, host, nil)
    }
}

系统函数NSURLComponant

用这个函数更方便,不用考虑url的编码解码问题。系统提供了从query字符串中获取参数的功能,不需要自己实现了。

extension String {
    /**
     解析url字符串,将其分解为scheme.host.query数组三部分
     
     - returns: scheme.host.query数组三部分组成的元组
     */
    func parseUrlString() -> (scheme:String?, host: String?, queryItems: [NSURLQueryItem]?)? {
        guard let urlComponents = NSURLComponents(string: self) else {
            log("非法的url字符串")
            log(self)
            return nil
        }
        
        let scheme = urlComponents.scheme
        let host = urlComponents.host
        let queryItems = urlComponents.queryItems
        
        return (scheme, host, queryItems)
    }
}

小结

  • 在正式用的时候,推荐用最后一种方法NSURLComponant

  • 在处理url有关的参数时,需要注意编解码(百分号形式)问题

  • HTTPS协议在互联网领域有比较重要的位置,相关的系统函数需要了解

  • 在服务化体系下,也可以参考HTTPS的设置,实现模块间的调用

  • 方案1只是简单的字符串处理,在一些不是很规范的HTTPS协议字符串的地方有一定作用。不过,还是按照http协议来做比较好

参考文章

在线编码转换 这个调试的时候要用到

Best way to parse URL string to get values for keys?

How to encode a URL in Swift

How to use stringByAddingPercentEncodingWithAllowedCharacters() for a URL in Swift 2.0

Unsupported URL iOS

你可能感兴趣的:(一次解析URL参数的实践)