깃털에 대한 초보자 가이드

Jennifer Aniston원래의: 2025-02-14 09:55:131015검색

<..> Feathers.js : 편안한 API 서버를 신속하게 구축하는 안내서

A Beginner’s Guide to Feathers.js 코어 포인트 :

<.> Feathers.js는 RESTFUL API 서버의 생성을 단순화하고, 반복적 인 백엔드 작업의 대부분을 처리하며, 개발자가 코드 사용자 정의 및 구성에 집중할 수 있도록합니다. 이 프레임 워크는 Express를 기반으로하며 SQL 및 NOSQL 데이터베이스를 지원하며 필요한 코드를 자동으로 생성하는 서비스를 사용하여 CRUD 작업을 쉽게 수행 할 수 있습니다. Feathers.js에서의 인증은 JSON Web Tokens (JWT)를 사용하여 API 엔드 포인트를 보호하여 승인 된 사용자 만 데이터에 액세스하거나 수정할 수 있습니다.

Feathers.js의 고리는 데이터가 데이터베이스에 도달하기 전이나 후에 데이터를 조작하는 미들웨어 기능 역할을합니다. 이는 검증, 권한 부여 및 동적 추가 필드와 같은 작업에 매우 유용합니다.

Application Server라고도하는 API 서버는 프론트 엔드 애플리케이션에 데이터를 제공하는 프로그램입니다. 또한 백엔드에서 비즈니스 로직을 처리하고 조직의 데이터베이스에 대한 제한된 액세스를 제공합니다. 무단 사람들이 데이터에 액세스하는 것을 방지 할뿐만 아니라 로그인 한 사용자가 허가를받지 않으면 액세스 또는 변경을 제한 할 수 있습니다.

당신이 구축 한 모든 응용 프로그램은 최종 사용자에게 서비스를 제공해야합니다. 이를 위해서는 응용 프로그램이 데이터를 처리해야합니다. 원격 API를 사용하여 새 서비스를 만들 수 있습니다. 그러나 대부분의 응용 프로그램의 경우 자체 데이터 저장을 관리해야합니다. 인기있는 옵션은 FireBase와 같은 온라인 데이터 스토리지 서비스를 사용하는 것입니다. 이렇게하면 분산 데이터베이스 서버 실행에 대한 지루한 세부 사항을 처리 할 필요가 없습니다. 그러나 프로젝트 요구 사항에는 MongoDB 또는 Oracle과 같은 완전한 기능을 갖춘 내부 데이터베이스 관리 시스템이 필요할 수 있습니다. 프론트 엔드 애플리케이션이 데이터베이스에 저장된 데이터에 액세스하려면 데이터베이스와 프론트 엔드 애플리케이션 사이에있는 서버 응용 프로그램이 필요합니다.

위 이미지에 표시된대로, 애플리케이션 서버의 작업은 SQL 또는 NOSQL 명령을 사용하여 데이터베이스의 데이터에 액세스하고 프론트 엔드 애플리케이션 (클라이언트 브라우저)이 JSON과 같이 이해할 수있는 형식으로 변환하는 것입니다. . 또한 애플리케이션 서버는 HTTPS 암호화 및 토큰 인증과 같은 다양한 보안 프로토콜을 사용하여 데이터베이스와 클라이언트 애플리케이션 간의 통신이 안전하고 신뢰할 수 있도록 할 수 있습니다. 이 아키텍처를 사용하는 주요 장점 중 하나는 동일한 애플리케이션 서버를 사용하여 다른 플랫폼, 모바일, 웹 등 다양한 플랫폼에 응용 프로그램을 배포 할 수 있다는 것입니다. 또한 더 많은 사용자에게 효율적으로 서비스를 제공하고 빠른 응답 시간을 달성하기 위해 응용 프로그램을 가로로 확장하기 쉽습니다.

우리는 간단한 API 서버를 구축하고 깃털이 제공하는 다양한 기능을 보여줄 것입니다.

전제 조건 :

이 튜토리얼을 시작하기 전에 다음 주제에 대한 탄탄한 기초가 있어야합니다. es6 javaScript 익스프레스 응용 프로그램 생성 express 를 사용하여 편안한 API를 만듭니다

깃털은 Node.js의 미니멀리스트 웹 프레임 워크 인 Express 위에 제작되었습니다. 링크에서 시연 된 튜토리얼을 완료하면 Express 만 사용하여 RESTFUL API를 구축하는 것이 매우 힘들 것입니다. 깃털을 사용하면 대부분의 반복적 인 작업이 이루어집니다. 코드 구성 및 사용자 정의에 집중하면됩니다. 코드를 파고이 웹 프레임 워크가 어떻게 작동하는지 알아 보겠습니다.

프로젝트 생성 :

깃털 사용을 시작하려면 전 세계적으로 명령 줄 애플리케이션을 설치해야합니다.

다음, 다음 명령을 사용하여 새 API 프로젝트를 만듭니다.

다음은 제 선택입니다. 원하는 테스트 프레임 워크를 선택할 수 있습니다. 불행히도, 테스트는이 기사의 초점 내에 있지 않으므로 여기에서는 다루지 않습니다. 나는 개인적으로 단순성을 좋아하기 때문에 농담을 선택한 이유입니다.

설치가 완료되면 좋아하는 코드 편집기를 열어 프로젝트 파일을 볼 수 있습니다.

전제 조건 섹션에 나열된 Express Tutorial을 작성하면 생성 된 코드가 귀하를 놀라게해서는 안됩니다. 다음은 폴더와 파일을 설명하는 짧은 요약입니다.

이제 각 파일의 역할에 대해 너무 걱정하지 마십시오. 이 튜토리얼을 살펴보면이 튜토리얼이 어떻게 작동하는지에 대해 자세히 알아볼 수 있습니다. 이제 테스트가 제대로 작동하고 있는지 확인해 봅시다. 코드 스타일 확인 (Linting) : 우리 프로젝트가 정의 된 eslint 규칙을 준수하는지 확인하려면 명령을 실행하십시오. UNIX 또는 Linux 플랫폼을 사용하는 경우 제대로 작동합니다. Windows를 사용하는 경우 테스트를 성공적으로 실행하기 위해 무언가를 조정해야합니다.

먼저,

로 이동하여 섹션을 봅니다. 라인을 다음과 같이 변경하십시오

다음, Visual Studio Code에 더 예쁘게 설치 한 경우 작업 영역 설정 탭에서 단일 견적 설정을 true로 변경해야합니다.

<code class="language-bash">npm install -g @feathersjs/cli</code>

마지막으로 파일을 작성하거나 편집 할 때 Newline이 LF인지 확인하십시오. Visual Studio Code 또는 이와 유사한 편집자를 사용하는 경우 상태 표시 줄에서 현재 Newline 스타일을 확인할 수 있습니다. CRLF가 표시되면 LF로 변경하십시오. 이러한 변경을 수행하면 코드 스타일 확인 테스트를 통과하는 데 도움이됩니다. 불행히도 테스트를 통과하려면 더 많은 작업이 필요하며 여기에 소개되지 않습니다.

CRUD RESTFUL 인터페이스를 생성하는 방법을 살펴 보겠습니다.

서비스 생성 :

<code class="language-bash">mkdir contacts-api
cd contacts-api
feathers generate app</code>

Express에서 편안한 CRUD API 인터페이스를 구축하려면 일부 작업이 필요합니다. 깃털에서 단순히 단일 명령을 실행하고 몇 가지 질문에 답변하여 코드를 생성 할 수 있습니다.

이 자습서에서는 NEDB 데이터베이스를 사용합니다. 깃털은 SQL 데이터베이스 (예 : MySQL) 및 NOSQL 데이터베이스 (예 : MongoDB)를 지원합니다. 그러나 컴퓨터 나 클라우드 서버에 데이터베이스 시스템을 설치하는 데 시간이 걸립니다. 반면에 NEDB는 MongoDB API의 하위 집합을 지원하는 JavaScript로 완전히 작성된 메모리 인 데이터베이스입니다. 구성이 필요하지 않습니다. 새로운 응용 프로그램을 프로토 타이핑 및 테스트하는 데 적합합니다. 이것은이 튜토리얼에서 사용할 데이터베이스입니다.

이 명령을 사용하여 생성 된 일부 파일을 간략하게 살펴 보겠습니다.

<code class="language-bash">npm install -g @feathersjs/cli</code>

. 이것은

에 대한 CRUD API 엔드 포인트를 제공하는 깃털 서비스입니다. 아주 작습니까? 깃털이 우리를 위해 무거운 리프팅을했기 때문입니다. Boilerplate Crud 코드를 작성하지 못하게됩니다.

. 여기서 우리는 CRUD 논리의 동작을 사용자 정의합니다. 깃털이 데이터베이스를 읽거나 쓰기 전에 데이터를 확인하거나 변경할 수있는

섹션이 있습니다. 또한 데이터베이스에서 클라이언트 응용 프로그램으로 보내기 전에 결과를 확인하거나 변경할 수있는 섹션도 있습니다. 액세스 제한, 데이터 검증, 조인 작업 수행 및 추가 필드 또는 열의 값 계산과 같은 작업을 수행 할 수 있습니다.

services/contacts/contact.service.js . 여기서는 모델을 정의하고 데이터베이스 테이블에 추가합니다. 또한 새 레코드가 삽입되거나 업데이트 될 때 필드를 확인하는 데 사용할 수있는 패턴을 정의하는 곳입니다. 불행히도 NEDB는 모드를 지원하지 않습니다. 그러나 Mongoose 어댑터를 통해 모드 기능을 지원하는 MongoDB에 연결된 모델의 예를 제공했습니다. /contacts

NEDB의 일부 제한 사항에도 불구하고 여전히 프로토 타이핑에 매우 적합한 데이터베이스입니다. 대부분의 NOSQL 데이터베이스를 사용하면 스키마를 먼저 정의하지 않고 모든 구조를 사용하여 데이터를 제출할 수 있습니다. 프로젝트 요구 사항을 구현 한 후 모델을 구현하는 것이 가장 좋습니다. 패턴으로 깃털은 정의한 규칙을 사용하여 필드 검증을 수행합니다. 스키마를 정의하려면 생산 준비 데이터베이스 (예 : MongoDB)가 필요합니다. 개발 데이터베이스의 구성 정의는

: 에 있습니다. services/contacts/contact.hooks.js
이것은 데이터베이스 자격 증명이 제공되는 곳입니다. 또 다른 구성 파일 before가 있습니다. 이것은 깃털 응용 프로그램을 배포 할 때 사용되는 생산 데이터베이스 구성입니다. 개발 중에 별도의 데이터베이스를 사용하는 것이 중요합니다. 그렇지 않으면 생산 데이터베이스에서 비즈니스 운영 데이터를 삭제하거나 손상시킬 위험이 있습니다. after
이제 우리는 연락처의 CRUD 서비스를 설정 했으므로 이제 시도해 볼 차례입니다. 명령 를 사용하여 Feather Server를 시작할 수 있습니다. 이 서버는 핫 재 장전을 지원하지 않습니다. 따라서 코드를 변경할 때마다 다시 시작해야합니다. Feathers 응용 프로그램과 상호 작용하려면 Postman 또는 Insomnia와 같은 API 브라우저 도구가 필요합니다. 이 튜토리얼에서는 불면증을 사용 하겠지만 Postman 또는 다른 도구로 쉽게 수행 할 수 있습니다.
새 GET 요청을 작성하고 ( ctrl npm start 를 누르고) "List Contact"라고 이름을 지정하십시오. URL 섹션에서 를 입력하십시오. "보내기"버튼을 클릭하면 다음보기가 표시됩니다.
아무것도! 데이터베이스는 현재 비어 있으므로 새로운 연락처를 만들어야합니다. Create Contact라는 새 요청을 만듭니다. 다음과 같이 나머지 필드를 채우십시오 게시 할 위의 양식의 메소드를 변경하는 것을 잊어 버리면 나중에 변경할 수 있습니다. 메소드를 게시하고 바디 탭을 JSON으로 변경하십시오. 다음 데이터를 JSON 탭에 복사하십시오 http://localhost:3030/contacts "보내기"버튼을 클릭하면 다음 응답을 받아야합니다. 새로운 연락처를 위해 A가 생성되었습니다.

"연락처 목록"으로 돌아가서 "보내기"버튼을 다시 클릭하십시오. 다음과 같은 결과를 얻어야합니다.

"연락처 생성"으로 돌아가서 몇 가지 새로운 기록을 게시하십시오.

지금 업데이트 작업을 수행하겠습니다. 이를 위해 업데이트 HTTP 메소드를 사용하지 않습니다. 이 방법은 레코드를 완전히 덮어 씁니다. 우리가하고 싶은 것은 전체 레코드가 아닌 단일 필드를 덮어 쓰는 것입니다. 이를 위해 패치를 사용합니다. 다음과 같이 새 요청 "업데이트"를 작성하십시오.
URL 필드에서
를 입력하십시오. 첫 번째 레코드의 ID로
를 교체하십시오. 다음 데이터를 JSON 탭에 붙여 넣습니다
"보내기"버튼을 클릭하십시오. 다음과 같은 결과가 표시됩니다.
<code class="language-bash">npm install -g @feathersjs/cli</code>

_id 나머지 필드는 변경되지 않은 상태로 유지됩니다. 다음으로 레코드를 삭제합니다. 쉽습니다. 새 삭제 요청을 작성하고 "연락처 삭제"라는 이름을 만듭니다. URL 필드에서 형식
를 사용하십시오. 이전과 마찬가지로 를 삭제하려는 레코드의 ID로 바꾸십시오. "보내기"를 클릭하면 레코드가 삭제됩니다. 목록 연락처 요청을 다시 실행하여 확인할 수 있습니다. http://localhost:3030/contacts/{_id} 우리는 방금 모든 CRUD 작업이 제대로 실행되고 있음을 확인했습니다. 다음 섹션에서는 인증을 설정하는 방법을 배웁니다. {_id}
(다음 내용은 원래 텍스트와 유사하지만 일부 진술 조정 및 단락 병합은 가독성과 유창성을 개선하고 원래 의도를 변경하지 않도록하기 위해 만들어졌습니다. 이미지 형식은 변경되지 않았습니다.)

인증 :
현재 API 엔드 포인트는 보호되지 않습니다. 응용 프로그램을 클라우드 서버에 배포하면 URL이있는 사람이라면 누구나 레코드에 액세스하고 작동 할 수 있습니다. 액세스를 제한하려면 인증을 설정해야합니다. JSON 웹 토큰을 사용하여 API 응용 프로그램에 대한 인증을 구현합니다. 다음 명령을 실행하여 설정하십시오 보시다시피, 깃털은 다양한 사용자 인증 방법을 지원합니다. "로컬 사용자 이름 비밀번호"옵션이 가장 쉽습니다. 다음 옵션을 선택하십시오 다음으로 새 사용자를 만들어야합니다. 불면증 또는 기타 API 브라우저 도구를 사용하여이를 수행 할 수 있습니다. 새 요청을 만들고 "사용자 생성"이름을 지정하십시오.
JSON 탭에서 다음 데이터를 보내십시오
당신은 다음과 유사한 응답을 받아야합니다 : 우리는 이제 사용자가 있습니다. 새로운 요청 "목록 사용자"를 작성하고 URL 를 보내서이를 확인해 봅시다. 불행히도, 당신은 다음의 응답을 받게됩니다 :
이 데이터에 액세스하려면 인증해야합니다. 로그인하는 데 사용할 수있는 프론트 엔드 응용 프로그램이 없으므로 API 브라우저를 계속 사용합니다. 새 요청을 만들고 "JWT 토큰을 얻으십시오"라는 이름을 지정하십시오. 다음과 같이 양식을 작성하십시오
이 요청은 POST 메소드를 사용합니다. 더 명확하게하려면 "로그인"으로 이름을 바꿀 수 있습니다. JSON 탭에서 다음 데이터를 복사하십시오
보내기 버튼을 클릭 한 후 다음 응답을 받아야합니다. 토큰 코드를 복사하십시오 (이중 인용문없이). 목록 사용자 요청 페이지로 이동하여 인증 탭을 선택하고 베어러를 선택하십시오. 이 토큰 코드를 토큰 필드에 붙여 넣으십시오. /contacts "보내기"버튼을 클릭 한 후 사용자 목록이 표시됩니다. 당사의 인증 시스템은 완전히 안전하지 않습니다. 를 열고 다음 코드 스 니펫을 업데이트하십시오.이렇게하면 인증 된 사용자 만 새 계정을 생성 할 수 있습니다. 다음 단계는
엔드 포인트를 보호하는 것입니다. 파일 를 열고 그에 따라 업데이트하십시오 코드 변경을 위해 깃털 서버를 다시 시작하십시오. 목록 연락처 요청을 실행하려고하면 다음 응답을 받게됩니다. /contacts 인증하려면 이전과 같이 베어러 토큰을 설정해야합니다. 이 작업을 마치면 요청을 보낼 수 있으며 연락처 목록을 받아야합니다. 이전에 얻은 토큰은 하루 만에 만료됩니다. 효율성을 위해서는 환경 변수를 사용하여 모든 API 요청 매개 변수를 한 번에보다 쉽게 업데이트 할 수 있도록하는 것이 가장 좋습니다. 프론트 엔드 애플리케이션을 구축 할 때는이 토큰을 로컬 스토리지에 저장해야합니다. 쿠키를 사용하지 마십시오. 그렇지 않으면 응용 프로그램이 CSRF 공격에 취약합니다. 알아야 할 다른 보안 위험은 Feathers 보안 문서를 확인하십시오. services/contacts/contacts.hooks.js 이제 인증을 설정 했으므로 나중에 생성 된 새로운 서비스는 새로운 엔드 포인트를 보호 할 수있는 옵션을 제공합니다. 다음 섹션 에서이 튜토리얼의 마지막 주제를 확인해 봅시다.
후크 :
Hook는 오류가 발생하거나 오류가 발생한시기 서비스 방법에 첨부 된 미들웨어 함수입니다. 그들은 종종 로깅을 처리하고, 액세스를 제한하고, 필드를 보호하고, 관련 엔티티를 채우고, 알림 보내기 등을 사용하는 데 사용됩니다. 당신이 를 보면, 내장 깃털 고리가 사용되는 것을 볼 수 있습니다. 우리는 우리 자신의 커스텀 후크를 만들 것입니다. 먼저 서버를 중지하고
데이터베이스 테이블을 삭제하십시오. 다음으로 다음 명령을 사용하여 새 후크를 생성하십시오.
다음 옵션으로 사용자 정의 후크를 만듭니다 이 후크에서 우리가하고 싶은 것은 "연락처 작성"요청을 처리하기 전에 두 개의 새 필드를 주입하는 것입니다.

: 현재 로그인 한 사용자에 대한 링크

services/users/users.hooks.js data/contacts.db
```
<code class="language-bash">npm install -g @feathersjs/cli</code>
```
process-contact
- createdBy : 생성 날짜를 추가하십시오 _id 파일을 열고 다음과 같이 파일을 업데이트하십시오. 다음, 요청 될 때 사용자 객체를 각 연락처 레코드에 첨부하는 다른 후크

위 내용은 깃털에 대한 초보자 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

성명：

이전 기사：Vue Chrome Extension : vue.js로 브라우저 애드온을 구축하십시오다음 기사：Vue Chrome Extension : vue.js로 브라우저 애드온을 구축하십시오