Find Usages Diff Raw Download HTML Widget
Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions 
1
  /*
2
  * JBoss, Home of Professional Open Source
3
  * Copyright 2008, Red Hat Middleware LLC, and individual contributors
4
  * by the @authors tag. See the copyright.txt in the distribution for a
5
  * full listing of individual contributors.
6
  *
7
  * Licensed under the Apache License, Version 2.0 (the "License");
8
  * you may not use this file except in compliance with the License.
9
  * You may obtain a copy of the License at
10
 * http://www.apache.org/licenses/LICENSE-2.0
11
 * Unless required by applicable law or agreed to in writing, software
12
 * distributed under the License is distributed on an "AS IS" BASIS,  
13
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
 * See the License for the specific language governing permissions and
15
 * limitations under the License.
16
 */
17
 
18
 package javax.enterprise.event;
19
 
21
 

Allows the application to fire events of a particular type.

Beans fire events via an instance of the Event interface, which may be injected:

 @Inject @Any Event<LoggedInEvent> loggedInEvent;

The fire() method accepts an event object:

 public void login() { 
    ...
    loggedInEvent.fire( new LoggedInEvent(user) );
 }

Any combination of qualifiers may be specified at the injection point:

 @Inject @Admin Event<LoggedInEvent> adminLoggedInEvent;

Or, the &.064;Any qualifier may be used, allowing the application to specify qualifiers dynamically:

 @Inject @Any Event<LoggedInEvent> loggedInEvent;

For an injected Event:

  • the specified type is the type parameter specified at the injection point, and
  • the specified qualifiers are the qualifiers specified at the injection point.

Parameters:
<T> the type of the event object
Author(s):
Gavin King
Pete Muir
David Allen
71
 
72
 
73
 public interface Event<T>
74
 {

   

Fires an event with the specified qualifiers and notifies observers.

Parameters:
event the event object
Throws:
java.lang.IllegalArgumentException if the runtime type of the event object contains a type variable
82
 
83
    public void fire(T event);
   
   

Obtains a child Event for the given additional required qualifiers.

Parameters:
qualifiers the additional specified qualifiers
Returns:
the child Event
Throws:
java.lang.IllegalArgumentException if passed two instances of the same qualifier type, or an instance of an annotation that is not a qualifier type
94
 
95
    public Event<T> select(Annotation... qualifiers);
   
   

Obtains a child Event for the given required type and additional required qualifiers.

Parameters:
<U> the specified type
subtype a java.lang.Class representing the specified type
qualifiers the additional specified qualifiers
Returns:
the child Event
Throws:
java.lang.IllegalArgumentException if passed two instances of the same qualifier type, or an instance of an annotation that is not a qualifier type
109
   public <U extends T> Event<U> select(Class<U> subtype, Annotation... qualifiers);
   
   

Obtains a child Event for the given required type and additional required qualifiers.

Parameters:
<U> the specified type
subtype a javax.enterprise.util.TypeLiteral representing the specified type
qualifiers the additional specified qualifiers
Returns:
the child Event
Throws:
java.lang.IllegalArgumentException if passed two instances of the same qualifier type, or an instance of an annotation that is not a qualifier type
123
   public <U extends T> Event<U> select(TypeLiteral<U> subtype, Annotation... qualifiers);
New to GrepCode? Check out our FAQ X