AWS SDK for JavaScript v2가 지원 종료에 도달했습니다. [AWS SDK for JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)로 마이그레이션하실 것을 권장합니다. 마이그레이션 방법에 대한 자세한 내용은 해당 [공지 사항](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)을 참조하세요. # 비동기식 서비스 호출 SDK를 통해 수행한 모든 요청은 비동기식입니다. 브라우저 스크립트를 작성할 때 이 점을 항상 주의해야 합니다. 웹 브라우저에서 실행 중인 JavaScript에는 일반적으로 실행 스레드가 하나 뿐입니다. AWS 서비스에 대한 비동기식 호출 이후에 브라우저 스크립트는 계속해서 실행되고 그 과정에서 브라우저 스크립트에서 반환하기 전에 비동기식 결과를 사용하는 코드를 실행하려고 시도할 수 있습니다. AWS 서비스에 대한 비동기식 호출에는 이러한 호출에 대한 관리가 필요합니다. 그래야 코드가 데이터를 사용할 수 있기 전에 데이터를 사용하려고 시도하지 않습니다. 이 섹션의 주제에서는 비동기식 호출 관리의 필요성과 비동기식 호출 관리에 사용할 수 있는 다양한 기법에 대해 자세히 다룹니다. **Topics** + [비동기식 호출 관리](making-asynchronous-calls.md) + [익명 콜백 함수 사용](using-a-callback-function.md) + [요청 객체 이벤트 리스너 사용](using-a-response-event-handler.md) + [비동기/대기 사용](using-async-await.md) + [JavaScript Promises 사용](using-promises.md) # 비동기식 호출 관리 예를 들어, 전자 상거래 웹 사이트의 홈 페이지에서는 재방문 고객이 로그인할 수 있습니다. 로그인한 고객을 위한 혜택의 일부로 로그인 후 사이트에서는 고객의 특정 기본 설정에 맞춰 사이트를 맞춤화합니다. 사이트를 맞춤화하려면 다음을 수행해야 합니다. 1. 고객이 로그인하고 로그인 보안 인증으로 검증되어야 합니다. 1. 고객 데이터베이스에서 고객의 기본 설정이 요청됩니다. 1. 데이터베이스에서는 페이지 로드 전에 사이트를 맞춤화하는 데 사용되는 고객의 기본 설정을 제공합니다. 이러한 작업이 동기식으로 실행되면 다음 작업을 시작하기 전에 각 작업이 끝나야 합니다. 따라서 고객 기본 설정이 데이터베이스에서 반환될 때까지 웹 페이지 로딩을 완료할 수 없습니다. 그러나 데이터베이스 쿼리가 서버로 전송된 후 네트워크 병목 현상, 예외적으로 높은 데이터베이스 트래픽 또는 불안한 모바일 디바이스 연결 등으로 인해 고객 데이터 수신이 지연되거나 실패할 수 있습니다. 이러한 상황에서도 웹 사이트가 멈추지 않도록 하기 위해 데이터베이스를 비동기식을 호출합니다. 데이터베이스 호출을 실행한 후 비동기 요청을 보내면 코드가 계속해서 예상대로 실행됩니다. 비동기 호출의 응답을 적절하게 관리하지 못하면 데이터를 아직 사용할 수 없는데도 코드가 데이터베이스에서 다시 필요한 정보를 사용하려고 시도할 수 있습니다. ![\[동기식 실행과 비동기식 실행 간의 차이\]](http://docs.aws.amazon.com/ko_kr/sdk-for-javascript/v2/developer-guide/images/async-vs-sync.png) # 익명 콜백 함수 사용 `AWS.Request` 객체를 생성하는 각 서비스 객체 메서드는 익명 콜백 함수를 마지막 파라미터로 수락할 수 있습니다. 이 콜백 함수의 서명은 다음과 같습니다. ``` function(error, data) { // callback handling code } ``` 이 콜백 함수는 성공적인 응답 또는 오류 데이터 반환 시 실행됩니다. 메서드 호출에 성공하면 `data` 파라미터에서 응답 내용을 콜백 함수에 사용할 수 있습니다. 호출에 실패하면 `error` 파라미터에 자세한 실패 정보가 제공됩니다. 일반적으로 콜백 함수 내 코드는 오류가 있는지 테스트하는데, 오류가 반환되면 처리합니다. 오류가 반환되지 않으면 코드는 응답의 `data` 파라미터에서 데이터를 검색합니다. 콜백 함수의 기본 형식은 다음 예제와 같습니다. ``` function(error, data) { if (error) { // error handling code console.log(error); } else { // data handling code console.log(data); } } ``` 이전 예제에서는 오류 또는 반환되는 데이터에 대한 자세한 내용이 콘솔에 로깅됩니다. 다음은 서비스 객체에 대한 메서드 호출의 일부로 전달되는 콜백 함수를 보여주는 예제입니다. ``` new AWS.EC2({apiVersion: '2014-10-01'}).describeInstances(function(error, data) { if (error) { console.log(error); // an error occurred } else { console.log(data); // request succeeded } }); ``` ## 요청 및 응답 객체에 액세스 콜백 함수 내에서 JavaScript 키워드 `this`는 대부분 서비스의 경우 기본 `AWS.Response` 객체를 가리킵니다. 다음 예제에서는 디버깅을 지원하기 위해 `httpResponse` 객체의 `AWS.Response` 속성이 콜백 함수 내에서 사용되어 원시 응답 데이터 및 헤더를 로깅합니다. ``` new AWS.EC2({apiVersion: '2014-10-01'}).describeInstances(function(error, data) { if (error) { console.log(error); // an error occurred // Using this keyword to access AWS.Response object and properties console.log("Response data and headers: " + JSON.stringify(this.httpResponse)); } else { console.log(data); // request succeeded } }); ``` 또한 `AWS.Response` 객체에는 원래 메서드 호출에서 보낸 `Request`가 포함된 `AWS.Request` 속성이 있으므로 수행된 요청에 대한 세부 정보에 액세스할 수도 있습니다. # 요청 객체 이벤트 리스너 사용 서비스 객체 메서드를 호출할 때 익명 콜백 함수를 파라미터로 생성해 전달하지 않으면 해당 메서드 호출은 `AWS.Request` 메서드를 사용해 수동으로 전송해야 하는 `send` 객체를 생성합니다. 응답을 처리하려면 `AWS.Request` 객체에 대한 이벤트 리스너를 생성해 메서드 호출에 대한 콜백 함수를 등록해야 합니다. 다음 예제에서는 성공적인 반환을 위해 서비스 객체 메서드 및 이벤트 리스너를 호출하기 위한 `AWS.Request` 객체를 생성하는 방법을 보여줍니다. ``` // create the AWS.Request object var request = new AWS.EC2({apiVersion: '2014-10-01'}).describeInstances(); // register a callback event handler request.on('success', function(response) { // log the successful data response console.log(response.data); }); // send the request request.send(); ``` `send` 객체에 대한 `AWS.Request` 메서드를 호출한 후에는 서비스 객체가 `AWS.Response` 객체를 수신할 때 이벤트 핸들러가 실행됩니다. `AWS.Request` 객체에 대한 자세한 내용은 API 참조의 [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Request.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Request.html) 섹션을 참조하세요. `AWS.Response` 객체에 대한 자세한 내용은 [응답 객체 사용](the-response-object.md) 또는 API 참조의 [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Response.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Response.html) 섹션을 참조하세요. ## 여러 콜백 묶기 모든 요청 객체에 대해 여러 콜백을 등록할 수 있습니다. 다른 이벤트 또는 동일한 이벤트에 대해 여러 콜백을 등록할 수 있습니다. 또한 다음 예제에서처럼 콜백을 묶을 수 있습니다. ``` request. on('success', function(response) { console.log("Success!"); }). on('error', function(response) { console.log("Error!"); }). on('complete', function() { console.log("Always!"); }). send(); ``` ## 객체 완료 이벤트 요청 `AWS.Request` 객체는 각 서비스 작업 메서드의 응답을 바탕으로 다음 완료 이벤트를 발생시킵니다. + `success` + `error` + `complete` 이러한 이벤트에 대한 응답으로 콜백 함수를 등록할 수 있습니다. 모든 요청 객체 이벤트의 전체 목록을 보려면 API 참조의 [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Request.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Request.html) 클래스를 참조하세요. ### 성공 이벤트 `success` 이벤트는 서비스 객체에서 성공적인 응답을 수신하면 발생합니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('success', function(response) { // event handler code }); ``` 응답은 서비스의 직렬화된 응답 데이터가 포함된 `data` 속성을 제공합니다. 예를 들어, Amazon S3 서비스 객체의 `listBuckets` 메서드에 대한 직접접 호출은 다음과 같습니다. ``` s3.listBuckets.on('success', function(response) { console.log(response.data); }).send(); ``` 이 호출은 응답을 반환한 다음 콘솔에 다음 `data`속성 내용을 출력합니다. ``` { Owner: { ID: '...', DisplayName: '...' }, Buckets: [ { Name: 'someBucketName', CreationDate: someCreationDate }, { Name: 'otherBucketName', CreationDate: otherCreationDate } ], RequestId: '...' } ``` ### 오류 이벤트 `error` 이벤트는 서비스 객체에서 오류 응답을 수신하면 발생합니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('error', function(error, response) { // event handling code }); ``` `error` 이벤트가 발생하면 응답의 `data` 속성 값이 `null`이고 `error` 속성에는 오류 데이터가 포함됩니다. 연결된 `error` 객체는 등록된 콜백 함수에 첫 번째 파라미터로 전달됩니다. 예를 들어, 다음 코드에서는 ``` s3.config.credentials.accessKeyId = 'invalid'; s3.listBuckets().on('error', function(error, response) { console.log(error); }).send(); ``` 오류를 반환한 다음 콘솔에 다음 오류 데이터를 출력합니다. ``` { code: 'Forbidden', message: null } ``` ### 완료 이벤트 호출 결과 성공 또는 오류인지 여부에 상관 없이 `complete` 이벤트는 서비스 객체 호출이 완료되면 발생합니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('complete', function(response) { // event handler code }); ``` `complete` 이벤트 콜백을 사용하면 성공 또는 오류 여부에 상관 없이 실행해야 하는 모든 요청 정리를 처리할 수 있습니다. `complete` 이벤트에 대한 콜백 내에서 응답 데이터를 사용하면 다음 예제에서 보여주는 것처럼 `response.data` 또는 `response.error` 속성 중 하나에 액세스하기 전에 먼저 두 속성을 확인합니다. ``` request.on('complete', function(response) { if (response.error) { // an error occurred, handle it } else { // we can use response.data here } }).send(); ``` ## 객체 HTTP 이벤트 요청 `AWS.Request` 객체는 각 서비스 작업 메서드의 응답을 바탕으로 다음 HTTP 이벤트를 발생시킵니다. + `httpHeaders` + `httpData` + `httpUploadProgress` + `httpDownloadProgress` + `httpError` + `httpDone` 이러한 이벤트에 대한 응답으로 콜백 함수를 등록할 수 있습니다. 모든 요청 객체 이벤트의 전체 목록을 보려면 API 참조의 [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Request.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Request.html) 클래스를 참조하세요. ### httpHeaders 이벤트 `httpHeaders` 이벤트는 원격 서버에서 헤더를 보낸 경우 발생합니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('httpHeaders', function(statusCode, headers, response) { // event handling code }); ``` 콜백 함수에 대한 `statusCode` 파라미터가 HTTP 상태 코드입니다. `headers` 파라미터에는 응답 헤더가 포함되어 있습니다. ### httpData 이벤트 `httpData` 이벤트는 서버에서 응답 데이터 패킷을 스트리밍하기 위해 발생됩니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('httpData', function(chunk, response) { // event handling code }); ``` 이 이벤트는 일반적으로 전체 응답을 메모리로 로드하는 것이 적절하지 않은 경우 대용량 응답을 청크로 수신하는 데 사용됩니다. 이 이벤트에는 서버의 실제 데이터 중 일부가 포함되어 있는 추가 `chunk` 파라미터가 있습니다. `httpData` 이벤트에 대한 콜백을 등록한 경우 응답의 `data` 속성에는 요청에 대해 직렬화된 전체 출력이 포함됩니다. 기본 제공 핸들러에 대한 추가 구문 분석 및 메모리 오버헤드가 없는 경우에는 기본 `httpData` 리스너를 제거해야 합니다. ### httpUploadProgress 및 httpDownloadProgress 이벤트 `httpUploadProgress` 이벤트는 HTTP 응답이 추가 데이터를 업로드한 경우 발생합니다. 마찬가지로, `httpDownloadProgress` 이벤트는 HTTP 요청에 추가 데이터를 다운로드한 경우 발생합니다. 다음은 이러한 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('httpUploadProgress', function(progress, response) { // event handling code }) .on('httpDownloadProgress', function(progress, response) { // event handling code }); ``` 콜백 함수에 대한 `progress` 파라미터에는 로드된 총 요청 바이트와 함께 객체가 포함되어 있습니다. ### httpError 이벤트 `httpError` 이벤트는 HTTP 요청에 실패한 경우 발생합니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('httpError', function(error, response) { // event handling code }); ``` 콜백 함수에 대한 `error` 파라미터에는 발생한 오류가 포함되어 있습니다. ### httpDone 이벤트 `httpDone` 이벤트는 서버가 데이터 전송을 마치면 발생합니다. 다음은 성공 이벤트에 대한 콜백 함수를 등록하는 방법입니다. ``` request.on('httpDone', function(response) { // event handling code }); ``` # 비동기/대기 사용 AWS SDK for JavaScript를 직접 호출할 때 `async/await` 패턴을 사용할 수 있습니다. 콜백을 받는 대부분의 함수는 promise를 반환하지 않습니다. promise를 반환하는 `await` 함수만 사용하므로 `async/await` 패턴을 사용하려면 `.promise()` 메서드를 호출이 끝날 때까지 연결하고 콜백을 제거해야 합니다. 다음 예에서는 async/await를 사용하여 `us-west-2`의 모든 Amazon DynamoDB 테이블을 나열합니다. ``` var AWS = require("aws-sdk"); //Create an Amazon DynamoDB client service object. dbClient = new AWS.DynamoDB({ region: "us-west-2" }); // Call DynamoDB to list existing tables const run = async () => { try { const results = await dbClient.listTables({}).promise(); console.log(results.TableNames.join("\n")); } catch (err) { console.error(err); } }; run(); ``` **참고** 모든 브라우저가 async/await를 지원하는 것은 아닙니다. async/await를 지원하는 브라우저 목록은 [Async functions](https://caniuse.com/#feat=async-functions)를 참조하세요. # JavaScript Promises 사용 `AWS.Request.promise` 메서드는 서비스 작업을 호출하고 콜백을 사용하지 않고 비동기식 흐름을 관리하는 방법을 제공합니다. Node.js 및 브라우저 스크립트에서 `AWS.Request` 객체는 콜백 함수 없이 서비스 작업이 호출된 경우 반환됩니다. 요청의 `send` 메서드를 호출하여 서비스를 호출할 수 있습니다. 그러나 `AWS.Request.promise`는 서비스 호출을 즉시 시작하고 응답 `data` 속성을 사용하여 이행되었거나 응답 `error` 속성을 사용하여 거부된 promise를 반환합니다. ``` var request = new AWS.EC2({apiVersion: '2014-10-01'}).describeInstances(); // create the promise object var promise = request.promise(); // handle promise's fulfilled/rejected states promise.then( function(data) { /* process the data */ }, function(error) { /* handle the error */ } ); ``` 다음 예제에서는 `data` 객체로 이행되었거나 `error` 객체로 거부된 promise를 반환합니다. promise를 사용하는 경우 단일 콜백이 오류 탐지를 담당하지 않습니다. 대신 요청 성공 또는 실패를 바탕으로 올바른 콜백이 호출됩니다. ``` var s3 = new AWS.S3({apiVersion: '2006-03-01', region: 'us-west-2'}); var params = { Bucket: 'bucket', Key: 'example2.txt', Body: 'Uploaded text using the promise-based method!' }; var putObjectPromise = s3.putObject(params).promise(); putObjectPromise.then(function(data) { console.log('Success'); }).catch(function(err) { console.log(err); }); ``` ## 여러 Promise 조정 경우에 따라 코드는 여러 비동기식 호출이 모두 성공적으로 반환된 경우에만 조치가 필요한 여러 비동기식 호출을 수행해야 합니다. promise를 사용하지 않고 개별 비동기 메서드 호출을 관리하는 경우 `all` 메서드를 사용하는 추가 promise를 생성할 수 있습니다. 이 메서드는 메서드에 전달한 promise 배열이 이행되는 경우 umbrella promise를 이행합니다. 콜백 함수는 `all` 메서드에 전달되는 promises의 값 배열로 전달됩니다. 다음 예에서 AWS Lambda 함수는 Amazon DynamoDB에 대한 비동기 직접 호출을 3개 수행해야 하는데 각 직접 호출에 대한 promise를 이행한 후에만 완료할 수 있습니다. ``` Promise.all([firstPromise, secondPromise, thirdPromise]).then(function(values) { console.log("Value 0 is " + values[0].toString); console.log("Value 1 is " + values[1].toString); console.log("Value 2 is " + values[2].toString); // return the result to the caller of the Lambda function callback(null, values); }); ``` ## Promise에 대한 브라우저 및 Node.js 지원 기본 JavaScript promise(ECMAScript 2015)에 대한 지원은 모드가 실행되는 JavaScript 엔진 및 버전에 따라 달라집니다. 코드를 실행해야 하는 각 환경에서 JavaScript promise에 대한 지원을 확인하려면 GitHub에서 [ECMAScript 호환성 표](https://compat-table.github.io/compat-table/es6/)를 참조하세요. ## 기타 Promise 구현 사용 ECMAScript 2015의 기본 promise 구현 이외에 다음을 포함해 타사 promise 라이브러리도 사용할 수 있습니다. + [bluebird](http://bluebirdjs.com) + [RSVP](https://github.com/tildeio/rsvp.js/) + [Q](https://github.com/kriskowal/q). 이러한 선택적 promise 라이브러리는 ECMAScript 5 및 ECMAScript 2015에서 기본 promise 구현을 지원하지 않는 환경에서 코드를 실행해야 하는 경우 유용할 수 있습니다. 타사 promise 라이브러리를 사용하려면 전역 구성 객체의 `setPromisesDependency` 메서드를 호출하여 SDK에 대한 promise 종속성을 설정해야 합니다. 브라우저 스크립트에서 SDK를 로드하기 전에 타사 promise 라이브러리를 로드해야 합니다. 다음 예제에서는 bluebird promise 라이브러리에서 구현을 사용하도록 SDK가 구성되었습니다. ``` AWS.config.setPromisesDependency(require('bluebird')); ``` JavaScript 엔진의 기본 promise 구현을 사용하기 위해 반환하려면 `setPromisesDependency`를 다시 호출하여 라이브러리 이름 대신 `null`을 전달합니다.