.NET에서 문서화되지 않은 API/프레임 워크를 다루는 방법은 무엇입니까? [닫은
https://stackoverflow.com/questions/211920
-
03-07-2019 - |
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
Russian문제
작업을 위해서는 독점 데이터베이스 솔루션을 처리하기 위해 외부 회사의 API로 코딩해야합니다. 불행히도 그들이 제공하는 문서는 적절한 API 문서와 적절한 API 문서의 예제 가이드에 가이드에 있으므로 오류 코드, 메소드 리턴 및 예외와 같은 끔찍한 세부 사항에 대해 매우 가볍습니다.
예를 들어, 클래스에는 .getErrorCode () 메소드가 있지만 오류 번호가 어떤 오류와 일치하는지 문서화하지 않았기 때문에 해당 오류 번호가 무엇을 의미하는지 모르겠습니다. 많은 경우에 메소드는 실제로 반환되는 객체 유형에 대한 문서화없이 객체를 반환합니다. 나는 그들에게 적절한 문서화를 반복적으로 요청했지만 위의 세부 사항이 적절한 비밀이라고 생각하는 것 같습니다. 따라서 제한적 또는 경우에도 존재하지 않는 문서를 둘러 볼 수있는 도구 나 방법이 있습니까?
Visual Studo 2005를 사용하고 있으며 .NET 아래 C#에서 코딩하고 있습니다.
그리고 누군가가 "API를 사용하지 마십시오"라고 대답하기 전에, 그것은 일을위한 것입니다.
해결책
불쾌한 시나리오. 나는 그것을 제안하는 것을 싫어하지만 아마도 반사기 난독 화되지 않은 경우 친구입니다. 일부 IP 문제가있을 수 있지만이 경우 반전되는 것은 API가 무엇인지 알아내는 유일한 방법 인 것 같습니다. 그러나 (.geterrorCode ()와 같은 메소드에서)는 이것이 P/Invoke 위에있는 심이라고 생각합니다.
내가 말할 수있는 주요 다른 것은 : 쓰기 많이 당신이 그것을 어떻게 사용하려고하는지 포괄하는 단위 테스트의 ... 그렇게 생각하고 무언가가 바뀌면 일찍 알게 될 것입니다.
다른 팁
코드 샘플을 받거나 원래 개발자와 대화 할 수 없다면 나는 보통 반사기 기본 코드를 보려면. 느리고 비효율적이지만 때로는 그것이 당신이 할 수있는 전부입니다.
그것은 당신의 상황에 달려 있습니다. API 비용을 지불하는 경우 API 사용 방법에 대한 더 나은 문서화를 위해 회사에 계속 압력을 가해야합니다.
그것이 효과가 없다면, 내가 할 일은 내가 개발할 때 내 문서를 시작하는 것입니다. 노트북, 개인 위키 (나사 위키 ) 또는 일종의 전자 문서화. 다른 사람들이 언급했듯이 반사판을 사용하여 소스에 도달하는 데 도움이 될 수 있습니다 (난독 화되지 않은 경우).
자신의 문서를 작성하는 것이 아니라는 것이 아닐 수도 있지만, 실제 문서를 얻을 수 없다면 적어도 몇 달 (또는 몇 년)을 안내 할 무언가를 가질 수 있도록 적어도 일부를 배우면서 일부를 만들 수 있습니다. API로 구축 된 코드를 유지하려고 할 때.
떠오르는 최고의 도구에는 전화 및 이메일이 포함됩니다. 바라건대 당신은 그들이 당신에게 더 유용한 정보를 줄 때까지 사람들을 계속 괴롭힐 수 있기를 바랍니다 ... :(
사용 반사기 소스 코드를 보려면. GetErrorCode 메시지에 대한 열거를 표시해야합니다.
그건 그렇고, 반사판은 우주의 역사상 가장 위대한 프로그램입니다.
