Apex 시작하기

• Apex 프로그래밍 언어의 주요 기능을 설명할 수 있습니다.
• Apex 클래스를 저장하고 Anonymous.Apex로 메서드를 호출할 수 있습니다.
• Developer Console을 사용하여 디버그 로그를 검사할 수 있습니다.

참고

한국어로 학습하시겠어요? 이 배지에서는 Trailhead 실습과제 검증이 영어로 진행됩니다. 참조용 번역이 괄호로 제공됩니다. Trailhead Playground에서 (1) 로캘을 미국으로 바꾸고 (2) 언어를 영어로 바꾼 후 (3) 영문으로 표시된 값을 복사해 붙여 넣으세요. 여기에 나와 있는 지침을 따르세요.

원하는 언어로 Trailhead 사용하기 배지를 확인해 현지화된 Trailhead 경험을 활용하는 방법에 대해 자세히 알아보세요.

Apex 언어 하이라이트

다른 개체 지향 프로그래밍 언어와 마찬가지로 다음은 Apex가 지원하는 언어 구성 중 일부입니다.

• 클래스, 인터페이스, 속성 및 컬렉션(배열 포함)
• 개체 및 배열 표기법
• 표현식, 변수 및 상수
• 조건문(if-then-else) 및 제어 플로 문(for 루프 및 while 루프)

다른 개체 지향 프로그래밍 언어와 달리 Apex는 다음을 지원합니다.

• Apex로서의 클라우드 개발은 클라우드에서 저장, 컴파일 및 실행됨.
• 데이터베이스 시스템의 트리거와 유사한 트리거.
• 데이터를 쿼리하고 검색하기 위해 직접 데이터베이스 호출 및 쿼리 언어를 만들 수 있는 Database 문.
• 트랜잭션 및 롤백.
• public 수정자보다 권한이 더 있는 global 액세스 수정자로, 네임스페이스와 애플리케이션 전반에 걸쳐 액세스를 허용함.
• 사용자 정의 코드의 버전 관리.

또한 Apex는 대소문자를 구분하지 않는 언어입니다.

개발 도구

Visual Studio Code용 Salesforce 확장을 사용하여 클라이언트 컴퓨터에서 Apex를 작성하고 디버깅할 수 있습니다. Salesforce Visual Studio Code 확장을 참조하세요.

또한 Salesforce 사용자 인터페이스를 사용하여 브라우저에서 직접 Apex를 작성하고 디버깅 정보에 액세스할 수 있습니다. Your Name(이름)에서 Developer Console을 열거나 빠른 액세스 메뉴()를 엽니다.

Apex는 다음 데이터 형식을 지원합니다.

• Integer, Double, Long, Date, Datetime, String, ID, Boolean 등과 같은 프리미티브.
• 일반 sObject 또는 계정, 연락처 또는 MyCustomObject__c와 같은 특정 sObject로서의 sObject. (sObject에 대한 자세한 내용은 이후 유닛에서 다루겠습니다.)
• 다음을 포함하는 컬렉션.
  • 기본 요소, sObject, 사용자 정의 개체, Apex 클래스에서 생성된 개체 또는 컬렉션의 목록(또는 배열)
  • 기본 요소 집합, sObject, 사용자 정의 개체, Apex 클래스에서 생성된 개체 또는 컬렉션의 설정
  • 프리미티브에서 프리미티브, sObject 또는 컬렉션으로의 맵
• 형식화된 값 목록(열거형이라고도 함)
• 사용자 정의 Apex 클래스
• 시스템 제공 Apex 클래스

Apex 컬렉션: 목록

목록은 정렬된 개체 컬렉션을 보유합니다. Apex의 목록은 배열과 동의어이며 두 가지를 서로 바꿔서 사용할 수 있습니다.

다음 두 선언은 동일합니다. colors 변수는 List 구문을 사용하여 선언됩니다.

List<String> colors = new List<String>();

또는 colors 변수는 배열로 선언될 수 있지만 배열이 아닌 목록에 할당됩니다.

String[] colors = new List<String>();

List.add() 메서드로 새로운 요소를 추가하여 필요에 따라 컬렉션을 늘립니다. 대괄호 배열 표기법을 사용하여 인덱스로 컬렉션의 기존 요소를 참조합니다. 하지만 대괄호 배열 표기법을 사용하여 요소를 추가할 수는 없습니다.

이 예는 목록을 만들 때 목록에 요소를 추가하고, add() 메서드를 사용하여 요소를 추가하는 방법을 보여줍니다. 

// Create a list and add elements to it in one step
List<String> colors = new List<String> { 'red', 'green', 'blue' };
// Add elements to a list after it has been created
List<String> moreColors = new List<String>();
moreColors.add('orange');
moreColors.add('purple');

목록 요소는 배열 요소와 마찬가지로 대괄호 사이에 인덱스를 지정하여 읽을 수 있습니다. 또한 get() 메서드를 사용하여 목록 요소를 읽을 수 있습니다. 이 예제는 이전 예제에서 만든 목록을 기반으로 하며 두 방법 중 하나를 사용하여 목록 요소를 읽는 방법을 보여줍니다. 이 예제는 배열 요소를 반복하는 방법도 보여줍니다.

// Get elements from a list
String color1 = moreColors.get(0);
String color2 = moreColors[0];
System.assertEquals(color1, color2);
// Iterate over a list to read elements
for(Integer i=0;i<colors.size();i++) {
    // Write value to the debug log
    System.debug(colors[i]);
}

추가 기본 정보

Apex는 Set 및 Map의 두 가지 다른 컬렉션 유형을 지원합니다. Apex 개발자 가이드의 컬렉션 섹션에서 자세히 알아볼 수 있습니다.

조직에서 EmailManager 클래스를 저장합니다.

1. Your Name(이름)에서 Developer Console을 열거나 빠른 액세스 메뉴()를 엽니다.
2. Developer Console에서 File(파일) | New(새로 만들기) | Apex Class(Apex 클래스)를 클릭하고 클래스 이름에 대해 EmailManager를 입력한 다음 OK(확인)를 클릭합니다.
3. 기본 클래스 본문을 EmailManager 클래스 예로 변경합니다.
   
   이메일을 전송하고 Apex 클래스 라이브러리의 기본 제공 Messaging 메서드를 사용하는 EmailManager 클래스에는 공개 메서드(sendMail())가 있습니다. 또한 이 클래스에는 비공개 도우미 메서드(inspectResults())가 있으며 이는 비공개이므로 외부에서 호출할 수 없지만 클래스 내에서만 사용됩니다. 이 도우미 메서드는 이메일 보내기 호출의 결과를 검사하고 sendMail()에서 호출됩니다.

   public class EmailManager {
       // Public method
       public void sendMail(String address, String subject, String body) {
           // Create an email message object
           Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage();
           String[] toAddresses = new String[] {address};
           mail.setToAddresses(toAddresses);
           mail.setSubject(subject);
           mail.setPlainTextBody(body);
           // Pass this email message to the built-in sendEmail method 
           // of the Messaging class
           Messaging.SendEmailResult[] results = Messaging.sendEmail(
                                    new Messaging.SingleEmailMessage[] { mail });
           // Call a helper method to inspect the returned results
           inspectResults(results);
       }
       // Helper method
       private static Boolean inspectResults(Messaging.SendEmailResult[] results) {
           Boolean sendResult = true;
           // sendEmail returns an array of result objects.
           // Iterate through the list to inspect results. 
           // In this class, the methods send only one email, 
           // so we should have only one result.
           for (Messaging.SendEmailResult res : results) {
               if (res.isSuccess()) {
                   System.debug('Email sent successfully');
               }
               else {
                   sendResult = false;
                   System.debug('The following errors occurred: ' + res.getErrors());                 
               }
           }
           return sendResult;
       }
   }

4. File(파일) | Save(저장)를 클릭하여 클래스를 저장합니다.
   
   참고: 코드의 구문이 올바르지 않으면 오류가 Problems(문제) 탭에 표시됩니다. 오류 세부 정보를 사용해 코드를 수정할 수 있습니다.

이메일을 보내는 메서드 호출

공개 메서드를 호출해 보겠습니다. 이를 위해 익명 Apex 실행을 사용합니다. 익명 Apex를 사용하면 코드 줄을 즉석에서 실행할 수 있으며 특히 기능을 테스트하기 위해 Apex를 호출하는 편리한 방법입니다. 다른 Apex 실행과 마찬가지로 디버그 로그 결과가 생성됩니다.

참고

예를 들어 트리거를 통해 Apex를 호출하는 다른 방법이 있습니다. 다른 모듈에서 트리거에 대해 자세히 알아보겠습니다.

1. Developer Console에서 Debug(디버그) | Open Execute Anonymous Window(익명 실행 창 열기)를 클릭합니다.
2. 열리는 창에서 다음을 입력합니다. 'Your email address'를 이메일 주소로 변경합니다.

   EmailManager em = new EmailManager();
   em.sendMail('Your email address', 'Trailhead Tutorial', '123 body');

3. Execute(실행)를 클릭합니다.
   이제 받은 편지함에 이메일이 수신되었을 것입니다. 이메일을 확인하세요.

디버그 로그 검사

디버그 로그는 코드 디버깅에 유용합니다. Apex 메서드가 실행되면 호출이 디버그 로그에 기록됩니다. 또한 로그에 고유한 디버그 메시지를 작성할 수 있으므로 오류가 있는 경우 코드를 디버깅하는 데 도움이 됩니다. sendMail()에서 호출되는 inspectResults() 도우미 메서드는 System.debug() 메서드를 사용하여 로그에 메시지를 써서 이메일 보내기 작업이 성공했는지 또는 오류가 있었는지 여부를 나타내는 메서드입니다. 메서드를 실행할 때 생성된 디버그 로그에서 이러한 메시지를 찾을 수 있습니다.

1. Developer Console에서 Logs(로그) 탭을 클릭하고 목록에서 가장 최근 로그를 두 번 클릭합니다.
2. Debug Only(디버그 전용)를 선택하여 로그를 필터링하면 System.debug() 문에 대한 로그 행만 표시됩니다.

이메일이 오류 없이 전송되었다고 가정하면 필터링된 로그 보기에 다음 메시지가 표시됩니다.

DEBUG|Email sent successfully

참고

또한 Filter(필터) 필드에서 키워드를 검색하거나 다른 옵션을 선택하여 디버그 로그를 필터링할 수 있습니다. 자세한 내용은 로그 검사기 도움말을 참조하세요.

정적 메서드 호출

클래스의 sendMail() 메서드는 클래스 구성원 변수에 액세스하지 않으며 인스턴스 메서드일 필요가 없습니다. static 키워드를 해당 선언에 추가하여 정적 메서드로 변경해 보겠습니다. 정적 메서드는 클래스의 인스턴스에서 호출할 필요가 없지만 클래스 이름에서 직접 호출되기 때문에 인스턴스 메서드보다 호출하기 쉽습니다.

1. Developer Console에서 EmailManager 클래스에 대해 열려 있는 탭을 찾고 sendMail() 메서드 정의의 첫 번째 줄을 다음과 같이 수정합니다(유일한 변경 사항은 static 키워드에 추가됩니다.).

   public static void sendMail(String address, String subject, String body) {

2. File(파일) | Save(저장)를 클릭하여 클래스를 저장합니다.
3. Execute Anonymous(익명 실행) 창에서 문을 수정하여 클래스 이름에 대한 정적 메서드를 호출합니다.

   EmailManager.sendMail('Your email address', 'Trailhead Tutorial', '123 body');

4. Execute(실행)를 클릭합니다. 이제 이 메서드가 실행되었으므로 이전 단계에서와 같이 이메일을 확인하고 선택적으로 디버그 로그를 확인할 수 있습니다.