• 谈Swift中的访问控制


    访问控制(Access Control)

    访问控制可以限定其他源文件或模块中的代码对你的代码的访问级别。这个特性可以让我们隐藏代码的一些实现细节,并且可以指定一些代码和访问和使用的优先接口。

    你可以明确地给单个类型(类、结构体、枚举)设置访问级别,也可以给这些类型的属性、方法、构造器、下标等设置访问级别。协议也可以被限定在一定的范围内使用,包括协议里的全局常量、变量和函数。

    Swift 不仅提供了多种不同的访问级别,还为某些典型场景提供了默认的访问级别,这样就不需要我们在每段代码中都申明显式访问级别。其实,如果只是开发一个单一目标的应用程序,我们完全可以不用显式声明代码的访问级别。

    注意:为了简单起见,对于代码中可以设置访问级别的特性(属性、基本类型、函数等),在下面的章节中我们会称之为“实体”。

    模块和源文件(Modules and Source Files)

    Swift中的访问控制模型基于模块和源文件这两个概念。

    模块指的是独立的代码单元,框架或应用程序会作为一个独立的模块来构建和发布。在 Swift中,一个模块可以使用import关键字导入另外一个模块。
       
    在Swift中,Xcode的每个目标(例如框架或应用程序)都被当作独立的模块处理。如果你是为了实现某个通用的功能,或者是为了封装一些常用方法而将代码打包成独立的框架,这个框架就是 Swift中的一个模块。当它被导入到某个应用程序或者其他框架时,框架内容都将属于这个独立的模块。

    源文件就是 Swift中的源代码文件,它通常属于一个模块,即一个应用程序或者框架。尽管我们一般会将不同的类型分别定义在不同的源文件中,但是同一个源文件也可以包含多个类型、函数之类的定义。

    访问级别(Access Levels)
    Swift 为代码中的实体提供了五种不同的访问级别。这些访问级别不仅与源文件中定义的实体相关,同时也与源文件所属的模块相关。

    1:开放访问(open access)和公开访问(public access)可以访问同一模块源文件中的任何实体,在模块外也可以通过导入该模块来访问源文件里的所有实体。通常情况下,框架中的某个接口可以被任何人使用时,你可以将其设置为开放(Open)或者公开(public)访问。对于开放(Open)或者公开(public)访问的区别,后面会讲到。

    2:内部访问(internal)可以访问同一模块源文件中的任何实体,但是不能从模块外访问该模块源文件中的实体。通常情况下,某个接口只在应用程序或框架内部使用时,你可以将其设置为内部访问。

    3:文件私有访问(fileprivate)限制实体只能被所定义的文件内部访问。当需要把这些细节被整个文件使用的时候,使用文件私有访问隐藏了一些特定功能的实现细节。

    4:私有访问(private)限制实体只能在所定义的作用域内使用。需要把这些细节被整个作用域使用的时候,使用文件私有访问隐藏了一些特定功能的实现细节。

    开放访问(open access)为最高(限制最少)访问级别,私有访问(private access)为最低(限制最多)访问级别。开放访问(open access)只作用于类类型和类的成员,它和公开访问(public access)的区别如下:

    1:公开访问(public access)或者其他更严访问级别的类,只能在它们定义的模块内部被继承。
    2:公开访问(public access)或者其他更严访问级别的类成员,只能在它们定义的模块内部的子类中重写。
    3:开放访问(open access)的类,可以在它们定义的模块中被继承,也可以在引用它们的模块中被继承。
    4:开放访问(open access)的类成员,可以在它们定义的模块中子类中重写,也可以在引用它们的模块中的子类重写。
    把一个类标记为开放,显式地表明,你认为其他模块中的代码使用此类作为父类,然后你已经设计好了你的类的代码了。

    访问级别基本原则(Guiding Pribciple of Access Levels)

    Swift 中的访问级别遵循一个基本原则:不可以在某个实体中定义访问级别更低(更严格)的实体。例如:
    1:一个公开访问级别的变量(public variable),其类型的访问级别不能是内部(internal),文件私有(fileprivate)或是私有类型(private)的。因为无法保证变量的类型在使用变量的地方可获取。
    2:函数的访问级别不能高于它的参数类型和返回类型的访问级别。因为这样就会出现函数可以在任何地方被访问,但是它的参数类型和返回类型却不可以的情况。

    关于此原则的各种情况的具体实现,将在下面的细节中体现。

    默认访问级别(Default Access Levels)

    如果你不为代码中的实体显式指定访问级别,那么它们默认为internal级别(有一些例外情况,稍后会进行说明)。因此,在大多数情况下,我们不需要显式指定实体的访问级别。

    单目标应用程序的访问级别(Access Levelsfor Single-Target Apps)

    当你编写一个简单的单目标应用程序时,应用的所有功能都是为该应用服务,而不需要提供给其他应用或者模块使用,所以我们不需要明确设置访问级别,使用默认的访问级别internal即可。但是,你也可以使用文件私有访问(fileprivate)或私有访问级别(private),用于隐藏一些功能的实现细节。


    框架的访问级别(Access Levelsfor Frameworks)

    当你开发框架时,就需要把一些对外的接口定义为开放(open)访问或公开(public)访问级别,以便使用者导入该框架后可以正常使用其功能。这些被你定义为对外的接口,就是这个框架的API。

    注意:框架依然会使用默认的内部访问级别,也可以指定为文件私有访问或者私有访问级别。当你想把某个实体作为框架的 API的时候,需显式为其指定开放访问或公开访问级别。

    单元测试目标的访问级别(Access Levelsfor Unit Test Targets)

    当你的应用程序包含单元测试目标时,为了测试,测试模块需要访问应用程序模块中的代码。默认情况下只有开放访问或公开访问级别级别的实体才可以被其他模块访问。然而,如果在导入应用程序模块的语句前使用@testable特性,然后在允许测试的编译设置(Build Options -> Enable Testability)下编译这个应用程序模块,单元测试目标就可以访问应用程序模块中所有内部级别的实体。

    访问控制语法(Access Control Syntax)

    通过修饰符 open,public,internal,fileprivate,private来声明实体的访问级别:

    public class SomePublicClass{}
    internal class SomeInternalClass{}
    fileprivate class SomeFilePrivateClass{}
    private class SomePrivateClass{}
    
    public var somePublicVariable = 0
    internal var someInternalConstant = 0
    fileprivate func someFilePrivateFuncation(){}
    private func somePrivateFuncation(){}

    除非专门指定,否则实体默认的访问级别为内部访问级别,可以查阅默认访问级别这一节。

    这意味着在不使用修饰符显式声明访问级别的情况下,

    SomeInternalClass和 someInternalConstant仍然拥有隐式的内部访问级别:
    class SomeInternalClass {} // 隐式内部访问级别
    var someInternalConstant = 0 // 隐式内部访问级别

    自定义类型(Custom Types)
    如果想为一个自定义类型指定访问级别,在定义类型时进行指定即可。新类型只能在它的访问级别限制范围内使用。例如,你定义了一个文件私有级别的类,那这个类就只能在定义它的源文件中使用,可以作为属性类型、函数参数类型或者返回类型,等等。

    一个类型的访问级别也会影响到类型成员(属性、方法、构造器、下标)的默认访问级别。如果你将类型指定为私有或者文件私有级别,那么该类型的所有成员的默认访问级别也会变成私有或者文件私有级别。如果你将类型指定为公开或者内部访问级别(或者不明确指定访问级别,而使用默认的内部访问级别),那么该类型的所有成员的默认访问级别将是内部访问。

    重要:上面提到,一个公开类型(public type)的所有成员的访问级别默认为内部访问级别,而不是公开级别。如果你想将某个成员指定为公开访问级别,那么你必须显式指定。这样做的好处是,在你定义公共接口的时候,可以明确地选择哪些接口是需要公开的,哪些是内部使用的,避免不小心将内部使用的接口公开。

    //显式公开类
    public class SomePublicClass{
    //显示公开类成员
    public var somePublicProperty = 0
    //隐式内部类成员
    var someInternalProperty = 0
    //显式文件私有类成员
    fileprivate func someFilePrivateMethod() {}
    //显式私有类成员
    private func somePrivateMethod() {}
    }
    
    //隐式内部类
    class SomeInternalClass {
    //隐式内部类成员
    var someInternalProperty = 0
    //显式文件私有类成员
    fileprivate func someFilePrivateMethod() {}
    //显式私有类成员
    private func somePrivateMethod() {}
    }
    
    //显式文件私有类
    fileprivate class SomeFilePrivateClass {
    //隐式文件私有类成员
    func someFilePrivateMethod() {}
    //显式私有类成员
    private func somePrivateMethod() {}
    }
    
    //显式私有类
    private class SomePrivateClass {
    //隐式私有类成员
    func somePrivateMethod() {}
    }

    元组类型(Tuple Types)

    元组的访问级别将由元组中访问级别最严格的类型来决定。例如,如果你构建了一个包含两种不同类型的元组,其中一个类型为内部访问级别,另一个类型为私有访问级别,那么这个元组的访问级别为私有访问级别。

    注意:元组不同于类、结构体、枚举、函数那样有单独的定义。元组的访问级别是在它被使用时自动推断出的,而无法明确指定。

    函数类型(Function Types)

    函数的访问级别根据访问级别最严格的参数类型或返回类型的访问级别来决定。但是,如果这种访问级别不符合函数定义所在环境的默认访问级别,那么就需要明确地指定该函数的访问级别。

    下面的例子定义了一个名为 someFunction()的全局函数,并且没有明确地指定其访问级别。也许你会认为该函数应该拥有默认的访问级别 internal,但事实并非如此。事实上,如果按下面这种写法,代码将无法通过编译:

    func someFunction() -> (SomeInternalClass, SomePrivateClass) {
        // 此处是函数实现部分
    }

    我们可以看到,这个函数的返回类型是一个元组,该元组中包含两个自定义的类(可查阅自定义类型)。其中一个类的访问级别是 internal,另一个的访问级别是 private,所以根据元组访问级别的原则,该元组的访问级别是 private(元组的访问级别与元组中访问级别最低的类型一致)。

    因为该函数返回类型的访问级别是 private,所以你必须使用private修饰符,明确指定该函数的访问级别:

    private func someFunction() -> (SomeInternalClass, SomePrivateClass) {
        // 此处是函数实现部分
    }

    将该函数指定为public或 internal,或者使用默认的访问级别internal都是错误的,因为如果把该函数当做public或internal级别来使用的话,可能会无法访问private级别的返回值。

    枚举类型(Enumeration Types)

    枚举成员的访问级别和该枚举类型相同,你不能为枚举成员单独指定不同的访问级别。

    比如下面的例子,枚举 CompassPoint被明确指定为public级别,那么它的成员 North、South、East、West的访问级别同样也是 public:

    public enum CompassPoint {
        case North
        case South
        case East
        case West
    }

    原始值和关联值(Raw Values and Associated Values)

    枚举定义中的任何原始值或关联值的类型的访问级别至少不能低于枚举类型的访问级别。例如,你不能在一个internal访问级别的枚举中定义private级别的原始值类型。

    嵌套类型(Nested Types)

    如果在private级别的类型中定义嵌套类型,那么该嵌套类型就自动拥有private访问级别。如果在public或者internal级别的类型中定义嵌套类型,那么该嵌套类型自动拥有internal访问级别。如果想让嵌套类型拥有public访问级别,那么需要明确指定该嵌套类型的访问级别。

    子类(Subclassing)

    子类的访问级别不得高于父类的访问级别。例如,父类的访问级别是 internal,子类的访问级别就不能是public。

    此外,你可以在符合当前访问级别的条件下重写任意类成员(方法、属性、构造器、下标等)。

    可以通过重写为继承来的类成员提供更高的访问级别。下面的例子中,类 A的访问级别是 public,它包含一个方法 someMethod(),访问级别为private。类 B继承自类 A,访问级别为 internal,但是在类 B 中重写了类 A中访问级别为private的方法 someMethod(),并重新指定为internal级别。通过这种方式,我们就可以将某类中private级别的类成员重新指定为更高的访问级别,以便其他人使用:

    public class A {
        private func someMethod() {}
    }
    
    internal class B: A {
        override internal func someMethod() {}
    }

    我们甚至可以在子类中,用子类成员去访问访问级别更低的父类成员,只要这一操作在相应访问级别的限制范围内(也就是说,在同一源文件中访问父类private级别的成员,在同一模块内访问父类internal级别的成员):

    public class A {
        private func someMethod() {}
    }
    
    internal class B: A {
        override internal func someMethod() {
            super.someMethod()
        }
    }

    因为父类A和子类B定义在同一个源文件中,所以在子类B可以在重写的 someMethod()方法中调用super.someMethod()。

    常量、变量、属性、下标(Constants、Variables、Properties、Subscripts)

    常量、变量、属性不能拥有比它们的类型更高的访问级别。例如,你不能定义一个public级别的属性,但是它的类型却是private级别的。同样,下标也不能拥有比索引类型或返回类型更高的访问级别。

    如果常量、变量、属性、下标的类型是private级别的,那么它们必须明确指定访问级别为 private:
    private var privateInstance = SomePrivateClass()

    Getter 和 Setter

    常量、变量、属性、下标的 Getters和 Setters的访问级别和它们所属类型的访问级别相同。
    Setter 的访问级别可以低于对应的 Getter的访问级别,这样就可以控制变量、属性或下标的读写权限。在var或subscript关键字之前,你可以通过fileprivate(set),private(set)或internal(set)为它们的写入权限指定更低的访问级别。

    注意:这个规则同时适用于存储型属性和计算型属性。即使你不明确指定存储型属性的 Getter和 Setter,Swift也会隐式地为其创建 Getter 和 Setter,用于访问该属性的后备存储。使用fileprivate(set),private(set)和internal(set)可以改变 Setter的访问级别,这对计算型属性也同样适用。

    下面的例子中定义了一个名为 TrackedString的结构体,它记录了 value属性被修改的次数:

    struct TrackedString {
        private(set) var numberOfEdits = 0
        var value: String = "" {
            didSet {
                    numberOfEdits += 1
            }
        }
    }    

    TrackedString结构体定义了一个用于存储String值的属性 value,并将初始值设为""(一个空字符串)。该结构体还定义了另一个用于存储Int值的属性 numberOfEdits,它用于记录属性 value被修改的次数。这个功能通过属性 value的 didSet观察器实现,每当给 value赋新值时就会调用 didSet方法,然后将 numberOfEdits的值加一。

    结构体TrackedString和它的属性 value均没有显式指定访问级别,所以它们都拥有默认的访问级别internal。但是该结构体的 numberOfEdits属性使用了private(set)修饰符,这意味着 numberOfEdits属性只能在定义该结构体的源文件中赋值。numberOfEdits属性的 Getter依然是默认的访问级别 internal,但是 Setter的访问级别是 private,这表示该属性只有在当前的源文件中是可读写的,而在当前源文件所属的模块中只是一个可读的属性。

    如果你实例化 TrackedString结构体,并多次对 value属性的值进行修改,你就会看到 numberOfEdits的值会随着修改次数而变化:

    var stringToEdit = TrackedString()
    stringToEdit.value = "This string will be tracked."
    stringToEdit.value += " This edit will increment numberOfEdits."
    stringToEdit.value += " So will this one."
    print("The number of edits is (stringToEdit.numberOfEdits)")
    // 打印 “The number of edits is 3”

    虽然你可以在其他的源文件中实例化该结构体并且获取到 numberOfEdits属性的值,但是你不能对其进行赋值。这一限制保护了该记录功能的实现细节,同时还提供了方便的访问方式。

    你可以在必要时为 Getter和 Setter显式指定访问级别。下面的例子将TrackedString结构体明确指定为了public访问级别。结构体的成员(包括 numberOfEdits属性)拥有默认的访问级别internal。你可以结合public和private(set)修饰符把结构体中的 numberOfEdits属性的 Getter的访问级别设置为 public,而 Setter的访问级别设置为 private:

    public struct TrackedString {
      public private(set) var numberOfEdits = 0
      public var value: String = "" {
        didSet {
          numberOfEdits += 1
        }
      }
      public init() {}
    }

    构造器(Initializers)

    自定义构造器的访问级别可以低于或等于其所属类型的访问级别。唯一的例外是必要构造器,它的访问级别必须和所属类型的访问级别相同。

    如同函数或方法的参数,构造器参数的访问级别也不能低于构造器本身的访问级别。

    默认构造器(Defalut Initializers)

    如默认构造器所述,Swift会为结构体和类提供一个默认的无参数的构造器,只要它们为所有存储型属性设置了默认初始值,并且未提供自定义的构造器。

    默认构造器的访问级别与所属类型的访问级别相同,除非类型的访问级别是public。如果一个类型被指定为public级别,那么默认构造器的访问级别将为internal。如果你希望一个public级别的类型也能在其他模块中使用这种无参数的默认构造器,你只能自己提供一个public访问级别的无参数构造器。

    结构体默认的成员逐一构造器(Default Memberwise Initializerfor Structure Types)

    如果结构体中任意存储型属性的访问级别为 private,那么该结构体默认的成员逐一构造器的访问级别就是private。否则,这种构造器的访问级别依然是internal。

    如同前面提到的默认构造器,如果你希望一个public级别的结构体也能在其他模块中使用其默认的成员逐一构造器,你依然只能自己提供一个public访问级别的成员逐一构造器。


    协议(Protocols)

    如果想为一个协议类型明确地指定访问级别,在定义协议时指定即可。这将限制该协议只能在适当的访问级别范围内被采纳。

    协议中的每一个要求都具有和该协议相同的访问级别。你不能将协议中的要求设置为其他访问级别。这样才能确保该协议的所有要求对于任意采纳者都将可用。

    注意:如果你定义了一个public访问级别的协议,那么该协议的所有实现也会是public访问级别。这一点不同于其他类型,例如,当类型是public访问级别时,其成员的访问级别却只是internal。

    协议继承(Protocol Inheritance)

    如果定义了一个继承自其他协议的新协议,那么新协议拥有的访问级别最高也只能和被继承协议的访问级别相同。例如,你不能将继承自internal协议的新协议定义为public协议。

    协议一致性(Protocol Conformance)

    一个类型可以遵守(conform)比自身访问级别低的协议。例如,你可以定义一个public级别的类型,它可以在其他模块中使用,同时它也可以遵守一个internal级别的协议,但是只能在该协议所在的模块中作为符合该协议的类型使用。

    遵守了协议的类型的访问级别取它本身和所采纳协议两者间最低的访问级别。也就是说如果一个类型是public级别,遵守的协议是internal级别,那么遵守了这个协议后,该类型作为符合协议的类型时,其访问级别也是internal。

    如果你遵守了协议,那么实现了协议的所有要求后,你必须确保这些实现的访问级别不能低于协议的访问级别。例如,一个public级别的类型,采纳了internal级别的协议,那么协议的实现至少也得是internal级别。

    注意:Swift和 Objective-C一样,协议的一致性是全局的,也就是说,在同一程序中,一个类型不可能用两种不同的方式实现同一个协议。

    扩展(Extensions)

    你可以在访问级别允许的情况下对类、结构体、枚举进行扩展。扩展成员具有和原始类型成员一致的访问级别。例如,你扩展了一个public或者internal类型,扩展中的成员具有默认的internal访问级别,和原始类型中的成员一致。如果你扩展了一个private类型,扩展成员则拥有默认的private访问级别。

    或者,你可以明确指定扩展的访问级别(例如,private extension),从而给该扩展中的所有成员指定一个新的默认访问级别。这个新的默认访问级别仍然可以被单独指定的访问级别所覆盖。

    通过扩展添加协议一致性(Adding Protocol Conformance with an Extension)

    如果你通过扩展来遵守协议,那么你就不能显式指定该扩展的访问级别了。协议拥有相应的访问级别,并会为该扩展中所有协议要求的实现提供默认的访问级别。

    泛型(Generics)

    泛型类型或泛型函数的访问级别取决于泛型类型或泛型函数本身的访问级别,还需结合类型参数的类型约束的访问级别,根据这些访问级别中的最低访问级别来确定。


    类型别名(Type Aliases)

    你定义的任何类型别名都会被当作不同的类型,以便于进行访问控制。类型别名的访问级别不可高于其表示的类型的访问级别。例如,private级别的类型别名可以作为 private,file-private,internal,public或者open类型的别名,但是public级别的类型别名只能作为public类型的别名,不能作为 internal,file-private,或private类型的别名。

    注意:这条规则也适用于为满足协议一致性而将类型别名用于关联类型的情况。
    ---------------------
    作者:Longshihua
    来源:CSDN
    原文:https://blog.csdn.net/longshihua/article/details/64442360
    版权声明:本文为博主原创文章,转载请附上博文链接!

  • 相关阅读:
    下载vue-devtools插件的步骤
    弄清 CSS3 的 transition 和 animation
    js与多行字符串
    swift 上手
    liunux 修改hostname
    linux 下使用配置文件
    linux安装oracle11g
    jQueryt过滤选择器
    Javascript并发模型和事件循环
    CSS生僻问题一网打尽
  • 原文地址:https://www.cnblogs.com/xjf125/p/10088307.html
Copyright © 2020-2023  润新知