Enterprise JavaBeans | это... Что такое Enterprise JavaBeans? (original) (raw)

Enterprise JavaBeans (также часто употребляется в виде аббревиатуры EJB) — спецификация технологии написания и поддержки серверных компонентов, содержащих бизнес-логику. Является частью Java EE.

Эта технология обычно применяется, когда бизнес-логика требует как минимум один из следующих сервисов, а часто все из них:

• поддержка сохранности данных (persistence); данные должны быть в сохранности даже после остановки программы, чаще всего достигается с помощью использования базы данных
• поддержка распределённых транзакций
• поддержка конкурентного изменения данных и многопоточность
• поддержка событий
• поддержка именования и каталогов (JNDI)
• безопасность и ограничение доступа к данным
• поддержка автоматизированной установки на сервер приложений
• удалённый доступ

Каждый EJB компонент является набором Java классов со строго регламентированными правилами именования методов (верно для EJB 2.0, в EJB 3.0 за счет использования аннотаций выбор имен — свободный). Бывают трех основных типов:

• объектные (Entity Bean), перенесены в спецификацию Java Persistence API
• сессионные (Session Beans), которые бывают
  • без состояния (stateless)
  • с поддержкой текущего состояния сессии (stateful)
  • один объект на все приложение (singleton), начиная с версии 3.1
• управляемые сообщениями (Message Driven Beans) — их логика является реакцией на события в системе

Содержание

• 1 Пример Entity Bean
• 2 Пример Entity Bean Listener
• 3 Пример Session Bean - Stateless EAO (Entity Access Object)
• 4 Пример Abstract EAO (Entity Access Object)
• 5 Пример Session Bean (Stateless) - Gallery Facade
• 6 Пример Application Exception - GalleryNotFoundException
• 7 Пример Application Exception - GalleryAlreadyExistsException
• 8 Ссылки

Пример Entity Bean

package org.test.entity;

import java.io.Serializable; import java.util.Date; import javax.persistence.*; import javax.validation.constraints.Size; import org.test.entity.listener.GalleryListener;

@Entity @EntityListeners({GalleryListener.class}) @Table(name = "gallery", uniqueConstraints = { @UniqueConstraint(columnNames = {"id"}) } ) @NamedQueries({ @NamedQuery(name = Gallery.QUERY_FIND_ALL, query = "SELECT g FROM Gallery g ORDER BY g.name ASC"), @NamedQuery(name = Gallery.QUERY_FIND_BY_NAME, query = "SELECT g FROM Gallery g WHERE c.name = :name") }) public class Gallery implements Serializable {

private static final long serialVersionUID = 1L;

public static final String QUERY_FIND_ALL = "Gallery.findAll";
public static final String QUERY_FIND_BY_NAME = "Gallery.findByName";

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(name = "id", nullable = false)
private Long id;

@Size(max = 100)
@Column(name = "name", length = 100)
private String name;

@Column(name = "created_at")
@Temporal(TemporalType.TIMESTAMP)
private Date createdAt;

public Gallery() {
}

public Gallery(String name) {
    this.name = name;
}

public Date getCreatedAt() {
    return createdAt;
}

public void setCreatedAt(Date createdAt) {
    this.createdAt = createdAt;
}

public Long getId() {
    return id;
}

public void setId(Long id) {
    this.id = id;
}

public String getName() {
    return name;
}

public void setName(String name) {
    this.name = name;
}

@Override
public boolean equals(Object obj) {
    if (obj == null) {
        return false;
    }
    if (getClass() != obj.getClass()) {
        return false;
    }
    final Gallery other = (Gallery) obj;
    if (this.id != other.id && (this.id == null || !this.id.equals(other.id))) {
        return false;
    }
    return true;
}

@Override
public int hashCode() {
    int hash = 7;
    hash = 47 * hash + (this.id != null ? this.id.hashCode() : 0);
    return hash;
}

}

Пример Entity Bean Listener

package org.test.entity.listener;

import java.util.Date; import javax.persistence.PrePersist; import org.test.entity.Gallery;

public class GalleryListener {

@PrePersist
public void prePersist(Gallery gallery) {
    gallery.setCreatedAt(new Date());
}

}

Пример Session Bean - Stateless EAO (Entity Access Object)

package org.test.eao;

import java.util.List; import javax.ejb.LocalBean; import javax.ejb.Stateless; import javax.ejb.TransactionAttribute; import javax.ejb.TransactionAttributeType; import javax.persistence.EntityManager; import javax.persistence.PersistenceContext; import org.test.entity.Gallery;

@Stateless @LocalBean public class GalleryEAO extends AbstractEAO {

@PersistenceContext(unitName = "PersistenceUnit")
private EntityManager entityManager;

public GalleryEAO() {
    super(Gallery.class);
}

@Override
protected EntityManager getEntityManager() {
    return entityManager;
}

@TransactionAttribute(TransactionAttributeType.SUPPORTS)
public List<Gallery> findAll() {
    return namedQuery(Gallery.QUERY_FIND_ALL).getResultList();
}

@TransactionAttribute(TransactionAttributeType.SUPPORTS)
public Gallery findByName(String name) {
    return namedQuery(Gallery.QUERY_FIND_BY_NAME)
            .setParameter("name", name)
            .getSingleResult();
}   

}

Пример Abstract EAO (Entity Access Object)

package org.test.eao;

import java.io.Serializable; import javax.persistence.EntityManager; import javax.persistence.Query; import javax.persistence.TypedQuery; import javax.persistence.criteria.CriteriaQuery; import javax.persistence.criteria.Root;

public abstract class AbstractEAO {

protected abstract EntityManager getEntityManager();

private Class<T> entityClass;

public Class<T> getEntityClass() {
    return entityClass;
}

public AbstractEAO(Class<T> entityClass) {
    this.entityClass = entityClass;
}

public void persist(T entity) {
    getEntityManager().persist(entity);
}

public void merge(T entity) {
    getEntityManager().merge(entity);
}

public void remove(T entity) {
    if (entity != null) {
        getEntityManager().remove(entity);
    }
}

public void remove(Object id) {
    T entity = (T) getEntityManager().find(entityClass, id);
    remove(entity);
}

public T find(Object id) {
    return getEntityManager().find(entityClass, id);
}

public void refresh(T entity) {
    getEntityManager().refresh(entity);
}

public TypedQuery<T> namedQuery(String queryName) {
    return getEntityManager().createNamedQuery(queryName, entityClass);
}

public TypedQuery<T> query(String queryString) {
    return getEntityManager().createQuery(queryString, entityClass);
}

public long count() {
    CriteriaQuery criteriaQuery = getEntityManager().getCriteriaBuilder().createQuery();
    Root<T> root = criteriaQuery.from(entityClass);
    criteriaQuery.select(getEntityManager().getCriteriaBuilder().count(root));
    Query query = getEntityManager().createQuery(criteriaQuery);

    return ((Long) query.getSingleResult()).longValue();
}

}

Пример Session Bean (Stateless) - Gallery Facade

package org.test.facade;

import java.util.List; import javax.ejb.*; import org.test.eao.GalleryEAO; import org.test.entity.Gallery; import org.test.exception.GalleryAlreadyExistsException; import org.test.exception.GalleryNotFoundException;

@Stateless @LocalBean public class GalleryFacade {

@EJB
private GalleryEAO galleryEAO;

@TransactionAttribute(TransactionAttributeType.SUPPORTS)
public Gallery findById(Long id) throws GalleryNotFoundException {
    Gallery gallery = galleryEAO.find(id);
    if (gallery == null) throw new GalleryNotFoundException("Gallery not found");
    return gallery;
}

@TransactionAttribute(TransactionAttributeType.SUPPORTS)
public List<Gallery> findAll() {
    return galleryEAO.findAll();
}

@TransactionAttribute(TransactionAttributeType.REQUIRED)
public void create(String name) throws GalleryAlreadyExistsException {
    if (galleryEAO.findByName(name) != null) throw new GalleryAlreadyExistsException("Gallery already exits", name);
    Gallery gallery = new Gallery(name);
    galleryEAO.persist(gallery);
}

@TransactionAttribute(TransactionAttributeType.REQUIRED)
public void remove(Long id) throws GalleryNotFoundException {
    Gallery gallery = findById(id);
    galleryEAO.remove(gallery);
}

}

Пример Application Exception - GalleryNotFoundException

package org.test.exception;

import javax.ejb.ApplicationException;

@ApplicationException(rollback=true) public class GalleryNotFoundException extends Exception {

public GalleryNotFoundException() {
}

public GalleryNotFoundException(String message) {
    super(message);
}    

}

Пример Application Exception - GalleryAlreadyExistsException

package org.test.exception;

import javax.ejb.ApplicationException;

@ApplicationException(rollback=true) public class GalleryAlreadyExistsException extends Exception {

private String name;

public GalleryAlreadyExistsException() {
}

public GalleryAlreadyExistsException(String message, String name) {
    super(message);
}

public String getName() {
    return name;
}   

}

Ссылки

• Официальная страница продукта Enterprise JavaBeans на портале Oracle
• Спецификации различных версий Enterprise JavaBeans от SUN
• Краткое введение в технологию Enterprise JavaBeans (rus)(по версии 1.1)
• Краткое введение в EJB3 на Linux Format Wiki

Java
Платформы	Java Card • Java ME • Java SE • Java EE
Технологии Sun	Java • Java Development Kit • OpenJDK • WTK • Java Virtual Machine • JavaFX • JAXP • Squawk
Основные сторонние технологии	GNU Classpath • GNU компилятор для Java • Kaffe • TopLink • Apache Harmony • Apache Struts • Spring Framework • Dalvik • Hibernate • JBoss • Processing • Dozer • AspectJ
История	История версий Java • Критика Java • Java Community Process • Sun Microsystems • Свободные реализации Java
Свойства языка	Байткод • Синтаксис • Апплеты • Сервлеты • Мидлеты • JavaServer Pages • Web Start • Enterprise JavaBeans
Скриптовые языки	Java Tcl • Jython • JRuby • BeanShell • Groovy • Judoscript • Sleep • Bean Scripting Framework • Yoix • Rhino
Конференции Java	JavaOne