View Javadoc

1   /*
2    * Copyright 2006-2008 the original author or authors.
3    * 
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    * 
8    *      http://www.apache.org/licenses/LICENSE-2.0
9    * 
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package org.springframework.osgi.context.event;
18  
19  import org.osgi.framework.Bundle;
20  import org.springframework.context.ApplicationContext;
21  
22  /**
23   * Event raised when an <code>ApplicationContext</code> failed.
24   * 
25   * @author Costin Leau
26   * 
27   */
28  public class OsgiBundleContextFailedEvent extends OsgiBundleApplicationContextEvent {
29  
30  	private final Throwable cause;
31  
32  
33  	/**
34  	 * Constructs a new <code>OsgiBundleContextFailedEvent</code> instance.
35  	 * 
36  	 * @param source the <code>ApplicationContext</code> that has failed (must
37  	 * not be <code>null</code>)
38  	 * @param bundle the OSGi bundle associated with the source application
39  	 * context
40  	 * @param cause optional <code>Throwable</code> indicating the cause of
41  	 * the failure
42  	 */
43  	public OsgiBundleContextFailedEvent(ApplicationContext source, Bundle bundle, Throwable cause) {
44  		super(source, bundle);
45  		this.cause = cause;
46  	}
47  
48  	/**
49  	 * Returns the <code>Throwable</code> that caused the application context
50  	 * to fail.
51  	 * 
52  	 * @return the cause of the failure.
53  	 */
54  	public final Throwable getFailureCause() {
55  		return cause;
56  	}
57  }