API 편집하기
편집을 되돌릴 수 있습니다.
이 편집을 되돌리려면 아래의 바뀐 내용을 확인한 후 저장해주세요.
최신판 | 당신의 편집 | ||
39번째 줄: | 39번째 줄: | ||
API 사용 방법에 대한 제한 사항 및 제한 사항도 문서에서 다르다. 예를 들어, API 함수에 대한 문서는 함수 자체가 되지 않도록, 매개 변수가 널(null) 일 수 없다. 수 스레드 안전 , 또는 감소하는 자기거래를 피한다 프로토콜을 취소할 수 있습니다. [ 설명 필요 ] API 문서는 포괄적인 경향이 있으므로 작성자가 문서를 업데이트한 상태로 유지하고 사용자가 주의 깊게 읽으면 버그가 발생할 수 있다. API 주석은 Java 주석 과 같은 메타 데이터 정보로 보강될 수 있다 . 이 메타 데이터는 컴파일러, 도구 및 런타임 환경에서 사용자 지정 동작 또는 사용자 지정 처리를 구현 하는 데 사용할 수 있다. 데이터 기반 방식으로 API 문서를 생성할 수 있습니다. 주어진 API를 사용하는 많은 수의 프로그램을 관찰함으로써 일반적인 사용법과 필요한 계약 및 지침을 유추할 수 있습니다. 그 후, 템플릿은 채취된 데이터로부터 자연 언어를 생성하는데 사용될 수 있다. | API 사용 방법에 대한 제한 사항 및 제한 사항도 문서에서 다르다. 예를 들어, API 함수에 대한 문서는 함수 자체가 되지 않도록, 매개 변수가 널(null) 일 수 없다. 수 스레드 안전 , 또는 감소하는 자기거래를 피한다 프로토콜을 취소할 수 있습니다. [ 설명 필요 ] API 문서는 포괄적인 경향이 있으므로 작성자가 문서를 업데이트한 상태로 유지하고 사용자가 주의 깊게 읽으면 버그가 발생할 수 있다. API 주석은 Java 주석 과 같은 메타 데이터 정보로 보강될 수 있다 . 이 메타 데이터는 컴파일러, 도구 및 런타임 환경에서 사용자 지정 동작 또는 사용자 지정 처리를 구현 하는 데 사용할 수 있다. 데이터 기반 방식으로 API 문서를 생성할 수 있습니다. 주어진 API를 사용하는 많은 수의 프로그램을 관찰함으로써 일반적인 사용법과 필요한 계약 및 지침을 유추할 수 있습니다. 그 후, 템플릿은 채취된 데이터로부터 자연 언어를 생성하는데 사용될 수 있다. | ||
− | + | ==디자인== | |
API 디자인은 사용에 상당한 영향을 미민다. 정보 숨기기 의 원칙은 모듈 사용자가 모듈 내부의 복잡성을 이해할 필요가 없도록 모듈의 구현 세부 사항을 숨겨 모듈 식 프로그래밍 을 가능하게 하는 프로그래밍 인터페이스의 역할을 설명합니다. 따라서, API의 디자인은 사용자가 기대할 수 있는 유일한 도구를 제공하려고 한다. 프로그래밍 인터페이스의 설계 는 복잡한 소프트웨어를 구성하는 소프트웨어 아키텍처 의 중요한 부분을 나타낸다 . | API 디자인은 사용에 상당한 영향을 미민다. 정보 숨기기 의 원칙은 모듈 사용자가 모듈 내부의 복잡성을 이해할 필요가 없도록 모듈의 구현 세부 사항을 숨겨 모듈 식 프로그래밍 을 가능하게 하는 프로그래밍 인터페이스의 역할을 설명합니다. 따라서, API의 디자인은 사용자가 기대할 수 있는 유일한 도구를 제공하려고 한다. 프로그래밍 인터페이스의 설계 는 복잡한 소프트웨어를 구성하는 소프트웨어 아키텍처 의 중요한 부분을 나타낸다 . | ||
몇몇 저자들은 Joshua Bloch , Kin Lane, 및 Michi Henning과 같은 API 설계 방법에 대한 권장 사항을 작성했다. 원격 API의 디자인과 진화 패턴은 일련의 EuroPLoP 논문에서 다룬다. | 몇몇 저자들은 Joshua Bloch , Kin Lane, 및 Michi Henning과 같은 API 설계 방법에 대한 권장 사항을 작성했다. 원격 API의 디자인과 진화 패턴은 일련의 EuroPLoP 논문에서 다룬다. |