You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openwebbeans.apache.org by ge...@apache.org on 2009/01/27 23:20:50 UTC
svn commit: r738278 - in
/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax: context/
inject/ inject/manager/
Author: gerdogdu
Date: Tue Jan 27 22:20:50 2009
New Revision: 738278
URL: http://svn.apache.org/viewvc?rev=738278&view=rev
Log:
Updating comments.
Modified:
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ContextNotActiveException.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ConversationScoped.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/Dependent.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/Current.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DefinitionException.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DeploymentType.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/New.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Bean.java
incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Manager.java
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ContextNotActiveException.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ContextNotActiveException.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ContextNotActiveException.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ContextNotActiveException.java Tue Jan 27 22:20:50 2009
@@ -15,11 +15,6 @@
import javax.inject.ExecutionException;
-/**
- * If the {@link Context} is not avalaible in the time of web beans component
- * getting, this exception is thrown.
- *
- */
public class ContextNotActiveException extends ExecutionException
{
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ConversationScoped.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ConversationScoped.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ConversationScoped.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/ConversationScoped.java Tue Jan 27 22:20:50 2009
@@ -18,9 +18,6 @@
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
-/**
- * Conversation wide scope type.
- */
@ScopeType
@Target( { ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/Dependent.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/Dependent.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/Dependent.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/context/Dependent.java Tue Jan 27 22:20:50 2009
@@ -18,12 +18,6 @@
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
-/**
- * Some web beans components is not lived without its parent web beans
- * component. This parent web beans components saves this dependent web beans
- * components in its {@link Dependent} scope. This annotation is used for
- * marking the web beans scope as dependent.
- */
@ScopeType(normal = false)
@Target( { ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/Current.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/Current.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/Current.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/Current.java Tue Jan 27 22:20:50 2009
@@ -23,10 +23,6 @@
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
-
-/**
- * Defines the current instance web beans component in the context.
- */
@Target( { TYPE, METHOD, PARAMETER, FIELD })
@Retention(RUNTIME)
@Documented
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DefinitionException.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DefinitionException.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DefinitionException.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DefinitionException.java Tue Jan 27 22:20:50 2009
@@ -13,10 +13,6 @@
*/
package javax.inject;
-/**
- * Defines the exception that is thrown when the definitons of the web beans
- * component is not logically correct.
- */
public class DefinitionException extends RuntimeException
{
private static final long serialVersionUID = -6261526411795328050L;
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DeploymentType.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DeploymentType.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DeploymentType.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/DeploymentType.java Tue Jan 27 22:20:50 2009
@@ -20,15 +20,6 @@
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
-
-/**
- * <p>
- * Every web beans components has some types. DeploymentType meta annotation is
- * used for definining new component types. There are two default deployment
- * type, these are {@link Production} for application components and
- * {@link Standard} for standart components.
- * </p>
- */
@Target(ANNOTATION_TYPE)
@Retention(RUNTIME)
@Documented
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/New.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/New.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/New.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/New.java Tue Jan 27 22:20:50 2009
@@ -23,12 +23,6 @@
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
-
-/**
- * Special binding. It is declared in the injection point. Every time injection
- * occurs, new instance of the injected component is created and put into the
- * dependent context.
- */
@Target( { METHOD, FIELD, PARAMETER, TYPE })
@Retention(RUNTIME)
@Documented
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Bean.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Bean.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Bean.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Bean.java Tue Jan 27 22:20:50 2009
@@ -18,81 +18,32 @@
import javax.context.Contextual;
-/**
- * Web Beans component contract.
- */
public abstract class Bean<T> implements Contextual<T>
{
- /** Manager instance */
private final Manager manager;
- /**
- * Constructs new web bean.
- *
- * @param manager manager instance
- */
protected Bean(Manager manager)
{
this.manager = manager;
}
- /**
- * Gets manager.
- *
- * @return the manager
- */
protected Manager getManager()
{
return manager;
}
- /**
- * Gets the set of api types of the web beans component.
- *
- * @return the set of api types
- */
public abstract Set<Class<?>> getTypes();
- /**
- * Gets the set of binding types of the web beans component.
- *
- * @return the binding types
- */
public abstract Set<Annotation> getBindings();
- /**
- * Gets the scope type of the web beans component.
- *
- * @return scope type
- */
public abstract Class<? extends Annotation> getScopeType();
- /**
- * Gets the deployment type of the web beans component.
- *
- * @return deployment type
- */
public abstract Class<? extends Annotation> getDeploymentType();
- /**
- * Gets the name of the web beans component.
- *
- * @return name of the component
- */
public abstract String getName();
- /**
- * True if serializable.
- *
- * @return true if serializable
- */
public abstract boolean isSerializable();
- /**
- * True if nullable.
- *
- * @return true if nullable
- */
public abstract boolean isNullable();
public abstract Set<InjectionPoint> getInjectionPoints();
Modified: incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Manager.java
URL: http://svn.apache.org/viewvc/incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Manager.java?rev=738278&r1=738277&r2=738278&view=diff
==============================================================================
--- incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Manager.java (original)
+++ incubator/openwebbeans/trunk/webbeans-api/src/main/java/javax/inject/manager/Manager.java Tue Jan 27 22:20:50 2009
@@ -17,54 +17,12 @@
import java.util.List;
import java.util.Set;
-import javax.annotation.NonBinding;
import javax.context.Context;
import javax.context.CreationalContext;
import javax.event.Observer;
import javax.inject.TypeLiteral;
-/**
- * Resolution of the components contract of the <b>Web Beans Container</b>.
- * There are two ways with regarding to the resolving components in the web
- * beans container, resolution by type and resolution by name.
- * <p>
- * When resolving at the injection point, the web beans container uses the api
- * type and binding type of the injected instance of the web bean component.
- * Each web beans component has to be enabled for being candidate in regarding
- * to resolution. Web Beans Container applies the following resolution procedure
- * in order;
- * </p>
- * <p>
- * <ul>
- * <li>Inspect the type of the injected point to find all web beans component
- * that has this API type.</li>
- * <li>From the candidates, it selects the all components that satisfies the
- * binding types of the injected point. If the injected point annotation has
- * some member values, then it selects the web beans components with binding
- * type (with {@link NonBinding} annotated member) that has same member values
- * with the injected annoation value.</li>
- * <li>If there are some components that has exactly the same binding type with
- * the injected point, container narrows the component set containing just those
- * components.</li>
- * <li>Examine the precedence type of the narrowed set of components and selects
- * the higher precedence of the components. Otherwise exception is thrown by the
- * container.</li>
- * </ul>
- * </p>
- * <p>
- * Resolution by name procedure is as follows;
- * </p>
- * <p>
- * <ul>
- * <li>Container selects the set of enabled web beans components that has the
- * given name</li>
- * <li>Container selects the higher precedence from the set using the component
- * type precedence</li>
- * <li>If exactly one component is remained, the resolution results in that
- * component, otherwise</li> exceptin is thrown by the container.
- * </ul>
- * </p>
- */
+
public interface Manager
{
public <T> Set<Bean<T>> resolveByType(Class<T> type, Annotation... bindings);