Java 2 Platform EE v1.3: Interface EJBLocalHome - Java Platform, Enterprise Edition v1.3.1 API Specifications

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.ejb
Interface EJBLocalHome

public interface EJBLocalHome

The EJBLocalHome interface must be extended by all enterprise Beans' local home interfaces. An enterprise Bean's local home interface defines the methods that allow local clients to create, find, and remove EJB objects, as well as home business methods that are not specific to a bean instance (session Beans do not have finders and home business methods).

The local home interface is defined by the enterprise Bean provider and implemented by the enterprise Bean container.

Method Summary

void remove(java.lang.Object primaryKey)
Remove an EJB object identified by its primary key.

Method Detail

remove

public void remove(java.lang.Object primaryKey)
            throws RemoveException,
                   EJBException

Remove an EJB object identified by its primary key.

This method can only be used by local clients of an entity bean. An attempt to call this method on a session bean will result in an EJBException.

Throws:: RemoveException - Thrown if the enterprise Bean or the container does not allow the client to remove the object.; EJBException - Thrown when the method failed due to a system-level failure.