기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 코드 예제 Amazon Q는 다양한 시나리오에서 코드를 제안할 수 있습니다. 선택한 프로그래밍 언어로 코드를 작성할 때 이 코드가 어떻게 도움이 될 수 있는지 알아보려면 다음 코드 예제를 참조하세요. **Topics** + [한 줄 코드 완성을 위해 Amazon Q Developer 사용](single-line-completion.md) + [전체 함수 생성을 위해 Amazon Q Developer 사용](full-function-generation.md) + [블록 완성을 위해 Amazon Q Developer 사용](code-block.md) + [Docstring, JSDoc 및 Javadoc 완성을 위해 Amazon Q Developer 사용](docstring-javadoc.md) + [줄별 권장 사항에 Amazon Q Developer 사용](line-by-line-1.md) # 한 줄 코드 완성을 위해 Amazon Q Developer 사용 한 줄의 코드를 입력하기 시작하면 Amazon Q에서 현재 및 이전 입력을 기반으로 제안을 합니다. ------ #### [ C\$1\$1 ] ![\[C++를 사용하는 한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/single-line-completion-c-plus.gif) ------ #### [ JavaScript ] 이 예제에서 Amazon Q는 개발자가 시작하는 코드 줄을 완성합니다. ![\[한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/javascript_vscode_SingleLine.gif) ------ #### [ TypeScript ] 이 예제에서는 사용자가 전체 주석을 입력한 다음 Amazon Q가 해당 주석과 함께 제공되는 코드를 제공합니다. ![\[한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/typescript_vscode_single-line.gif) ------ #### [ C\$1 ] 이 예제에서 Amazon Q는 주석을 기반으로 한 줄 권장 사항을 제공합니다. ![\[한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/c-sharp-single-line.gif) ------ #### [ Shell ] 아래 이미지에서 Amazon Q는 한 줄 코드를 완성하는 방법에 대한 권장 사항을 제공합니다. ![\[한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/jb-single-line-shell.gif) ------ #### [ Java ] 한 줄의 코드를 입력하기 시작하면 Amazon Q에서 현재 및 이전 입력을 기반으로 제안을 합니다. 아래 Java 예제에서 사용자는 기존 클래스에 문자열 `public`을 입력합니다. 이 입력을 기반으로 Amazon Q는 기본 메서드의 서명에 대한 제안을 생성합니다. ![\[한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-c9-single-line-completion.gif) ------ #### [ Python ] 이 예제에서 Amazon Q는 개발자의 주석을 기반으로 한 줄 코드를 추천합니다. ![\[한 줄 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_singleline.gif) ------ # 전체 함수 생성을 위해 Amazon Q Developer 사용 Amazon Q는 사용자가 작성한 주석을 기반으로 전체 함수를 생성할 수 있습니다. 주석 작성을 마치면 Amazon Q에서 함수 서명을 제안합니다. 제안을 수락하면 Amazon Q가 자동으로 커서를 함수의 다음 부분으로 이동하고 제안을 합니다. 제안 사이에 추가로 주석이나 코드 줄을 입력하더라도 Amazon Q는 해당 입력을 기반으로 리팩터링을 수행합니다. ------ #### [ C ] ![\[C를 사용하는 전체 함수 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif) ------ #### [ C\$1\$1 ] ![\[C++를 사용하는 전체 함수 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif) ------ #### [ JavaScript ] 다음 예제에서는 사용자가 주석 세트를 기반으로 전체 함수를 생성한 다음 편집합니다. ![\[전체 함수 생성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/javascript_lambda_FullFunctionGeneration.gif) 다음 이미지에서 사용자는 Amazon S3에서 파일을 읽기 위한 함수 서명을 작성했습니다. Amazon Q에서는 이후 `read_from_s3` 메서드의 전체 구현을 제안합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-function-read-from-s3.png) **참고** 이전 예제와 같이 Amazon Q는 `import` 문을 제안의 일부로 포함하기도 합니다. 수동으로 이러한 `import` 문을 파일 상단으로 이동하는 것이 좋습니다. 또 다른 예로, 다음 이미지에서는 사용자가 함수 서명을 작성했습니다. Amazon Q에서는 이후 `quicksort` 메서드의 전체 구현을 제안합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-function-quicksort.png) Amazon Q는 제안을 할 때 이전 코드 조각을 고려합니다. 다음 이미지에서 이전 예제의 사용자는 위에 있는 `quicksort`에 대해 제안된 구현을 수락했습니다. 그런 다음 사용자는 일반적인 `sort` 메서드에 대한 함수 서명을 작성합니다. 그런 다음 Amazon Q는 이미 작성된 내용을 기반으로 구현을 제안합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-function-from-context-sort.png) 다음 이미지에서 사용자는 주석을 작성했습니다. 이 주석을 기반으로 Amazon Q는 함수 서명을 제안합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-comment-binary-search.png) 다음 이미지에서 이전 예제의 사용자는 제안된 함수 서명을 수락했습니다. 이후 Amazon Q는 `binary_search` 함수의 전체 구현을 제안합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-function-binary-search.png) ------ #### [ Java ] 다음 목록에는 Amazon Q에서 제안을 하고 사용자에게 전체 함수 생성 프로세스를 안내하는 방법에 대한 예가 포함되어 있습니다. 1. 다음 예제에서 사용자는 주석을 입력합니다. Amazon Q는 함수 서명을 제안합니다. 사용자가 해당 제안을 수락하면 Amazon Q가 함수 본문을 제안합니다. ![\[주석에서 생성된 함수의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment.gif) 1. 아래 이미지에서 사용자는 Amazon Q의 제안을 수락하기 전에 함수 본문에 주석을 입력합니다. 다음 줄에서 Amazon Q는 주석을 기반으로 제안을 생성합니다. ![\[기존 코드 블록 내의 주석에서 생성된 함수의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment-within-block.gif) ------ #### [ C\$1 ] 다음 예제에서는 Amazon Q가 전체 함수를 추천합니다. ![\[Function declaration for ListTables with AmazonDynamoDBClient parameter in code editor.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/c-sharp-full-function.gif) ------ #### [ TypeScript ] 다음 예제에서 Amazon Q는 사용자의 문서 문자열을 기반으로 함수를 생성합니다. ![\[전체 함수 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/typescript_vscode_function.gif) ------ #### [ Python ] Amazon Q는 사용자가 작성한 주석을 기반으로 전체 함수를 생성할 수 있습니다. 주석 작성을 마치면 Amazon Q에서 함수 서명을 제안합니다. 제안을 수락하면 Amazon Q가 자동으로 커서를 함수의 다음 부분으로 이동하고 제안을 합니다. 제안 사이에 추가로 주석이나 코드 줄을 입력하더라도 Amazon Q는 해당 입력을 기반으로 리팩터링을 수행합니다. 다음 예제에서 Amazon Q는 전체 함수와 해당 유닛 테스트를 모두 생성합니다. ![\[전체 함수 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/python_pycharm_fullfunction_unittests.GIF) 다음 목록에는 Amazon Q에서 제안을 하고 사용자에게 전체 함수 생성 프로세스를 안내하는 방법에 대한 예가 포함되어 있습니다. 1. 아래 이미지에서 사용자는 주석을 입력했습니다. 주석 아래에 있는 함수 서명은 Amazon Q의 제안입니다. ![\[alt_text\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-jb-comment-062022.png) 1. 아래 이미지에서 사용자는 함수 서명에 대한 Amazon Q 제안을 수락했습니다. 제안을 수락하면 커서가 자동으로 진행되고 Amazon Q는 함수 본문에 대한 새로운 제안을 했습니다. ![\[alt_text\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunctionadvance-062022.png) 1. 아래 이미지에서 사용자는 Amazon Q의 제안을 수락하기 전에 함수 본문에 주석을 입력합니다. 다음 줄에서 Amazon Q는 주석의 내용을 기반으로 새 제안을 생성했습니다. ![\[주석의 콘텐츠를 기반으로 새 제안 생성\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunction-062022.png) 이 예에서 Amazon Q는 사용자가 서명의 일부를 입력한 후 전체 함수를 추천합니다. ![\[전체 함수 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_fullfunction.gif) ------ # 블록 완성을 위해 Amazon Q Developer 사용 블록 완성은 `if/for/while/try` 코드 블록을 완성하는 데 사용됩니다. ------ #### [ C ] ![\[C를 사용하는 블록 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/block-completion-c.gif) ------ #### [ C\$1\$1 ] ![\[C++를 사용하는 블록 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/block-completion-c-plus.gif) ------ #### [ Java ] 아래 예제에서 사용자는 `if` 문의 서명을 입력합니다. 문의 본문은 Amazon Q의 제안입니다. ![\[블록 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-c9-block-completion.gif) ------ #### [ C\$1 ] 아래 이미지에서 Amazon Q는 함수를 완성하는 방법을 추천합니다. ![\[블록 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/c-sharp-block.gif) ------ #### [ TypeScript ] 아래 이미지에서 Amazon Q는 함수를 완성하는 방법을 추천합니다. ![\[블록 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/typescript_vscode_block-completion.gif) ------ #### [ Python ] 이 예제에서 Amazon Q는 컨텍스트를 기반으로 코드 블록을 추천합니다. ![\[코드 블록 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_codeblock.gif) ------ # Docstring, JSDoc 및 Javadoc 완성을 위해 Amazon Q Developer 사용 Amazon Q는 코드 내에서 설명서를 생성하거나 완료하는 데 도움이 될 수 있습니다. ------ #### [ C\$1\$1 ] ![\[C++를 사용하는 docstring 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/docstring-completion-c-plus.gif) ------ #### [ Javascript ] 이 예제에서는 Amazon Q가 기존 상수를 기반으로 JSDoc 파라미터를 채웁니다. ![\[JSDoc 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/javascript_vscode_JSDocCompletion.gif) ------ #### [ C\$1 ] 이 예제에서는 Amazon Q가 기존 상수를 기반으로 JSDoc 파라미터를 채웁니다. ![\[DocString이 완성된 C3의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/c-sharp-docstring.gif) ------ #### [ Java ] 다음은 [Oracle 웹 사이트의 예제](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html)에서 수정된 예입니다. 아래 이미지에서 사용자는 docstring 입력을 시작했습니다. Amazon Q는 docstring에 추가할 단어를 제안했습니다. ![\[docstring을 완성하는 함수 제안\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/jb-docstring-java.png) 다음은 [Oracle 웹 사이트의 예제](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html)에서 수정된 예입니다. 아래 Java 예제에서 사용자는 docstring을 입력합니다. Amazon Q는 docstring을 처리하는 함수를 제안합니다. ![\[Javadoc을 기반으로 한 코드 완성의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/cw-c9-javadoc.gif) ------ #### [ Python ] 이 예제에서 Amazon Q는 주변 컨텍스트를 기반으로 Docstring을 추천합니다. ![\[Docstring 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_commentblock.gif) ------ # 줄별 권장 사항에 Amazon Q Developer 사용 사용 사례에 따라 Amazon Q는 한 가지 권장 사항으로 전체 함수 블록을 생성하지 못할 수도 있습니다. 하지만 Amazon Q는 줄별 권장 사항을 제공할 수 있습니다. ------ #### [ Go and GoLand ] 이 예제에서는 Amazon Q가 줄별 권장 사항을 제공합니다. ![\[줄별 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-go.gif) 다음은 줄별 권장 사항의 또 다른 예로, 이번에는 유닛 테스트를 사용합니다. ![\[줄별 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-unit-test-go.gif) ------ #### [ C\$1\$1 and CLion ] 이 예제에서는 Amazon Q가 줄별 권장 사항을 제공합니다. ![\[줄별 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-cpp.gif) ------ #### [ Python ] 다음 이미지에서 고객은 Amazon CloudWatch Logs 그룹에 메시지를 게시하고자 한다는 내용의 최초 주석을 작성했습니다. 이를 기반으로 Amazon Q는 다음 이미지에 표시된 것처럼 첫 번째 권장 사항에서만 클라이언트 초기화 코드를 제안할 수 있습니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-1.png) 하지만 사용자가 계속해서 줄별 권장 사항을 요청하는 경우 Amazon Q는 이미 작성된 내용을 기반으로 코드 줄을 계속 제안합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-2.png) **참고** 위 예제에서는 `VPCFlowLogs`는 올바른 상수 값이 아닐 수 있습니다. Amazon Q의 제안에서 필요에 따라 상수의 이름을 변경해야 합니다. Amazon Q는 다음 이미지와 같이 최종적으로 전체 코드 블록을 완료할 수 있습니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-3.png) 이 예제에서 Amazon Q는 한 번에 한 줄씩 권장 사항을 제공합니다. ![\[줄별 완성 기능의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_linebyline.gif) ------