Apdesigner プログラマーズガイド

3.4.2 EJB1.1作成規約について

EJB1.1の主な規約について説明します。

• Session Beanの規約
• Entity Beanの規約

[Session Beanの規約]

			Session Bean
			STATELESS	STATEFUL
Homeインタフェース			必須	必須
	タイプ		インタフェース	インタフェース
	extends		javax.ejb.EJBHome	javax.ejb.EJBHome
	createメソッド		1個 Beanクラスにパラメタが同じejbCreateメソッドが必要	1個以上 Beanクラスにパラメタが同じejbCreateメソッドが必要
		メソッド名	create	create
		パラメタ	なし	任意
		復帰値	Remoteインタフェース	Remoteインタフェース
		throws句	対応するejbCreateメソッドのthrows句に含まれるすべての例外 java.rmi.RemoteException javax.ejb.CreateException	対応するejbCreateメソッドのthrows句に含まれるすべての例外 java.rmi.RemoteException javax.ejb.CreateException
Remoteインタフェース			必須	必須
	タイプ		インタフェース	インタフェース
	extends		javax.ejb.EJBObject	javax.ejb.EJBObject
	ビジネスメソッド		0個以上 Beanクラスにメソッド名、パラメタ、復帰値が同じビジネスメソッドが必要	0個以上 Beanクラスにメソッド名、パラメタ、復帰値が同じビジネスメソッドが必要
		メソッド名	任意	任意
		パラメタ	任意	任意
		復帰値	任意	任意
		throws句	Beanクラスの対応するビジネスメソッドのthrows句に含まれるすべての例外java.rmi.RemoteException	Beanクラスの対応するビジネスメソッドのthrows句に含まれるすべての例外java.rmi.RemoteException
Beanクラス			必須	必須
	タイプ		クラス	クラス
	public		必須	必須
	extends		可	可
	implements		javax.ejb.SessionBean javax.ejb.SessionSynchronizationは不可	javax.ejb.SessionBean
	abstract		×	×
	final		×	×
	ejbCreateメソッド		1個 Homeインタフェースにパラメタが同じcreateメソッドが必要	1個以上 Homeインタフェースにパラメタが同じcreateメソッドが必要
		メソッド名	ejbCreate	ejbCreate
		public	必須	必須
		final	×	×
		static	×	×
		パラメタ	なし	任意
		復帰値	void	void
		throws句	任意 java.rmi.RemoteExceptionは推奨しない	任意 java.rmi.RemoteExceptionは推奨しない
	ビジネスメソッド		0個以上 Remoteインタフェースに、メソッド名、パラメタ、復帰値が同じビジネスメソッドが必要	0個以上 Remoteインタフェースに、メソッド名、パラメタ、復帰値が同じビジネスメソッドが必要
		メソッド名	任意	任意
		public	必須	必須
		final	×	×
		static	×	×
		パラメタ	任意	任意
		復帰値	任意	任意
		throws句	任意 java.rmi.RemoteExceptionは推奨しない	任意 java.rmi.RemoteExceptionは推奨しない
	finalizeメソッド		不可	不可
	コンストラクタ		引数なしpublicコンストラクタは必須	引数なしpublicコンストラクタは必須

×：　使用できません。

[Entity Beanの規約]

			Entity Bean
			CMP(Container-managed persistence)	BMP(Bean-managed persistence)
Homeインタフェース			必須	必須
	タイプ		インタフェース	インタフェース
	extends		javax.ejb.EJBHome	javax.ejb.EJBHome
	createメソッド		0個以上 Beanクラスにパラメタが対応するejbCreateメソッドが必要	0個以上 Beanクラスにパラメタが対応するejbCreateメソッドが必要
		メソッド名	create	create
		パラメタ	任意	任意
		復帰値	Remoteインタフェース	Remoteインタフェース
		throws句	対応するejbCreateとejbPostCreateメソッドのthrows句に含まれるすべての例外 java.rmi.RemoteException javax.ejb.CreateException	対応するejbCreateとejbPostCreateメソッドのthrows句に含まれるすべての例外 java.rmi.RemoteException javax.ejb.CreateException
	finderメソッド		0個以上	0個以上 Beanクラスにメソッド名、パラメタが対応するejbFindメソッドが必要
		メソッド名	find+任意	find+任意
		パラメタ	任意	任意
		復帰値	Remoteインタフェースまたはそのコレクション	Remoteインタフェースまたはそのコレクション
		throws句	java.rmi.RemoteException javax.ejb.FinderException	java.rmi.RemoteException javax.ejb.FinderException 対応するejbFindメソッドのthrows句に含まれるすべての例外
	findByPrimaryKeyメソッド		1個	1個 Beanクラスに対応するejbFindByPrimaryKeyメソッドが必要
		メソッド名	findByPrimaryKey	findByPrimaryKey
		パラメタ	Primary Keyクラス	Primary Keyクラス
		復帰値	Remoteインタフェース	Remoteインタフェース
		throws句	java.rmi.RemoteException javax.ejb.FinderException	java.rmi.RemoteException javax.ejb.FinderException 対応するejbFindメソッドのthrows句に含まれるすべての例外
Remoteインタフェース			必須	必須
	タイプ		インタフェース	インタフェース
	extends		javax.ejb.EJBObject	javax.ejb.EJBObject
	ビジネスメソッド		0個以上 Beanクラスにメソッド名、パラメタ、復帰値が同じビジネスメソッドが必要	0個以上 Beanクラスにメソッド名、パラメタ、復帰値が同じビジネスメソッドが必要
		メソッド名	任意	任意
		パラメタ	任意	任意
		復帰値	任意	任意
		throws句	java.rmi.RemoteException 対応するビジネスメソッドのthrows句に含まれるすべての例外	java.rmi.RemoteException 対応するビジネスメソッドのthrows句に含まれるすべての例外
Beanクラス			必須	必須
	タイプ		クラス	クラス
	public		必須	必須
	extends		可	可
	implements		javax.ejb.EntityBean	javax.ejb.EntityBean
	abstract		×	×
	final		×	×
	ejbCreateメソッド		0個以上 Homeインタフェースにパラメタが対応するcreateメソッドが必要 メソッド名、パラメタが対応するejbPostCreateメソッドが必要	0個以上 Homeインタフェースにパラメタが対応するcreateメソッドが必要 メソッド名、パラメタが対応するejbPostCreateメソッドが必要
		メソッド名	ejbCreate	ejbCreate
		public	必須	必須
		final	×	×
		static	×	×
		パラメタ	任意	任意
		復帰値	Primary Keyクラス	Primary Keyクラス
		throws句	任意 java.rmi.RemoteExceptionは推奨しない	任意 java.rmi.RemoteExceptionは推奨しない
	ejbPostCreateメソッド		0以上 メソッド名、パラメタが対応するejbCreateメソッドが必要	0個以上 メソッド名、パラメタが対応するejbCreateメソッドが必要
		メソッド名	ejbPostCreate	ejbPostCreate
		public	必須	必須
		final	×	×
		static	×	×
		パラメタ	任意	任意
		復帰値	void	void
		throws句	任意 java.rmi.RemoteExceptionは推奨しない	任意 java.rmi.RemoteException推奨はしない
	ejbFindメソッド		−	0個以上 Homeインタフェースにメソッド名、パラメタが対応するfinderメソッドが必要
		メソッド名	−	ejbFind+任意
		public	−	必須
		final	−	×
		static	−	×
		パラメタ	−	任意
		復帰値	−	Primary Keyクラスまたはそのコレクション
		throws句	−	任意 java.rmi.RemoteExceptionは推奨されず
	ejbFindByPrimaryKeyメソッド		−	1個 Homeインタフェースに対応するfindByPrimaryKeyメソッドが必要
		メソッド名	−	ejbFindByPrimaryKey
		public	−	必須
		final	−	×
		static	−	×
		パラメタ	−	Primary Keyクラス
		復帰値	−	Primary Keyクラス
		throws句	−	任意 java.rmi.RemoteExceptionは推奨しない
	ビジネスメソッド		0個以上 Remoteインタフェースに、メソッド名、パラメタ、復帰値が同じビジネスメソッドが必要	0個以上 Remoteインタフェースに、メソッド名、パラメタ、復帰値が同じビジネスメソッドが必要
		メソッド名	任意	任意
		public	必須	必須
		final	×	×
		static	×	×
		パラメタ	任意	任意
		復帰値	任意	任意
		throws句	任意 java.rmi.RemoteExceptionは推奨しない	任意 java.rmi.RemoteExceptionは推奨しない
	finalizeメソッド		不可	不可
	コンストラクタ		引数なしpublicコンストラクタは必須	引数なしpublicコンストラクタは必須
	CMPフィールド		deployment descriptorの<cmp-field>と対応する	−
Primary Keyクラス			deployment descriptorの<prim-key-class>と対応する	deployment descriptorの<prim-key-class>と対応する
	型		任意のクラス	任意のクラス
	public		複数フィールドにマップされる場合は必須。	−
	フィールド		複数フィールドにマップされる場合はpublic必須 複数フィールドにマップされる場合はcontainer-managed fieldの名前のフィールドは必須	−
	コンストラクタ		複数フィールドにマップされる場合は引数なしpublic必須	−
	hashCodeメソッド		必須	必須
	equalsメソッド		必須	必須

×：　使用できません。
−：　無効になります。