Probekit-yleiskuva

Probekit on kehys, jonka avulla Eclipse-ympäristössä voi kirjoittaa ja käyttää luotauksia. Luotaukset ovat Java™-koodin fragmentteja, jotka voi lisätä ohjelmaan. Ne antavat tietoja ohjelmasta sen ollessa ajossa.

Luotaukset selitetään seuraavassa esimerkkiluotauksen avulla. Se on perusluotaus, joka tulostaa sanoman, jossa yksilöidään jokainen ohjelman ajossa kutsuttu metodi.

Luotaukset määritetään Probekit-muokkausohjelmassa tehtyjen merkintöjen avulla. Tämä malli sisältää yhden fragmentin. Fragmentit määrittävät, mitä luotaus tekee. Fragmentin määrityksiä ovat seuraavat:

Luotaus näyttää seuraavalta Probekit-muokkausohjelmassa:

Probekit-muokkausohjelma, jossa näkyvät ohjeaiheessa kuvatun peruskoodimallin merkinnät.

Kun olet luonut luotauksen Probekit-muokkausohjelman avulla, voit käyttää sitä projektin luokka- ja jar-tiedostoissa. Kun sitten ajat projektin, fragmentin koodi ajetaan ohjelman mukana.

Seuraavassa on yleiskuvaus luotausten luonnista ja käytöstä sekä tietoja siitä, miten Probekit on hyödyksi:
  1. Voit luoda luotauksia Probekit-lähdetiedostoihin Probekit-muokkausohjelman avulla. Probekit-lähdetiedostoilla on oltava tunniste .probe. Ne voivat sisältää yhden luotauksen tai useita, ja kukin luotaus voi sisältää yhden luotausfragmentin tai useita.
  2. Probekit kokoaa luotausfragmentit joukoksi Java-metodeja ja kääntää ne sitten. Kun Probekit kääntää luotauksen, se yhdistää luotausfragmentit tavalliseen Java-vakiokoodiin ja muodostaa uuden luotausluokan Java-lähdekoodin. Luotausfragmenteista muodostetut funktiot näkyvät uudessa luotausluokassa staattisina metodeina.
  3. Kun käytät luotausta, määritä kohteena olevat luokka- ja jar-tiedostot, joita haluat tutkia. Probekitin BCI (byte-code instrumentation) -ohjelma viittaa käytettävissä olevien luotausten ja niiden kohdemerkkijonojen luetteloon ja lisää kohdeohjelmaan kutsuja luotausfragmentin metodeihin. Kutsukäskyjen lisäystä kohdemetodeihin kutsutaan instrumentoinniksi. Instrumentoidun metodin sisältävää luokkaa kutsutaan luodatuksi luokaksi. Luotausfragmentin pyytämät tietoalkiot (esimerkiksi metodin nimi ja luokan nimi) välitetään argumentteina.
  4. ###Kun sovellus on instrumentoitu. Luotausfragmentit ajetaan ohjelman ajon yhteydessä.
Luotausfragmentin tyyppi määrittää, milloin fragmentti ajetaan. Voit määrittää tyypit, joiden seurauksena fragmentti ajetaan seuraavissa tilanteissa:

Luotausfragmentit voivat käyttää tietoalkioita, jotka antavat erilaisia tietoja sovelluksesta siinä pisteessä, jossa ne on lisätty. Esimerkki:

Jos haluat käyttää luotausta vain tiettyihin luokkiin ja metodeihin, määritä kohteet tai aseta suodattimet. Lisätietoja on kohdassa Luotauksen kohdemääritykset ja suodattimet.

Liittyviä käsitteitä
Luotausten käsittely
Metodiluotaukset ja callsite-luotaukset
Aiheeseen liittyviä viitteitä
Probekit-esimerkkejä