Package org.beanlet.web

Adds web specific beanlet scopes.

See:
Description

Class Summary

RequestContextListener

Add the following configuration to the web application's web.xml file to support the Request and Session beanlet scopes.

Annotation Types Summary

Request	Request beanlets do not provide direct access to the underlying objects.
Session	Session beanlets do not provide direct access to the underlying objects.

Package org.beanlet.web Description

Adds web specific beanlet scopes.

Beanlet Scopes

The Beanlet web package comes with two object scopes:

• Request beanlets do not provide direct access to the underlying objects. Instead, clients obtain a stub that delegates invocations to the underlying instance. In case of request beanlets, the stub creates a new instance per HTTP request. This instance is always assigned while performing that particular HTTP request.
• Session beanlets do not provide direct access to the underlying objects. Instead, clients obtain a stub that delegates invocations to the underlying instance. In case of request beanlets, the stub creates a new instance per HTTP session. This instance is always assigned while performing a request for that particular HTTP session. Session beanlet instances only exist while the session, for which they were created, is active. These beanlet instances are destroyed when their HTTP session is invalidated or expired.
  Session beanlets are non reentrant by default, which means that only one thread can invoke a method of the beanlet instance at the same time. This feature is provided by the stub, which controls all access to the underlying instance. Session beanlets can also be configured to be reentrant.

Static versus Non-Static

Beanlets are created in either a static or a non-static context. Static, in this context, means that beanlets are created independently from the current state of the container or application. Static beanlets are created at the container's discretion and therefore do not allow applications to pass any state to this component while it is being created. Non-static beanlets are only created upon application request. Applications can pass objects - or state if you will - by using wiring BY_INFO dependency injection. Use the BeanletMetaData interface to find out whether a beanlet is static, or not.

The static property of a beanlet is derived from the selected beanlet scope, i.e., singleton vanilla beanlets are static, where non-singleton vanilla beanlets are non-static. The following table shows the static property for all web beanlet scopes.

	singleton	reentrant	static
Request	N/A	N/A	false
Session	N/A	true/false	false