Swift-style-guide: 프로토콜 명명

C# 이름 스타일을 Swift로 번역하는 것은 어려울 것이라고 생각합니다. 인터페이스의 'I'는 네임스페이스가 다르기 때문에 .NET에서 작동합니다.

동명사("able" 및 "ing")는 영어와 유사하게 작동한다고 생각합니다.
"동명사는 동사에 "-ing"을 붙여 만든 명사입니다.

예: 이 클래스를 해시(동사)해야 합니다. 해시 가능(동명사)입니까? 비교하고 싶습니다(동사), 이 클래스는 비교할 수 있습니까(동명사)?

C#을 보면 모든 인터페이스에 동명사를 사용하지도 않습니다. Point(클래스) 및 IPoint(X 및 Y를 구현하는 인터페이스)를 가져옵니다. 의미 있는 것을 만드는 것은 약간 오해의 소지가 있습니다.

UITableViewDelegate 및 UITableViewDataSource와 같은 프로토콜은 나에게 적합합니다. 나는 개인적으로 ...프로토콜 접미사에 문제가 없지만 일반적인 규칙으로 원하지는 않습니다. 때로는 'able'이 더 잘 작동하고 때로는 ...Delegate 또는 ...DataSource와 같은 다른 접미사가 더 적합합니다.

오늘 만들어지면 UITableViewDelegateType 및 UITableViewDataSourceType이라고 부를 거라고 생각합니다. Greg Heo는 이것을 "is a"라고 부릅니다: http://www.skilled.io/gregheo/what-the-55-swift-standard-library-protocols-taught-me

내 자신의 많은 프로토콜은 하나의 기능이나 속성만 캡슐화합니다. Swift는 프로토콜 이름을 같은 이름으로 지정하는 데 문제가 없으며 매우 깨끗한 접근 방식이라고 생각합니다.

protocol bool {
   var bool: Bool {get}
}

struct Struct: bool {
   let bool = true
}

필요할 때 일반 대리자 및 데이터 소스 명명 규칙을 사용하지만 단순히 개체를 구성하는 데 사용되는 프로토콜의 경우 이름에 Protocol 를 넣었습니다. 이것이 모범 사례인지 아닌지 확실하지 않습니다. 조사했을 때 정보를 찾을 수 없었습니다.

protocol AlertModalProtocol {
func titleText() -> String
func messageText() -> String
}

struct NewUserAlertModal: AlertModalProtocol {

    func titleText() -> String {
        return "Welcome new user"
    }

    func messageText() -> String {
        return "Thanks for joining the app."
    }
}

@mitchellporter 가 하는 것처럼 "프로토콜"을 사용하자는 제안을 보았지만 "유형" 접미사는 공룡의 길을 가고 있는 것 같습니다.

Swift API 디자인 지침에서 :

무엇인가를 설명하는 프로토콜은 명사로 읽어야 합니다(예: 컬렉션). 기능을 설명하는 프로토콜은able, ible 또는 ing 접미사를 사용하여 이름을 지정해야 합니다(예: Equatable, ProgressReporting).

그 흥미 롭군요. 내 경험상, Thing은 전통적으로 비추상 클래스였을 때 ThingType이 필요했습니다. (즉, Thing은 ThingType을 구현하는 구체적인 유형이고 더 구체적인 다른 유형도 ThingType을 구현합니다.) NSObjectProtocol은 이러한 유형의 예입니다.

API 디자인 지침 초안의 라인을 따라 몇 가지 텍스트를 추가하겠습니다.

빠른
다른 사람의 코드를 보면서 문제에 직면했습니다. 무엇인지, 명사일 때 설명하는 프로토콜이 종종 클래스 메서드와 혼동되기 때문에 조용히 불편합니다. 이 문제를 해결하려면 다음 규칙을 사용하는 것이 더 좋습니다.

When the protocol name is a noun - write ..Protocol (yes, even in swift);
예: PhotoModuleProtocol
When the protocol is an adverb or an adjective - write ..able, ..ing and so on;
예: 테스트 가능

내 생각에는 Swift hipster의 것보다 누군가의 코드를 인식하는 시간을 카운트다운하는 것이 무엇인지 명시적으로 지금 밝히는 것이 좋습니다.

2015년에 마지막 댓글을 게시했습니다... 그 이후로 @gregheo가 이전에 공유한 것을 주로 사용하도록 마이그레이션했습니다.

무엇인가를 설명하는 프로토콜은 명사로 읽어야 합니다(예: 컬렉션). 기능을 설명하는 프로토콜은able, ible 또는 ing 접미사를 사용하여 이름을 지정해야 합니다(예: Equatable, ProgressReporting).

예를 들어 일반적으로 다음과 같은 기본 모델 유형이 있습니다.

protocol BaseType {
    var objectId: String { get set }
    var createdAt: NSDate? { get set }
    var updatedAt: NSDate? { get set }
    func toJSON() -> [String: AnyObject]
    static func from(json: [String: AnyObject]) -> AnyObject
}

앱 전체의 모든 모델에는 이 기능이 필요하므로 모두 BaseType 따릅니다. 실제로 앱 이름을 따서 이 기본 유형의 이름을 지정했으므로 앱 이름이 Instagram 이면 InstagramType 됩니다. 지금 생각해보니 이름에 Type 를 포함하는 것은 무의미해 보입니다... 이름을 BaseModel , InstagramModel 또는 심지어 Model .

기능을 설명하는 프로토콜에 관해서는 가능, ible 및 ing 유형 접미사도 사용했습니다.

내 이름에 protocol 라는 단어를 사용하는 것은 중복되는 느낌이 들었고 "이봐, 이것은 클래스가 아닌 프로토콜입니다" 프로토콜은 클래스 위가 아닌 경우 신속하게 클래스와 동일하게 간주되어야 하기 때문에 잘못된 것입니다.

따라서 이름에 프로토콜을 포함하여 단일 항목으로 지정하지 않고 그냥 둡니다. 이것은 단지 나에게 옳다고 느끼는 것이며, 나는 이것이 옳다 그르다를 주장하지 않습니다. 몇 년이 지난 후에도 나는 항상 Swift에서 새로운 것을 발견하고 있으며 모든 것을 알아내려는 시도를 포기했습니다. 실제로 이 시점에서 커뮤니티가 무엇을 제공하는지 실험하고 확인하려고 합니다. :)

그래도 명사로 프로토콜을 명명하면 클래스가 아니라 프로토콜임을 확인하기 위해 단어("..Model", "..Type" 등이 될 수 있음)가 추가됩니다. 이 단어를 사용하는 것만으로 변경 =)