Namai (J2EE)

Šiam straipsniui ar jo daliai trūksta išnašų į patikimus šaltinius. Jūs galite padėti Vikipedijai pridėdami tinkamas išnašas su šaltiniais.

Namai (angl. home) – speciali klasė, skirta jos valdomoms EJB pupoms sukurti arba (jei tai ilgalaikės pupos) surasti duomenų bazėje.

Namai turi vieną ar kelis pupų sukūrimo metodus (pupa inicializuojama panaudojant šių metodų parametrus) ir vieną ar kelis jų suradimo metodus (pupos ieškoma su atskirai nurodyta SQL užklausa, kuri generuojama panaudojant metodų parametrus). Visos ilgalaikės pupos (angl. entity beans) paprastai turi bent vieną paieškos metodą pupai rasta pagal duomenų bazės pirminį raktą.

Skiriami lokalūs namai (skirti pasiekti iš to paties kompiuterio) bei įprastiniai (tolimi) namai, kurie veikia tiek lokaliai, tiek ir kitame kompiuteryje per tinklą.

Namų klasė J2EE sistemoje paprastai visada generuojama automatiškai, tačiau paprastesnėse vystymo aplinkose namus išpildantį interfeisą gali tekti koduoti ir rankiniu būdu. Tai nėra sudėtinga, nes šie interfeisai yra paprasti.

Pavyzdys

// Lokalūs namai, tvarkatys įrašus apie klientus
public interface ClientHome
   extends EJBLocalHome
{
  // Rask pagal duomenų bazės raktą
  Client findByPrimaryKey(Integer key) throws FinderException;

  // Rask pagal vardą
  Collection findByName(String name) throws FinderException;  

  // Sukurk naują 
  Client create() throws CreateException;
}