13. EJB 2.1 jako przykład klasycznego middleware API

Materiał zawiera wprowadzenie do EJB - czym są, jakie są ich rodzaje. Oprócz tego zapoznamy się z ogólnym mechanizmem działania EJB, zwracając szczególną uwagę na obiekty pośredniczące i  interfejsy Home. Zostanie pokazany przykład aplikacji, opracowanej w wersji EJB 2.1 i wdrożonej w środowisku serwera SJAS 8.2.  W tej chwili dostępna jest specyfikacja EJB 3.0, znacznie ułatwiająca sposób programowania EJB. Jednak mechanizm działania EJB (choć w nowej wersji może być ukryty przed programistą) pozostaje ten sam i warto z nim - choćby w zarysach się zapoznać.

Wysłuchaj wprowadzenia do wykładu.

1. Komponenty EJB

• komponenty sesyjne (session beans) - wykonują działania (np. wypłata z konta). Dwa typy: bezstanowe (stateless) i stanowe (stateful). Te ostatnie zachowują pośrednie stany wykonywanych czynności dla danego klienta ("prowadzą" stan poprzez szereg kolejnych zleceń - np. zakupy w e-sklepie i stan koszyka).
• komponenty encyjne (entity beans) - modelują (odzwierciedlają) dane (np. produkty, klienci).
• komponenty sterowane komunikatami (message driven beans) - podobne do sesyjnych, ale akcje sterowane komunikatami (zob. JMS).

2. EJB, uslugi middleware a logika biznesowa

3. Programowanie komponentów EJB 2.1

package pit;

import javax.ejb.SessionBean;
import javax.ejb.SessionContext;
import java.math.*;


public class PitBean implements SessionBean {

    private BigDecimal taxRate = new BigDecimal("0.14");

    public PitBean() {
    }

    public BigDecimal taxToPay(BigDecimal income) {
        BigDecimal result = income.multiply(taxRate);

        return result.setScale(2, BigDecimal.ROUND_UP);
    }


    // Metoda wołana przy tworzeniu obiektu ziarna
    public void ejbCreate() {
    }

    // Metody interfejsu SessionBean

    public void ejbRemove() {
    }

    public void ejbActivate() {
    }

    public void ejbPassivate() {
    }

    public void setSessionContext(SessionContext sc) {
    }
}

• mają nazwę ejbCreate,
• typ wyniku void,
• są publiczne,
• mogą mieć argumenty, ale typy argumentów muszą spełniać wymagania zdalnego dostępu (np. przekazanie przez referencję dotyczyć może tylko zdalnych obiektów),
• mogą sygnalizować wyjątek CreateException - zwykle jako reakcja na wadliwe argumenty wywołania.

• bezpieczeństwa,
• transakcyjności,
• zarządzania zasobami, w tym cyklem zyciowym komponentu,
• trwałości (utrwalania stanów i danych),
• zarządzania wielodostępem (zapewniony wspólbieżny dostęp ze strony wielu klientów jednocześnie),
• itp.

package pit;

import javax.ejb.EJBObject;
import java.rmi.RemoteException;
import java.math.*;

public interface Pit extends EJBObject {
    public BigDecimal taxToPay(BigDecimal income) throws RemoteException;
}

• tworzeniem,
• odnajdywaniem istniejących,
• usuwaniem.

package pit;

import java.rmi.RemoteException;
import javax.ejb.CreateException;
import javax.ejb.EJBHome;


public interface PitHome extends EJBHome {
    Pit create() throws RemoteException, CreateException;
}

• fabryczne metody tworzenia obiektu (create) muszą być zgodne (pod względem nazwy i typów argumentów) z metodami inicjacji ziarna w implementacji komponentu biznesowego (ejbCreate).
• tutaj mamy zdalny obiekt Home, dlatego wyjątek RemoteException

• klasę ziarna biznesowego PitBean,
• interfejs Remote - o nazwie Pit, służący do generacji zdalnego obiektu EJBObject, pośredniczącego w odwołaniach do naszego ziarna,
• interfejs Home - o nazwie PitHome, służący do generacji fabryki EJB-obiektów, za pomoca której klienci tworzą obiekty i uzyskują do nich dostęp.

• uzyskać dostęp do fabryki obiektów (interfejs Home = u nas PitHome) - oczywiście poprzez JNDI,
• za pośrednictwem Home uzyskac dostęp do obiektu pośredniczącego (interfejs Remote = u nas Pit),
• wywoływac metody interfejsu Pit, które za pośrednictwem EJBObject odwołują się do analogicznych metod klasy ziarna biznesowego (PitBean).

import pit.Pit;
import pit.PitHome;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.rmi.PortableRemoteObject;
import java.math.BigDecimal;


public class PitClient {
    public static void main(String[] args) {
        try {
            Context initial = new InitialContext();
            Context myEnv = (Context) initial.lookup("java:comp/env");
            Object objref = myEnv.lookup("ejb/Pit");

            PitHome home =
                (PitHome) PortableRemoteObject.narrow(objref,
                    PitHome.class);

            Pit pit = home.create();

            BigDecimal income = new BigDecimal("100000.00");
            BigDecimal tax = pit.taxToPay(income);

            System.out.println("Podatek wynosi: " + tax);

            System.exit(0);

        } catch (Exception ex) {
            System.err.println("Caught an unexpected exception!");
            ex.printStackTrace();
        }
    }
}

4. Składanie aplikacji

• uniwersalne - zgodne ze specyfikacją EJB, używane w każdym serwerze aplikacji,
• specyficzne - wymagane przez konkretne serwery aplikacji.

<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.1"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
    http://java.sun.com/xml/ns/j2ee/ejb-jar_2_1.xsd">

<display-name>PitAppJar</display-name>
<enterprise-beans>
<session>
<display-name>PitBean</display-name>
<ejb-name>PitBean</ejb-name>
<home>pit.PitHome</home>
<remote>pit.Pit</remote>
<ejb-class>pit.PitBean</ejb-class>
<session-type>Stateless</session-type>
<transaction-type>Bean</transaction-type>
<security-identity>
<use-caller-identity/>
</security-identity>
</session>
</enterprise-beans>
</ejb-jar>

<?xml version="1.0" encoding="UTF-8"?>
<application-client xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.4" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/application-client_1_4.xsd">
<display-name>PitAppClient</display-name>
<ejb-ref>
<ejb-ref-name>ejb/Pit</ejb-ref-name>
<ejb-ref-type>Session</ejb-ref-type>
<home>pit.PitHome</home>
<remote>pit.Pit</remote>
</ejb-ref>
</application-client>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sun-ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Application Server 8.1 EJB 2.1//EN" "http://www.sun.com/software/appserver/dtds/sun-ejb-jar_2_1-1.dtd">

<sun-ejb-jar>
  <enterprise-beans>
    <name>PitAppJar</name>
    <ejb>
      <ejb-name>PitBean</ejb-name>
      <jndi-name>PitBean</jndi-name>
    </ejb>
  </enterprise-beans>
</sun-ejb-jar>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sun-application-client PUBLIC "-//Sun Microsystems, Inc.//DTD Application Server 8.1 Application Client 1.4//EN" "http://www.sun.com/software/appserver/dtds/sun-application-client_1_4-1.dtd">
<sun-application-client>
<ejb-ref>
<ejb-ref-name>ejb/Pit</ejb-ref-name>
<jndi-name>PitBean</jndi-name>
</ejb-ref>
</sun-application-client>

5. Wdrażanie aplikacji

6. Podsumowanie

• koncepcją EJB,
• rodzajami EJB,
• sposobem programowania EJB w wersji 2.1,
• struktura i składaniem aplikacji typu "Enterprise",
• wdrażaniem aplikacji.

7. Zadania