Skip to main content
Slack의 Trailblazer Community가 이제 오픈 베타를 시작했습니다. 참여하고 실시간으로 소통하세요. Slack에서 함께하세요

Apex 시작하기

학습 목표

이 유닛을 완료하면 다음을 수행할 수 있습니다.

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

참고

한국어로 학습하시겠어요? Trailhead playground에서 한국어로 실습 과제를 시작하고, 괄호 안에 제공된 번역을 사용해 탐색해 보세요. 영어 데이터를 기반으로 실습 과제 검증이 이루어지므로 영문으로 표시된 값만 복사해 붙여 넣습니다. 한국어 조직에서 실습 과제를 통과하지 못한 경우, (1) 로캘을 미국을 바꾸고 (2) 여기에 제시된 지침에 따라 언어를 영어로 바꾼 후 (3) "Check Challenge(과제 확인)" 버튼을 눌러 다시 진행해 보세요.

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

시작하기 전에

여러분과 함께 Apex 모험을 시작하게 되어 대단히 기쁩니다. 이 모듈에서는 프로그래밍 언어에 대한 기본 사항을 다루지만, 깊이 있는 내용도 함께 살펴볼 예정입니다. 이 모듈이 Apex에 대한 첫 번째 학습인 경우 먼저 빠른 시작: Apex 프로젝트를 진행하는 것이 좋습니다. 그 후에 다시 돌아오세요. 기다리고 있겠습니다!

Apex는 무엇인가요?

Apex는 Java와 유사한 구문을 사용하고 데이터베이스 저장 프로시저와 같이 작동하는 프로그래밍 언어입니다. Apex를 통해 개발자는 버튼 클릭, 관련 레코드 업데이트 및 Visualforce 페이지와 같은 시스템 이벤트에 비즈니스 로직을 추가할 수 있습니다.

언어로서의 Apex는 다음과 같습니다.

  • 호스팅됨 - Apex는 서버인 Salesforce Platform에서 저장, 컴파일 및 실행됩니다.
  • 개체 - 지향 - Apex는 클래스, 인터페이스 및 상속을 지원합니다.
  • 강력한 형식 - Apex는 컴파일 타임에 개체에 대한 참조의 유효성을 검사합니다.
  • 멀티 테넌트 인식 - Apex는 멀티 테넌트 플랫폼에서 실행되므로 제한을 적용하여 런어웨이 코드를 철저히 차단합니다. 이러한 제한을 통해 코드가 공유 리소스를 독점하는 것을 방지할 수 있습니다.
  • 데이터베이스와 통합 - 레코드에 액세스하고 이를 조작하는 것이 간단합니다. Apex는 레코드 및 해당 필드에 대한 직접 액세스를 제공하고 해당 레코드를 조작하기 위한 문 및 쿼리 언어를 제공합니다.
  • 데이터 중심 - Apex는 데이터베이스에 대한 트랜잭션 액세스를 제공하여 작업을 롤백할 수 있도록 합니다.
  • 사용 용이성 - Apex는 친숙한 Java 관용구를 기반으로 합니다.
  • 테스트 용이성 - Apex는 유닛 테스트 생성, 실행 및 코드 커버리지에 대한 기본 제공 지원을 제공합니다.
  • 버전 관리 - 사용자 정의 Apex 코드는 API의 여러 버전에 맞게 저장할 수 있습니다.

Apex는 클라우드 기반 프로그래밍 언어입니다.

Apex 언어 하이라이트

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

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

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

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

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

개발 도구

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

또한 Salesforce 사용자 인터페이스를 사용하여 브라우저에서 직접 Apex를 작성하고 디버깅 정보에 액세스할 수 있습니다. Web Console(웹 콘솔)은 이전의 레거시 도구와 고사양 개발 환경 사이의 간극을 해소하기 위해 설계된 브라우저 기반의 경량화된 최신 통합 개발 환경(IDE)입니다. 자세한 내용은 웹 콘솔 개발자 문서를 참조하세요.

빠른 액세스 메뉴(Setup 기어 아이콘)에서 웹 콘솔을 열 수 있습니다.

웹 콘솔

데이터 형식 개요

Apex는 Salesforce에 특정한 데이터 형식인 sObject 데이터 형식을 포함하여 다양한 데이터 형식을 지원합니다.

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

  • Integer, Double, Long, Date, Datetime, String, ID, Boolean 등의 기본 유형.
  • 일반 sObject 또는 Account(계정), Contact(연락처), MyCustomObject__c 같은 특정 sObject 형태의 sObject. (sObject에 대한 자세한 내용은 이후 유닛에서 다루겠습니다.)
  • 다음을 포함하는 컬렉션.
    • 목록: 순서가 있고 색인이 지정된 요소의 컬렉션입니다. 목록 요소는 기본 유형, 컬렉션, 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
System.debug('Print out the colors in moreColors:');
for(String color : moreColors) {
    // Write value to the debug log
    System.debug(color);
}

추가 기본 정보

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

Apex 클래스

Apex 클래스의 이점 중 하나는 코드 재사용입니다. Class 메서드는 트리거 및 기타 클래스에서 호출할 수 있습니다. 다음 튜토리얼에서는 조직에 예제 클래스를 저장하고 이 클래스를 사용하여 계정 설명을 업데이트하고 디버그 로그를 검사하는 방법을 안내합니다.

Apex 클래스 저장

AccountProcessor 클래스에는 공개 메서드 updateAccountDescriptions()가 있습니다. 이 메서드는 계정 목록을 가져와 applyStandardFormatting() 비공개 도우미 메서드에 지정된 형식에 따라 설명을 업데이트합니다. 비공개 도우미 메서드는 외부에서 호출할 수 없으며, 반드시 클래스 내부에서 호출해야 합니다. AccountProcessor 클래스에는 데이터베이스 업데이트 작업의 결과를 검사하는 inspectResults() 비공개 도우미 메서드도 포함되어 있습니다.

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

  1. 빠른 액세스 메뉴(Setup 기어 아이콘)에서 Web Console(웹 콘솔)을 엽니다.
  2. Web Console(웹 콘솔)에서 Ctrl+Shift+P(Windows) 또는 ⌘+Shift+P(macOS)를 눌러 명령 팔레트를 표시합니다.
  3. SFDX: Create Apex Class(SFDX: Apex 클래스 만들기)를 입력하고 Enter를 누릅니다.
  4. 템플릿 유형으로 DefaultApexClass를 선택한 후 Enter를 누릅니다.
  5. 클래스 이름으로 AccountProcessor를 입력한 후 Enter를 누릅니다.
  6. 출력 디렉터리로 force-app/main/default/classes를 선택한 후 Enter를 누릅니다.
  7. 기본 클래스 본문을 AccountProcessor 클래스 예로 변경합니다.
public with sharing class AccountProcessor {
    /**
     * Applies a standard formatting to the descriptions of accounts in the list,
     * and updates each account.
     */
    public void updateAccountDescriptions(List<Account> acctList) {
        if (acctList == null || acctList.isEmpty()) {
            System.debug('Account list is null or empty.');
            return;
        }
        for (Account acc : acctList) {
            applyStandardFormatting(acc);
        }
        Database.SaveResult[] srList = Database.update(acctList,
false,
AccessLevel.USER_MODE);
        inspectResults(srList);
    }
    /**
     * Private helper method to handle the description formatting logic.
     */
    private static void applyStandardFormatting(Account acc) {
        String timestamp = String.valueOf(Datetime.now());
        if (String.isBlank(acc.Description)) {
            acc.Description = 'Account updated on: ' + timestamp;
        } else {
            acc.Description += ' | Last processed: ' + timestamp;
        }
    }
    /*
     * Private helper method to inspect the returned results.
     */
    private static void inspectResults(Database.SaveResult[] results) {
        for (Database.SaveResult sr : results) {
            if (sr.isSuccess()) {
                System.debug('Successfully updated account. Account ID: ' + sr.getId());
            } else {
                for (Database.Error err : sr.getErrors()) {
                    System.debug('The following error has occurred.');
                    System.debug(err.getStatusCode() + ': ' + err.getMessage());
                    System.debug('Account fields that affected this error: ' +
err.getFields());
                }
            }
        }
    }
}
  1. 클래스를 저장하려면 Ctrl+S(Windows) 또는 ⌘+S(macOS)를 누릅니다.

저장하면 Salesforce가 클래스를 컴파일하고 배포합니다.

Note

클래스에 오류가 있으면 저장 시 배포가 실패합니다. 웹 콘솔(Web Console) 창 하단의 Output(출력) 패널에서 오류에 대한 정보를 확인할 수 있습니다.

추가 기본 정보

저장한 클래스는 개체 지향 프로그래밍(OOP)을 사용합니다. 이 클래스는 이메일 관리와 관련된 메서드를 캡슐화합니다. OOP의 완벽한 예가 되기 위해 클래스에는 해당 속성에 액세스하기 위한 구성원 변수(속성) 및 접근자 메서드도 포함되지만 간소화하기 위해 클래스에는 이러한 요소가 없습니다.

메서드를 호출하여 계정 설명 업데이트

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

Note

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

  1. Web Console(웹 콘솔)에서 Ctrl+Shift+P(Windows) 또는 Cmd+Shift+P(macOS)를 눌러 명령 팔레트를 엽니다.
  2. SFDX: Create Anonymous Apex Script(SFDX: 익명 Apex 스크립트 만들기)를 입력하고 Enter를 누릅니다.
  3. 클래스 이름으로 UpdateAccounts를 입력한 후 Enter를 누릅니다.
  4. 출력 디렉터리로 scripts/apex를 선택한 후 Enter를 누릅니다.
  5. 다음 코드를 입력합니다.
// Create new accounts
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Second New Account'));
// Insert them into the database
try {
    insert as user newAccts;
    System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
    System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Instantiate an AccountProcessor object
AccountProcessor myAcctProcessor = new AccountProcessor();
// Pass the original list to update the account descriptions
myAcctProcessor.updateAccountDescriptions(newAccts);
  1. 스크립트를 저장하려면 Ctrl+S(Windows) 또는 ⌘+S(macOS)를 누릅니다.
  2. 스크립트를 실행하려면 텍스트 편집기에서 마우스 오른쪽 버튼을 클릭하고 SFDX: Execute Anonymous Apex with Currently Open Editor(SFDX: 현재 열린 편집기로 익명 Apex 실행)를 선택합니다.
  3. Salesforce에서 My New Account(내 새 계정)와 My Second New Account(내 두 번째 새 계정) 레코드 상세 페이지를 엽니다.

My New Account(내 새 계정)의 Description(설명) 필드 값은 Original Description | Last processed: 2026-01-01 00:00:00 (원본 설명 | 마지막으로 처리한 시간: 2026-01-01 00:00:00) 이어야 하고, My Second New Account(내 두 번째 새 계정)의 Description(설명) 필드 값은 Account updated on: 2026-01-01 00:00:00 (계정 업데이트 시간: 2026-01-01 00:00:00) 이어야 합니다. 단, 두 타임스탬프는 익명 Apex 트랜잭션을 실행한 실제 날짜와 시간으로 표시됩니다.

디버그 로그 검사

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

  1. Web Console(웹 콘솔)에서 UpdateAccounts 스크립트를 실행한 후 Output(출력) 패널을 엽니다.
  2. Debug Only(디버그 전용)를 선택하여 로그를 필터링하면 System.debug() 문에 대한 로그 행만 표시됩니다.
  3. Output(출력) 패널 상단의 filter(필터) 필드에 USER_DEBUG를 입력하여 System.debug() 문에 해당하는 로그 줄만 표시되도록 로그를 필터링합니다.
  4. .sfdx/tools/debug/logs 디렉터리에서 디버그 로그를 볼 수도 있습니다.

Web Console(웹 콘솔)에서 디버그 로그를 필터링하여 디버그 메시지 보기

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

DEBUG|Successfully inserted 2 accounts.
DEBUG|Successfully updated account. Account ID: {id}
DEBUG|Successfully updated account. Account ID: {id}
Note

또한 filter(필터) 필드에서 키워드를 검색하여 디버그 로그를 필터링할 수 있습니다. 로그 이벤트 유형에 대한 자세한 내용은 Debug Log Levels(디버그 로그 수준)을 참조하세요.

정적 메서드 호출

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

  1. Web Console(웹 콘솔)에서 AccountProcessor.cls 클래스 파일을 엽니다.
  2. updateAccountDescriptions() 정의의 첫 번째 줄을 수정합니다. 유일한 변경 사항은 static(정적) 키워드가 추가된 것입니다.
public static void updateAccountDescriptions(List<Account> acctList) {
  1. 클래스를 저장하려면 Ctrl+S(Windows) 또는 ⌘+S(macOS)를 누릅니다. 저장하면 클래스가 다시 배포됩니다.
  2. UpdateAccounts.apex 익명 Apex 스크립트 파일을 엽니다.
  3. 스크립트가 클래스 이름으로 정적 메서드를 호출하도록 현재 코드를 다음 코드로 교체합니다.
// Create new accounts
// For clarity, use different account names than the ones you used previously
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My Third New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Fourth New Account'));
// Insert them into the database
try {
    insert as user newAccts;
    System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
    System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Pass the original list to update the account descriptions
// The static method is called directly on the class
AccountProcessor.updateAccountDescriptions(newAccts);
  1. 스크립트를 저장하려면 Ctrl+S(Windows) 또는 ⌘+S(macOS)를 누릅니다.
  2. 스크립트를 실행하려면 텍스트 편집기에서 마우스 오른쪽 버튼을 클릭하고 SFDX: Execute Anonymous Apex with Currently Open Editor(SFDX: 현재 열린 편집기로 익명 Apex 실행)를 선택합니다. 이제 이 메서드가 실행되었으므로 이전 단계에서와 같이 Salesforce에서 업데이트된 계정 설명을 확인할 수 있으며, 선택적으로 디버그 로그도 확인할 수 있습니다.

리소스

Salesforce 도움말에서 Trailhead 피드백을 공유하세요.

Trailhead에 관한 여러분의 의견에 귀 기울이겠습니다. 이제 Salesforce 도움말 사이트에서 언제든지 새로운 피드백 양식을 작성할 수 있습니다.

자세히 알아보기 의견 공유하기