Salesforce Apex -opetusohjelma aloittelijoille

Apex auttaa kehittäjiä lisäämään liiketoimintalogiikkaa järjestelmätapahtumiin, kuten painikkeiden napsautuksiin, niihin liittyviin tietueiden päivityksiin ja Visualforce-sivuihin. Apexin syntaksi on samankaltainen kuin Java. Rekisteröidy Salesforceen oppia, miten CRM toimii.

Apex-ohjelmointikielen ominaisuudet

Tässä ovat Salesforce Apexin tärkeät ominaisuudet:

• Apex on kirjainkokoa ei erotella.
• Voit suorittaa sObject-tietueille DML-toimintoja, kuten INSERT, UPDATE, UPSERT ja DELETE, Apexin avulla.
• Voit tehdä sObject-tietueiden kyselyitä Apexissa käyttämällä SOQL:ää (Salesforce Object Query Language) ja SOSL:ää (Salesforce Object Search Language).
• Voit luoda a yksikkötesti ja suorita se varmistaaksesi koodin kattavuus ja Apex-koodin tehokkuutta.
• Apex suorittaa usean vuokralaisen ympäristössä ja Salesforce on määritellyt hallintarajoitukset, jotka estävät käyttäjää monopolisoimasta jaettuja resursseja. Mikä tahansa Salesforcen hallintarajoituksen ylittävä koodi epäonnistuu ja näkyviin tulee virhe.
• Salesforce-objektia voidaan käyttää tietotyyppinä Apexissa. Esimerkiksi:

  Account acc = new Account();

  Tässä Account on Salesforcen vakio-objekti.

• Apex päivittää automaattisesti jokaisen Salesforce-julkaisun yhteydessä.

Milloin kehittäjän tulisi valita Apex?

Apex-koodia tulisi kirjoittaa vain, jos liiketoimintaskenaario on liian monimutkainen toteutettavaksi Salesforcen tarjoamalla valmiilla osoita ja napsauta -toiminnolla.

Seuraavassa on muutamia tilanteita, joissa sinun on kirjoitettava Apex-koodia:

• Luoda verkkopalveluita, jotka integroivat Salesforcen muihin sovelluksiin.
• Mukautetun validoinnin toteuttaminen sObjects-objekteille.
• Suorittaa mukautettua Apex-logiikkaa, kun DML-toiminto suoritetaan.
• Toteuttaa toimintoja, joita ei voida rakentaa olemassa olevilla deklaratiivisilla automaatiotyökaluilla, kuten Flow'lla.
• Järjestää sähköpostipalvelut jotka käsittelevät saapuvien sähköpostien sisällön, otsikot ja liitteet.

Kun tiedät, milloin Apex on oikea valinta, seuraava vaihe on ymmärtää, mitä koodillesi tapahtuu tallentamisen jälkeen.

Apexin toimintarakenne

Seuraavassa on Apex-koodin toimintojen kulku:

• Kehittäjän toiminto: Kun kehittäjä tallentaa koodia alustalle, kaikki Apex-koodi käännetään joukoksi ohjeita, jotka Apex-ajonaikainen tulkki ymmärtää, ja nämä ohjeet tallennetaan sitten metatietoina alustalle.
• Loppukäyttäjän toimenpiteet: Kun käyttäjätapahtuma suorittaa Apex-koodia, alustapalvelin hakee käännetyt ohjeet metatiedoista ja suorittaa ne Apex-tulkin läpi ennen tuloksen palauttamista.

Alla oleva kaavio näyttää, miten kehittäjän ja loppukäyttäjän toiminnot ovat vuorovaikutuksessa Lightning Platform -sovelluspalvelimen kanssa:

Apex-kehitysympäristö

Apex-koodia voidaan kehittää joko Salesforcen hiekkalaatikossa tai Developer Edition -organisaatiossa.

Koodia kannattaa kehittää ensin hiekkalaatikkoympäristössä ja sitten ottaa se käyttöön tuotantoympäristössä alla olevan esimerkin mukaisesti:

Apex-koodin kehitystyökalut: Seuraavat kolme työkalua ovat käytettävissä Apex-koodin kehittämiseen kaikissa Salesforce-versioissa:

• Kehittäjäkonsoli
• Visual Studio Code Salesforce Extension Packilla (tämä korvaa käytöstä poistetun Force.com IDE:n)
• Code editori Salesforce-määritysten käyttöliittymässä

Kun ympäristösi on valmis, tarkastellaanpa itse kielen rakennuspalikoita, aloittaen tietotyypeistä.

Apexin tietotyypit

Apex tukee seuraavia tietotyyppejä:

primitiivinen

Kokonaisluku, Double, Long, Date, Datetime, Decimal, Time, Blob, String, ID ja Boolean katsotaan alkeellisiksi tietotyypeiksi. Kaikki alkeelliset tietotyypit välitetään arvon, ei viitteen perusteella.

Kaikki tuotteet

Apexissa on saatavilla kolmenlaisia ​​kokoelmia:

• Lista: Se on järjestetty kokoelma primitiivien, sObjektien, kokoelmien tai indekseihin perustuvien Apex-objektien joukkoa.
• Sarja: Järjestämätön kokoelma ainutlaatuisia elementtejä, jotka eivät sisällä kaksoiskappaleita.
• Kartta: Se on kokoelma yksilöllisiä avaimia, jotka on yhdistetty yksittäisiin arvoihin. Nämä arvot voivat olla primitiivi-objekteja, sObject-objekteja, kokoelmia tai Apex-objekteja.

sObjekti

Tämä on erityinen tietotyyppi Salesforcessa. Se on samanlainen kuin pöytä SQL ja sisältää kenttiä, jotka ovat samanlaisia ​​kuin SQL:n sarakkeet.

Enums

Enum on vatsalihastract-tietotyyppi, joka tallentaa yhden arvon äärellisestä joukosta määritettyjä tunnisteita.

Luokat, objektit ja rajapinnat

Käyttäjän määrittämiä Apex-luokkia ja -rajapintoja voidaan myös käyttää tietotyyppeinä. Objekti viittaa minkä tahansa Apexissa tuetun tietotyypin instanssiin.

Apexin syntaksi

Muuttuva ilmoitus

Koska Apex on vahvasti tyypitetty kieli, Apexissa on pakollista deklaroida muuttuja, jolla on tietotyyppi.

Esimerkiksi:

Contact con = new Contact();

Tässä muuttuja con deklaroidaan ja sen tietotyyppi on Contact.

SOQL-kysely

SOQL on lyhenne sanoista Salesforce Object Query Language. SOQL:ää käytetään sObject-tietueiden hakemiseen Salesforce-tietokannasta. Esimerkiksi:

Account acc = [SELECT Id, Name FROM Account LIMIT 1];

Yllä oleva kysely hakee tilitietueen Salesforce-tietokannasta.

Loop lausunto

Silmukkalauseketta käytetään listan tietueiden läpikäymiseen. Iteraatioiden määrä on yhtä suuri kuin listan tietueiden määrä. Esimerkiksi:

List<Account> listOfAccounts = [SELECT Id, Name FROM Account LIMIT 100];
// iteration over the list of accounts
for(Account acc : listOfAccounts){
	//your logic
}

Yllä olevassa koodinpätkässä listOfAccounts on List-tietotyypin muuttuja.

Virtauksen ohjauslausunto

Virtauksenohjauslauseke on hyödyllinen, kun haluat suorittaa joitakin koodirivejä tiettyjen ehtojen perusteella.

Esimerkiksi:

List<Account> listOfAccounts = [SELECT Id, Name FROM Account LIMIT 100];
// execute the logic if the size of the account list is greater than zero
if(listOfAccounts.size() > 0){
	//your logic
}

Yllä oleva koodinpätkä kyselee tilitietueita tietokannasta ja tarkistaa listan koon.

DML-lausunto

DML on lyhenne sanoista Data Manipulation Language. DML-lauseita käytetään Salesforce-tietokannan tietojen käsittelyyn. Esimerkiksi:

Account acc = new Account(Name = 'Test Account');
insert acc; //DML statement to create account record.

Apex-käyttöoikeusmäärittelijät

Apexin tukemat käyttöoikeusmäärittelijät ovat seuraavat:

julkinen

Tämä käyttöoikeusmäärite antaa pääsyn luokkaan, metodiin tai muuttujaan, jota Apex käyttää nimiavaruudessa.

yksityinen

Tämä käyttöoikeusmäärite antaa pääsyn luokkaan, metodiin tai muuttujaan käytettäväksi paikallisesti tai koodin siinä osassa, jossa se on määritelty. Kaikki metodit ja muuttujat, joille ei ole määritelty käyttöoikeusmääritettä, käyttävät oletusarvoista private-käyttöoikeusmääritettä.

Suojattu

Tämä käyttöoikeusmäärite antaa pääsyn metodiin tai muuttujaan, jota määrittävän Apex-luokan sisäiset luokat voivat käyttää.

Global

Tämä käyttöoikeusmäärite antaa Apexille pääsyn luokkaan, metodiin tai muuttujaan, jota se voi käyttää sekä nimiavaruuden sisällä että sen ulkopuolella. On suositeltavaa olla käyttämättä global-avainsanaa, ellei se ole välttämätöntä.

Avainsanat Apexissa

Jakamisen kanssa

Jos luokka määritellään tällä avainsanalla, kaikkia nykyiseen käyttäjään sovellettavia jakamissääntöjä noudatetaan. Jos tätä avainsanaa ei ole, koodi suoritetaan järjestelmäkontekstissa.

Esimerkiksi:

public with sharing class MyApexClass{
// sharing rules enforced when code in this class executes
}

Ilman jakamista

Jos luokka on määritelty tällä avainsanalla, nykyiseen käyttäjään sovellettavia jakamissääntöjä ei noudateta.

Esimerkiksi:

public without sharing class MyApexClass{
// sharing rules are not enforced when code in this class executes
}

Staattinen

static-avainsanalla määritelty muuttuja tai metodi alustetaan kerran ja liitetään luokkaan. Staattisia muuttujia ja metodeja voidaan kutsua suoraan luokan nimellä ilman, että luokasta luodaan instanssia.

pää

Avainsanalla final määriteltyä vakiota tai metodia ei voida korvata. Esimerkiksi:

public class myCls {
static final Integer INT_CONST = 10;
}

Jos yrität ohittaa tämän INT_CONST-muuttujan arvon, saat poikkeuksen – System.FinalException: Final variable has already been initialized.

Palata

Tämä avainsana palauttaa arvon menetelmästä. Esimerkiksi:

public String getName() {
return 'Test';
}

Null

Se määrittelee null-vakion ja se voidaan liittää muuttujaan. Esimerkiksi:

Boolean b = null;

Virtual

Jos luokka määritellään virtual-avainsanalla, sitä voidaan laajentaa ja korvata.

Abstract

Jos luokka määritellään abs-arvollatracavainsanalla t, sen on sisällettävä vähintään yksi metodi, jossa on avainsana abstract, ja kyseisellä metodilla tulisi olla vain allekirjoitus.

Esimerkiksi:

public abstract class MyAbstractClass {
abstract Integer myAbstractMethod1();
}

Apex String

Merkkijono on joukko merkkejä, joilla ei ole merkkirajoitusta. Esimerkiksi:

String name = 'Test';

Salesforcen String-luokka tarjoaa useita sisäänrakennettuja metodeja. Seuraavassa on muutamia usein käytettyjä metodeja:

lyhentää (maxWidth)

Tämä metodi katkaisee merkkijonon määritettyyn pituuteen ja palauttaa sen, jos annetun merkkijonon pituus on pidempi kuin määritetty pituus; muussa tapauksessa se palauttaa alkuperäisen merkkijonon. Jos maxWidth-muuttujan arvo on pienempi kuin 4, metodi heittää ajonaikaisen poikkeuksen – System.StringException: Lyhenteen vähimmäisleveys on 4.

Esimerkiksi:

String s = 'Hello World';
String s2 = s.abbreviate(8);
System.debug('s2: ' + s2); //Hello...

isoilla kirjaimilla ()

Tämä menetelmä muuntaa merkkijonon ensimmäisen kirjaimen otsikon kirjainkoon ja palauttaa sen.

Esimerkiksi:

String s = 'hello';
String s2 = s.capitalize();
System.assertEquals('Hello', s2);

sisältää (alimerkkijono)

Tämä metodi palauttaa arvon true, jos metodia kutsuva merkkijono sisältää määritetyn alimerkkijonon.

String name1 = 'test1';
String name2 = 'test';
Boolean flag = name1.contains(name2);
System.debug('flag:: ' + flag); //true

yhtä kuin(merkkijonoId)

Tämä metodi palauttaa arvon true, jos välitetty parametri ei ole null ja edustaa samaa binääristä merkkijonoa kuin metodia kutsuva merkkijono.

Kun Id-arvoja verrataan, ID-tunnusten pituudet eivät välttämättä ole yhtä suuret. Esimerkiksi jos 15-merkkistä ID:tä edustavaa merkkijonoa verrataan 18-merkkistä ID:tä edustavaan objektiin, tämä metodi palauttaa silti arvon true. Esimerkiksi:

String stringValue15 = '001D000000Ju1zH';
Id idValue18 = '001D000000Ju1zHIAR';
Boolean result = stringValue15.equals(idValue18);
System.debug('result: ' + result); //true

Yllä olevassa esimerkissä equals-metodi vertaa 15-merkkistä objekti-ID:tä 18-merkkiseen objekti-ID:hen, ja jos molemmat ID:t edustavat samaa binäärisekvenssiä, se palauttaa arvon true.

Käytä tätä menetelmää kirjainkoon erottelun vertailuun.

escapeSingleQuotes (merkkijonoEscape)

Tämä metodi lisää koodinvaihtomerkin (\) ennen mitä tahansa merkkijonossa olevaa yksittäistä lainausmerkkiä ja palauttaa tuloksen. Tämä metodi estää SOQL-injektion dynaamista SOQL-kyselyä luotaessa. Se varmistaa, että kaikkia yksittäisiä lainausmerkkejä käsitellään sulkeutuvina merkkijonoina tietokantakomentojen sijaan.

Esimerkiksi:

String s = 'Hello \'Tom\'';
String escapedStr = String.escapeSingleQuotes(s);
System.debug(escapedStr); // Outputs Hello \'Tom\'

poista (alimerkkijono)

Tämä metodi poistaa kaikki mainitun alimerkkijonon esiintymät metodia kutsuvasta merkkijonosta ja palauttaa tuloksena olevan merkkijonon.

Esimerkiksi:

String s1 = 'Salesforce and force.com';
String s2 = s1.remove('force');
System.debug('s2: ' + s2); // 'Sales and .com'

osamerkkijono (aloitusindeksi)

Tämä metodi palauttaa alimerkkijonon, joka alkaa startIndex-kohdasta merkityllä merkillä ja jatkuu merkkijonon loppuun.

Esimerkiksi:

String s1 = 'hamburger';
String s2 = s1.substring(3);
System.debug('s2: ' + s2); //burger

käänteinen()

Tämä metodi kääntää merkkijonon kaikki merkit päinvastaisiksi ja palauttaa sen. Esimerkiksi:

String s = 'Hello';
String s2 = s.reverse();
System.debug('s2:::: ' + s2); // olleH

trimmata()

Tämä metodi poistaa merkkijonosta kaikki alusta ja takaa tulevat välilyönnit ja palauttaa sen.

valueOf(muunnettava)

Tämä metodi palauttaa syötetyn objektin merkkijonoesityksen.

Merkkijonot, luokat ja avainsanat yhdistyvät, kun alat pakata logiikkaa uudelleenkäytettäviin yksiköihin, ja juuri tähän Apex-luokat ovat olemassa.

Apex-luokka

Apex-luokka on suunnitelma tai malline, josta objektit luodaan. Objekti on luokan instanssi.

Apex-luokkia voi luoda Salesforcessa kolmella tavalla:

• Kehittäjäkonsoli
• Visual Studio Code Salesforce-laajennuspaketin avulla
• Apex-luokan tietosivu Määritykset-valikossa

Apexissa voit määritellä ulkoluokan, jota kutsutaan myös ylimmän tason luokaksi, ja voit myös määrittää ulkoluokan sisällä olevia luokkia, joita kutsutaan sisäluokiksi.

Ulkoluokan määrittelyssä on pakollista käyttää käyttöoikeusmäärettä, kuten global tai public.

Sisäluokkien määrittelyssä ei ole välttämätöntä käyttää käyttöoikeusmäärettä.

Apex-luokka määritellään avainsanalla class, jota seuraa luokan nimi.

Avainsanaa extends käytetään Apex-luokan olemassa olevan luokan laajentamiseen ja avainsanaa implements käytetään rajapinnan toteuttamiseen Apex-luokassa.

Salesforce Apex ei tue moniperintää; Apex-luokka voi laajentaa vain yhtä olemassa olevaa Apex-luokkaa, mutta se voi toteuttaa useita rajapintoja.

Apex-luokka voi sisältää käyttäjän määrittämän konstruktorin, ja jos käyttäjän määrittämää konstruktoria ei ole saatavilla, käytetään oletuskonstruktoria. Konstruktorin koodi suoritetaan, kun luokan instanssi luodaan.

Apex-luokan syntaksi:

public class myApexClass{
// variable declaration
//constructor
	public myApexClass(){
	}
//methods declaration
}

Avainsanaa new käytetään Apex-luokan instanssin luomiseen. Alla on syntaksi Apex-luokan instanssin luomiseksi:

myApexClass obj = new myApexClass();

Apex Getter ja setteri

Apex-ominaisuus on samankaltainen kuin Apex-muuttuja. Apex-ominaisuudelle tarvitaan getter ja setter. Niitä voidaan käyttää koodin suorittamiseen ennen ominaisuuden arvoon pääsemistä tai sen muuttamista. get-akcessorin koodi suoritetaan, kun ominaisuuden arvo luetaan. set-akcessorin koodi suoritetaan, kun ominaisuuden arvoa muutetaan. Kaikkia ominaisuuksia, joilla on vain get-akcessor, pidetään vain luku -oikeuksina, kaikkia ominaisuuksia, joilla on vain set-akcessor, pidetään vain kirjoitusoikeuksina, ja kaikkia ominaisuuksia, joilla on sekä get- että set-akcessorit, pidetään luku- ja kirjoitusoikeuksina. Apex-ominaisuuden syntaksi:

public class myApexClass {
// Property declaration
	access_modifier return_type property_name {
	get {
			//code
		}
		set{
			//code
		}
	}
}

Tässä access_modifier on ominaisuuden käyttöoikeusmääre, return_type on ominaisuuden tietotyyppi ja property_name on ominaisuuden nimi.

Alla on esimerkki Apex-ominaisuudesta, jolla on sekä get- että set-akussorit:

public class myApex{
	public String name{
		get{ return name; }
		set{ name = value; }
	}
}

Tässä ominaisuuden nimi on name, se on julkinen ominaisuus ja palauttaa merkkijono-tietotyypin.

get- ja set-lohkoissa ei ole pakollista olla koodia. Nämä lohkot voidaan jättää tyhjiksi automaattisen ominaisuuden määrittämiseksi. Esimerkiksi:

public double MyReadWriteProp{ get; set; }

Get- ja set-käyttöoikeudet voidaan määrittää myös omilla käyttöoikeusmääritteillään. Jos käyttöoikeusmäärite on määritelty määritteen kanssa, se ohittaa ominaisuuden käyttöoikeusmääritteen. Esimerkiksi:

public String name{private get; set;}// name is private for read and public for write.

Luokat määrittelevät uudelleenkäytettävän logiikan, jota kutsutaan eksplisiittisesti. Seuraavaksi käsiteltävät liipaisimet (triggerit) suoritetaan automaattisesti aina, kun tietueet muuttuvat.

Apex Trigger

Apex-käynnistimet mahdollistavat mukautetun Apexin suorittamisen ennen DML-toiminnon suorittamista ja sen jälkeen.

Apex tukee seuraavia kahden tyyppisiä liipaisimia:

Ennen liipaisimia: Näitä käynnistimiä käytetään kentän arvon validointiin ja päivittämiseen ennen tietueen tallentamista tietokantaan.

Liipaisimien jälkeen: Näitä käynnistimiä käytetään kenttien arvojen (kuten tietue-ID:n ja LastModifiedDate-kentän) käyttämiseen, jotka järjestelmä asettaa sen jälkeen, kun tietue on vahvistettu tietokantaan. Näitä kenttien arvoja voidaan käyttää muiden tietueiden muokkaamiseen. Käynnistimien jälkeen käynnistyvät tietueet ovat vain luku -tilassa.

Bulk-triggerien kirjoittaminen on paras käytäntö. Bulk-triggeri voi käsitellä sekä yhden että useita tietueita kerrallaan.

Apex-liipaisimen syntaksi:

trigger TriggerName on ObjectName (trigger_events) {
	//Code_block
 }

Tässä TriggerName on liipaisimen nimi, ObjectName on sen objektin nimi, johon liipaisu on kirjoitettu, ja trigger_events on pilkuilla erotettu tapahtumien luettelo.

Apex-käynnistimet tukevat seuraavia tapahtumia: ennen lisäystä, ennen päivitystä, ennen poistoa, lisäyksen jälkeen, päivityksen jälkeen, poiston jälkeen ja poiston palautuksen jälkeen.

Staattisia avainsanoja ei voi käyttää Apex-liipaisimessa. Kaikkia sisäluokkiin sovellettavia avainsanoja voidaan käyttää Apex-liipaisimessa.

Jokainen triggeri määrittelee implisiittisiä muuttujia, jotka palauttavat ajonaikaisen kontekstin. Nämä muuttujat on määritelty System.Trigger-luokassa ja niitä kutsutaan kontekstimuuttujiksi. Alla olevat kaksi kuvakaappausta listaavat Apex-triggerien tukemat kontekstimuuttujat:

Seuraavassa on huomioitavia asioita Apex-käynnistimien kontekstimuuttujista:

• Älä käytä trigger.new- ja trigger.old-muuttujaa DML-toiminnoissa.
• Trigger.new-tiedostoa ei voi poistaa.
• Trigger.new on vain luku -tilassa triggerien jälkeen.
• Trigger.new-funktiota voidaan käyttää saman objektin kenttien arvojen muuttamiseen vain ennen käynnistystä.

Alla olevat kaksi kuvakaappausta listaavat huomioitavia asioita tietyistä toimista eri laukaisutapahtumissa:

Triggerit käsittelevät reaaliaikaista logiikkaa, mutta jotkin työt ovat yksinkertaisesti liian suuria yhdeksi transaktioksi. Tässä kohtaa Apex-erälaskenta tulee mukaan kuvaan.

Eräluokka Apexissa

Salesforcessa eräajoluokkaa käytetään käsittelemään suuri määrä tietueita, jotka normaalisti käsiteltäessä ylittäisivät Apex-hallintarajoitukset. Eräluokka suorittaa koodin asynkronisesti.

Eräluokan edut ovat seuraavat:

• Eräluokka käsittelee tiedot lohkoissa, ja jos yhden lohkon käsittely epäonnistuu, onnistuneesti käsiteltyjä lohkoja ei peruta.
• Jokainen eräluokan tietokokonaisuus käsitellään uusilla hallintaohjelman rajoituksilla, mikä varmistaa, että koodi suoritetaan hallintaohjelman suoritusrajojen puitteissa.

Database.Batchable-rajapinnan on oltava toteutettu Apex-luokalla, jotta sitä voidaan käyttää eräajoluokkana. Se tarjoaa kolme metodia, jotka eräajoluokan on toteutettava:

1. aloita()

Tämä metodi luo rajapinnan execute-metodin käsittelemien tietueiden tai objektien laajuuden. Sitä kutsutaan vain kerran eräajon suorituksen aikana. Tämä metodi palauttaa joko Database.QueryLocator-objektin tai iteroitavan tietueen. Database.QueryLocator-objektia käyttämällä SOQL-kyselyllä voidaan noutaa 50 miljoonaa tietuetta, mutta iteroitavaa tietuetta käytettäessä SOQL-kyselyllä voidaan noutaa vain 50 000 tietuetta. Iteroitavaa tietuetta käytetään monimutkaisen laajuuden luomiseen eräajoluokalle.

start-metodin syntaksi:

global (Database.QueryLocator | Iterable<sObject>) start(Database.BatchableContext bc) {}

2. suorita()

Tätä metodia käytetään jokaisen tietolohkon käsittelyyn. Suoritusmetodia kutsutaan jokaiselle tietuelohkolle. Suorituserän oletuskoko on 200 tietuetta. Suoritusmetodi ottaa vastaan ​​kaksi argumenttia:

Viittaus Database.BatchableContext-objektiin,

sObject-luettelo, kuten List , tai luettelo parametrisoiduista tyypeistä. Suoritusmetodin syntaksi:

global void execute(Database.BatchableContext bc, List<P> records){}

3. viimeistely()

finish-metodia kutsutaan kerran eräkäsittelyluokan suorituksen aikana. finish-metodissa voidaan suorittaa jälkikäsittelyoperaatioita. Esimerkiksi: vahvistussähköpostin lähettäminen. Tätä metodia kutsutaan, kun kaikki erät on käsitelty. finish-metodin syntaksi:

global void finish(Database.BatchableContext bc){}

Database.BatchableContext-objekti

Jokaisella Database.Batchable-rajapinnan metodilla on viittaus Database.BatchableContext-objektiin.

Tätä objektia käytetään track eräajon edistyminen.

Seuraavat ovat BatchableContextin tarjoamat instanssimetodit:

• getChildJobId(): Tämä metodi palauttaa parhaillaan käsiteltävänä olevan eräajon tunnuksen.
• getJobId(): Tämä menetelmä palauttaa erätyön tunnuksen.

Alla on eräluokan syntaksi:

global class MyBatchClass implements Database.Batchable<sObject> {
	global (Database.QueryLocator | Iterable<sObject>) start(Database.BatchableContext bc) {
// collect the batches of records or objects to be passed to execute
}
global void execute(Database.BatchableContext bc, List<P> records){
// process each batch of records
}
global void finish(Database.BatchableContext bc){
// execute any post-processing operations
}
}

Database.executeBatch-menetelmä

Database.executeBatch-metodia käytetään eräajoluokan suorittamiseen.

Tämä metodi ottaa kaksi parametria: käsiteltävän eräluokan instanssin ja valinnaisen scope-parametrin, joka määrittää erän koon. Jos sitä ei ole määritetty, käytetään oletusarvoista kokoa 200.

Database.executeBatch-funktion syntaksi:

Database.executeBatch(myBatchObject, scope)

Suoritetaan eräluokkaa nimeltä MyBatchClass:

MyBatchClass myBatchObject = new MyBatchClass();
Id batchId = Database.executeBatch(myBatchObject, 100);

Tietokanta.Tilallinen

Eräluokka on oletusarvoisesti tilaton. Joka kerta, kun suoritusmetodia kutsutaan, objektista vastaanotetaan uusi kopio ja kaikki luokan muuttujat alustetaan.

Database.Stateful on toteutettu tekemään eräluokasta tilallisen.

Jos eräajoluokkasi toteuttaa tietokantaTilatietoinen rajapinta, kaikki instanssimuuttujat säilyttävät arvonsa, mutta staattiset muuttujat nollataan tapahtumien välillä.

Asynkroninen Apex Beyond Batch

Batch Apex on vain yksi monista tavoista suorittaa koodia asynkronisesti. Salesforce tarjoaa neljä asynkronista vaihtoehtoa, ja oikean valinta riippuu siitä, kuinka paljon dataa käsittelet ja onko työt ketjutettava vai ajoitettava.

• Tulevaisuuden menetelmät: @future-merkinnällä varustetut nämä sopivat parhaiten yksinkertaisiin, käynnistys- ja unohdustoimintoihin, kuten ulkoisiin verkkopalveluihin tehtäviin kutsuihin.
• Jonotettava Apex: Toteuttaa Queueable-rajapinnan, hyväksyy monimutkaisia ​​objektityyppejä, palauttaa työtunnuksen ja tukee työtehtävien ketjuttamista toiseen.
• Erä Apex: Käsittelee erittäin suuria tietomääriä paloina, kuten edellä on kuvattu.
• Ajoitettu Apex: Toteuttaa Schedulable-rajapinnan, jotta luokka suoritetaan tiettyyn aikaan, kuten yöllinen siivoustyö.

Tyyppi	Best For	Avainominaisuus
Tuleva menetelmä	Yksinkertaiset huomiotekstit	Tulen ja unohda
Jonotettava Apex	Jaksottainen käsittely	Työketjutus ja seuranta
Erä Apex	Miljoonia tietueita	Paloiteltu käsittely
Ajoitettu Apex	Toistuvat työt	Cron-pohjainen ajoitus

Valitsemastasi toteutusmallista riippumatta jokaista tapahtumaa mitataan edelleen alla lueteltuja alustakohtaisia ​​​​hallitsijarajoituksia vasten.

Apex Governor Limits

Apex-hallintarajoitukset ovat Apex-suoritusmoottorin valvomia rajoituksia sen varmistamiseksi, että karkaava Apex-koodi ja -prosessit eivät monopolisoi jaettuja resursseja eivätkä häiritse muiden käyttäjien käsittelyä monivuokraajaympäristössä. Nämä rajoitukset tarkistetaan jokaista Apex-tapahtumaa kohden. Seuraavat hallintarajoitukset on määritelty Salesforcen toimesta jokaiselle Apex-tapahtumalle:

Tuotetiedot	Raja
SOQL-kyselyt, jotka voidaan tehdä synkronisessa tapahtumassa	100
SOQL-kyselyt, jotka voidaan tehdä asynkronisessa tapahtumassa	200
Tietueet, jotka voidaan noutaa SOQL-kyselyllä	50,000
Tietueet, jotka Database.getQueryLocator voi noutaa	10,000
Apex-tapahtumassa suoritettavat SOSL-kyselyt	20
Tietueet, jotka voidaan noutaa SOSL-kyselyllä	2,000
Apex-tapahtumassa suoritettavat DML-lausekkeet	150
Tietueet, jotka voidaan käsitellä DML-käskyn, Approval.processin tai database.emptyRecycleBinin tuloksena	10,000
Apex-tapahtumassa tehtävät callout-kutsut	100
Apex-tapahtumassa suoritettavien kaikkien kutsujen kumulatiivinen aikakatkaisuraja	120 sekuntia
System.enqueueJob-jonoon lisättävien Apex-töiden raja	50
Toteutusaikaraja jokaiselle Apex-tapahtumalle	10 minuuttia
Apex-luokassa ja -liipaisimessa käytettävien merkkien rajoitus	1 euroa
Synkronisen tapahtuman suorittimen aikaraja	10,000 millisekuntia
Asynkronisen tapahtuman suorittimen aikaraja	60,000 millisekuntia
Keon kokonaiskoko	6 Mt (synkroninen) / 12 Mt (asynkroninen)

Kuinka kirjoittaa testiluokka Apexissa

Salesforce vaatii, että vähintään 75 prosenttia Apex-koodistasi on katettu yksikkötesteillä, ennen kuin voit ottaa sen käyttöön tuotantoympäristössä, ja jokaisen triggerin on oltava jollain tavalla katettu. Testiluokkien kirjoittaminen on siksi Apex-ydintaito, ei valinnainen lisä.

Testiluokka annotoidaan @isTest-tunnisteella, ja jokainen testimetodi merkitään myös @isTest-tunnisteella. Testimetodit eivät tallenna tietoja tietokantaan eivätkä näe useimpia olemassa olevia organisaatiotietoja, joten jokainen testi luo omat tietueensa. Test.startTest()- ja Test.stopTest()-metodit antavat testattavalle koodille uudet hallintarajoitukset, ja väitteet varmistavat, että logiikka toimi odotetulla tavalla.

Tässä on yksinkertainen testiluokka tilin luomislogiikalle:

@isTest
private class AccountHandlerTest {
    @isTest
    static void testCreateAccount() {
        Account acc = new Account(Name = 'Test Account');
        Test.startTest();
        insert acc;
        Test.stopTest();
        Account result = [SELECT Id, Name FROM Account WHERE Id = :acc.Id];
        System.assertEquals('Test Account', result.Name);
    }
}

Noudata näitä ohjeita kirjoittaessasi kokeita:

• Käytä @testSetup-metodia luodaksesi jaetun testidatan kerran kaikille luokan testimetodeille.
• Testaa joukkotoimintoja lisäämällä 200 tietuetta yhden sijaan.
• Käsittele positiivisia, negatiivisia ja rajoitetun käyttäjän skenaarioita.
• Sisällytä aina merkitykselliset System.assert-lauseet; kattavuus ilman väitteitä ei todista mitään.

Apexin parhaat käytännöt

Aloittelijat kirjoittavat usein Apex-koodia, joka toimii yhden tietueen kanssa, mutta epäonnistuu todellisuudessa joukkooperaatioissa. Seuraavat käytännöt pitävät koodisi hallintarajojen sisällä ja helpommin ylläpidettävänä:

• Kookkaa kaikki: Kirjoita logiikka, joka käsittelee tietuekokoelmia, koska käynnistimet voivat vastaanottaa jopa 200 tietuetta yhdessä erässä.
• Pidä SOQL ja DML poissa silmukoista: Kysely ennen silmukkaa, kerää muutokset listaan ​​ja suorita yksi DML-lauseke silmukan jälkeen.
• Yksi liipaisin objektia kohden: Pidä liipaisimet logiikkavapaina ja delegoi työ käsittelijäluokille, mikä tekee suoritusjärjestyksestä ennustettavan.
• Käytä jakamisen kanssa: Käytä tietuetason suojausta, ellei ole dokumentoitua syytä suorittaa sitä järjestelmäkontekstissa.
• Vältä tunnisteiden kovakoodausta: Tietue-ID:t eroavat eri hiekkalaatikoiden ja tuotantoympäristöjen välillä, joten hae niitä tai käytä mukautettuja metatietoja.
• Koodin rajoitusten valvonta: Limits-luokan metodit, kuten Limits.getQueries(), antavat sinun tarkistaa resurssien kulutuksen suorituksen aikana.

💡 Vinkki: Suorita koodisi 200 tietueen verran hiekkalaatikossa ennen käyttöönottoa. Useimmat hallintarajoitusten virheet ilmenevät vain suurissa määrissä, ja niiden havaitseminen varhain on paljon halvempaa kuin niiden virheenkorjaus tuotannossa.

UKK