IT News #1) MS,API 개발 설계 언어로 '캐들' 선택

https://www.codingworldnews.com/news/articleView.html?idxno=14133 

MS, API 개발 설계 언어로 '캐들' 선택 - 코딩월드뉴스

Cadl

캐들 용어에 들어가기 전, API가 무엇인지 살펴보자.

API의 정의부터 보면, 'Application Programming Interface'의 약자로서 운영체제와 응용프로그램 사이의 통신에 사용되는 언어나 메시지 형식을 이야기한다.

​

---

가게의 점원 같은 역할, API

 

먼저 API란, 점원은 손님의 주문을 받아 요리사에게 전달하고, 반대로 요리사에게 받은 음식을 손님에게 전한다. 점원의 역할처럼 API는 중간 전달자의 역할은 한다.

​

요리사와 손님을 각 서버라고 한다면 API는 중간에서 양쪽의 서버를 연결!!

 

https://m.blog.naver.com/PostView.naver?blogId=kistiscienceon&logNo=222722915536&navType=by 

API 뜻? 오픈 API? 쉽게 설명해줄게~

 

캐들 Cadl

캐들은 .NET과 일부 유사한 자바스크립트와 유사한 언어다. 마이크로소프트는 C#에 익숙한 사람이라면 누구나 쉽게 사용할 수 있도록 ‘API용 TypeScript’라고 설명했다. 비주얼 스튜디오 및 비주얼 스튜디오 코드의 언어 서버에 캐들 확장을 추가해 기본 제공 구문 강조 표시, 코드 완성, linting에서 지원을 받을 수 있다. 

 

장점

1. 디자인을 추상화해, 더 간결한 출력을 제공

->  비주얼 스튜디오와 같은 플랫폼의 OpenAPI 도구가 빠르고 효율적으로 구문 분석 가능

2. 캐들을 사용하면 50줄의 코드로 500줄 OpenAPI 정의 가능

=> 설계자와 개발자가 API를 구성하고 제한하는 논리적인 방법이다.

 

 

캐들에서 API 정의 작성법

1. 일반적으로 캐들 코드의 기본 파일에서 REST 및 OpenAPI 바인딩을 해야 한다.

캐들에서 키워드는 ‘데코레이터’라고 하며 @로 시작해 파일을 사람이 읽을 수 있도록 한다. 정의는 서비스 정의로 시작해 서비스에 이름을 지정하고 버전 번호를 지정해야 한다. 다음에 엔드포인트에 대한 URI가 있는 서버 정의를 추가할 수 있다. 전 세계적으로 분산된 시스템에 유용한 이 기능은 API를 사용할 수 있는 지역과 같은 추가 매개변수를 추가할 수 있다. 이는 애저(Azure)를 염두에 두고 설계된 것이지만, 여러 엔드포인트가 있는 분산 시스템에 유용하다.

2. API에서 사용하는 경로와 리소스를 정의한다.

경로는 서비스 URI에 상대적인 리소스 경로이며 API 작업을 래핑하는 네임스페이스에 연결된다. 작업은 예상되는 HTTP 동사를 사용하거나 목록과 같은 기능으로 정의된다. 이름이 사용되는 경우 컴파일러는 API를 생성할 때 적절한 동사를 추가한다. 이는 REST API 호출의 요청 본문을 정의할 수 있으므로 이를 사용해 복잡한 API에 JSON을 보내거나 비교적 기본적인 것에 대한 간단한 텍스트를 보낼 수 있다.

API가 더 복잡할 때는 자동 경로 지정 옵션은 매개변수를 사용해 경로를 생성할 수 있다. 사용자 이름이나 ID를 경로에서 예상하는 API에 전달하는 때를 예시로 언급할 수 있다. 경로에 매개변수를 전달하는 것으로 제한되지 않는다.

URL 쿼리로 전달하는 옵션이 있다. 결과는 Express node.js 애플리케이션 프레임워크 작업을 연상시키는 REST API를 정의하는 비교적 간단한 방법이다. 주로 캐들이 서비스 호출을 위한 URL을 구성하고 API를 코드로 추상화하기 때문이다. 

API 정의 작성은 캐들 기능 중 일부 기능에 해당한다. 더 중요한 것은 API를 제공하는 데 사용해야 하는 구조를 제공해 개발팀에 API 표준을 적용하는 것이다. 캐들 정의 표준을 구축하기 위한 핵심 요소는 라이브러리를 생성하는 것이다. 

라이브러리로 캐들 정의의 표준을 확립한다면, C#과 매우 유사한 구문으로 공통 함수에 대한 재사용 가능한 템플릿을 관리할 수 있다. 또, 마이크로소프트는 이를 사용해 애저 API 기능을 구현하는 방법을 살펴볼 가치가 있다. 

예를 들어, API의 기능을 자세히 설명하는 REST API 형식을 정의하는 일반 인터페이스를 만들 수 있다. 라이브러리가 있으면 API 인터페이스를 확장해 라이브러리 템플릿을 사용해 경로에 매핑하고 적절하게 태그를 지정할 수 있다. 다음으로 모델 정의를 사용해 예상 응답을 나열하는 API를 생성한다.

 

---

Comments

프로그래밍 언어가 계속해서 나오고 있어서 다 공부해야 하나 부담이 있었는데, C#과 비슷하다고 하니 다행이다.