어느 것이 더 낫습니다 : getters 또는 선택 문자열 매개 변수가있는 1 개의 메소드?

우리의 지식 영역은 맨발로 압력판을 걷는 사람들과 관련이 있습니다. 센서 데이터에서 사람의 발이 인식되면 '발'클래스의 물체를 만드는 이미지 인식을 수행합니다.

발 데이터에 대해 몇 가지 계산을 수행해야합니다.

이제 어떤 API가 더 좋을까요?

class Foot : public RecognizedObject  { 
  MaxPressureFrame getMaxPressureFrame();
  FootAxis getFootAxis();
  AnatomicalZones getAnatomicalZones();

  // + similar getters for other calculations

  // ...
}

또는:

class Foot : public RecognizedObject {
  virtual CalculationBase getCalculation(QString aName);

  // ...
}

지금, 내가 생각해 낼 수있는 많은 장단점이 있지만, 어느 것이 가장 중요한지를 결정할 수는 없습니다. 이것은 우리가 판매하는 소프트웨어 라이브러리가 아닌 최종 사용자 응용 프로그램입니다.

어떤 충고?

첫 번째 접근 방식의 일부 전문가는 다음과 같습니다.

• 키스-모든 것이 매우 구체적입니다. API이지만 구현도 마찬가지입니다.
• 강력한 형식의 반환 값
• 이 클래스에서 상속하는 것은 바보입니다. 재정의 할 수 없으며 추가 만 할 수 있습니다.
• API는 매우 닫히고 아무것도 들어 가지 않으며 재정의 할 수 없으므로 잘못 될 수 있습니다.

일부 단점 :

• 우리가 발명 한 모든 새로운 계산이 목록에 추가됨에 따라 게터의 수가 늘어날 것입니다.
• API가 변경 될 가능성이 더 높으며 주요 변경 사항이 도입되면 새로운 API 버전 인 Foot2가 필요합니다.
• 다른 프로젝트에서 클래스를 재사용하는 경우 모든 계산이 필요하지 않을 수 있습니다

두 번째 접근 방식의 일부 전문가 :

• 더 유연한
• api는 변경 될 가능성이 적습니다.

일부 단점 :

• 느슨하게 입력했습니다. 모든 통화에 캐스트가 필요합니다.
• 문자열 매개 변수-그것에 대해 나쁜 감정을 가지고 있습니다 (문자열 값에서 분기 ...)
• 추가 유연성을 요구하는 현재 사용 사례 / 요구 사항은 없지만 앞으로있을 수 있습니다.
• API는 제한 사항을 부과합니다. 모든 계산은 기본 클래스에서 파생되어야합니다. 이 1 가지 방법을 통해 계산을 수행해야하며, 매개 변수를 전달하는 훨씬 더 역동적이고 초 유연한 방법을 고안하지 않으면 추가 매개 변수를 전달하는 것이 불가능합니다.

나는 첫 번째 접근법에서 돈을 지불 할 것이라고 생각합니다. 마술 문자열은 다음과 같은 문제를 일으킬 수 있습니다. 입력 오류, 오용, 사소한 반환 유형 안전, 코드 완성 부족, 불분명 한 코드 (이 버전에 해당 기능이 있습니까? 런타임에 알게 될 것입니다). 열거 형을 사용하면 이러한 문제 중 일부가 해결되지만 제기 한 단점을 살펴 보겠습니다.

• 우리가 발명 한 모든 새로운 계산이 목록에 추가됨에 따라 게터의 수가 늘어날 것입니다.

사실, 그것은 성가 시게 할 수 있지만, 일을 멋지고 엄격하게 유지하고 최신 IDE에서 프로젝트의 어느 곳에서나 코드 완성을 제공하며 열거 형보다 훨씬 유용한 제목 주석이 있습니다.

• API가 변경 될 가능성이 더 높으며 주요 변경 사항이 도입되면 새로운 API 버전 인 Foot2가 필요합니다.

사실, 그것은 실제로 거대한 프로입니다.) 부분 API에 대한 인터페이스를 정의 할 수 있으며 최신 API의 영향을받지 않는 종속 클래스를 다시 컴파일 할 필요가 없습니다 (Foot2가 필요 없음). 이를 통해 더 나은 분리가 가능해지며, 종속성은 이제 구현이 아니라 인터페이스에 있습니다. 또한 기존 인터페이스가 변경되면 종속 클래스에서 컴파일 오류가 발생하여 오래된 코드를 방지하는 데 좋습니다.

• 다른 프로젝트에서 클래스를 재사용하는 경우 모든 계산이 필요하지 않을 수 있습니다

마법의 문자열이나 열거 형을 사용하는 것이 어떻게 도움이되는지 모르겠습니다 ... 올바르게 이해하면 Foot 클래스에 코드를 포함 시키거나 몇 개의 작은 클래스로 나누면 두 옵션 모두에 해당됩니다.

옵션 3을 권장합니다. 계산은 추상화의 본질적인 부분이 Foot아니라 작동합니다. 그런 다음 Foot계산을 다음 과 같이 별도의 클래스로 나눌 수 있습니다 .

class Foot : public RecognizedObject {
public:
    // Rather low-level API to access all characteristics that might be needed by a calculation
};

class MaxPressureFrame {
public:
    MaxPressureFrame(const Foot& aFoot); // Performs the calculation based on the information in aFoot
    //API for accessing the results of the calculation
};

// Similar classes for other calculations

이 방법으로 계산을 강력하게 입력 할 수 있으며에 노출되는 정보의 양에 심각한 오류가없는 한 기존 코드에 영향을주지 않고 새로운 계산을 추가 할 수 있습니다 Foot.