[Swift] Access Control (접근 제어)

Access Control

접근 제어는 다른 소스 파일 및 모듈에 있는 코드의 코드 일부에 대한 접근을 제한한다. 이 기능은 코드의 세부 구현 정보를 숨기고, 해당 코드에 접근하고 사용할 수 있는 기본 인터페이스를 지정할 수 있다.

개별 타입 (클래스, 구조체, 열거형) 뿐만 아니라 해당 타입에 속하는 속성, 메소드, 이니셜라이저 및 서브스크립트에도 특정 접근 레벨을 지정할 수 있다. 프로토콜은 전역 상수, 변수, 함수처럼 특정 컨텍스트로 제한될 수 있다.

Swift는 다양한 레벨의 접근 제어를 제공할 뿐만 아니라 일반적인 시나리오에 대한 기본 접근 레벨을 제공하여 명시적으로 접근 제어 레벨을 지정할 필요성을 줄여준다. 실제로 single-target 앱을 만들 경우, 명시적으로 접근 제어 레벨을 지정할 필요가 없다.

접근 제어를 적용할 수 있는 코드의 다양한 측면 (프로퍼티, 타입, 함수 등)을 간략하게 하기 위해 이제 "Entities"라고 한다.

Modules and Source Files

Swift의 접근 제어 모델은 모듈 및 소스 파일의 개념에 기초한다.

모듈은 코드 배포의 단일 단위로 구축되어 제공되며 Swift의 import 키워드를 사용하여 다른 모듈에서 가져올 수 있는 프레임워크 또는 응용 프로그램이다.

Xcode의 각 빌드 타겟 (앱 번들 또는 프레임워크)은 Swift에서 별도의 모듈로 처리된다. 앱의 코드의 여러 측면을 독립형 프레임워크로 그룹화하면 (아마도 여러 애플리케이션에서 해당 코드를 캡슐화하여 재사용하기 위해) 해당 프레임워크 내에서 정의한 모든 것들은 앱 내에서 가져와 사용하거나 다른 프레임워크 내에서 사용될 때 별도 모듈의 일부가 된다.

소스 파일은 모듈 내의 단일 Swift 소스 코드 파일이다 (사실상 앱 또는 프레임워크 내의 단일 파일). 개별 타입을 분리된 소스 파일에 정의하는 것이 일반적이지만, 하나의 소스 파일에는 여러 타입, 함수 등에 대한 정의가 포함될 수 있다.

Access Levels

Swift는 코드 내의 엔티티에 대해 5가지 접근 레벨을 제공한다. 이 접근 레벨들은 엔티티가 정의된 소스 파일과 관련이 있으며, 소스 파일이 속한 모듈들과도 관련이 있다.

• Open access 와 public access 를 통해 엔티티를 정의한 모듈의 소스 파일 내에서 사용할 수 있으며, 정의한 모듈을 import하는 다른 모듈의 소스 파일에서도 사용할 수 있다. 일반적으로 프레임워크에 대한 공용 인터페이스를 지정할 때 open 또는 public 접근을 사용한다. open 과 public의 차이점은 아래에 설명되어있다.
• Internal access 를 사용하면 정의한 모듈의 모든 소스 파일 내에서 엔티티를 사용할 수 있지만, 해당 모듈 외부의 소스 파일에서는 사용할 수 없다. 일반적으로 앱 또는 프레임워크의 내부 구조를 정의할 때 internal 접근을 사용한다.
• File-private access 는 엔티티의 사용을 자체적으로 정의한 소스 파일로 제한한다. 특정 기능의 세부 정보가 전체 파일 내에서 사용될 경우, 해당 세부 구현 정보를 숨길 때 file-private access를 사용한다.
• Private access 는 엔티티를 포함하는 선언과 같은 파일에 있는 선언의 확장자로 제한한다. 특정 기능의 구현 세부 정보가 단일 선언 내에서만 사용되는 경우, 이러한 세부 정보를 숨길 때 사용한다.

Open access는 가장 높은 (가장 제한적이지 않은) 접근 레벨이며, private access가 가장 낮은 (가장 제한적인) 접근 레벨이다.

Open access는 클래스, 클래스 멤버에게만 적용되며, Subclassing에서 설명한 것처럼 모듈 외부의 코드가 서브클래스와 오버라이드를 허용하기 때문에 public access와는 다르다. 클래스를 open으로 명시한 것은 해당 클래스를 슈퍼 클래스로 사용하는 다른 모듈의 코드가 미치는 영향을 고려했으며 이에 따라 클래스의 코드로 설계했음을 나타낸다.

open > public > internal > file-private > private

Guiding Principle of Access Levels

Swift의 접근 레벨은 전반적인 guiding 원칙을 따른다: 더 낮은 (더 제한적인) 접근 레벨을 가진 다른 엔티티의 용어로 정의될 수 있는 엔티티는 없다.

예를 들면:

• public 변수는 internal, file-private 또는 private 타입을 갖는 것으로 정의할 수 없다. 이 타입은 public 변수가 사용되는 모든 곳에서 사용할 수 없다.
• 함수는 주변 코드에서 구성 타입을 사용할 수 없는 상황에서 사용할 수 있기 때문에 매개변수 타입 및 리턴 타입보다 높은 접근 레벨을 가질 수 없다.

언어의 다양한 측면에 대한 이 guiding 원칙의 구체적인 것들은은 아래에 자세히 설명되어있다.

Default Access Levels

몇 가지 특정 엔티티를 제외하고 코드의 거의 모든 엔티티는 사용자가 직접 명시적으로 접근 레벨을 지정하지 않아도 default 수준의 접근 레벨을 갖는다. 따라서 대부분의 경우 코드에 명시적 접근 레벨을 지정할 필요가 없다.

Access Levels for Single-Target Apps

간단한 single-target 앱을 작성할 때, 앱의 코드는 일반적으로 앱 내에 자체적으로 포함되어 있으므로 앱 모듈 외부에서 사용할 수 있도록 할 필요가 없다. 기본 접근 레벨이 이미 이 요구사항과 일치한다. 따라서 사용자 정의 접근 레벨을 지정할 필요가 없다. 그러나 앱 모듈 내의 다른 코드로부터 구현 세부 정보를 숨기기 위해 코드의 일부를 file-private 또는 private으로 표시할 수 있다.

Access Levels for Frameworks

프레임워크를 개발할 때, 해당 프레임워크에 대한 공용 인터페이스를 open 또는 public으로 표시하여 프레임워크를 import하는 앱과 같은 다른 모듈에서 보고 접근할 수 있도록 한다. 이 public-facing 인터페이스는 프레임워크를 위한 API이다.

프레임워크의 모든 내부 구현 세부 정보는 여전히 기본 접근 레벨인 internal을 사용할 수 있으며, 프레임워크의 내부 코드의 다른 부분에서 숨기려면 private 또는 file-private로 마크하면 된다. 엔티티가 프레임워크 API의 일부가 되기를 바란다면 open 또는 public으로 표시해야한다.

Access Levels for Unit Test Targets

단위 테스트 대상으로 앱을 작성할 때, 테스트를 위해 앱의 코드를 해당 모듈에 제공해야한다. 기본적으로 다른 모듈에서는 open 또는 public으로 표시된 엔티티만 접근할 수 있었다. 하지만 @testable 특성을 가진 프로덕트 모듈을 import하고 프로덕트 모듈의 테스트가 활성화된 상태로 컴파일하는 경우, 유닛 테스트 대상은 내부 엔티티에 접근할 수 있다.

정리

Keyword	Access Level	Inheritance
open	가장 높은 (제한적이지 않은) 접근 레벨으로, 클래스와 클래스의 멤버에서만 사용 가능. 모듈 외부에서도 접근 가능	O
public	모듈 외부에서도 접근 가능.클래스와 구조체 모두에서 사용 가능.	O
internal	같은 모듈 내부에서만 접근 가능. 기본 접근 레벨이므로 표기하지 않아도 된다.	범위 내에서만 가능
file-private	같은 파일 내에서만 접근 가능	범위 내에서만 가능
private	가장 낮은 (제한적인) 접근 레벨으로, 정의한 블록 내부에서만 접근 가능	X

ㅤ

ㅤ

Apple Documentation