Lokin ja jäljityksen analysointitoiminto sisältää seuraavien kirjausapuohjelmien erillisen ja lisäosien tuen:
Tuki sisältää seuraavat toiminnot:
Seuraavat lisäosat sisältävät tämän tuen:
Kirjausapuohjelma |
Lisäosan JAR-tiedostot |
---|---|
Java-kirjaus (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Apache Jakarta Commons -kirjaus |
org.eclipse.hyades.logging.core\hlcommons.jar |
Apache Jakarta Log4J -kirjaus |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event V1.0.1 -kirjaus |
org.eclipse.hyades.logging.core\hlcbe101.jar |
Seuraavissa osissa on kuvattu kunkin kirjausapuohjelman tukilajin tietoja, ja osissa on ohjeita esimerkkiohjelmista, jotka esittelevät kirjaustoiminnon käyttöä.
Pakettiin org.eclipse.hyades.logging.java14 sisältyvän luokan java.util.logging.LogRecord laajennuksen avulla voit luoda mukautetun lokitietueen tapahtuman org.eclipse.hyades.logging.events.cbe.CommonBaseEvent kirjausta varten tietueessa java.util.logging.LogRecord. Tämä tietue org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord laajentaa tietueen java.util.logging.LogRecord ja sisältää viittauksen tapahtumaan org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Kaikki tietueen java.util.logging.LogRecord ominaisuudet on määritetty vastaamaan vähintään yhtä Common Base Event -ominaisuutta, jotta voidaan joustaa muiden kuin Common Base Event -tapahtumien havaitsemisessa tarvittavien käsittely- ja muotoilutoimintojen osalta.
Pakettiin org.eclipse.hyades.logging.java14 sisältyvän liittymän java.util.logging.Filter toteutus sallii vain org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord -lokitietueiden kirjauksen.
Pakettiin org.eclipse.hyades.logging.java14 sisältyvän abstraktin luokan java.util.logging.Formatter laajennuksen avulla voit määrittää käsittelytoiminnot muotoilemaan org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- ja java.util.logging.LogRecord-lokisanomat XML-muotoon. Tämä muotoilutoiminto org.eclipse.hyades.logging.java14.XmlFormatter muuntaa org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord - tai java.util.logging.LogRecord-lokisanomat XML-muotoon Common Base Event -ohjelman version 1.0.1 skeeman mukaisesti. Muotoilun aikana lokisanomasta tarkistetaan, toteuttaako se rajapinnan org.eclipse.hyades.logging.core.IExternalizableToXml (esim. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Jos se toteuttaa, sovellusohjelmaliittymää (API) externalizeCanonicalXmlString() kutsutaan XML-järjestysnumeroinnin sijasta. Muussa tapauksessa java.util.logging.LogRecord-lokisanoma muunnetaan Common Base Event -objektiksi saman vastaavuusmäärityksen avulla kuin tapahtumassa org.eclipse.hyades.logging.events.cbe.CommonBaseEvent ja muutetaan XML-muotoon kutsumalla sovellusohjelmaliittymää (API)externalizeCanonicalXmlString().
Pakettiin org.eclipse.hyades.logging.java kuuluvan abstraktin luokan java.util.logging.Handler laajennuksen avulla kirjaustoiminnot voidaan määrittää kirjaamaan
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- ja
java.util.logging.LogRecord-lokisanomat kirjausagenttiin.
Tällä käsittelytoiminnolla org.eclipse.hyades.logging.java.LoggingAgentHandler tarkistetaan, voidaanko kirjaustoimintoon kirjattu org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord- tai java.util.logging.LogRecord -lokisanoma kirjata kirjaustoiminnon ja käsittelytoiminnon suodattimen ja kirjaustason mukaan. Jos lokisanoma kirjataan, kirjausagentin nimi selvitetään sanoman kirjanneen kirjaustoiminnon nimen avulla. Muussa tapauksessa voit käyttää käsittelytoimintoa org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, joka luo yhden Logging Agent Handler -nimisen kirjausagentin. Sanoma muotoillaan XML-muotoon muotoilutoiminnon org.eclipse.hyades.logging.java.XmlFormatter avulla ja kirjoitetaan kirjausagenttiin.
Kuvaava esimerkkiohjelma
Esimerkkiohjelmasta näkee, miten JSR-047-Java-kirjauksen tukea hyödynnetään, kuvaamalla kokoonpano ja instrumentointi, joita tarvitaan JSR-047-Java-kirjauksen erillisen tuen ja lisäosatuen uusia ja aiempia käyttäjiä varten. Saat lisätietoja valitsemalla vaihtoehdot Tiedosto > Uusi > Esimerkki... > JSR-047-kirjausmalli.
Pakettiin org.eclipse.hyades.logging.commons sisältyvän rajapinnan org.apache.commons.logging.Log toteutuksen avulla voit luoda kirjaustoiminnon org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- ja java.lang.Throwable-lokisanomien kirjaukseen. Tämä kirjaustoiminto org.eclipse.hyades.logging.commons.Logger tarkistaa, voidaanko kirjaustoimintoon kirjattu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- tai java.lang.Throwable-lokisanoma kirjata kirjaustoiminnon kirjaustason mukaan. Jos lokisanoma voidaan kirjata, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- tai java.lang.Throwable-lokisanoma muotoillaan ja kirjataan. Abstraktin luokan org.apache.commons.logging.LogFactory toteutus esittelee välityspalvelimen factory-metodin, joka liittyy org.eclipse.hyades.logging.commons.Logger-ilmentymiin. Tätä välityspalvelimen org.eclipse.hyades.logging.commons.LoggerFactory-factory-metodia on tarkoitus käyttää useissa luokanlataustoiminnon ympäristöissä, joissa kukin erillinen luokanlataustoiminto edellyttää vähintään yhden lajista kirjaustoimintoa sekä sen factory-metodia. Kaikki luokanlataustoiminnot käyttävät samoja Apache Commons -binaaritiedostoja.
Kirjaustoiminto org.eclipse.hyades.logging.commons.Logger muotoilee org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- ja java.lang.Throwable-lokisanomat XML-muotoon Common Base Event -ohjelman version 1.0.1 skeeman mukaisesti. Muotoilun aikana lokisanomasta tarkistetaan, toteuttaako se rajapinnan org.eclipse.hyades.logging.core.IExternalizableToXml (esimerkiksi org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Jos se toteuttaa, sovellusohjelmaliittymää (API) externalizeCanonicalXmlString() kutsutaan XML-järjestysnumeroinnin sijasta. Muussa tapauksessa java.lang.Object- tai java.lang.Throwable-lokisanoma muunnetaan Common Base Event -objektiksi metodien org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() avulla ja muotoillaan XML-muotoon kutsumalla externalizeCanonicalXmlString() sovellusohjelmaliittymää (API).
Kirjaustoiminto org.eclipse.hyades.logging.commons.Logger kirjaa org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- ja java.lang.Throwable-lokisanomat kirjausagenttiin. Jos lokisanoma kirjataan, kirjausagentin nimi selvitetään sanoman kirjanneen kirjaustoiminnon nimen avulla. Sanoma muotoillaan XML-muotoon ja kirjoitetaan kirjausagenttiin.
Pakettiin org.eclipse.hyades.logging.commons sisältyvän rajapinnan org.apache.commons.logging.Log toteutuksen avulla voit luoda kirjaustoiminnon org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- ja java.lang.Throwable-lokisanomien kirjaukseen paikalliseen tiedostoon. Tämä kirjaustoiminto org.eclipse.hyades.logging.commons.FileLogger tarkistaa, voidaanko kirjaustoimintoon kirjattu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- tai java.lang.Throwable-lokisanoma kirjata kirjaustoiminnon kirjaustason mukaan. Jos lokisanoma voidaan kirjata, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-, java.lang.Object- tai java.lang.Throwable-lokisanoma muotoillaan XML-muotoon ja kirjataan paikalliseen tiedostoon. Abstraktin luokan org.apache.commons.logging.LogFactory toteutus esittelee välityspalvelimen factory-metodin, joka liittyy org.eclipse.hyades.logging.commons.FileLogger-ilmentymiin. Tätä välityspalvelimen org.eclipse.hyades.logging.commons.FileLoggerFactory-factory-metodia on tarkoitus käyttää useissa luokanlataustoiminnon ympäristöissä, joissa kukin erillinen luokanlataustoiminto edellyttää vähintään yhden lajista kirjaustoimintoa sekä sen factory-metodia. Kaikki luokanlataustoiminnot käyttävät samoja Apache Commons -binaaritiedostoja.
Kuvaava esimerkkiohjelma
Esimerkkiohjelmasta näkee, miten Apache Jakarta Commons -kirjauksen tukea hyödynnetään, kuvaamalla kokoonpano ja instrumentointi, joita tarvitaan Apache Jakarta Commons -kirjauksen erillisen tuen ja lisäosatuen uusia ja aiempia käyttäjiä varten. Saat lisätietoja valitsemalla vaihtoehdot Tiedosto > Uusi > Esimerkki... > Apache Commons -kirjausmalli.
Lokisanoman org.apache.log4j.spi.LoggingEvent sanomaominaisuuden avulla voit kirjata org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-tapahtuman.
Pakettiin org.eclipse.hyades.logging.log4j sisältyvän abstraktin luokan org.apache.log4j.spi.Filter laajennuksen avulla voidaan kirjata vain org.eclipse.hyades.logging.events.cbe.CommonBaseEvent-tapahtumia.
Pakettiin org.eclipse.hyades.logging.log4j sisältyvän abstraktin luokan org.apache.log4j.Layout laajennuksen avulla voit määrittää liitostoiminnot, jotka muotoilevat org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- ja org.apache.log4j.spi.LoggingEvent-lokisanomat XML-muotoon. Tämä muotoilutoiminto org.eclipse.hyades.logging.log4j.XmlLayout muuntaa org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- tai org.apache.log4j.spi.LoggingEvent-lokisanomat XML-muotoon Common Base Event -ohjelman version 1.0.1 skeeman mukaisesti. Muotoilun aikana lokisanomasta tarkistetaan, toteuttaako org.apache.log4j.spi.LoggingEvent-lokisanoman sanomaominaisuus rajapinnan org.eclipse.hyades.logging.core.IExternalizableToXml (esimerkiksi org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Jos se toteuttaa, sovellusohjelmaliittymää (API) externalizeCanonicalXmlString() kutsutaan XML-järjestysnumeroinnin sijasta. Muussa tapauksessa org.apache.log4j.spi.LoggingEvent-lokisanoma muunnettaan Common Base Event -objektiksi metodien org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() avulla ja muotoillaan XML-muotoon kutsumalla sovellusohjelmaliittymää (API) externalizeCanonicalXmlString().
Pakettiin org.eclipse.hyades.logging.log4j sisältyvän abstraktin luokan org.apache.log4j.AppenderSkeleton
laajennuksen avulla kirjaustoiminto voidaan määrittää kirjaamaan
org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- ja
org.apache.log4j.spi.LoggingEvent-lokisanomat kirjausagenttiin.
Tämä liitostoiminto org.eclipse.hyades.logging.log4j.LoggingAgentAppender tarkistaa, voidaanko kirjaustoimintoon kirjattu org.eclipse.hyades.logging.events.cbe.CommonBaseEvent- ja org.apache.log4j.spi.LoggingEvent-lokisanoma kirjata kirjaustoiminnon ja liitostoiminnon suodattimen ja kirjaustason mukaan. Jos lokisanoma kirjataan, kirjausagentin nimi selvitetään sanoman kirjanneen kirjaustoiminnon nimen avulla. Muussa tapauksessa voit käyttää liitostoimintoa org.eclipse.hyades.logging.log4j.SingleLoggingAgentAppender, joka luo yhden Logging Agent Appender -nimisen kirjausagentin. Sanoma muotoillaan XML-muotoon muotoilutoiminnon org.eclipse.hyades.logging.log4j.XmlLayout avulla ja kirjoitetaan kirjausagenttiin.
Kuvaava esimerkkiohjelma
Esimerkkiohjelman avulla esitetään, kuinka Apache Jakarta Log4J Logging -kirjauksen tukea voidaan kehittää. Esimerkissä kuvataan kokoonpano ja instrumentointi, joita Apache Jakarta Log4J Logging -kirjauksen erillisen tuen ja lisäosatuen uudet ja aiemmat käyttäjät tarvitsevat. Saat lisätietoja valitsemalla vaihtoehdot Tiedosto > Uusi > Esimerkki... > Apache Log4J -kirjausmalli.
Kuvaava esimerkkiohjelma
Esimerkkiohjelman avulla esitetään, kuinka EMF Common Base Events -kirjauksen tukea voidaan kehittää. Esimerkissä luodaan ja määritetään Common Base Events -tapahtumien kokoonpanoja käyttämällä Common Base Event -XML-mallipohjatiedostoa Event Factory. Saat lisätietoja valitsemalla vaihtoehdot Tiedosto >Uusi > Esimerkki... > EMF Common Base Event v1.0.1 -kirjausmalli.
Aiheeseen liittyviä käsitteitä
Common Base Event -malli
(C) Copyright IBM Corporation 2000, 2006. All rights reserved.